History

Jakub Sokołowski 74be1115c6 boot,store: use both new and old domain names Signed-off-by: Jakub Sokołowski <jakub@status.im>		2024-03-15 14:27:37 +01:00
..
files	Initial commit	2023-09-08 14:11:02 +02:00
group_vars	boot,store: use both new and old domain names	2024-03-15 14:27:37 +01:00
host_vars	boot,store: temporarily lock image at v0.24.0	2024-02-29 20:11:22 +01:00
inventory	ansible/inventory: update to use status.im domain	2024-03-14 22:57:09 +01:00
lookup_plugins	Initial commit	2023-09-08 14:11:02 +02:00
README.md	Initial commit	2023-09-08 14:11:02 +02:00
bootstrap.yml	Initial commit	2023-09-08 14:11:02 +02:00
main.yml	requirements: use full names for all roles	2024-03-14 21:56:06 +01:00
requirements.yml	boot,store: use both new and old domain names	2024-03-15 14:27:37 +01:00
terraform.py	Initial commit	2023-09-08 14:11:02 +02:00
upgrade.yml	Initial commit	2023-09-08 14:11:02 +02:00
versioncheck.py	Initial commit	2023-09-08 14:11:02 +02:00

README.md

Description

Herein lie all ansible related files except for ansible.cfg at the root of the repo for easier usage without having to cd here.

Usage

Simply run the play related to the specific type of configuration you want to deploy:

 > ls -1 ansible/*.yml 
ansible/bootstrap.yml
ansible/upgrade.yml
ansible/main.yml

ansible-playbook ansible/main.yml

Bootstrap

All hosts are bootstraped right after provisioning using these roles:

If you want to re-run any bootstrap step you can do it like so:

ansible-playbook ansible/bootstrap.yml -t role::bootstrap:hostname

In this case only the hostname set of tasks will be executed due to the role::bootstrap:hostname tag.

Inventory

The inventory we use is crated by Terraform via the terraform-provider-ansible which generates the necessary data structures in the Consul Key/Value store that is later used by the terraform.py script to provide hosts and their variables to Ansible.

Some ways to view existing hosts:

ansible localhost -m debug -a 'var=groups'
ansible all -o -m debug -a 'var=ansible_host' | columns -t

Variables

Ansible variables can be provided to Ansible using the --extra-vars/-e flag. An example of such a flag is

compose_state: 'present'
compose_recreate: 'smart'
compose_restart: false

These are used in every role that starts docker containers. You can use them to change the behaviour of roles. For example to re-create all metric related containers use:

ansible-playbook ansible/main.yml -e compose_recreate=always

Secrets

Secrets are stored and provided in two ways:

password-store through the passwordstore lookup plugin
BitWarden through the ./lookup_plugins/bitwarden.py plugin.