bonfire-app/justfile

612 lines
22 KiB
Makefile
Raw Normal View History

2022-05-23 02:20:39 +00:00
# recipes for the `just` command runner: https://just.systems
# how to install: https://github.com/casey/just#packages
## Main configs - override these using env vars
# what flavour do we want?
FLAVOUR := env_var_or_default('FLAVOUR', "classic")
FLAVOUR_PATH := env_var_or_default('FLAVOUR_PATH', "flavours/" + FLAVOUR)
# do we want to use Docker? set as env var:
# - WITH_DOCKER=total : use docker for everything (default)
# - WITH_DOCKER=partial : use docker for services like the DB
# - WITH_DOCKER=easy : use docker for services like the DB & compiled utilities like messctl
# - WITH_DOCKER=no : please no
WITH_DOCKER := env_var_or_default('WITH_DOCKER', "total")
MIX_ENV := env_var_or_default('MIX_ENV', "dev")
2022-10-17 10:01:30 +00:00
APP_DOCKER_IMAGE := env_var_or_default('APP_DOCKER_IMAGE', "bonfirenetworks/bonfire:latest-" +FLAVOUR)
2022-10-17 01:02:24 +00:00
DB_DOCKER_IMAGE := if arch() == "aarch64" { "ghcr.io/baosystems/postgis:12-3.3" } else { env_var_or_default('DB_DOCKER_IMAGE', "postgis/postgis:12-3.3-alpine") }
2022-05-23 02:20:39 +00:00
## Other configs - edit these here if necessary
FORKS_PATH := "forks/"
ORG_NAME := "bonfirenetworks"
APP_NAME := "bonfire"
2022-06-24 21:42:35 +00:00
APP_VSN_EXTRA := "beta"
2022-05-23 02:20:39 +00:00
APP_REL_DOCKERFILE :="Dockerfile.release"
APP_REL_DOCKERCOMPOSE :="docker-compose.release.yml"
APP_REL_CONTAINER := APP_NAME + "_release"
WEB_CONTAINER := APP_NAME +"_web"
APP_VSN := `grep -m 1 'version:' mix.exs | cut -d '"' -f2`
APP_BUILD := `git rev-parse --short HEAD`
2022-06-23 01:16:54 +00:00
APP_DOCKER_REPO := ORG_NAME+"/"+APP_NAME
2022-05-23 02:20:39 +00:00
CONFIG_PATH := FLAVOUR_PATH + "/config"
UID := `id -u`
GID := `id -g`
2022-06-16 22:34:16 +00:00
## Configure just
# choose shell for running recipes
set shell := ["bash", "-uc"]
2022-05-23 02:20:39 +00:00
# set shell := ["bash", "-uxc"]
2022-06-16 22:34:16 +00:00
# load all vars from .env file
2022-05-23 02:20:39 +00:00
set dotenv-load
2022-06-16 22:34:16 +00:00
# export just vars into recipe as env vars
2022-05-23 02:20:39 +00:00
set export
2022-06-16 22:34:16 +00:00
# support args like $1, $2, etc, and $@ for all args
2022-05-23 02:20:39 +00:00
set positional-arguments
#### GENERAL SETUP RELATED COMMANDS ####
help:
@echo "Just commands for Bonfire:"
@just --list
2022-05-23 03:15:11 +00:00
pre-setup flavour='classic':
2022-05-23 02:20:39 +00:00
@echo "Using flavour '$flavour' at flavours/$flavour with env '$MIX_ENV'"
@ln -sfn flavours/$flavour/config ./config
@mkdir -p data/
@mkdir -p ./config/prod
@mkdir -p ./config/dev
2022-05-23 03:18:03 +00:00
@mkdir -p ./config/test
2022-05-23 02:20:39 +00:00
@touch ./config/deps.path
@test -f ./config/$MIX_ENV/.env || ((test -f ./config/$MIX_ENV/public.env && (cat ./config/$MIX_ENV/public.env ./config/$MIX_ENV/secrets.env > ./config/$MIX_ENV/.env) && rm ./config/$MIX_ENV/public.env && rm ./config/$MIX_ENV/secrets.env) || (cat ./config/templates/public.env ./config/templates/not_secret.env > ./config/$MIX_ENV/.env) && echo "MIX_ENV=$MIX_ENV" >> ./config/$MIX_ENV/.env)
2022-06-29 08:29:20 +00:00
@ln -sf ./config/dev/ ./config/test/
2022-06-22 09:02:23 +00:00
@rm .env | true
2022-05-23 02:20:39 +00:00
@ln -sf ./config/$MIX_ENV/.env ./.env
@mkdir -p forks/
@mkdir -p data/uploads/
@mkdir -p priv/static/data
@ln -s data/uploads priv/static/data/ | true
@mkdir -p data/search/dev
@chmod 700 .erlang.cookie
# Initialise env files, and create some required folders, files and softlinks
2022-06-20 02:30:53 +00:00
config:
@just flavour $FLAVOUR
# Initialise a specific flavour, with its env files, and create some required folders, files and softlinks
flavour select_flavour:
2022-05-23 02:20:39 +00:00
@echo "Switching to flavour '$select_flavour'..."
@just pre-setup $select_flavour
2022-06-20 02:30:53 +00:00
@just deps-clean-data
2022-06-21 11:01:09 +00:00
@just deps-clean-api
@just mix deps.clean --build --unused
@just deps-get
2022-06-20 02:30:53 +00:00
@just js-deps-get
2022-05-23 02:20:39 +00:00
@echo "You can now edit your config for flavour '$select_flavour' in /.env and ./config/ more generally."
pre-init:
2022-06-28 00:29:03 +00:00
@echo "Running $MIX_ENV env, with flavour: $FLAVOUR at path: $FLAVOUR_PATH"
2022-05-23 02:20:39 +00:00
@rm -rf ./priv/repo
@cp -rn $FLAVOUR_PATH/repo ./priv/repo
2022-06-28 00:29:03 +00:00
@rm -rf ./data/current_flavour
@ln -sf ../$FLAVOUR_PATH ./data/current_flavour
@ln -sf ./config/$MIX_ENV/.env ./.env
2022-10-17 01:02:24 +00:00
@mkdir -p priv/static/public
2022-05-23 02:20:39 +00:00
init: pre-init services
2022-06-23 01:16:54 +00:00
@echo "Light that fire... $APP_NAME with $FLAVOUR flavour in $MIX_ENV - docker:$WITH_DOCKER - $APP_VSN - $APP_BUILD - $FLAVOUR_PATH - {{os_family()}}/{{os()}} on {{arch()}}"
2022-05-23 02:20:39 +00:00
#### COMMON COMMANDS ####
# First run - prepare environment and dependencies
setup:
2022-06-20 02:30:53 +00:00
just flavour $FLAVOUR
2022-05-23 02:20:39 +00:00
just build
just mix setup
# Prepare environment and dependencies
prepare:
just pre-setup $FLAVOUR
just build
# Run the app in development
dev: init dev-run
2022-06-16 22:34:16 +00:00
@dev-run:
2022-05-23 02:20:39 +00:00
{{ if WITH_DOCKER == "total" { "just docker-stop-web && docker-compose run --name $WEB_CONTAINER --service-ports web" } else { "iex -S mix phx.server" } }}
# Generate docs from code & readmes
docs:
just mix-remote docs
2022-09-06 20:59:28 +00:00
# Analyse the codebase and generate some reports. Requires Graphviz and SQLite
arch:
just mix arch.explore.static
just mix arch.explore.xrefs
just mix arch.explore.apps
2022-09-08 02:50:23 +00:00
-MIX_ENV=test just mix arch.explore.coverage
2022-09-06 20:59:28 +00:00
just mix arch.dsm
2022-09-08 02:50:23 +00:00
just mix arch.report.html
mkdir -p reports/dev/static/html/data/
just mix arch.apps.xref --format mermaid --out reports/dev/static/html/data/apps.mermaid
just mix arch.apps.xref --format svg --out reports/dev/static/html/data/apps.svg
# just mix arch.xref --format svg --out reports/dev/static/modules.png Bonfire.Web.Router Bonfire.UI.Social.Routes Bonfire.UI.Me.Routes
2022-09-06 20:59:28 +00:00
2022-05-23 02:20:39 +00:00
# Force the app to recompile
recompile:
just mix "compile --force"
dev-test:
2022-10-23 21:01:21 +00:00
@MIX_ENV=test START_SERVER=yes just dev-run
2022-05-23 02:20:39 +00:00
# Run the app in dev mode, as a background service
dev-bg: init
{{ if WITH_DOCKER == "total" { "just docker-stop-web && docker-compose run --detach --name $WEB_CONTAINER --service-ports web elixir -S mix phx.server" } else { 'elixir --erl "-detached" -S mix phx.server" && echo "Running in background..." && (ps au | grep beam)' } }}
# Run latest database migrations (eg. after adding/upgrading an app/extension)
db-migrate:
2022-06-23 01:16:54 +00:00
just mix "ecto.migrate"
2022-05-23 02:20:39 +00:00
# Run latest database seeds (eg. inserting required data after adding/upgrading an app/extension)
2022-06-23 01:16:54 +00:00
db-seeds: db-migrate
just mix "ecto.seeds"
2022-05-23 02:20:39 +00:00
# Reset the DB (caution: this means DATA LOSS)
db-reset: init dev-search-reset db-pre-migrations
2022-06-23 01:16:54 +00:00
just mix "ecto.reset"
2022-05-23 02:20:39 +00:00
2022-06-23 01:16:54 +00:00
dev-search-reset: dev-search-reset-docker
2022-05-23 02:20:39 +00:00
rm -rf data/search/dev
2022-06-23 01:16:54 +00:00
dev-search-reset-docker:
{{ if WITH_DOCKER != "no" { "docker-compose rm -s -v search" } else {""} }}
2022-05-23 02:20:39 +00:00
# Rollback previous DB migration (caution: this means DATA LOSS)
db-rollback:
2022-06-23 01:16:54 +00:00
just mix "ecto.rollback"
2022-05-23 02:20:39 +00:00
# Rollback ALL DB migrations (caution: this means DATA LOSS)
db-rollback-all:
just mix "ecto.rollback --all"
#### UPDATE COMMANDS ####
# Update the dev app and all dependencies/extensions/forks, and run migrations
update: init update-repo
just prepare
just update-forks
just update-deps
just mix deps.get
2022-06-23 01:16:54 +00:00
just mix "ecto.migrate"
2022-05-23 02:20:39 +00:00
just js-deps-get
# Update the app and Bonfire extensions in ./deps
update-app: update-repo update-deps
2022-09-15 19:43:27 +00:00
pre-update-deps:
2022-05-23 02:20:39 +00:00
@rm -rf deps/*/assets/pnpm-lock.yaml
@rm -rf deps/*/assets/yarn.lock
2022-09-15 19:43:27 +00:00
# Update Bonfire extensions in ./deps
update-deps: pre-update-deps
2022-05-23 02:20:39 +00:00
just mix-remote updates
2022-07-13 00:25:09 +00:00
update-repo: pre-contrib-hooks
2022-05-23 02:20:39 +00:00
@chmod +x git-publish.sh && ./git-publish.sh . pull || git pull
2022-07-13 00:25:09 +00:00
update-repo-pull:
2022-05-23 02:20:39 +00:00
@chmod +x git-publish.sh && ./git-publish.sh . pull only
# Update to the latest Bonfire extensions in ./deps
update-deps-bonfire:
just mix-remote bonfire.deps
# Update evey single dependency (use with caution)
2022-09-15 19:43:27 +00:00
update-deps-all: deps-clean-unused pre-update-deps
2022-06-22 06:59:10 +00:00
just mix-remote "deps.update --all"
2022-09-15 06:40:33 +00:00
just js-app-deps upgrade
just js-ext-deps upgrade
just js-ext-deps outdated
just js-app-deps outdated
just mix "hex.outdated --all"
2022-05-23 02:20:39 +00:00
# Update a specify dep (eg. `just update.dep pointers`)
update-dep dep:
@chmod +x git-publish.sh && ./git-publish.sh $FORKS_PATH/$dep pull
just mix-remote "deps.update $dep"
./assets/install_extensions.sh $dep
2022-05-23 02:20:39 +00:00
# Pull the latest commits from all ./forks
update-forks:
@jungle git fetch || echo "Jungle not available, will fetch one by one instead."
2022-07-29 00:47:21 +00:00
@chmod +x git-publish.sh && find $FORKS_PATH -mindepth 1 -maxdepth 1 -type d -exec ./git-publish.sh {} rebase \;
2022-05-23 02:20:39 +00:00
# TODO: run in parallel? find $FORKS_PATH -mindepth 1 -maxdepth 1 -type d | xargs -P 50 -I '{}' ./git-publish.sh '{}'
# Pull the latest commits from all ./forks
update-fork dep:
@chmod +x git-publish.sh && find $FORKS_PATH/$dep -mindepth 0 -maxdepth 0 -type d -exec ./git-publish.sh {} pull \;
# Fetch locked version of non-forked deps
deps-get:
just mix-remote deps.get
just mix deps.get
2022-09-15 06:40:33 +00:00
just js-deps-get
2022-05-23 02:20:39 +00:00
2022-06-03 23:58:37 +00:00
deps-clean:
just mix bonfire.deps.clean
2022-05-23 02:20:39 +00:00
deps-clean-data:
just mix bonfire.deps.clean.data
deps-clean-api:
just mix bonfire.deps.clean.api
#### DEPENDENCY & EXTENSION RELATED COMMANDS ####
2022-09-15 06:40:33 +00:00
js-deps-get: js-app-deps js-ext-deps
2022-05-23 02:20:39 +00:00
2022-09-15 06:40:33 +00:00
js-app-deps yarn_args='':
chmod +x ./assets/install_app.sh
just cmd ./assets/install_app.sh $yarn_args
2022-05-23 02:20:39 +00:00
2022-09-15 06:40:33 +00:00
js-ext-deps yarn_args='':
chmod +x ./config/deps.js.sh
just cmd ./config/deps.js.sh $yarn_args
2022-05-23 02:20:39 +00:00
2022-08-19 20:23:18 +00:00
deps-outdated: deps-clean-unused
2022-05-23 02:20:39 +00:00
@just mix-remote "hex.outdated --all"
2022-08-19 20:23:18 +00:00
deps-clean-unused:
@just mix "deps.clean --unlock --unused"
2022-05-23 02:20:39 +00:00
dep-clean dep:
@just mix "deps.clean $dep --build"
# Clone a git dep and use the local version, eg: `just dep-clone-local bonfire_me https://github.com/bonfire-networks/bonfire_me`
dep-clone-local dep repo:
git clone $repo $FORKS_PATH$dep 2> /dev/null || (cd $FORKS_PATH$dep ; git pull)
just dep.go.local dep=$dep
# Clone all bonfire deps / extensions
deps-clone-local-all:
2022-06-16 22:34:16 +00:00
curl -s https://api.github.com/orgs/bonfire-networks/repos?per_page=500 | ruby -rrubygems -e 'require "json"; JSON.load(STDIN.read).each { |repo| %x[just dep.clone.local dep="#{repo["name"]}" repo="#{repo["ssh_url"]}" ]}'
2022-05-23 02:20:39 +00:00
# Switch to using a local path, eg: just dep.go.local pointers
dep-go-local dep:
just dep-go-local-path $dep $FORKS_PATH$dep
# Switch to using a local path, specifying the path, eg: just dep.go.local dep=pointers path=./libs/pointers
dep-go-local-path dep path:
just dep-local add $dep $path
just dep-local enable $dep $path
# Switch to using a git repo, eg: just dep.go.git pointers https://github.com/bonfire-networks/pointers (specifying the repo is optional if previously specified)
dep-go-git dep repo:
2022-06-16 22:34:16 +00:00
-just dep-git add $dep $repo
2022-05-23 02:20:39 +00:00
just dep-git enable $dep NA
just dep-local disable $dep NA
# Switch to using a library from hex.pm, eg: just dep.go.hex dep="pointers" version="_> 0.2" (specifying the version is optional if previously specified)
dep-go-hex dep version:
2022-06-16 22:34:16 +00:00
-just dep-hex add dep=$dep version=$version
2022-05-23 02:20:39 +00:00
just dep-hex enable $dep NA
just dep-git disable $dep NA
just dep-local disable $dep NA
# add/enable/disable/delete a hex dep with messctl command, eg: `just dep-hex enable pointers 0.2`
dep-hex command dep version:
just messctl "$command $dep $version"
just mix "deps.clean $dep"
# add/enable/disable/delete a git dep with messctl command, eg: `just dep-hex enable pointers https://github.com/bonfire-networks/pointers#main
dep-git command dep repo:
just messctl "$command $dep $repo config/deps.git"
just mix "deps.clean $dep"
# add/enable/disable/delete a local dep with messctl command, eg: `just dep-hex enable pointers ./libs/pointers`
dep-local command dep path:
just messctl "$command $dep $path config/deps.path"
just mix "deps.clean $dep"
# Utility to manage the deps in deps.hex, deps.git, and deps.path (eg. `just messctl help`)
messctl *args='': init
{{ if WITH_DOCKER == "no" { "messctl $@" } else { "docker-compose run web messctl $@" } }}
#### CONTRIBUTION RELATED COMMANDS ####
pre-push-hooks: pre-contrib-hooks
2022-07-19 04:22:38 +00:00
just mix changelog
2022-09-15 06:40:33 +00:00
just mix format
pre-contrib-hooks:
2022-09-12 04:34:14 +00:00
-sed -i '' 's,/forks/,/deps/,' config/deps_hooks.js
2022-07-09 04:20:00 +00:00
2022-05-23 02:20:39 +00:00
# Push all changes to the app and extensions in ./forks
contrib-forks: pre-push-hooks contrib-forks-publish git-publish
2022-05-23 02:20:39 +00:00
# Push all changes to the app and extensions in ./forks, increment the app version number, and push a new version/release
contrib-release: pre-push-hooks contrib-forks-publish update-app contrib-app-release
2022-05-23 02:20:39 +00:00
2022-06-05 21:59:24 +00:00
# Rebase app's repo and push all changes to the app
contrib-app-only: pre-push-hooks update-repo git-publish
2022-05-23 02:20:39 +00:00
2022-06-05 21:59:24 +00:00
# Increment the app version number and commit/push
contrib-app-release: pre-push-hooks contrib-app-release-increment git-publish
2022-05-23 02:20:39 +00:00
2022-06-06 01:23:10 +00:00
# Increment the app version number
2022-05-23 02:20:39 +00:00
contrib-app-release-increment:
@cd lib/mix/tasks/release/ && mix escript.build && ./release ../../../../ $APP_VSN_EXTRA
2022-07-29 00:47:21 +00:00
contrib-forks-publish: update-forks
2022-05-23 02:20:39 +00:00
2022-09-30 06:15:36 +00:00
contrib-rel-push: contrib-release rel-build-release rel-push
2022-09-19 07:53:42 +00:00
# Count lines of code (requires cloc: `brew install cloc`)
cloc:
cloc lib config forks/*/lib forks/*/test test
2022-05-23 02:20:39 +00:00
# Run the git add command on each fork
git-forks-add: deps-git-fix
find $FORKS_PATH -mindepth 1 -maxdepth 1 -type d -exec echo add {} \; -exec git -C '{}' add --all . \;
# Run a git status on each fork
git-forks-status:
@jungle git status || find $FORKS_PATH -mindepth 1 -maxdepth 1 -type d -exec echo {} \; -exec git -C '{}' status \;
# Run a git command on each fork (eg. `just git-forks pull` pulls the latest version of all local deps from its git remote
git-forks command:
@find $FORKS_PATH -mindepth 1 -maxdepth 1 -type d -exec echo $command {} \; -exec git -C '{}' $command \;
# List all diffs in forks
git-diff:
@find $FORKS_PATH -mindepth 1 -maxdepth 1 -type d -exec echo {} \; -exec git -C '{}' --no-pager diff --color --exit-code \;
# Run a git command on each dep, to ignore chmod changes
deps-git-fix:
find ./deps -mindepth 1 -maxdepth 1 -type d -exec git -C '{}' config core.fileMode false \;
find ./forks -mindepth 1 -maxdepth 1 -type d -exec git -C '{}' config core.fileMode false \;
# Draft-merge another branch, eg `just git-merge with-valueflows-api` to merge branch `with-valueflows-api` into the current one
2022-06-16 22:34:16 +00:00
@git-merge branch:
2022-05-23 02:20:39 +00:00
git merge --no-ff --no-commit $branch
# Find any git conflicts in ./forks
2022-06-16 22:34:16 +00:00
@git-conflicts:
2022-05-23 02:20:39 +00:00
find $FORKS_PATH -mindepth 1 -maxdepth 1 -type d -exec echo add {} \; -exec git -C '{}' diff --name-only --diff-filter=U \;
2022-06-16 22:34:16 +00:00
@git-publish:
2022-05-23 02:20:39 +00:00
chmod +x git-publish.sh
./git-publish.sh
#### TESTING RELATED COMMANDS ####
# Run tests. You can also run only specific tests, eg: `just test forks/bonfire_social/test`
test *args='':
2022-06-16 22:34:16 +00:00
MIX_ENV=test just mix test $@
2022-05-23 02:20:39 +00:00
# Run only stale tests
test-stale *args='':
2022-06-16 22:34:16 +00:00
MIX_ENV=test just mix test --stale $@
2022-05-23 02:20:39 +00:00
# Run tests (ignoring changes in local forks)
test-remote *args='':
2022-06-16 22:34:16 +00:00
MIX_ENV=test just mix-remote test $@
2022-05-23 02:20:39 +00:00
# Run stale tests, and wait for changes to any module code, and re-run affected tests
test-watch *args='':
2022-06-16 22:34:16 +00:00
MIX_ENV=test just mix test.watch --stale $@
2022-05-23 02:20:39 +00:00
# Run stale tests, and wait for changes to any module code, and re-run affected tests, and interactively choose which tests to run
test-interactive *args='':
@MIX_ENV=test just mix test.interactive --stale $@
# dev-test-watch: init ## Run tests
# docker-compose run --service-ports -e MIX_ENV=test web iex -S mix phx.server
# Create or reset the test DB
test-db-reset: init db-pre-migrations
{{ if WITH_DOCKER == "total" { "docker-compose run -e MIX_ENV=test web mix ecto.reset" } else { "MIX_ENV=test mix ecto.reset" } }}
#### RELEASE RELATED COMMANDS (Docker-specific for now) ####
2022-05-23 03:04:46 +00:00
rel-init:
2022-07-22 00:24:21 +00:00
MIX_ENV=prod just pre-init
2022-05-23 02:20:39 +00:00
# copy current flavour's config, without using symlinks
2022-05-23 03:04:46 +00:00
rel-config-prepare:
2022-07-22 00:24:21 +00:00
rm -rf data/current_flavour
mkdir -p data
rm -rf flavours/*/config/*/dev
cp -rfL $FLAVOUR_PATH data/current_flavour
2022-05-23 02:20:39 +00:00
# copy current flavour's config, without using symlinks
2022-05-23 03:04:46 +00:00
rel-prepare: rel-config-prepare
2022-07-22 00:24:21 +00:00
mkdir -p forks/
mkdir -p data/uploads/
mkdir -p data/null/
touch data/current_flavour/config/deps.path
2022-05-23 02:20:39 +00:00
2022-06-23 01:16:54 +00:00
# Build the Docker image (with no caching)
2022-05-23 03:04:46 +00:00
rel-rebuild: rel-init rel-prepare assets-prepare
2022-07-22 00:24:21 +00:00
just rel-build "forks/" --no-cache
2022-06-23 07:11:32 +00:00
# Build the Docker image (NOT including changes to local forks)
rel-build-release: rel-init rel-prepare assets-prepare
@echo "Please note that the build will not include any changes in forks/ that haven't been commited and pushed, you may want to run just contrib-release first."
@just rel-build "data/null" --no-cache
2022-05-23 02:20:39 +00:00
2022-06-23 07:11:32 +00:00
# Build the Docker image (including changes to local forks, and using caching)
rel-build FORKS_TO_COPY_PATH="forks/" ARGS="": rel-init rel-prepare assets-prepare
@echo "Building $APP_NAME with flavour $FLAVOUR for arch {{arch()}}."
@docker build $ARGS --progress=plain \
2022-05-23 02:20:39 +00:00
--build-arg FLAVOUR_PATH=data/current_flavour \
--build-arg APP_NAME=$APP_NAME \
--build-arg APP_VSN=$APP_VSN \
--build-arg APP_BUILD=$APP_BUILD \
2022-06-23 07:11:32 +00:00
--build-arg FORKS_TO_COPY_PATH=$FORKS_TO_COPY_PATH \
2022-06-23 01:16:54 +00:00
-t $APP_DOCKER_REPO:release-$FLAVOUR-$APP_VSN-$APP_BUILD \
2022-05-23 02:20:39 +00:00
-f $APP_REL_DOCKERFILE .
2022-06-23 01:16:54 +00:00
@echo Build complete: $APP_DOCKER_REPO:release-$FLAVOUR-$APP_VSN-$APP_BUILD
@echo "Remember to run just rel-tag or just rel-push"
2022-05-23 02:20:39 +00:00
rel-tag-commit build label: rel-init
docker tag $APP_DOCKER_REPO:release-$FLAVOUR-$APP_VSN-{{build}} $APP_DOCKER_REPO:{{label}}-$FLAVOUR-{{arch()}}
2022-07-06 01:39:47 +00:00
2022-05-23 02:20:39 +00:00
# Add latest tag to last build
2022-06-23 01:16:54 +00:00
rel-tag label='latest':
just rel-tag-commit $APP_BUILD {{label}}
2022-05-23 02:20:39 +00:00
# Add latest tag to last build and push to Docker Hub
2022-06-23 01:16:54 +00:00
rel-push label='latest':
2022-07-06 01:39:47 +00:00
@just rel-tag {{label}}
@just rel-push-only {{label}}
2022-07-04 23:22:56 +00:00
rel-push-only label='latest':
2022-07-06 01:39:47 +00:00
@docker login && docker push $APP_DOCKER_REPO:{{label}}-$FLAVOUR-{{arch()}}
2022-05-23 02:20:39 +00:00
2022-07-04 23:22:56 +00:00
2022-05-23 02:20:39 +00:00
# Run the app in Docker & starts a new `iex` console
2022-06-23 01:16:54 +00:00
rel-run: rel-init docker-stop-web rel-services
2022-05-23 02:20:39 +00:00
@docker-compose -p $APP_REL_CONTAINER -f $APP_REL_DOCKERCOMPOSE run --name $WEB_CONTAINER --service-ports --rm web bin/bonfire start_iex
# Run the app in Docker, and keep running in the background
2022-05-23 03:04:46 +00:00
rel-run-bg: rel-init docker-stop-web
2022-05-23 02:20:39 +00:00
@docker-compose -p $APP_REL_CONTAINER -f $APP_REL_DOCKERCOMPOSE up -d
# Stop the running release
2022-05-23 03:04:46 +00:00
rel-stop:
2022-05-23 02:20:39 +00:00
@docker-compose -p $APP_REL_CONTAINER -f $APP_REL_DOCKERCOMPOSE stop
2022-05-23 03:04:46 +00:00
rel-update: update-repo-pull
2022-05-23 02:20:39 +00:00
@docker-compose -p $APP_REL_CONTAINER -f $APP_REL_DOCKERCOMPOSE pull
@echo Remember to run migrations on your DB...
rel-logs:
@docker-compose -p $APP_REL_CONTAINER -f $APP_REL_DOCKERCOMPOSE logs
# Stop the running release
2022-05-23 03:04:46 +00:00
rel-down: rel-stop
2022-05-23 02:20:39 +00:00
@docker-compose -p $APP_REL_CONTAINER -f $APP_REL_DOCKERCOMPOSE down
# Runs a the app container and opens a simple shell inside of the container, useful to explore the image
2022-06-23 01:16:54 +00:00
rel-shell: rel-init docker-stop-web rel-services
2022-05-23 02:20:39 +00:00
@docker-compose -p $APP_REL_CONTAINER -f $APP_REL_DOCKERCOMPOSE run --name $WEB_CONTAINER --service-ports --rm web /bin/bash
# Runs a simple shell inside of the running app container, useful to explore the image
2022-06-23 01:16:54 +00:00
rel-shell-bg: rel-init rel-services
2022-05-23 02:20:39 +00:00
@docker-compose -p $APP_REL_CONTAINER -f $APP_REL_DOCKERCOMPOSE exec web /bin/bash
# Runs a simple shell inside of the DB container, useful to explore the image
2022-06-23 01:16:54 +00:00
rel-db-shell-bg: rel-init rel-services
2022-05-23 02:20:39 +00:00
@docker-compose -p $APP_REL_CONTAINER -f $APP_REL_DOCKERCOMPOSE exec db /bin/bash
2022-06-23 01:16:54 +00:00
rel-db-dump: rel-init rel-services
2022-05-23 02:20:39 +00:00
docker-compose -p $APP_REL_CONTAINER -f $APP_REL_DOCKERCOMPOSE exec db /bin/bash -c "PGPASSWORD=$POSTGRES_PASSWORD pg_dump --username $POSTGRES_USER $POSTGRES_DB" > data/db_dump.sql
2022-06-23 01:16:54 +00:00
rel-db-restore: rel-init rel-services
2022-05-23 02:20:39 +00:00
cat $file | docker exec -i bonfire_release_db_1 /bin/bash -c "PGPASSWORD=$POSTGRES_PASSWORD psql -U $POSTGRES_USER $POSTGRES_DB"
rel-services:
{{ if WITH_DOCKER != "no" { "docker-compose -p $APP_REL_CONTAINER -f $APP_REL_DOCKERCOMPOSE up -d db search" } else {""} }}
#### DOCKER-SPECIFIC COMMANDS ####
2022-10-17 01:02:24 +00:00
dc *args='':
docker-compose $@
2022-05-23 02:20:39 +00:00
# Start background docker services (eg. db and search backends).
2022-06-16 22:34:16 +00:00
@services:
{{ if MIX_ENV == "prod" { "just rel-services" } else { "just dev-services" } }}
2022-05-23 02:20:39 +00:00
2022-06-16 22:34:16 +00:00
@dev-services:
{{ if WITH_DOCKER != "no" { "docker-compose up -d db search" } else {""} }}
2022-05-23 02:20:39 +00:00
# Build the docker image
build: init
{{ if WITH_DOCKER != "no" { "mkdir -p deps && docker-compose pull && docker-compose build" } else { "echo Skip building container..." } }}
2022-05-23 02:20:39 +00:00
# Build the docker image
rebuild: init
{{ if WITH_DOCKER != "no" { "mkdir -p deps && docker-compose build --no-cache" } else { "echo Skip building container..." } }}
2022-05-23 02:20:39 +00:00
# Run a specific command in the container (if used), eg: `just cmd messclt` or `just cmd time` or `just cmd "echo hello"`
2022-06-16 22:34:16 +00:00
@cmd *args='': init
{{ if WITH_DOCKER == "total" { "docker-compose run --service-ports web $@" } else {"$@"} }}
2022-05-23 02:20:39 +00:00
# Open the shell of the web container, in dev mode
shell:
2022-06-16 22:34:16 +00:00
just cmd bash
2022-05-23 02:20:39 +00:00
docker-stop-web:
2022-06-16 22:34:16 +00:00
-docker stop $WEB_CONTAINER
-docker rm $WEB_CONTAINER
2022-05-23 02:20:39 +00:00
#### MISC COMMANDS ####
# Open an interactive console
@imix *args='':
just cmd iex -S mix $@
2022-05-23 02:20:39 +00:00
# Run a specific mix command, eg: `just mix deps.get` or `just mix "deps.update pointers"`
2022-06-20 03:51:48 +00:00
@mix *args='':
2022-06-16 22:34:16 +00:00
just cmd mix $@
2022-05-23 02:20:39 +00:00
# Run a specific mix command, while ignoring any deps cloned into ./forks, eg: `just mix-remote deps.get` or `just mix-remote deps.update pointers`
mix-remote *args='': init
{{ if WITH_DOCKER == "total" { "docker-compose run -e WITH_FORKS=0 web mix $@" } else {"WITH_FORKS=0 mix $@"} }}
# Run a specific exh command, see https://github.com/rowlandcodes/exhelp
exh *args='':
2022-06-16 22:34:16 +00:00
just cmd "exh -S mix $@"
2022-05-23 02:20:39 +00:00
licenses:
@mkdir -p docs/DEPENDENCIES/
just mix-remote licenses && mv DEPENDENCIES.md docs/DEPENDENCIES/$FLAVOUR.md
# Extract strings to-be-localised from the app and installed extensions
localise-extract:
2022-06-16 22:34:16 +00:00
just mix "bonfire.localise.extract"
2022-06-01 01:04:22 +00:00
cd priv/localisation/ && for f in *.pot; do mv -- "$f" "${f%.pot}.po"; done
2022-05-23 02:20:39 +00:00
2022-06-23 07:11:32 +00:00
@localise-tx-init:
pip install transifex-client
tx config mapping-bulk -p bonfire --source-language en --type PO -f '.po' --source-file-dir priv/localisation/ -i fr -i es -i it -i de --expression 'priv/localisation/<lang>/LC_MESSAGES/{filename}{extension}' --execute
# curl -o- https://raw.githubusercontent.com/transifex/cli/master/install.sh | bash
@localise-tx-pull:
tx pull --all --minimum-perc=5 --force
just mix deps.compile bonfire_common --force
2022-06-23 07:11:32 +00:00
@localise-tx-push:
tx push --source
@localise-extract-push: localise-extract localise-tx-push
2022-06-03 23:58:37 +00:00
2022-07-19 23:40:50 +00:00
assets-prepare:
-mkdir -p priv/static/data/uploads
-mkdir -p rel/overlays/
2022-06-16 22:34:16 +00:00
-cp lib/*/*/overlay/* rel/overlays/
2022-05-23 02:20:39 +00:00
# Workarounds for some issues running migrations
db-pre-migrations:
2022-06-16 22:34:16 +00:00
-touch deps/*/lib/migrations.ex
-touch forks/*/lib/migrations.ex
-touch priv/repo/*
2022-05-23 02:20:39 +00:00
# Generate secrets
secrets:
@cd lib/mix/tasks/secrets/ && mix escript.build && ./secrets 128 3
2022-07-30 21:05:55 +00:00
# Start or stop nix postgres server
@nix-db pg_cmd:
2022-07-30 21:05:55 +00:00
pg_ctl -D ${PGDATA} -l ${PGDATA}/all.log -o "--unix_socket_directories='${PGDATA}'" $pg_cmd
# Initialize postgres database. Only need to run the first time!
nix-db-init: (nix-db "start")
2022-07-30 21:05:55 +00:00
createdb ${PGDATABASE}
createuser -dlsw ${PGUSERNAME}
2022-09-06 20:59:28 +00:00