started#

Расширение тестирования ansible.builtin.started проверяет, запущена ли асинхронная задача. Для этого расширение сравнивает значение ключа started из данных о состоянии задачи со значением 1.

Примечание

Расширение можно использовать для проверки статуса синхронных задач, но оно будет выдавать предупреждения.

Описание применения расширений тестирования приведено в документе Тестирование.

Особенности работы#

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

<task_data> is ansible.builtin.started

Здесь <task_data> – словарь с данными задачи. Его можно получить с помощью директивы register.

Для инверсии результата сравнения добавьте not:

<task_data> is not ansible.builtin.started

Входные значения#

Расширение принимает единственный входной параметр Input – словарь данных о состоянии задачи Ansible.

Выходные значения#

Расширение возвращает значение True или False в зависимости от результата проверки:

  • False – задача не запущена;

  • True – задача запущена.

Пример#

Следующий пример демонстрирует использование расширения для проверки статуса асинхронной задачи:

---
# ...
  tasks:
    - name: Run script in an async mode
      ansible.builtin.command: /path/to/script.py
      async: 1000
      poll: 20
      register: async_script

    - name: Check on async task status
      ansible.builtin.debug:
        msg: "Task is started"
      when: async_script is ansible.builtin.started