ansible-vault¶
Verschlüsselt Dateien und Werte mit einem Passwort, damit Geheimnisse ins Git-Repository des Projekts dürfen.

Syntax¶
ansible-vault create | encrypt | decrypt | view | edit | rekey DATEI
ansible-vault encrypt_string WERT --name VARIABLE
Optionen¶
| Option | Beschreibung |
|---|---|
create DATEI |
Eine neue verschlüsselte Datei im Editor anlegen |
encrypt DATEI |
Eine bestehende Datei verschlüsseln |
view DATEI |
Den Inhalt zeigen, ohne ihn entschlüsselt zu speichern |
edit DATEI |
Im Editor bearbeiten, danach wieder verschlüsseln |
decrypt DATEI |
Dauerhaft entschlüsseln |
rekey DATEI |
Das Vault-Passwort ändern |
encrypt_string |
Einen einzelnen Wert für eine normale YAML-Datei verschlüsseln |
--vault-password-file DATEI |
Das Passwort aus einer Datei lesen statt nachzufragen |
Beispiele¶
Eine Datei mit Passwörtern verschlüsseln:
ansible-vault encrypt group_vars/secrets.yml
New Vault password:
Confirm New Vault password:
Encryption successful
Wie die Datei jetzt aussieht:
head -3 group_vars/secrets.yml
$ANSIBLE_VAULT;1.1;AES256
37626437363538343563666534313964333566323336393839383138626636376538383034656262
6463643237393466356266303034303132393431616464310a383131396365653136636362313431
Den Inhalt lesen:
ansible-vault view --vault-password-file ~/.vault_pass group_vars/secrets.yml
db_password: S3cr3t-Pa55
Einen einzelnen Wert verschlüsseln:
ansible-vault encrypt_string --vault-password-file ~/.vault_pass 'S3cr3t-Pa55' --name db_password
db_password: !vault |
$ANSIBLE_VAULT;1.1;AES256
39356637356462313933343739313665396566343538303430613339663830393138663233393730
3361643539663062386234306235383966356231323939390a633932343230393339363466653938
37633630653434326232636138376266653661653832363263663838663632336335386639383065
3163316534616634360a303961373638323463643334373139303231613735666130333437643932
6331
Füg die Ausgabe in eine normale Variablendatei ein. Der Rest der Datei bleibt lesbar.
Ein Playbook mit verschlüsselten Variablen ausführen:
ansible-playbook site.yml --ask-vault-pass --limit web01 --tags packages
Vault password:
PLAY [Set up web servers] ******************************************************
TASK [Gathering Facts] *********************************************************
ok: [web01]
TASK [Install nginx] ***********************************************************
ok: [web01]
PLAY RECAP *********************************************************************
web01 : ok=2 changed=0 unreachable=0 failed=0 skipped=0 rescued=0 ignored=0
Wann brauche ich das?¶
- Für Passwörter, API-Schlüssel und private Schlüssel, die ein Playbook braucht
- Um ein ganzes Projekt in Git abzulegen, ohne Geheimnisse preiszugeben
- In CI-Pipelines, zusammen mit einer Passwortdatei, die nur die Pipeline kennt
Passwortdatei statt Eintippen
Leg das Vault-Passwort in ~/.vault_pass mit den Rechten 600 ab und setze
vault_password_file = ~/.vault_pass in der ansible.cfg. Committe diese Datei nie.
Passwort weg, Daten weg
Ohne das Passwort lässt sich eine Vault-Datei nicht entschlüsseln. Bewahre es in deinem Passwortmanager auf.