infra-nimbus/ansible

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:

• status-im/infra-role-bootstrap-linux
• status-im/infra-role-bootstrap-macos
• status-im/infra-role-bootstrap-windows

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

A backup of the Terraform state is created at .terraform/terraform.tfstate.backup. It is symetrically encrypted using Fernet algorithm with a key generated from haed CONSUL_HTTP_TOKEN and can be decrypted by using decrypt_tf_backup.py script.

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 three ways:

• password-store - Using passwordstore plugin for core infra secrets.
• Vault - Using vault plugin for service secrets.

Read secrets management guide for more details.