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

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

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

Обзор

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

Требования

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

python >= 2.6
python >= 2.7
shade

Параметры

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

Примечания

Примечание

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

Примеры

# 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'	Словарь, описывающий службу.
	service_type строка		Тип службы. Пример: image
	enabled булево		Статус службы. Пример: True
	description строка		Описание службы. Пример: Служба изображений OpenStack
	name строка		Имя службы. Пример: glance
	id строка		Идентификатор службы. Пример: 3292f020780b4d5baf27ff7e1d224c44

Статус

Этот модуль помечен как предварительный, что означает, что его интерфейс не гарантируется как обратная совместимость.

Автор

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.5/modules/os_keystone_service_module.html