okho54/lint repository overview

⁠Описание

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

Плейбуки в ansible/playbooks/ разделённые по ролям, могут быть применены на хосты, которые перечислены в production.ini.

⁠Состав репозитория

В плейбуках используются роли из внешних репозиториев, поэтому их необходимо загрузить перед запуском.

Необходимые роли (и их версии) перечислены в файле ansible/requirements.yml.

Имя файла-окружения, используемого для setup.sh, задается переменной окружения ENV_NAME или опцией -e. Например:

export ENV_NAME=vagrant.ini

⁠Как использовать

Изменение параметров окружения необходимо осуществлять путем создания Pull Request из своего форка.

⁠Как использовать вручную

Необходимо задать окружение (путём указания имени файла-окружения), для которого будут осуществлены изменения. Например:

export ENV_NAME=vagrant.ini

и после этого выполнить:

./setup.sh -l -p <playbook_name>.yml

Данная команда установит Mitogen последней версии, загрузит необходимые версии ролей перечисленных в requirements.yml и проверит текущий код на корректносить синтаксиса.

Для тестирования ролей Ansible используется Molecule со следующей структурой:

• molecule.yml - в файле описывается конфигурация Molecule – драйвер и провайдер для тестов, зависимости, порядок тестов, верифаер
• playbook.yml - содержит список ролей, которые мы тестируем
• tests/test_default.py - содержит пользовательские тесты

Для запуска тестов выполните команду:

molecule test

Для запуска плейбука и выполнения всех (доступных для этого окружения) операций настройки, выполните команду:

./setup.sh -l -i -p <playbook_name>.yml

⁠Структура каталогов

/infrastructure/
 |
 |_/ansible/ - каталог для хранения плейбуков Ansible
 |  |
 |  |_/group_vars/ - каталог переменных для групп
 |  |_/host_vars/ - каталог переменных для хостов
 |  |_/molecule/
 |  |_/playbooks/ - каталог хранения плейбуков с разделением по группам
 |  |_/plugins/ - каталог временного хранения необходимых плагинов (на текущий момент только Mitogen)
 |  |_/requirements.yml - файл с описанием необходимых ролей
 |  |_/roles/ - каталог для временного хранения необходимых ролей
 |  |_/templates/ - каталог шаблонов конфигурационных файлов используемых в плейбуке
 |
 |_/ansible-roles/ - каталог постоянного хранения ролей
 |_/docker-images/ - каталог конфигурационных файлов для изготовления Docker-образов
 |_/helm/ - каталог для хранения Helm chart-ов
 |_/packer/ - каталог для хранения конфигурационных файлов создания Packer-образов
 |_/terraform/
 |_/vagrant/ - каталог для хранения конфигурации вирутального окружения

⁠Дополнительно

• Создание образа Packer для AWS VPN⁠
• Запуск виртуальной машины Linux для AWS VPN на базе подготовленного образа AMI⁠
• Резервное копирование и восстановление с restic⁠
• Развертывание Kubernetes кластера⁠
• Развертывание Helm chart-ов⁠
• Просмотр логов из докера в браузере⁠
• Релоад сервиса при изменении в директории⁠