Skip to content

Latest commit

 

History

History
152 lines (104 loc) · 4.41 KB

README.md

File metadata and controls

152 lines (104 loc) · 4.41 KB
Raw

Déploiement avec Ansible

Installer Ansible - Exemple sur Ubuntu

Créer un environnement virtuel :

python3 -m venv .venv
source .venv/bin/activate

MAJ l'outillage puis installer Ansible :

python -m pip install -U pip
python -m pip install -U setuptools wheel
python -m pip install -U -r ansible/requirements.txt

Installer les rôles et collections Ansible :

ansible-galaxy install -r ansible/requirements.yml

Se déplacer dans ce dossier :

cd ansible/

Sauf mention contraire, les commandes suivantes sont à mener dans cet environnement virtuel et dans ce dossier.

Vérifier sa configuration SSH

Voir le README principal.

Adapter le fichier inventory.yml si besoin

Adaptations possibles :

  • la valeur des clés ansible_host doit correspondre aux hosts déclarés dans le ~/.ssh.config

Tester si Ansible se connecte et s'exécute correctement

Exécuter un ping :

> ansible -i inventory.yml all -m ping
elgeopaso2204 | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/bin/python3"
    },
    "changed": false,
    "ping": "pong"
}

elgeopaso1804 | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/bin/python3"
    },
    "changed": false,
    "ping": "pong"
}

Vérifier l'exécution en mode sudo :

> ansible -i inventory.yml elgeopaso2204 -a "sudo -l"
elgeopaso2204 | CHANGED | rc=0 >>
Matching Defaults entries for geotribu on geotribu:
    env_reset, mail_badpass, secure_path=/usr/local/sbin\:/usr/local/bin\:/usr/sbin\:/usr/bin\:/sbin\:/bin\:/snap/bin

User geotribu may run the following commands on geotribu:
    (ALL) NOPASSWD: ALL

Lancer le playbook de test :

> ansible-playbook -i inventory.yml playbook-test.yml

PLAY [Playbook de test] ***********************************************************************************************************************

TASK [Gathering Facts] *********************************************************************************************************************
Enter passphrase for key '/home/jmo/.ssh/id_rsa_elgeopaso': ok: [elgeopaso2204]

ok: [elgeopaso1804]

TASK [Ping l'hôte] *************************************************************************************************************************
ok: [elgeopaso2204]
ok: [elgeopaso1804]

TASK [Affiche message de base] *************************************************************************************************************
ok: [elgeopaso1804] => {
    "msg": "Salut le serveur de GeoRezo"
}
ok: [elgeopaso2204] => {
    "msg": "Salut le serveur de GeoRezo"
}

PLAY RECAP *********************************************************************************************************************************
elgeopaso1804              : ok=3    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0  
elgeopaso2204              : ok=3    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

Lancer le playbook

ansible-playbook -i inventory.yml playbook.yml --ask-vault-pass

Ou si le mot de passe du vault est dans le fichier password_file :

ansible-playbook -i inventory.yml playbook.yml --vault-password-file password_file

Gestion des secrets

Les mots de passe et autres données sensibles sont chiffrées à l'aide de l'utilitaire ansible-vault via un mot de passe maître (voir avec l'admin de Geotribu).

Il est possible de stocker le mot de passe maître à différents endroits :

  • dans un fichier password_file qui ne sera jamais envoyé ou ajouté à Git

Créer un nouveau secret

Pour ajouter un nouveau secret (mot de passe, token, etc.) qu'on appelle ici mon_token_secret :

  1. Exécuter : ansible-vault encrypt_string --vault-id default@password_file --stdin-name 'mon_token_secret'
  2. Entrer la valeur du secret dans le prompt qui s'ouvre (fermer avec Ctrl + d)
  3. Copier/coller le résultat dans le fichier de variables souhaité. Par exemple : host_vars/elgeopaso2204.yml

Accèder à un secret

Pour accéder à un mot de passe dans le vault :

ansible localhost -m ansible.builtin.debug -a var="mon_token_secret" -e "@host_vars/elgeopaso2204.yml" --vault-password-file password_file

Développement local

Il est possible d'utiliser une VM pour tester le déploiement sans risque :

vagrant up --provision