Ad-hoc команды хороши для разовых вопросов. Настройку машины записывают в плейбук — файл, который можно запускать снова и снова. Сейчас ты напишешь первый: он поставит nginx, положит свою страницу и заведёт пользователя.
Начнём с плейбука из одной задачи и будем дописывать по одной, каждый раз запуская и глядя на результат. Машина та же, контейнер target из прошлой практики. Проверь, что он запущен: docker ps --filter name=target.
Шаг 1. Одна задача
Открой новый файл в каталоге ~/infra/ansible. Сверху — где и как выполнять, ниже — список задач, пока из одной.
- name: Подготовка машины hosts: lab become: true tasks: - name: nginx установлен ansible.builtin.apt: name: nginx state: present
hosts: lab — группа из инвентаря, become: true — всё от root. Задача говорит не «поставь nginx», а «nginx должен быть установлен»: state: present. Имя задачи пишут так же — как описание нужного состояния. Флаг --syntax-check разбирает файл и ничего не выполняет.
ansible-playbook site.yml --syntax-checkplaybook: site.ymlОдна строка с именем файла — ошибок нет. Ошибка отступа выглядит так: We were unable to read either as JSON nor YAML и номер строки. Теперь по-настоящему.
ansible-playbook site.ymlTASK [Gathering Facts] ************** ok: [target] TASK [nginx установлен] ************* changed: [target] PLAY RECAP ************************************************* target : ok=2 changed=1 unreachable=0 failed=0
Gathering Facts Ansible делает сам перед каждым плеем: собирает сведения о машине — систему, адреса, память. changed у нашей задачи — пакет поставлен. Главная проверка — запусти ещё раз:
ansible-playbook site.ymlTASK [nginx установлен] ************* ok: [target] target : ok=2 changed=0 unreachable=0 failed=0
changed=0: nginx уже стоит, и модуль apt это увидел и ничего не делал. Это свойство называется идемпотентностью: сколько ни запускай, машина придёт в одно и то же состояние.
Шаг 2. Служба запущена
Пакет стоит, но работает ли nginx? Спросим, есть ли его процесс. Команда pgrep ищет процессы по имени.
docker exec target pgrep nginxПусто: установить не значит запустить. Допиши вторую задачу.
- name: nginx запущен ansible.builtin.service: name: nginx state: started
ansible-playbook site.ymlTASK [nginx установлен] ************* ok: [target] TASK [nginx запущен] **************** changed: [target] target : ok=3 changed=1 unreachable=0 failed=0
В контейнере нет systemd, и модуль service сам возьмёт старый скрипт /etc/init.d/nginx. На настоящем сервере тот же модуль поговорит с systemd — плейбук менять не придётся.
Шаг 3. Своя страница
Третья задача кладёт страницу. Модуль copy с параметром content пишет файл с указанным текстом.
- name: Страница сайта на месте ansible.builtin.copy: dest: /var/www/html/index.html content: "Настроено Ansible\n"
Проверять страницу будем запросом изнутри контейнера, а curl в нём нет. Пусть его тоже ставит плейбук: в первой задаче замени name: nginx списком пакетов, а саму задачу переименуй — теперь она про пакеты вообще.
- name: Пакеты установлены ansible.builtin.apt: name: [nginx, curl] state: present
ansible-playbook site.ymlTASK [Пакеты установлены] *********** changed: [target] TASK [nginx запущен] **************** ok: [target] TASK [Страница сайта на месте] ****** changed: [target] target : ok=4 changed=2 unreachable=0 failed=0
docker exec target curl -s localhostНастроено AnsibleСтраница отдаётся сразу: файлы сайта nginx читает на каждый запрос, и перезапускать его ради них не нужно.
Шаг 4. Настройки и handler
С настройками самого nginx иначе: он читает их один раз при старте. Добавим маленький файл настроек — заголовок ответа, по которому видно, что сервер настроен Ansible.
- name: Заголовок в настройках nginx ansible.builtin.copy: dest: /etc/nginx/conf.d/provision.conf content: "add_header X-Managed-By ansible;\n"
ansible-playbook site.ymlTASK [Заголовок в настройках nginx] * changed: [target] target : ok=5 changed=1 unreachable=0 failed=0
Файл на месте. Флаг -I у curl просит только заголовки ответа, а grep -i ищет без учёта регистра.
docker exec target curl -sI localhost | grep -i managedПусто. Файл лежит, но nginx про него не знает — он не перечитывал настройки. Нужно попросить его об этом, но только когда настройки поменялись, а не на каждом прогоне. Для этого есть handler — задача, которая выполняется лишь по вызову. Вызов — строка notify у задачи; сработает он, только если задача что-то изменила. Допиши notify к последней задаче, а в конец файла, на уровне tasks, — сам handler.
notify: nginx перечитанhandlers: - name: nginx перечитан ansible.builtin.service: name: nginx state: reloaded
Имя должно совпадать с тем, что в notify, буква в букву. Запусти плейбук — и handler не сработает: файл уже лежит, задача ничего не меняет, вызывать некого. Поэтому заодно поменяй в content слово ansible на provision.
ansible-playbook site.ymlTASK [Заголовок в настройках nginx] * changed: [target] RUNNING HANDLER [nginx перечитан] *** changed: [target] target : ok=6 changed=2 unreachable=0 failed=0
docker exec target curl -sI localhost | grep -i managedX-Managed-By: provisionТеперь заголовок есть. Ещё один прогон даст changed=0, и handler промолчит: менять нечего. Handler выполняется один раз в конце плея, даже если его позвали пять задач, — nginx перечитается однажды, а не пять раз подряд.
Шаг 5. Свежий список пакетов
Пакеты на свежей машине ставятся не всегда. Изобразим машину, где список пакетов давно не обновляли: удалим его и уберём curl.
docker exec target sh -c 'rm -rf /var/lib/apt/lists/*'Звёздочку раскрывает оболочка, а docker exec своей оболочки не запускает — поэтому команда обёрнута в sh -c.
docker exec target apt-get remove -y curlansible-playbook site.ymlfatal: [target]: FAILED! => {"msg": "No package matching 'curl' is available"} target : ok=1 changed=0 unreachable=0 failed=1
apt ищет пакет в локальном списке, а список пуст. Параметр update_cache: true велит сначала обновить его — как apt-get update руками. Допиши его в задачу с пакетами.
update_cache: trueТеперь плейбук проходит, но список обновляется на каждом прогоне — это поход в интернет и лишние секунды. Параметр cache_valid_time: 3600 говорит: не обновлять, если обновляли меньше часа назад.
cache_valid_time: 3600В нашем прогоне это дало 7,5 секунды вместо 9 на каждый запуск плейбука. На сервере с медленным зеркалом разница больше.
Шаг 6. Переменная и пользователь
Последняя задача — пользователь для выката. Имя запишем один раз, как переменную плея, и подставим, где нужно. Блок vars — в заголовок, перед tasks.
vars: deploy_user: deploy
Задача — в список tasks, после пакетов.
- name: Пользователь для выката заведён ansible.builtin.user: name: "{{ deploy_user }}" shell: /bin/bash
Двойные фигурные скобки — подстановка переменной. Кавычки вокруг обязательны, иначе YAML примет скобки за свой синтаксис.
ansible-playbook site.ymlTASK [Пользователь для выката заведён] changed: [target] target : ok=6 changed=1 unreachable=0 failed=0
docker exec target id deployuid=1002(deploy) gid=1002(deploy) groups=1002(deploy)Пользователь есть. Сверь итоговый файл — заголовок и пакеты:
- name: Подготовка машины hosts: lab become: true vars: deploy_user: deploy tasks: - name: Пакеты установлены ansible.builtin.apt: name: [nginx, curl] state: present update_cache: true cache_valid_time: 3600
Пользователь, служба и страница:
- name: Пользователь для выката заведён ansible.builtin.user: name: "{{ deploy_user }}" shell: /bin/bash - name: nginx запущен ansible.builtin.service: name: nginx state: started - name: Страница сайта на месте ansible.builtin.copy: dest: /var/www/html/index.html content: "Настроено Ansible\n"
Настройки и handler:
- name: Заголовок в настройках nginx ansible.builtin.copy: dest: /etc/nginx/conf.d/provision.conf content: "add_header X-Managed-By provision;\n" notify: nginx перечитан handlers: - name: nginx перечитан ansible.builtin.service: name: nginx state: reloaded
Шаг 7. Сломать идемпотентность
Посмотрим, как выглядит плохая задача. Допиши в конец списка tasks, перед handlers, задачу с shell, которая дописывает строку приветствия в файл /etc/motd — его показывают при входе на машину:
- name: Плохая задача для опыта ansible.builtin.shell: echo "Добро пожаловать" >> /etc/motd
Для опыта берём именно этот файл, а не /etc/hosts, хотя в жизни так чаще портят его. В контейнере /etc/hosts подкладывает Docker, и править его на месте нельзя: sed -i упадёт с Device or resource busy.
Запусти плейбук два раза и посмотри на второй:
ansible-playbook site.ymlTASK [Плохая задача для опыта] ****** changed: [target]changed каждый раз: shell не знает, нужна ли строка, и дописывает её снова. Проверим, сколько строк набралось. Флаг -c у grep считает совпадения.
docker exec target grep -c Добро /etc/motd2Две одинаковые строки. Убери опытную задачу из site.yml в nano, а мусор из файла — sed с флагом -i, который правит файл на месте:
docker exec target sed -i '/Добро/d' /etc/motdПравильный способ добавить строку — модуль lineinfile: он добавит её, только если строки нет.
Шаг 8. Поймать ручную правку
Представим, что кто-то зашёл на сервер и «на минутку» удалил страницу руками.
docker exec target rm /var/www/html/index.htmlФлаг --check прогоняет плейбук, ничего не меняя, а --diff показывает, что именно поменялось бы.
ansible-playbook site.yml --check --diffTASK [Страница сайта на месте] *************************** --- before +++ after: /var/www/html/index.html @@ -0,0 +1 @@ +Настроено Ansible changed: [target]
Ничего не изменено, но видно, что разошлось и как: файла нет, а должен быть с такой строкой. Это и есть поиск дрейфа — расхождения машины с описанием. Верни машину в состояние обычным прогоном.
ansible-playbook site.ymlTASK [Страница сайта на месте] ****** changed: [target] target : ok=6 changed=1 unreachable=0 failed=0
У --check есть ограничение. На пустой машине он упадёт на задаче «nginx запущен» с Could not find the requested service nginx: в режиме проверки пакет ведь не ставится, и следующей задаче не на что опереться. Задачи, зависящие от предыдущих, он честно проверить не может, поэтому его берут на уже настроенных машинах — как здесь.
Шаг 9. Закоммитить
Плейбук — код, ему место в репозитории. Но прямой push в main с раздела 12 закрыт, поэтому с этого раздела каждую работу ведём так же, как на работе: в своей ветке, а в main она попадает через merge request. GitLab для этого должен быть запущен: если гасил его, выполни docker compose start в ~/gitlab и дождись healthy. Он держит около 6 ГБ, поэтому стенду в этом разделе нужно 8 ГБ, как в таблице из практики про стенд. Если памяти впритык, держи GitLab запущенным только на время push и слияния, а потом снова гаси docker compose stop: сам Ansible без GitLab работает.
Сначала ветка — флаг -c создаёт её и переходит в неё, несохранённые правки едут с тобой.
cd ~/infra git switch -c ansible-base
Коммит, как обычно. Флаг -m — сообщение коммита.
git add ansible/ git commit -m "ansible: первый плейбук для машины target"
Отправляем ветку в GitLab. Удалённый репозиторий называется gitlab — так ты назвал его в практике про проект.
git push -u gitlab ansible-baseОткрой ссылку merge_requests/new из вывода, создай merge request, дождись зелёного конвейера и нажми Merge. Затем вернись в main и забери слияние к себе.
git switch main git pull
Этот приём — ветка, push, merge request, pull — дальше в разделах 13–15 будет одной строкой.
Шаг 10. Сдать
Выполни команду сдачи: она запустит плейбук ещё раз и проверит страницу.