Что будет, если Ansible попробует удалить несуществующий файл

Влияние удаления несуществующего файла в Ansible

При попытке удалить несуществующий файл с помощью модуля file (с параметром state: absent), Ansible не вызывает ошибку и не приводит к сбою задачи. Это поведение является одним из ключевых принципов idempotency (идемпотентности) в Ansible — выполнение задачи должно приводить к одинаковому результату независимо от начального состояния системы.

Детальное поведение

1. Модуль file проверяет существование файла перед выполнением операции.
2. Если файл не существует, задача завершается успешно с статусом ok или changed: false в выводе (если используется режим --diff или подробный вывод).
3. Это предотвращает ненужные ошибки в playbook, когда операция удаления может быть частью стандартной процедуры очистки.

Пример playbook и его вывод

---
– name: Пример удаления несуществующего файла
  hosts: localhost
  tasks:
    – name: Удалить файл /tmp/nonexistent.txt
      ansible.builtin.file:
        path: /tmp/nonexistent.txt
        state: absent

Вывод выполнения:

PLAY [Пример удаления несуществующего файла] ***********************************

TASK [Удалить файл /tmp/nonexistent.txt] ***************************************
ok: [localhost]

PLAY RECAP *********************************************************************
localhost                  : ok=1    changed=0    unreachable=0    failed=0    skipped=0    rescued=0    ignored=0

Ключевые наблюдения из вывода:

• ok: [localhost] — задача выполнена успешно
• changed: 0 в итоговом recap — состояние системы не изменилось (файл уже отсутствовал)

Исключения и особые случаи

Несмотря на стандартное безопасное поведение, существуют ситуации, где нужно контролировать этот процесс:

1. Модуль shell или command: Если удаление выполняется через эти модули (например, rm /tmp/nonexistent.txt), система может вернуть ошибку:

   – name: Попытка удалить через shell (опасно!)
     ansible.builtin.shell: rm /tmp/nonexistent.txt
   

   Вывод будет содержать failed, если файл не существует и команда rm возвращает ошибку.

2. Проверка существования файла перед удалением: В некоторых сценариях требуется логика "удалить только если существует":

   – name: Проверить существование файла
     ansible.builtin.stat:
       path: /tmp/somefile.txt
     register: file_stat
   
   – name: Удалить файл если он существует
     ansible.builtin.file:
       path: /tmp/somefile.txt
       state: absent
     when: file_stat.stat.exists
   

3. Обработка символических ссылок: Модуль file с state: absent также удаляет символические ссылки, если они существуют на указанном пути.

Практические рекомендации

• Используйте модуль file для операций с файлами вместо shell/command — это обеспечивает идемпотентность и безопасность.
• Не добавляйте условные проверки when для простого удаления — модуль file уже обрабатывает отсутствие файла корректно.
• Для сложных операций (например, удаление с определенными правами или в особых условиях) используйте комбинацию stat + file с условиями.
• В режиме --diff вы увидите сообщение "file does not exist, not deleting", что полезно для отладки.

Архитектурный контекст

Это поведение соответствует философии Ansible:

• Declarative configuration (декларативная конфигурация) — мы описываем желаемое состояние (state: absent), а Ansible определяет, какие действия нужны для его достижения.
• Safe automation (безопасная автоматизация) — playbook не должны ломаться из-за отсутствия файлов, которые могут быть удалены ранее или на других системах.
• Consistent state management (управление состоянием) — результат всегда одинаков: файл отсутствует после выполнения задачи.

Таким образом, попытка удалить несуществующий файл в Ansible является штатной операцией, которая не приводит к ошибкам и соответствует принципам надежной автоматизации инфраструктуры.