openstack.cloud.os_keystone_service – Управление службами идентификации OpenStack
Примечание
Этот плагин входит в коллекцию openstack.cloud (версия 1.2.1).
Для его установки используйте: ansible-galaxy collection install openstack.cloud.
Для использования в книге задач укажите: openstack.cloud.os_keystone_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, который может быть использован для проверки запросов 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 строка |
| Тип URL конечной точки для извлечения из каталога сервиса. псевдонимы: endpoint_type |
| name строка / обязательно | Имя сервиса | |
| region_name строка | Название региона. | |
| service_type строка / обязательно | Тип сервиса | |
| state строка |
| Ресурс должен быть присутствовать или отсутствовать. |
| timeout целое число | По умолчанию: 180 | Сколько времени Ansible должно ждать запрошенного ресурса. |
| validate_certs булево |
| Проверяются ли запросы SSL API. До 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 | |
| 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/os_keystone_service_module.html