community.general.consul_acl – Управление ключами и правилами доступа Consul ACL

Примечание

Этот плагин является частью коллекции community.general (версия 1.3.2).

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

Для использования в книге задач укажите: community.general.consul_acl.

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

Обзор

Позволяет добавлять, изменять и удалять ключи ACL и связанные правила в кластере Consul через агент. Более подробную информацию об использовании и настройке ACL см. на https://www.consul.io/docs/guides/acl.html.

Требования

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

python-consul
pyhcl
requests

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
host строка	По умолчанию: "localhost"	хост агента consul, по умолчанию localhost
mgmt_token строка / обязательно		требуется маркер управления для манипулирования списками acl
name строка		имя, которое должно быть связано с ключом acl; это невидимо для Consul
port целое число	По умолчанию: 8500	порт, на котором работает агент consul
rules список / элементы=строка		правила, которые должны быть связаны с данным маркером
scheme строка	По умолчанию: "http"	схема протокола, на которой работает агент consul
state строка	Варианты: present ← absent	признак наличия или отсутствия пары ACL
token строка		ключ маркера, идентифицирующий набор правил ACL. Если сгенерирован consul, это будет UUID
token_type строка	Варианты: client ← management	тип маркера, который должен быть создан
validate_certs булево	Варианты: no yes ←	требовать проверку TLS-сертификата агента consul

Примеры

- name: Create an ACL with rules
  community.general.consul_acl:
    host: consul1.example.com
    mgmt_token: some_management_acl
    name: Foo access
    rules:
      - key: "foo"
        policy: read
      - key: "private/foo"
        policy: deny

- name: Create an ACL with a specific token
  community.general.consul_acl:
    host: consul1.example.com
    mgmt_token: some_management_acl
    name: Foo access
    token: my-token
    rules:
      - key: "foo"
        policy: read

- name: Update the rules associated to an ACL token
  community.general.consul_acl:
    host: consul1.example.com
    mgmt_token: some_management_acl
    name: Foo access
    token: some_client_token
    rules:
      - event: "bbq"
        policy: write
      - key: "foo"
        policy: read
      - key: "private"
        policy: deny
      - keyring: write
      - node: "hgs4"
        policy: write
      - operator: read
      - query: ""
        policy: write
      - service: "consul"
        policy: write
      - session: "standup"
        policy: write

- name: Remove a token
  community.general.consul_acl:
    host: consul1.example.com
    mgmt_token: some_management_acl
    token: 172bd5c8-9fe9-11e4-b1b0-3c15c2c9fd5e
    state: absent

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

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

Ключ	Возвращаемое значение	Описание
operation строка	changed	выполненная операция над ACL Пример: update
rules строка	status == "present"	представление правил ACL в формате HCL JSON, как описано в документации Consul (https://www.consul.io/docs/guides/acl.html#rule-specification). Пример: {'key': {'bar': {'policy': 'deny'}, 'foo': {'policy': 'write'}}}
token строка	success	маркер, связанный с ACL (идентификатор ACL) Пример: a2ec332f-04cf-6fba-e8b8-acf62444d3da

Авторы

Steve Gargan (@sgargan)
Colin Nolan (@colin-nolan)

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