os_server_facts – Извлечение фактов о виртуальных серверах
Новая версия 2.0.
Описание
- Извлечение фактов о виртуальных серверах из 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. | |
| detailed boolean |
| если true, возвращаются дополнительные детали о серверах за счет дополнительных API-вызовов. |
| interface - добавлено в 2.3 |
| Тип URL конечной точки для извлечения из каталога служб. псевдонимы: endpoint_type |
| key - | Путь к клиентскому ключу для использования в рамках транзакции SSL. | |
| region_name - | Имя региона. | |
| server - | ограничить результаты серверами с именами или UUID, соответствующими этому выражению glob (например, <web*>). | |
| timeout - | По умолчанию: 180 | Сколько времени Ansible должен ждать запрошенного ресурса. |
| verify boolean |
| Нужно ли проверять запросы API SSL. До версии 2.3 по умолчанию это было True. псевдонимы: validate_certs |
| wait boolean |
| Должен ли Ansible ждать, пока запрошенный ресурс не будет завершен. |
Примечания
Примечание
- Этот модуль создает новый факт верхнего уровня
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
Примеры
# Gather facts about all servers named <web*>:
- os_server_facts:
cloud: rax-dfw
server: web*
- debug:
var: openstack_servers
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Monty
Подсказка
Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.7/modules/os_server_facts_module.html
