Модуль openstack.cloud.compute_service_info — получение служб OpenStack Compute (Nova)

Примечание

Этот модуль входит в коллекцию openstack.cloud (версия 2.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните команду ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install openstack.cloud. Для работы с этим модулем необходимы дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: openstack.cloud.compute_service_info.

Краткое описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Получение списка служб OpenStack Compute (Nova).

Требования

На узле, выполняющем этот модуль, должны быть установлены следующие компоненты.

python >= 3.6
openstacksdk >= 1.0.0

Параметры

Параметр	Комментарии
api_timeout integer	Время ожидания уровня сокетов перед истечением времени ожидания вызовов API. Если параметр не задан, в библиотеку requests ничего не передаётся.
auth dictionary	Словарь с данными аутентификации, необходимыми для используемой облаком стратегии плагина аутентификации. Для стандартного плагина password здесь должны быть указаны auth_url, username, password, project_name и сведения о доменах (например, user_domain_name или project_domain_name), если облако их поддерживает. Для других плагинов этот параметр должен содержать все параметры, необходимые соответствующему плагину аутентификации. Этот параметр не требуется, если указано имя облака или присутствуют переменные окружения OpenStack OS_*.
auth_type string	Имя используемого плагина аутентификации. Если облако использует способ аутентификации, отличный от аутентификации по паролю, укажите здесь имя плагина и соответствующим образом измените содержимое параметра auth.
binary string	Фильтрация результатов списка служб по имени исполняемого файла службы.
ca_cert псевдонимы: cacert string	Путь к пакету сертификатов CA, который можно использовать для проверки запросов SSL API.
client_cert псевдонимы: cert string	Путь к клиентскому сертификату, используемому при SSL-соединении.
client_key псевдонимы: key string	Путь к клиентскому ключу, используемому при SSL-соединении.
cloud any	Именованное облако или конфигурация облака, с которыми выполняются операции. Если значение cloud — строка, она указывает на конфигурацию именованного облака, определённую в файле OpenStack clouds.yaml. Параметр задаёт значения по умолчанию для auth и auth_type. Этот параметр не требуется, если указан auth или присутствуют переменные окружения OpenStack OS_. Если значение cloud* — словарь, он содержит полную конфигурацию облака, аналогичную разделу файла clouds.yaml.
host string	Фильтрация результатов списка служб по имени узла.
interface псевдонимы: endpoint_type string	Тип URL конечной точки, получаемой из каталога служб. Варианты: `"admin"` `"internal"` `"public"` ← (по умолчанию)
region_name string	Имя региона.
sdk_log_level string	Уровень ведения журнала OpenStackSDK Варианты: `"INFO"` ← (по умолчанию) `"DEBUG"`
sdk_log_path string	Путь к файлу журнала OpenStackSDK. Если значение пустое, журнал не записывается.
timeout integer	Время ожидания ansible запрошенного ресурса. По умолчанию: `180`
validate_certs псевдонимы: verify boolean	Следует ли проверять запросы SSL API. До Ansible 2.3 значение по умолчанию было `true`. Варианты: `false` `true`
wait boolean	Должен ли ansible ожидать завершения операции с запрошенным ресурсом. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Вместо явного указания значений можно использовать стандартные переменные окружения OpenStack, например OS_USERNAME.
Данные аутентификации обрабатываются openstacksdk. Это означает, что значения могут поступать из YAML-файла конфигурации /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных окружения и, наконец, из явных параметров плейбука. Дополнительные сведения см. на странице https://docs.openstack.org/openstacksdk/

Примеры

- name: Fetch all OpenStack Compute (Nova) services
  openstack.cloud.compute_service_info:
    cloud: awesomecloud

- name: Fetch a subset of OpenStack Compute (Nova) services
  openstack.cloud.compute_service_info:
    cloud: awesomecloud
    binary: "nova-compute"
    host: "localhost"

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
compute_services list / элементы=dictionary	Список словарей с описаниями служб Compute (Nova). Возвращается: всегда
availability_zone string	Имя зоны доступности. Возвращается: при успешном выполнении
binary string	Имя исполняемого файла службы. Возвращается: при успешном выполнении
disabled_reason string	Причина отключения службы Возвращается: при успешном выполнении
host string	Имя узла. Возвращается: при успешном выполнении
id string	Уникальный UUID. Возвращается: при успешном выполнении
is_forced_down boolean	Принудительно ли остановлена служба или nova-compute Возвращается: при успешном выполнении
name string	Имя службы Возвращается: при успешном выполнении
state string	Состояние службы: up или down. Возвращается: при успешном выполнении
status string	Статус службы: enabled или disabled. Возвращается: при успешном выполнении
update_at string	Дата и время обновления ресурса Возвращается: при успешном выполнении

Авторы

OpenStack Ansible SIG

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/openstack/cloud/compute_service_info_module.html