Provision
—— XP

Ansible Vault: пароли в репозитории

теория~4 минут+220 XP

Следующей роли понадобится пароль от базы. Положить его в group_vars/lab.yml открытым текстом — значит закоммитить в Git, а в разделе 06 ты уже учился так не делать с .env. Держать в голове тоже не выход: плейбук запускает конвейер, а у конвейера головы нет. Этот урок о том, как хранить секрет в репозитории и не показать его никому лишнему.

Ansible Vault — встроенный в Ansible способ хранить секреты зашифрованными прямо в репозитории. Пароль лежит в group_vars шифром и расшифровывается только в момент прогона — у того, кто знает пароль от шифра. Это как сейф в общем шкафу: все видят, что он есть и когда его открывали (история в Git), но внутрь попадает только тот, у кого ключ. Главное правило сейфа — ключ не кладут рядом с ним.

В разделе 19 ты встретишь HashiCorp Vault — другую программу с похожим именем. Не путай: там отдельный сервер секретов, а здесь шифр внутри файлов.

Зашифровать одно значение

Шифровать можно файл целиком, но удобнее — одно значение. Тогда остальной файл остаётся читаемым, и в merge request видно, что поменялось.

ubuntu@stand:~$
ansible-vault encrypt_string 'S3cretPass' --name db_password
ubuntu@stand:~$
db_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 Vault
Шифрование файлов и значений в репозитории паролем. Не путать с HashiCorp Vault. ↩ к тексту
encrypt_string
Команда, которая шифрует одно значение и выдаёт готовый кусок YAML с меткой !vault.
vault_password_file
Строка ansible.cfg с путём к файлу пароля от шифра. Файл — вне репозитория, права 600.
no_log
Метка задачи: не печатать её параметры и результат. Ставят на задачи с секретами.

Что спросят на собеседовании

  • Как хранить пароли для Ansible в git?
    Шифровать ansible-vault encrypt_string и класть в group_vars. Пароль от шифра держать вне репозитория — файл с правами 600 или защищённая переменная CI.
  • Почему пароль утёк в журнал, хотя он в Vault?
    Vault шифрует хранение. При прогоне значение расшифровано, и --diff, -vvv или debug его печатают. Задачи с секретами помечают no_log: true.

Что дальше

Дальше — зашифровать пароль, положить файл с ним на машину и убедиться, что он нигде не виден открытым.

Проверь себя+220 XPдве попытки
1
Ansible Vault
Что делает Ansible Vault?
2
Ключ от шифра
Где хранить пароль, которым зашифрован Vault?
3
Утечка в журнал
Зачем задаче с паролем ставят no_log: true?
ответь на все вопросы, чтобы проверить

Нашёл ошибку или непонятное место? Наведи на абзац — слева появится «+», нажми и напиши, что не так. Замечание увидит автор курса.Нашёл ошибку или непонятное место? Нажми «+» справа от заголовка раздела и напиши, что не так. Замечание увидит автор курса.