> ## Documentation Index
> Fetch the complete documentation index at: https://infra-docs.kaeyros.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Ansible Vault : secrets d'infrastructure dans ansible-roles

> Les fichiers sensibles du repo ansible-roles sont chiffrés avec Ansible Vault. Mot de passe dans Passbolt (groupe DevOps). Commandes : edit, rekey, view.

Les playbooks Ansible du repo `github.com/kaeyros-analytics-org/ansible-roles` contiennent des variables sensibles : adresses IP, credentials serveurs, paramètres système. Ces données sont protégées par Ansible Vault dans les fichiers `group_vars` et `host_vars`. Cette page détaille les commandes essentielles et les règles à respecter pour manipuler ces fichiers en toute sécurité.

> [!NOTE]
>
> Le mot de passe maître d'Ansible Vault est stocké dans Passbolt, groupe DevOps.

## Structure des fichiers chiffrés

Les fichiers suivants doivent toujours être chiffrés s'ils contiennent des données sensibles :

```text theme={null}
ansible-roles/
└── inventory/
    └── */
        ├── group_vars/
        │   └── *.yml
        └── host_vars/
            └── *.yml
```

## Commandes essentielles

```bash Éditer un fichier chiffré theme={null}
ansible-vault edit inventory/production/group_vars/webservers.yml
```

```bash Afficher le contenu sans éditer theme={null}
ansible-vault view inventory/production/host_vars/big-one-9d0479e4.yml
```

```bash Changer le mot de passe d'un fichier theme={null}
ansible-vault rekey inventory/production/group_vars/all.yml
```

```bash Chiffrer un fichier existant theme={null}
ansible-vault encrypt inventory/staging/group_vars/database.yml
```

```bash Déchiffrer un fichier (à éviter) theme={null}
ansible-vault decrypt inventory/production/group_vars/secrets.yml
```

> [!WARNING]
>
> Ne jamais commiter un fichier non chiffré contenant des secrets dans le repo `ansible-roles`. Utilisez un pre-commit hook ou vérifiez manuellement avec `git diff --cached` avant chaque push. Si un fichier sensible est exposé, contactez immédiatement [devops@kaeyros-analytics.com](mailto:devops@kaeyros-analytics.com).

> [!TIP]
>
> Pour éviter les erreurs, configurez votre éditeur pour reconnaître l'en-tête `!vault |` et afficher une alerte visuelle lorsque vous ouvrez un fichier non chiffré dans un répertoire `group_vars` ou `host_vars`.

> [!NOTE]
>
> Pour toute question sur Ansible Vault ou sur le repo `ansible-roles`, contactez l'équipe DevOps à l'adresse [devops@kaeyros-analytics.com](mailto:devops@kaeyros-analytics.com).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.