Spec-Zone.ru › Ansible

Модуль community.general.rundeck_job_run – Запуск задания Rundeck

Примечание

Этот модуль входит в коллекцию community.general (версия 9.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать её в плейбуке, укажите: community.general.rundeck_job_run.

Впервые появился в community.general 3.8.0

  • Обзор
  • Параметры
  • Атрибуты
  • Примеры
  • Возвращаемые значения

Обзор

  • Этот модуль запускает задание Rundeck, указанное по идентификатору.

Параметры

Параметр

Комментарии

abort_on_timeout

boolean

Отправить запрос на прерывание задачи, если превышено указанное wait_execution_timeout.

Варианты:

  • false ← (по умолчанию)
  • true

api_token

string / обязательно

Токен API пользователя Rundeck.

api_version

integer

Используемая версия API Rundeck.

Версия API должна быть не менее 14.

По умолчанию: 39

client_cert

путь

Файл цепочки сертификатов в формате PEM, используемый для аутентификации SSL клиента.

Этот файл также может содержать ключ, и если ключ включен, client_key не требуется.

client_key

путь

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

Если client_cert содержит как сертификат, так и ключ, этот параметр не требуется.

filter_nodes

строка

Фильтр узлов, на которых должны выполняться задачи.

См. https://docs.rundeck.com/docs/manual/11-node-filters.html#node-filter-syntax.

force

boolean

Если yes, не получать кэшированную копию.

Варианты:

  • false ← (по умолчанию)
  • true

force_basic_auth

boolean

Указанные учетные данные с помощью url_username и url_password должны передаваться в заголовке HTTP.

Варианты:

  • false ← (по умолчанию)
  • true

http_agent

string

Заголовок для идентификации, обычно отображается в журнале веб-сервера.

По умолчанию: "ansible-httpget"

job_id

string / обязательно

Уникальный идентификатор задачи.

job_options

словарь

Параметры задачи для шагов.

Числовые значения должны быть заключены в кавычки.

loglevel

string

Конфигурация уровня ведения журнала.

Варианты:

  • "debug"
  • "verbose"
  • "info" ← (по умолчанию)
  • "warn"
  • "error"

run_at_time

string

Планирование выполнения задачи на определенную дату и время.

Формат даты и времени ISO-8601, например 2021-10-05T15:45:00-03:00.

url

string / обязательно

URL экземпляра Rundeck.

url_password

string

Пароль для использования в аутентификации HTTP Basic.

Если параметр url_username не указан, параметр url_password не будет использован.

url_username

string

Имя пользователя для использования в аутентификации HTTP Basic.

Этот параметр может использоваться без url_password для сайтов, которые допускают пустые пароли.

use_gssapi

boolean

добавлен в ansible-core 2.11

Использовать GSSAPI для выполнения аутентификации, как правило, это используется для аутентификации Kerberos или Kerberos через Negotiate.

Требуется установка библиотеки Python gssapi.

Учетные данные для GSSAPI можно указать с помощью url_username/url_password или с помощью переменной среды GSSAPI KRB5CCNAME, которая определяет пользовательский кэш учетных данных Kerberos.

Аутентификация NTLM не поддерживается, даже если механизм GSSAPI для NTLM установлен.

Варианты:

  • false ← (по умолчанию)
  • true

use_proxy

boolean

Если no, прокси не будет использоваться, даже если он определен в переменной среды на целевых хостах.

Варианты:

  • false
  • true ← (по умолчанию)
END_OF_DOCUMENT_MARKER

validate_certs

boolean

Если no, сертификаты SSL не будут проверены.

Это следует использовать только на сайтах, контролируемых лично, использующих самозаверяющие сертификаты.

Варианты:

  • false
  • true ← (по умолчанию)

wait_execution

boolean

Ожидать завершения выполнения задания.

Варианты:

  • false
  • true ← (по умолчанию)

wait_execution_delay

integer

Задержка в секундах между запросами проверки статуса выполнения задания.

По умолчанию: 5

wait_execution_timeout

integer

Таймаут ожидания выполнения задания в секундах.

Если таймаут истекает, задание будет прервано.

Учитывайте задержку, основанную на wait_execution_delay после каждой проверки статуса задания.

По умолчанию: 120

Атрибуты

Атрибут

Поддержка

Описание

check_mode

Поддержка: нет

Может работать в режиме check_mode и возвращать прогноз статуса изменений без модификации целевого объекта.

diff_mode

Поддержка: нет

При работе в режиме разницы вернет детали изменений (или возможных изменений в check_mode).

Примеры

- name: Run a Rundeck job
  community.general.rundeck_job_run:
    url: "https://rundeck.example.org"
    api_version: 39
    api_token: "mytoken"
    job_id: "xxxxxxxxxxxxxxxxx"
  register: rundeck_job_run

- name: Show execution info
  ansible.builtin.debug:
    var: rundeck_job_run.execution_info

- name: Run a Rundeck job with options
  community.general.rundeck_job_run:
    url: "https://rundeck.example.org"
    api_version: 39
    api_token: "mytoken"
    job_id: "xxxxxxxxxxxxxxxxx"
    job_options:
        option_1: "value_1"
        option_2: "value_3"
        option_3: "value_3"
  register: rundeck_job_run

- name: Run a Rundeck job with timeout, delay between status check and abort on timeout
  community.general.rundeck_job_run:
    url: "https://rundeck.example.org"
    api_version: 39
    api_token: "mytoken"
    job_id: "xxxxxxxxxxxxxxxxx"
    wait_execution_timeout: 30
    wait_execution_delay: 10
    abort_on_timeout: true
  register: rundeck_job_run

- name: Schedule a Rundeck job
  community.general.rundeck_job_run:
    url: "https://rundeck.example.org"
    api_version: 39
    api_token: "mytoken"
    job_id: "xxxxxxxxxxxxxxxxx"
    run_at_time: "2021-10-05T15:45:00-03:00"
  register: rundeck_job_schedule

- name: Fire-and-forget a Rundeck job
  community.general.rundeck_job_run:
    url: "https://rundeck.example.org"
    api_version: 39
    api_token: "mytoken"
    job_id: "xxxxxxxxxxxxxxxxx"
    wait_execution: false
  register: rundeck_job_run

Возвращаемые значения

Общие возвращаемые значения документированы здесь, следующие поля уникальны для данного модуля:

Ключ

Описание

execution_info

словарь

Метаданные выполнения задания Rundeck.

Возвращается: всегда

Пример: {"execution_info": {"argstring": "-exit_code 0", "date-ended": {"date": "2021-10-05T15:50:26Z", "unixtime": 1633449026358}, "date-started": {"date": "2021-10-05T15:50:20Z", "unixtime": 1633449020784}, "description": "sleep 5 && echo 'Test!' && exit ${option.exit_code}", "executionType": "user", "href": "https://rundeck.example.org/api/39/execution/1", "id": 1, "job": {"averageDuration": 4917, "description": "", "group": "", "href": "https://rundeck.example.org/api/39/job/697af0c4-72d3-4c15-86a3-b5bfe3c6cb6a", "id": "697af0c4-72d3-4c15-86a3-b5bfe3c6cb6a", "name": "Test", "options": {"exit_code": "0"}, "permalink": "https://rundeck.example.org/project/myproject/job/show/697af0c4-72d3-4c15-86a3-b5bfe3c6cb6a", "project": "myproject"}, "output": "Test!", "permalink": "https://rundeck.example.org/project/myproject/execution/show/1", "project": "myproject", "serverUUID": "5b9a1438-fa3a-457e-b254-8f3d70338068", "status": "succeeded", "successfulNodes": ["localhost"], "user": "admin"}, "msg": "Job execution succeeded!"}

Авторы

  • Phillipe Smith (@phsmith)

Ссылки на коллекцию

  • Система отслеживания задач
  • Репозиторий (исходные коды)
  • Задать вопрос
  • Отправить отчет об ошибке
  • Запросить функцию
  • Общение

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/rundeck_job_run_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API