noofac-snackpot/SETUP.md

To set up

These subdirectorys need to be cloned, as they are not part of the repo.

The first is Ansible. The exact version is not always important, but it is wise to keep roughly the same version because Ansible has changed a lot. I like to be able to use a version which works with my playbooks... some of my older playbooks contained a lot of workarounds for old versions of ansible. Newer playbooks use newer versions of Ansible. At the time of writing, I'm using v2.9.26.

git clone git@github.com:ansible/ansible.git .ansible-src
(cd .ansible-src && git co v2.9.26)

This subdirectory contains the passwords and other secrets this repo needs access to. It is a Password Store GPG2 encrypted repository, accessible with the pass command. Ansible has a plugin which can use that.

git clone gitolite:password-store .password-store

You should also make sure that the hosts in the inventory are accessible - sometimes this requires adding ~/.ssh/config settings like this example:

Host mixian mixian.noodlefactory.co.uk
Hostname 142.132.227.118
User root

Before deploying

This script initialises the environment so that pass and ansible-playbook will work as if they were installed in the standard places (although they are not).

./env-setup 

Dependencies

Ansible role and collection dependencies the need to be installed:

ansible-galaxy install -r requirements.yml
ansible-galaxy collection install -r requirements.yml