Модуль community.general.rundeck_acl_policy — управление политиками ACL Rundeck

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install community.general.

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

Краткое описание
Параметры
Атрибуты
Примеры
Возвращаемые значения

Краткое описание

Создание, обновление и удаление политик ACL Rundeck через HTTP API.

Параметры

Параметр	Комментарии
api_token псевдонимы: token строка / обязательный	Задаёт токен для аутентификации в API Rundeck.
api_version целое число	Используемая версия API Rundeck. Версия API должна быть не ниже 14. По умолчанию: `39`
client_cert путь добавлено в community.general 0.2.0	Файл цепочки сертификатов в формате PEM для аутентификации SSL-клиента. Этот файл также может содержать ключ; если ключ включён в файл, параметр `client_key` не требуется.
client_key путь добавлено в community.general 0.2.0	Файл в формате PEM, содержащий закрытый ключ для аутентификации SSL-клиента. Если `client_cert` содержит и сертификат, и ключ, этот параметр не требуется.
force логическое значение добавлено в community.general 0.2.0	Если `yes`, не использовать кэшированную копию. Варианты: `false` ← (по умолчанию) `true`
force_basic_auth логическое значение добавлено в community.general 0.2.0	Передавать учётные данные, указанные с помощью `url_username` и `url_password`, в заголовке HTTP. Варианты: `false` ← (по умолчанию) `true`
http_agent строка добавлено в community.general 0.2.0	Значение заголовка для идентификации; обычно отображается в журналах веб-сервера. По умолчанию: `"ansible-httpget"`
name строка / обязательный	Задаёт имя проекта.
policy строка	Задаёт содержимое политики ACL. Содержимое политики ACL — это объект YAML, описанный в http://rundeck.org/docs/man5/aclpolicy.html. Это может быть строка YAML или объект YAML инвентаризации Ansible.
project строка	Задаёт проект, которому назначается политика ACL. Если значение не задано, политика ACL применяется на уровне системы.
state строка	Создать или удалить проект Rundeck. Варианты: `"present"` ← (по умолчанию) `"absent"`
url строка / обязательный	URL HTTP, HTTPS или FTP в формате (http\|https\|ftp)://[user[:pass]]@host.domain[:port]/path
url_password строка добавлено в community.general 0.2.0	Пароль для HTTP-аутентификации Basic. Если параметр `url_username` не указан, параметр `url_password` использоваться не будет.
url_username строка добавлено в community.general 0.2.0	Имя пользователя для HTTP-аутентификации Basic. Этот параметр можно использовать без `url_password` для сайтов, допускающих пустые пароли.
use_gssapi логическое значение добавлено в 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 логическое значение добавлено в community.general 0.2.0	Если `no`, прокси использоваться не будет, даже если он задан в переменной среды на целевых узлах. Варианты: `false` `true` ← (по умолчанию)
validate_certs логическое значение добавлено в community.general 0.2.0	Если `no`, сертификаты SSL проверяться не будут. Используйте этот параметр только на контролируемых вами сайтах с самоподписанными сертификатами. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в режиме `check_mode` и возвращать прогнозируемый статус изменений без изменения целевого узла.
diff_mode	Поддержка: отсутствует	В режиме diff возвращает сведения об изменениях (или возможных изменениях в `check_mode`).

Примеры

- name: Create or update a rundeck ACL policy in project Ansible
  community.general.rundeck_acl_policy:
    name: "Project_01"
    api_version: 18
    url: "https://rundeck.example.org"
    token: "mytoken"
    state: present
    project: "Ansible"
    policy:
      description: "my policy"
      context:
        application: rundeck
      for:
        project:
          - allow: read
      by:
        group: "build"

- name: Remove a rundeck system policy
  community.general.rundeck_acl_policy:
    name: "Project_01"
    url: "https://rundeck.example.org"
    token: "mytoken"
    state: absent

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

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

Ключ	Описание
after словарь	Словарь со сведениями о политике ACL после изменения. Возвращается: при успехе
before словарь	Словарь со сведениями о политике ACL до изменения. Возвращается: при успехе
rundeck_response строка	Ответ Rundeck в случае сбоя. Возвращается: при сбое

Авторы

Loic Blot (@nerzhul)

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

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