os_keystone_service – Управление службами идентификации OpenStack

Новая версия с 2.2.

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

Обзор

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

Требования

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

openstacksdk
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, который может использоваться для проверки запросов SSL API. псевдонимы: 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 строка добавлено в 2.3	Варианты: админ внутренний публичный ←	Тип 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.8/modules/os_keystone_service_module.html