openstack.cloud.catalog_service – Управление сервисами идентификации OpenStack

Примечание

Этот плагин входит в состав коллекции openstack.cloud (версия 1.2.1).

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

Для использования в книге задач, укажите: openstack.cloud.catalog_service.

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

Описание

Создание, обновление или удаление службы идентификации OpenStack. Если служба с заданным именем уже существует, она будет обновлена с новым описанием и включёнными атрибутами.

Требования

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

openstacksdk
openstacksdk >= 0.12.0
python >= 3.6

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_timeout целое число		Сколько времени должна ждать система сокетов, прежде чем произойдёт таймаут для вызовов API. Если это опущено, ничего не будет передано в библиотеку запросов.
auth словарь		Словарь, содержащий информацию об авторизации, как требуется стратегией плагина авторизации облака. Для плагина по умолчанию password, он будет содержать auth_url, username, password, project_name и любую информацию о доменах (например, user_domain_name или project_domain_name), если облако их поддерживает. Для других плагинов этот параметр должен содержать параметры, необходимые данному плагину авторизации. Этот параметр не нужен, если указано имя облака или присутствуют переменные окружения OpenStack OS_*.
auth_type строка		Имя плагина авторизации для использования. Если облако использует что-то кроме парольной аутентификации, имя плагина должно быть указано здесь, и содержимое параметра auth должно быть соответствующим образом обновлено.
availability_zone строка		Игнорируется. Присутствует для обратной совместимости
ca_cert строка		Путь к пакету сертификатов CA, который может использоваться для проверки запросов API SSL. псевдонимы: cacert
client_cert строка		Путь к клиенту сертификат для использования в рамках транзакции SSL. псевдонимы: cert
client_key строка		Путь к ключу клиента для использования в рамках транзакции SSL. псевдонимы: key
cloud сырой		Назначенное облако или конфигурация облака для работы. Если cloud — строка, она ссылается на конфигурацию назначенного облака, как определено в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если указан auth или присутствуют переменные окружения OpenStack OS_. Если cloud* — словарь, он содержит полную конфигурацию облака, как в разделе clouds.yaml.
description строка		Описание службы
enabled логический	Варианты: нет да ←	Включена ли служба
interface строка	Варианты: admin internal public ←	Тип URL конечной точки для извлечения из каталога служб. псевдонимы: endpoint_type
name строка / обязательно		Имя службы
region_name строка		Имя региона.
service_type строка / обязательно		Тип службы
state строка	Варианты: present ← absent	Должен ли ресурс быть присутствующим или отсутствующим.
timeout целое число	По умолчанию: 180	Сколько времени Ansible должен ждать запрошенного ресурса.
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/

Примеры

# Create a service for glance
- openstack.cloud.catalog_service:
     cloud: mycloud
     state: present
     name: glance
     service_type: image
     description: OpenStack Image Service
# Delete a service
- openstack.cloud.catalog_service:
     cloud: mycloud
     state: absent
     name: glance
     service_type: image

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

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

Ключ		Возвращаемое	Описание
id строка		При успехе, когда state равен 'present'	Идентификатор службы. Пример: 3292f020780b4d5baf27ff7e1d224c44
service сложный		При успехе, когда state равен 'present'	Словарь, описывающий службу.
	description строка	успех	Описание службы. Пример: OpenStack Image Service
	enabled логический	успех	Статус службы. Пример: True
	id строка	успех	Идентификатор службы. Пример: 3292f020780b4d5baf27ff7e1d224c44
	name строка	успех	Имя службы. Пример: glance
	service_type строка	успех	Тип службы. Пример: image

Авторы

OpenStack Ansible SIG

© 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/openstack/cloud/catalog_service_module.html