os_ironic_inspect - Явно запускает интроспекцию узла baremetal в ironic.
Новая в версии 2.1.
Обзор
- Запрашивает от Ironic установить узел в состояние интроспекции, чтобы собрать метаданные об узле. Эта команда может быть вне очереди или в очереди в зависимости от конфигурации драйвера ironic. Это возможно только для узлов в состоянии «управляемый» и «доступный».
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- 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. | |
| interface (добавлено в 2.3) |
| Тип URL-адреса конечной точки для извлечения из каталога служб. Псевдонимы: endpoint_type |
| ironic_url | Если используется режим noauth, этот параметр необходим для указания URL-адреса конечной точки для API Ironic. Используйте его со значениями "auth" и "auth_type", установленными в None. | |
| key | Путь к ключу клиента для использования в рамках транзакции SSL. | |
| mac | уникальный MAC-адрес, используемый для попытки идентификации хоста. | |
| name | уникальный идентификатор имени для идентификации хоста в Ironic. | |
| region_name | Имя региона. | |
| timeout | По умолчанию: 1200 | Время ожидания в секундах для ожидания выполнения роли до завершения интроспекции узла, если wait установлено в True. |
| uuid | глобально уникальный идентификатор (UUID) для идентификации хоста. | |
| verify bool |
| Нужно ли проверять SSL-API-запросы. До версии 2.3 значение по умолчанию составляло True. Псевдонимы: validate_certs |
| wait bool |
| Должен ли Ansible ждать, пока запрашиваемый ресурс не завершит свою работу. |
Примечания
Примечание
- Можно использовать стандартные переменные среды 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
Примеры
# Invoke node inspection
- os_ironic_inspect:
name: "testnode1"
Возвращаемые факты
Возвращаемые этим модулем факты добавляются/обновляются в фактах хоста hostvars и могут быть обработаны по имени, как и любые другие факты хоста. Для использования их не нужно регистрировать.
| Факт | Возвращаемое | Описание |
|---|---|---|
| cpu_arch строка | Обнаруженный тип архитектуры процессора Пример: x86_64 | |
| cpus строка | Количество ядер процессора, определенных в обновленных свойствах узла. Пример: 1 | |
| local_gb строка | Общий размер локального дискового хранилища, как обновлено в свойствах узла. Пример: 10 | |
| memory_mb строка | Объем памяти узла, как обновлено в свойствах узла Пример: 1024 |
Статус
Этот модуль помечен как превью, что означает, что интерфейс не гарантируется как обратный.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что его поддерживает сообщество Ansible. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- Юлия Крегер (@juliakreger)
Подсказка
Если вы обнаружите какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/os_ironic_inspect_module.html