Сейчас ты дашь машине пароль от базы так, как это делают в настоящем репозитории: шифром в group_vars, с ключом от шифра вне Git. А заодно посмотришь, где расшифрованный пароль всё-таки может вылезти наружу, — чтобы это случилось на стенде, а не в журнале конвейера.
Пароль будет учебный — S3cretPass. Работаем в ~/infra/ansible.
Шаг 1. Ключ от шифра
Сначала пароль, которым будем шифровать. Придумывать его не надо: openssl rand выдаёт случайные байты, -base64 24 — 24 байта в читаемом виде. > записывает вывод в файл.
openssl rand -base64 24 > ~/.vault-passФайл лежит в домашнем каталоге, а не в ~/infra, — в репозиторий он не попадёт. Закроем его от чужих глаз: права 600 из раздела 02.
chmod 600 ~/.vault-passls -l ~/.vault-pass-rw------- 1 anton anton 33 Oct 1 12:10 /home/anton/.vault-passШаг 2. Сказать Ansible, где ключ
Допиши строку в секцию [defaults] файла ansible.cfg.
vault_password_file = ~/.vault-passТеперь Ansible будет расшифровывать молча. Без этой строки пришлось бы добавлять --ask-vault-pass к каждому запуску.
Шаг 3. Зашифровать пароль
Шифруем одно значение. --name — имя будущей переменной.
ansible-vault encrypt_string 'S3cretPass' --name db_passwordEncryption successful db_password: !vault | $ANSIBLE_VAULT;1.1;AES256 6132376431633965383839346163...
Скопируй всё, начиная с db_password:, и вставь в конец group_vars/lab.yml, с теми же отступами. Файл остаётся читаемым: web_message открыт, зашифрован только пароль.
Учебный пароль ты набрал в команде, и он остался в истории шелла. На работе так не делают: пароль вставляют, когда команда спросит его сама, если вызвать её без значения.
Шаг 4. Убедиться, что расшифровывается
Модуль debug печатает переменную. Флаг -a передаёт ему параметр var.
ansible lab -m debug -a var=db_passwordtarget | SUCCESS => { "db_password": "S3cretPass" }
Вот первая утечка: Vault зашифровал хранение, а в работе пароль — обычная строка, и любая задача может её напечатать.
Шаг 5. Задача с паролем — пока без защиты
Добавим в site.yml, в список tasks, задачу, которая кладёт пароль в файл для приложения. mode — права файла, кавычки нужны, чтобы YAML не превратил 0600 в число.
- name: Файл с паролем базы на месте ansible.builtin.copy: dest: /etc/app.env content: "DB_PASSWORD={{ db_password }}\n" mode: "0600"
Посмотрим заранее с разницей файлов:
ansible-playbook site.yml --check --diffTASK [Файл с паролем базы на месте] ****************** --- before +++ after: /etc/app.env @@ -0,0 +1 @@ +DB_PASSWORD=S3cretPass changed: [target]
Вторая утечка: --diff напечатал пароль. В конвейере CI этот журнал увидели бы все участники проекта.
Шаг 6. Закрыть задачу
Допиши к задаче одну строку на уровне ansible.builtin.copy:
no_log: trueТеперь применяем по-настоящему, тоже с --diff:
ansible-playbook site.yml --diffTASK [Файл с паролем базы на месте] ****************** changed: [target]
Пароля в выводе нет, осталась только пометка, что задача что-то изменила. Это при обычном выводе. С флагом -v (подробнее) Ansible печатает и результат задачи — и вместо него ты увидишь заглушку:
changed: [target] => {"censored": "the output has been hidden due to the fact that 'no_log: true' was specified for this result", "changed": true}«censored» — результат спрятан, потому что у задачи стоит no_log: true. Без no_log на этом месте с -v лежал бы весь результат вместе с содержимым файла.
Шаг 7. Проверить на машине
Файл должен принадлежать root и читаться только им. stat -c '%a %U' печатает права числом и владельца.
docker exec target stat -c '%a %U' /etc/app.env600 rootШаг 8. Проверить репозиторий
Последнее — убедиться, что открытого пароля нет ни в одном файле репозитория. git grep ищет по файлам под контролем Git, -c печатает по строке на каждый файл с совпадениями, а wc -l считает эти строки. Флаг -C у git — выполнить в другом каталоге, не переходя туда.
git -C ~/infra grep -c S3cretPass | wc -l0Ноль файлов — открытого пароля в репозитории нет. Теперь коммит:
Работаем в своей ветке: -c создаёт её и переходит в неё.
cd ~/infra git switch -c ansible-vault
Коммит, флаг -m — его сообщение.
git add ansible/ git commit -m "ansible: пароль базы в vault, файл app.env"
Флаг -u у push связывает новую ветку с GitLab.
git push -u gitlab ansible-vaultСлей merge request в GitLab, затем git switch main и git pull. Файл ~/.vault-pass в коммит не попал: он вне репозитория. Сохрани его копию в менеджере паролей — потеряешь, и зашифрованное не прочитает никто.
Шаг 9. Сдать
Выполни команду сдачи: она проверит шифр, права ключа, прогон, файл на машине и отсутствие открытого пароля в Git.