os_keystone_service - Управление сервисами идентификации OpenStack
Новая версия 2.2.
Обзор
- Создать, обновить или удалить сервис идентификации OpenStack. Если сервис с указанным именем уже существует, он будет обновлен с новым описанием и включенными атрибутами.
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- openstacksdk
- python >= 2.7
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| 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 | Описание сервиса | |
| enabled bool |
| Включен ли сервис |
| interface (добавлен в 2.3) |
| Тип URL конечной точки для извлечения из каталога сервисов. псевдонимы: endpoint_type |
| key | Путь к ключу клиента для использования в рамках транзакции SSL. | |
| name обязательно | Имя сервиса | |
| region_name | Имя региона. | |
| service_type обязательно | Тип сервиса | |
| state |
| Должен ли ресурс присутствовать или отсутствовать. |
| timeout | По умолчанию: 180 | Сколько времени Ansible должен ждать запрошенного ресурса. |
| verify bool |
| Необходимо ли проверять запросы SSL API. До версии 2.3 по умолчанию было True. псевдонимы: validate_certs |
| wait bool |
| Должен ли 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' | Словарь, описывающий сервис. | |
| id строка | Идентификатор сервиса. Пример: 3292f020780b4d5baf27ff7e1d224c44 | ||
| name строка | Имя сервиса. Пример: glance | ||
| service_type строка | Тип сервиса. Пример: image | ||
| description строка | Описание сервиса. Пример: Сервис изображений OpenStack | ||
| enabled булево | Статус сервиса. Пример: True | ||
Статус
Этот модуль помечен как превью, что означает, что гарантии обратной совместимости нет.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- 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.6/modules/os_keystone_service_module.html