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

Примечание

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

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

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

Для использования в playbook, укажите: community.general.nomad_token.

Новое в community.general 8.1.0

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

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

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

Требования

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

python-nomad

Параметры

Параметр	Комментарии
client_cert path	Путь к сертификату для TLS/SSL.
client_key path	Путь к закрытому ключу сертификата для TLS/SSL.
global_replicated boolean	Указывает, был ли токен создан с помощью `--global`. Варианты: `false` ← (по умолчанию) `true`
host string / обязательно	FQDN сервера 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`), в режиме diff.

См. также

Документация Nomad ACL: Полная документация по API ACL 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 словарь	Результат, возвращённый 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

словарь

Результат, возвращённый 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/nomad_token_module.html