openstack.cloud.baremetal_inspect – Явно запускает интроспекцию узла Baremetal в ironic.
Примечание
Этот плагин входит в коллекцию openstack.cloud (версия 1.2.1).
Для его установки используйте: ansible-galaxy collection install openstack.cloud.
Чтобы использовать его в книге задач, укажите: openstack.cloud.baremetal_inspect.
Обзор
- Запрашивает Ironic установить узел в состояние инспекции, чтобы собрать метаданные об узле. Эта команда может быть вне очереди или внутри очереди в зависимости от конфигурации драйвера ironic. Это возможно только для узлов в состояниях «управляемый» и «доступный».
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- 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-сертификатов, который можно использовать для проверки запросов API SSL. алиасы: cacert | |
| client_cert строка | Путь к клиенту сертификату для использования в рамках транзакции SSL. алиасы: cert | |
| client_key строка | Путь к ключу клиента для использования в рамках транзакции SSL. алиасы: key | |
| cloud необработанные данные | Именованное облако или конфигурация облака для работы. Если cloud является строкой, она ссылается на именованную конфигурацию облака, как определено в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если предоставлен auth или присутствуют переменные окружения OpenStack OS_* . Если cloud — словарь, он содержит полную конфигурацию облака, как в разделе clouds.yaml. | |
| interface строка |
| Тип URL конечной точки для извлечения из каталога сервисов. алиасы: endpoint_type |
| ironic_url строка | Если используется режим noauth, это требуется для задания URL конечной точки API Ironic. Используйте вместе с параметрами "auth" и "auth_type" со значением None. | |
| mac строка | уникальный MAC-адрес, используемый для идентификации хоста. | |
| name строка | уникальный идентификатор имени для идентификации хоста в Ironic. | |
| region_name строка | Имя региона. | |
| timeout целое число | Значение по умолчанию: 1200 | Время ожидания в секундах, чтобы позволить роли ждать завершения интроспекции узла, если wait установлено в True. |
| uuid строка | глобально уникальный идентификатор (UUID) для идентификации хоста. | |
| validate_certs логическое значение |
| Следует ли проверять запросы API SSL. До 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/
Примеры
# Invoke node inspection
- openstack.cloud.baremetal_inspect:
name: "testnode1"
Возвращаемые факты
Возвращаемые этим модулем факты добавляются/обновляются в фактах хоста hostvars и могут быть использованы по имени, как и любой другой факт хоста. Их не нужно регистрировать для использования.
| Факт | Возвращаемое значение | Описание |
|---|---|---|
| cpu_arch строка / элементы=строка | успех | Обнаруженный тип архитектуры процессора Пример: x86_64 |
| cpus строка / элементы=строка | успех | Количество ядер процессора, определенных в обновленных свойствах узла. Пример: 1 |
| local_gb строка / элементы=строка | успех | Общий размер локального дискового хранилища, как обновлено в свойствах узла. Пример: 10 |
| memory_mb строка / элементы=строка | успех | Количество памяти узла, как обновлено в свойствах узла Пример: 1024 |
Авторы
- Группа 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/baremetal_inspect_module.html
