Если Ansible уже подключается по SSH, это ещё не означает, что cloud-init закончил работу. Финальная стадия может в этот момент устанавливать пакеты, запускать runcmd и менять те же файлы. Первый шаг — дождаться cloud-init status --wait и проверить его код возврата, а не добавлять случайный sleep.
После устранения параллельного запуска конфликт может остаться: cloud-init и Ansible способны последовательно записывать разные версии одного ресурса. Устойчивый результат требует явной границы ownership. Cloud-init оставляют минимальный bootstrap, а повторяемую конфигурацию передают Ansible либо наоборот — но не обоим сразу.
Временная шкала доказывает настоящую гонку
cloud-init status --wait --format json
systemctl status cloud-final.service --no-pager
journalctl -u cloud-final.service -b --no-pager
stat /etc/example/service.conf
ansible-playbook -i inventory first-boot.yml --check --diffИмена файла и playbook условные. Выполняйте чтение без вывода user-data: оно может содержать секреты. status --wait блокируется до завершения cloud-init, но завершение не всегда означает успех, поэтому pipeline обязан разобрать код возврата и extended status. Не запускайте эту команду из самого runcmd: такой шаг ждёт собственного завершения.
Пять стадий заканчиваются не одновременно с SSH
| Стадия | Что может происходить | Что видит Ansible |
|---|---|---|
| Detect / Local | Поиск datasource, сеть и диски | Host часто ещё недоступен |
| Network | User-data и сетевые модули | SSH уже может появиться |
| Config | Config modules и runcmd preparation | Соединение есть, конфигурация не финальна |
| Final | Пакеты, scripts, config management | Вероятна гонка за dpkg/yum и files |
| Done / degraded | Работа завершена с результатом | Можно разбирать итог и запускать playbook |
Официальная документация cloud-init описывает стадии Detect, Local, Network, Config и Final; SSH может стать доступен до Final. Поэтому ansible.builtin.wait_for_connection подтверждает рабочий transport и ping, но не подтверждает завершение bootstrap. Эти два барьера отвечают на разные вопросы и нужны последовательно.
Карта владельцев показывает второй тип конфликта
- Для каждого изменённого файла записать cloud-init module или Ansible role, которые его создают.
- Проверить package installation, repositories, users, SSH keys, hostname, firewall и service enablement.
- Отделить одноразовый bootstrap от desired state, который должен восстанавливаться при каждом playbook run.
- Удалить дублирующую запись из одного источника, а не прятать diff через changed_when: false.
- Если образ готовится заранее, очищать cloud-init state только в image build process, не на рабочей VM.
- Зафиксировать владельца ресурса рядом с user-data template или role defaults.
Особенно часто инструменты спорят за /etc/hosts, hostname, authorized_keys и package manager. Блокировка dpkg показывает параллельность, а файл, который меняется через минуту после успешного play, — последовательное двойное владение. Эти симптомы требуют разных исправлений.
Барьер добавляем до gather_facts и ролей
- hosts: newly_created
gather_facts: false
tasks:
- name: Wait for usable transport
ansible.builtin.wait_for_connection:
timeout: 600
- name: Wait until cloud-init completes
ansible.builtin.command: cloud-init status --wait
changed_when: false
- name: Gather facts after bootstrap
ansible.builtin.setup:Фрагмент — условная схема. command завершит task ошибкой при ненулевом коде, что полезнее слепого продолжения. Для образов без cloud-init добавьте проверяемое условие по фактам образа или отдельной inventory group, а не игнорируйте ошибку для всех hosts. Если status сообщает degraded, сохраните details и остановите rollout.
Второй прогон служит контрольным тестом
- Создать одну тестовую VM из того же image и user-data.
- Дождаться cloud-init с проверкой результата.
- Запустить Ansible в обычном режиме и сохранить changed tasks.
- Подождать полный boot cycle и проверить владельцев файлов.
- Запустить playbook второй раз: неожиданных changes быть не должно.
- Перезагрузить VM и повторить diff без повторной инициализации instance.
- Проверить service state и содержимое одного спорного файла.
Не считайте полный ноль changed абсолютным требованием для задач с временными значениями, но каждый повторный change должен быть объяснён. Если после reboot cloud-init снова выполняет first-boot modules, проверьте instance identity и cache, а не лечите последствия Ansible handler.
Что сохранить перед изменением bootstrap
Для разбора нужны версия cloud-init, cloud provider/image ID, обезличенный user-data template, status JSON, journal cloud-final, список changed tasks и diff спорного файла без секретов. Для отката храните предыдущие image и user-data версии; не копируйте /var/lib/cloud целиком в тикет, потому что там могут оказаться чувствительные данные.