os_keystone_service – Управление службами OpenStack Identity

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

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

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

Требования

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

openstacksdk
openstacksdk >= 0.12.0
python >= 2.7

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_timeout целое число		Сколько времени слой сокетов должен ждать перед истечением времени ожидания для вызовов API. Если этот параметр опущен, он не будет передан в библиотеку requests.
auth словарь		Словарь, содержащий информацию об авторизации, необходимую для стратегии плагина авторизации облака. Для плагина по умолчанию password, он будет содержать auth_url, username, password, project_name и любую информацию о домене (например, os_user_domain_name или os_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
- os_keystone_service:
     cloud: mycloud
     state: present
     name: glance
     service_type: image
     description: OpenStack Image Service
# Delete a service
- os_keystone_service:
     cloud: mycloud
     state: absent
     name: glance
     service_type: image

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

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

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

Статус

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

Авторы

Sam Yaple (@SamYaple)

Подсказка

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

© 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_service_module.html