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

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.

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

Добавлено в community.general 8.1.0

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

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

Этот модуль позволяет создавать токены Bootstrap, создавать и обновлять токены ACL, а также удалять токены ACL.

Требования

Следующие требования необходимы на хосте, выполняющем этот модуль.

python-nomad

Параметры

Параметр	Комментарии
client_cert path	Путь к сертификату для TLS/SSL.
client_key path	Путь к закрытому ключу сертификата для TLS/SSL.
global_replicated boolean	Указывает, был ли токен создан с помощью `--global`. Варианты: `false` ← (по умолчанию) `true`
host string / обязательный	Полное доменное имя сервера Nomad.
name string	Имя создаваемого токена ACL.
namespace string	Пространство имён Nomad.
policies list / elements=string	Список политик, назначенных токену. По умолчанию: `[]`
port integer добавлено в community.general 8.0.0	Порт сервера Nomad. По умолчанию: `4646`
state string / обязательный	Создать или удалить токен ACL. Варианты: `"present"` `"absent"`
timeout integer	Тайм-аут (в секундах) запроса к Nomad. По умолчанию: `5`
token string	Токен ACL для аутентификации.
token_type string	Тип токена может быть `client`, `management` или `bootstrap`. Варианты: `"client"` ← (по умолчанию) `"management"` `"bootstrap"`
use_ssl boolean	Использовать соединение TLS/SSL. Варианты: `false` `true` ← (по умолчанию)
validate_certs boolean	Включить проверку сертификатов TLS/SSL. Варианты: `false` `true` ← (по умолчанию)

Атрибуты

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

См. также

Документация Nomad ACL: Полная документация по ACL API Nomad.

Примеры

- name: Create boostrap token
  community.general.nomad_token:
    host: localhost
    token_type: bootstrap
    state: present

- name: Create ACL token
  community.general.nomad_token:
    host: localhost
    name: "Dev token"
    token_type: client
    policies:
      - readonly
    global_replicated: false
    state: absent

- name: Update ACL token Dev token
  community.general.nomad_token:
    host: localhost
    name: "Dev token"
    token_type: client
    policies:
      - readonly
      - devpolicy
    global_replicated: false
    state: absent

- name: Delete ACL token
  community.general.nomad_token:
    host: localhost
    name: "Dev token"
    state: absent

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

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

Ключ	Описание
result dictionary	Результат, возвращённый Nomad. Возвращается: всегда Пример: `{"accessor_id": "0d01c55f-8d63-f832-04ff-1866d4eb594e", "create_index": 14, "create_time": "2023-11-12T18:48:34.248857001Z", "expiration_time": null, "expiration_ttl": "", "global": true, "hash": "eSn8H8RVqh8As8WQNnC2vlBRqXy6DECogc5umzX0P30=", "modify_index": 836, "name": "devs", "policies": ["readonly"], "roles": null, "secret_id": "12e878ab-e1f6-e103-b4c4-3b5173bb4cea", "type": "client"}`

Ключ

Описание

result

dictionary

Результат, возвращённый Nomad.

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

Пример: {"accessor_id": "0d01c55f-8d63-f832-04ff-1866d4eb594e", "create_index": 14, "create_time": "2023-11-12T18:48:34.248857001Z", "expiration_time": null, "expiration_ttl": "", "global": true, "hash": "eSn8H8RVqh8As8WQNnC2vlBRqXy6DECogc5umzX0P30=", "modify_index": 836, "name": "devs", "policies": ["readonly"], "roles": null, "secret_id": "12e878ab-e1f6-e103-b4c4-3b5173bb4cea", "type": "client"}

Авторы

Pedro Nascimento (@apecnascimento)

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

© 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/nomad_token_module.html