From eec1dcb0b2edd8fe6b3cc9021e58c087dd79fe0e Mon Sep 17 00:00:00 2001 From: 3wc <3wc.git@doesthisthing.work> Date: Tue, 22 Sep 2020 16:13:18 +0200 Subject: [PATCH] Update README and tweak default STACK_DIR --- README.md | 25 +++++++++++++++++++++++++ abra | 2 +- 2 files changed, 26 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index 6e774da..2c79d5c 100644 --- a/README.md +++ b/README.md @@ -12,6 +12,31 @@ Docker stack magic 🎩🐇 `make dev_install` +## Specify what to deploy where + +You can use `abra` in one of 2 ways: + +1. Clone a `compose-stack`, create an `.envrc` in it, and run `abra` in that + directory. Be sure to set `ABRA_STACK_DIR=.` +2. "Monorepo mode": keep all your `compose-stack`s in one directory and all your `env` files in + another, e.g.: + ``` + $ tree + . + ├── apps + │   ├── mediawiki.demo.autonomic.zone.env + │   ├── wordpress.demo.autonomic.zone.env + └── stacks + ├── gitea + ├── matrix-synapse + ├── mediawiki + ├── nextcloud + ├── swarmpit + ├── traefik + └── wordpress + $ abra -e apps/mediawiki.demo.autonomic.zone.env deploy + ``` + ## Examples ``` diff --git a/abra b/abra index 02df06d..3753800 100755 --- a/abra +++ b/abra @@ -92,7 +92,7 @@ if [ -z "$COMPOSE_FILE" ]; then fi if [ -z "$ABRA_STACK_DIR" ]; then - ABRA_STACK_DIR="../stacks/$SERVICE" + ABRA_STACK_DIR="stacks/$SERVICE" fi ###### Safety checks