os_keystone_service - Управление сервисами идентификации OpenStack
Введено в версии 2.2.
- Описание
- Требования (для хоста, выполняющего модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Описание
- Создание, обновление или удаление сервиса идентификации OpenStack. Если сервис с указанным именем уже существует, он будет обновлён с новым описанием и атрибутами включения.
Требования (для хоста, выполняющего модуль)
- python >= 2.6
- python >= 2.7
- shade
Параметры
| параметр | обязателен | значение по умолчанию | варианты | комментарии |
|---|---|---|---|---|
| api_timeout | нет | None | Сколько времени должно ждать сокетное соединение перед тем, как произойдёт таймаут для вызовов API. Если этот параметр отсутствует, он не будет передан в библиотеку requests. | |
| auth | нет | Словарь, содержащий информацию об авторизации, необходимую для стратегии подключаемого модуля авторизации облака. Для стандартного подключаемого модуля password он будет содержать auth_url, username, password, project_name и любую информацию о доменах, если облако их поддерживает. Для других подключаемых модулей этот параметр должен содержать необходимые параметры подключаемого модуля авторизации. Этот параметр не нужен, если предоставлено имя облака или присутствуют переменные среды OpenStack OS_*. | ||
| auth_type | нет | password | Имя подключаемого модуля авторизации для использования. Если облако использует что-то кроме парольной авторизации, имя подключаемого модуля должно быть указано здесь, а содержимое параметра auth должно быть соответствующим образом обновлено. | |
| availability_zone | нет | Игнорируется. Присутствует для обратной совместимости | ||
| cacert | нет | None | Путь к пакету сертификатов CA, который может быть использован для проверки запросов API SSL. | |
| cert | нет | None | Путь к клиенту сертификат для использования в рамках транзакции SSL. | |
| cloud | нет | Имя облака для работы. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если предоставлен auth или если присутствуют переменные среды OpenStack OS_*. | ||
| description | нет | None | Описание сервиса | |
| enabled | нет | True | Сервис включён | |
| endpoint_type | нет | public |
| Тип URL-адреса конечной точки для извлечения из каталога сервисов. |
| key | нет | None | Путь к клиенту ключ для использования в рамках транзакции SSL. | |
| name | да | Имя сервиса | ||
| region_name | нет | Имя региона. | ||
| service_type | да | Тип сервиса | ||
| state | нет | present |
| Ресурс должен быть присутствующим или отсутствующим. |
| timeout | нет | 180 | Сколько времени Ansible должно ждать требуемого ресурса. | |
| validate_certs | нет | Должны ли проверяться запросы API SSL. До версии 2.3 это значение по умолчанию было True. псевдонимы: verify | ||
| wait | нет | yes |
| Должен ли Ansible ждать завершения требуемого ресурса. |
Примеры
# 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 | Идентификатор сервиса. | При успехе, когда I(state) равно 'present' | строка | 3292f020780b4d5baf27ff7e1d224c44 | ||||||||||||||||||||||||||||||
| service | Словарь, описывающий сервис. | При успехе, когда I(state) равно 'present' | сложный | |||||||||||||||||||||||||||||||
| содержит: |
| |||||||||||||||||||||||||||||||||
Примечания
Примечание
- Стандартные переменные среды 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
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет обратной совместимым.
Для получения помощи в разработке модулей, если вы заинтересованы, прочитайте Документация по сообществу и содействие, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/os_keystone_service_module.html
