abra/README.md

abra

Docker stack magic 🎩🐇

Install

curl -fsSL https://install.abra.autonomic.zone | bash

Specific releases are available via the project release page.

Changes

See CHANGELOG.md.

Hacking

git clone ssh://git@git.autonomic.zone:2222/autonomic-cooperative/abra.git
cd abra
make dev_install

See autonomic-cooperative/installer-scripts for the installer script deployment. To make a release, just add an entry to CHANGELOG.md (following semver please) and then git tag x.x.x && git push origin main --tags. If you want the installer-scripts deployment to pick that up, you'll need to change the version number in the Makefile and run make in that repository and push the changes.

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-stacks 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

• abra run mariadb mysqldump gitea -p'GdIbMeS09SURRktBnm3jcTufsL5z0MPd' | gzip > ../git.autonomic.zone_mariadb_date +%F.sql.gz