os_keystone_endpoint – Управление конечными точками сервиса OpenStack Identity

Новое в версии 2.5.

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

Обзор

Создать, обновить или удалить конечные точки сервиса OpenStack Identity. Если сервис с таким же сочетанием service, interface и region уже существует, url и state (present или absent) будут обновлены.

Требования

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

openstacksdk >= 0.12.0
openstacksdk >= 0.13.0
python >= 2.7

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_timeout целое число		Сколько времени (в секундах) модуль должен ждать при вызове API перед сбросом соединения. Если параметр опущен, к библиотеке запросов ничего не будет передано.
auth словарь		Словарь, содержащий информацию об авторизации, необходимую стратегии подключаемых модулей авторизации облака. Для стандартного подключаемого модуля password он будет содержать auth_url, username, password, project_name и любую информацию о доменных именах (например, os_user_domain_name или os_project_domain_name), если облако их поддерживает. Для других подключаемых модулей этот параметр должен содержать параметры, необходимые данному подключаемому модулю. Этот параметр не нужен, если указано имя облака или присутствуют переменные окружения OpenStack OS_*.
auth_type строка		Имя подключаемого модуля авторизации для использования. Если облако использует что-то другое, кроме аутентификации по паролю, имя подключаемого модуля следует указать здесь, и содержимое параметра auth следует обновить соответствующим образом.
ca_cert строка		Путь к пакету сертификатов CA, который может использоваться для проверки запросов к API SSL. псевдонимы: cacert
client_cert строка		Путь к клиенту сертификат для использования в процессе SSL-транзакции. псевдонимы: cert
client_key строка		Путь к ключу клиента для использования в процессе SSL-транзакции. псевдонимы: key
cloud raw		Именованное облако или конфигурация облака для работы. Если cloud — строка, она ссылается на конфигурацию именованного облака, как определено в файле OpenStack clouds.yaml. Устанавливает значения по умолчанию для auth и auth_type. Этот параметр не нужен, если указан параметр auth или присутствуют переменные окружения OpenStack OS_. Если cloud* — словарь, он содержит полную конфигурацию облака, как в разделе clouds.yaml.
enabled логическое значение	Варианты: нет да ←	Включён ли сервис.
endpoint_interface - / обязательно	Варианты: admin public internal	Интерфейс сервиса.
interface строка	Варианты: admin internal public ←	Тип URL конечной точки для получения из каталога сервисов. псевдонимы: endpoint_type
region -		Регион, к которому относится сервис. Обратите внимание, что для аутентификации используется region_name.
region_name строка		Имя региона.
service - / обязательно		Имя или идентификатор сервиса.
state -	Варианты: present ← absent	Необходимо ли `present` или `absent`.
timeout целое число	По умолчанию: 180	Сколько времени Ansible должен ждать запрашиваемый ресурс.
url - / обязательно		URL сервиса.
validate_certs логическое значение	Варианты: нет ← да	Должны ли запросы к API SSL проверяться? В Ansible до версии 2.3 по умолчанию было значение `yes`. псевдонимы: verify
wait логическое значение	Варианты: нет да ←	Должен ли Ansible ждать завершения запрошенного ресурса.

Примечания

Примечание

Могут использоваться стандартные переменные окружения OpenStack, такие как OS_USERNAME, вместо указания явных значений.
Информация об авторизации управляется openstacksdk, что означает, что значения могут поступать из файла конфигурации yaml в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных окружения, и, наконец, из явных параметров в задачах. Дополнительную информацию можно найти по адресу https://docs.openstack.org/openstacksdk/

Примеры

- name: Create a service for glance
  os_keystone_endpoint:
     cloud: mycloud
     service: glance
     endpoint_interface: public
     url: http://controller:9292
     region: RegionOne
     state: present

- name: Delete a service for nova
  os_keystone_endpoint:
     cloud: mycloud
     service: nova
     endpoint_interface: public
     region: RegionOne
     state: absent

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

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

Ключ		Возвращаемое значение	Описание
endpoint сложное		При успехе, когда state — `present`	Словарь, описывающий конечную точку.
	enabled логическое значение		Статус сервиса. Пример: Истина
	id строка		Идентификатор конечной точки. Пример: 3292f020780b4d5baf27ff7e1d224c44
	interface строка		Интерфейс конечной точки. Пример: public
	region строка		Имя региона. Пример: РегионОдин
	service_id строка		Идентификатор сервиса. Пример: b91f1318f735494a825a55388ee118f3
	url строка		URL сервиса. Пример: http://controller:9292

Статус

Этот модуль не гарантирует обратной совместимости интерфейса. [preview]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Мохаммед Насер (@mnaser)
Альберто Мурильо (@albertomurillo)

Подсказка

Если вы заметили какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/os_keystone_endpoint_module.html