os_server_facts - Получение фактов о одном или нескольких вычислительных экземплярах
Новая версия с 2.0.
Обзор
- Получение фактов о серверных экземплярах из OpenStack.
Требования (для хоста, на котором выполняется модуль)
- python >= 2.6
- python >= 2.7
- shade
Параметры
| параметр | обязателен | значение по умолчанию | варианты | примечания |
|---|---|---|---|---|
| api_timeout | нет | None | Сколько времени должна ждать сокетная прослойка, прежде чем произойдёт таймаут для API-вызовов. Если этот параметр опущен, ничего не будет передано в библиотеку запросов. | |
| auth | нет | Словарь, содержащий информацию об авторизации, необходимую стратегии подключаемого модуля авторизации облака. Для стандартного подключаемого модуля password он будет содержать auth_url, username, password, project_name и любые сведения о доменах, если облако их поддерживает. Для других подключаемых модулей этот параметр должен содержать любые требуемые параметры подключаемого модуля авторизации. Этот параметр не нужен, если указано имя облака или присутствуют переменные среды OpenStack OS_*. | ||
| auth_type | нет | password | Имя подключаемого модуля авторизации для использования. Если облако использует что-то помимо парольной авторизации, здесь должно быть указано имя подключаемого модуля, а содержимое параметра auth должно быть соответствующим образом обновлено. | |
| availability_zone | нет | Игнорируется. Присутствует для обратной совместимости | ||
| cacert | нет | None | Путь к пакету сертификатов CA, который может использоваться при проверке SSL API-запросов. | |
| cert | нет | None | Путь к клиенту сертификат для использования в рамках SSL-транзакции. | |
| cloud | нет | Именованное облако для работы. Обеспечивает значения по умолчанию для auth и auth_type. Этот параметр не нужен, если предоставлен параметр auth или присутствуют переменные среды OpenStack OS_*. | ||
| detailed | нет | если true, возвращает дополнительные детали о серверах ценой дополнительных API-вызовов. | ||
| endpoint_type | нет | public |
| Тип URL-адреса конечной точки для извлечения из каталога служб. |
| key | нет | None | Путь к ключу клиента для использования в рамках SSL-транзакции. | |
| region_name | нет | Имя региона. | ||
| server | нет | None | Ограничить результаты серверами с именами или UUID, соответствующими этому выражению glob (например, C<web*>). | |
| timeout | нет | 180 | Сколько времени Ansible должен ждать запрошенного ресурса. | |
| validate_certs | нет | Необходимо ли проверять SSL API-запросы. До версии 2.3 по умолчанию было True. Псевдонимы: verify | ||
| wait | нет | yes |
| Должен ли Ansible ждать, пока запрошенный ресурс не будет завершен. |
Примеры
# Gather facts about all servers named C<web*>:
- os_server_facts:
cloud: rax-dfw
server: web*
- debug:
var: openstack_servers
Примечания
Примечание
- Этот модуль создаёт новый факт верхнего уровня
openstack_servers, который содержит список серверов. - Стандартные переменные среды 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_server_facts_module.html