Следующей роли понадобится пароль от базы. Положить его в group_vars/lab.yml открытым текстом — значит закоммитить в Git, а в разделе 06 ты уже учился так не делать с .env. Держать в голове тоже не выход: плейбук запускает конвейер, а у конвейера головы нет. Этот урок о том, как хранить секрет в репозитории и не показать его никому лишнему.
Ansible Vault — встроенный в Ansible способ хранить секреты зашифрованными прямо в репозитории. Пароль лежит в group_vars шифром и расшифровывается только в момент прогона — у того, кто знает пароль от шифра. Это как сейф в общем шкафу: все видят, что он есть и когда его открывали (история в Git), но внутрь попадает только тот, у кого ключ. Главное правило сейфа — ключ не кладут рядом с ним.
В разделе 19 ты встретишь HashiCorp Vault — другую программу с похожим именем. Не путай: там отдельный сервер секретов, а здесь шифр внутри файлов.
Зашифровать одно значение
Шифровать можно файл целиком, но удобнее — одно значение. Тогда остальной файл остаётся читаемым, и в merge request видно, что поменялось.
ansible-vault encrypt_string 'S3cretPass' --name db_passworddb_password: !vault | $ANSIBLE_VAULT;1.1;AES256 6132376431633965383839346163...
--name — имя переменной. Ответ — готовый кусок YAML: метка !vault говорит Ansible «это шифр», первая строка шифра — версия и алгоритм AES256. Этот кусок вставляют в обычный group_vars/lab.yml рядом с открытыми переменными.
Команда спросит пароль от шифра — или возьмёт его из файла, если он указан в ansible.cfg. И от того, где лежит этот файл, зависит, есть ли от шифра хоть какой-то толк.
Где ключ от шифра
Пароль от Vault кладут в файл вне репозитория, например ~/.vault-pass, с правами 600 — читать может только владелец, как ключ SSH. В ansible.cfg пишут строку vault_password_file = ~/.vault-pass, и дальше Ansible расшифровывает молча.
Вместо файла можно спрашивать пароль при каждом запуске — флаг --ask-vault-pass. В конвейере CI файл пароля кладут в переменную типа File с флагами protected, как ключ SSH в разделе 12.
Типичная ошибка новичка — положить .vault-pass в каталог проекта и закоммитить вместе со всем. Тогда сейф стоит в шкафу, а ключ висит на дверце.
Шифр не спасает от журнала
Vault защищает хранение, а не использование. В момент прогона значение расшифровано и становится обычной строкой. Задача с --diff покажет её в разнице файлов, флаг -vvv — в параметрах модуля, модуль debug — просто напечатает.
Поэтому задачи, которые работают с секретами, помечают no_log: true. В выводе вместо параметров и результата будет the output has been hidden due to the fact that 'no_log: true' was specified. Обратная сторона — такую задачу трудно отлаживать: на время отладки no_log снимают и обязательно возвращают.
Ещё два флага пригодятся, когда машин станет много: --limit запускает плейбук только на части машин, --tags — только задачи с метками. Здесь достаточно знать, что такое есть.
Словарь урока
Что спросят на собеседовании
- Как хранить пароли для Ansible в git?Шифровать ansible-vault encrypt_string и класть в group_vars. Пароль от шифра держать вне репозитория — файл с правами 600 или защищённая переменная CI.
- Почему пароль утёк в журнал, хотя он в Vault?Vault шифрует хранение. При прогоне значение расшифровано, и --diff, -vvv или debug его печатают. Задачи с секретами помечают no_log: true.
Что дальше
Дальше — зашифровать пароль, положить файл с ним на машину и убедиться, что он нигде не виден открытым.