3.8 KiB
3.8 KiB
AnsibleTemplate
Темплейт для создания, проверки и тестирование ролей Ansible с помощью контейнеров Docker.
С чего начать?
На вашей машине вам необходимо сбилдить образ, где будут запускаться все роли через docker-compose.
Это можно сделать самостоятельно:
- make docker build - создание контейнера
- make docker rebuild - пересоздание контейнера, если были внесены изменения в Dockerfile
- make docker prune - очистить систему от лишних образов
- make docker shell - войти в контейнер Shell
- make docker release - собирает образ контейнера и пушит его в докер реджистри
- make docker images - собрать образы контейнеров с systemd, для удобного тестирования ролей.
Или ввести команду:
- make init - которая создаст файл секретов с паролем. Сбилдит образ. И создаст новую роль.
Работа с ролью
- make role new - создать новую роль из шаблона. Название роли пишется на английском, описание роли на любом языке
- make role lint - проверяет все роли в папке roles/* на наличие ошибок
- make role test - позволяет тестировать роль, указанную в molecule/default/converge.yml сразу на двух контейнерах (RedHat и Ubuntu)
- make role deploy - запускает роль в продакшен. Все хосты берет из файла inventory/hosts
Работа с файлом переменных
Все переменные защищены через Ansible-Vault и находятся в папке vars/secrets.yml
Для смены пароля измените его в файле ./vault-password.txt
- make vault create - создать новый файл с учетом пароля в файле ./vault-password.txt
- make vault delete - удалить файл с переменными
- make vault edit - отредактировать файл переменных
- make vault show - показать содержимое файла переменных
- make vault rekey - сменить пароль шифрования
- make vault encrypt - зашифровать файл секретов
- make vault decrypt - расшифровать файл секретов
Работа с Git
- make git push - запушить изменения. С выбором ветки и вводом коммита.
- make git pull - получить изменения из репы
- make git new - создание нового брэнча имя cluster-branch_name для IaC подхода.
Добавить свой образ контейнера для тестов
Что бы добавить или изменить докер-образы для тестирования ролей измените файл настроек молекулы molecule/default/molecule.yml
- name: ubuntu-instance
image: "your.docker-registry.com/your-image:latest"
privileged: true
pre_build_image: true
volumes:
- /sys/fs/cgroup:/sys/fs/cgroup:ro
Помните, что образ обязательно должен содержать python не ниже версии 3.12 и systemd для нормального тестирования ролей.