aceberg/gans repository overview

⁠ ⁠gans

Git+Ansible: watch git repo for changes and run only changed playbooks
(Also, gans means goose in German)

• Quick start⁠
• Usage⁠
• Config⁠
• Options⁠
• Thanks⁠

⁠Quick start

Make sure /path/to/git/repo leads to your Ansible git repo.

docker run --name gans \
-e "TZ=Asia/Novosibirsk" \
-v ~/.dockerdata/gans:/data/gans \
-v /path/to/git/repo:/gitrepo \
-p 8845:8845 \
aceberg/gans

Or use docker-compose.yml⁠

⁠Usage

Web interface is pretty self-explanatory. If you know Ansible, you shouldn't have any problems.
Important things about gans:

• It supports only local git repos for now. If you need to work with remote repo, you can pull it regularly with git-syr⁠ or your own cron script.
• I decided not to parse Ansible Inventory to reduce errors, so you need to enter hosts and groups manually on Repo page. Gans will work only with those hosts.
• SSH Keys are handled by Ansible Inventory or ansible.cfg. Keys page is only there to help you upload them and check their presence.

Example ansible.cfg⁠ and hosts.ini⁠ can also help. To work correctly ansible.cfg shoul be at the / of git repo.

⁠Config

Configuration can be done through config file or environment variables

⁠Options

⁠Thanks

• All go packages listed in dependencies⁠
• Bootstrap⁠
• Themes: Free themes for Bootstrap⁠
• Favicon and logo: Goose icons created by Freepik - Flaticon⁠