Если 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 часто ещё недоступен
NetworkUser-data и сетевые модулиSSH уже может появиться
ConfigConfig 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.

Второй прогон служит контрольным тестом

  1. Создать одну тестовую VM из того же image и user-data.
  2. Дождаться cloud-init с проверкой результата.
  3. Запустить Ansible в обычном режиме и сохранить changed tasks.
  4. Подождать полный boot cycle и проверить владельцев файлов.
  5. Запустить playbook второй раз: неожиданных changes быть не должно.
  6. Перезагрузить VM и повторить diff без повторной инициализации instance.
  7. Проверить 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 целиком в тикет, потому что там могут оказаться чувствительные данные.

Проверенные источники