os_ironic_inspect - Явно запускает интроспекцию узла baremetal в ironic.
Новое в версии 2.1.
Сводка
- Запрашивает от Ironic установить узел в состояние инспекции для сбора метаданных об узле. Эта команда может быть вне очереди или в очереди, в зависимости от конфигурации драйвера ironic. Это возможно только для узлов в состоянии «управляемый» и «доступный».
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.7
- shade
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_timeout | Сколько времени слой сокетов должен ждать перед истечением времени ожидания для вызовов API. Если это опущено, ничего не будет передано библиотеке запросов. | |
| auth | Словарь, содержащий информацию об авторизации, необходимую стратегии подключаемого модуля проверки подлинности облака. Для стандартного подключаемого модуля password, он должен содержать auth_url, username, password, project_name и любую информацию о доменах, если облако их поддерживает. Для других подключаемых модулей, этот параметр должен содержать необходимые параметры подключаемого модуля проверки подлинности. Этот параметр не требуется, если указано имя облака или присутствуют переменные среды OpenStack OS_*. | |
| auth_type | Имя подключаемого модуля проверки подлинности для использования. Если облако использует что-то кроме аутентификации по паролю, имя подключаемого модуля должно быть указано здесь, и содержимое параметра auth должно быть соответствующим образом обновлено. | |
| availability_zone | Игнорируется. Присутствует для обратной совместимости | |
| cacert | Путь к пакету сертификата CA, который может использоваться в качестве части проверки запросов API SSL. | |
| cert | Путь к клиенту сертификата для использования в рамках транзакции SSL. | |
| cloud | Имя облака или конфигурация облака для работы с ним. Если cloud — строка, она ссылается на конфигурацию облака с именем, определённую в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не требуется, если указан auth или присутствуют переменные среды OpenStack OS_*. Если cloud — словарь, он содержит полную конфигурацию облака, как в разделе clouds.yaml. | |
| interface (добавлен в 2.3) |
| Тип URL конечной точки для извлечения из каталога сервисов. псевдонимы: endpoint_type |
| ironic_url | Значение по умолчанию: None | Если используется режим noauth, необходимо установить это значение на URL конечной точки для API Ironic. Используйте вместе с настройками «auth» и «auth_type», установленными в None. |
| key | Путь к клиентскому ключу для использования в рамках транзакции SSL. | |
| mac | Значение по умолчанию: None | уникальный MAC-адрес, используемый для попытки идентификации хоста. |
| name | Значение по умолчанию: None | уникальный идентификатор имени для идентификации хоста в Ironic. |
| region_name | Имя региона. | |
| timeout | Значение по умолчанию: 1200 | Время ожидания в секундах для того, чтобы роль ждала завершения интроспекции узла, если wait установлен в True. |
| uuid | Значение по умолчанию: None | уникальный глобальный идентификатор (UUID) для идентификации хоста. |
| verify |
| Должны ли запросы API SSL проверяться. До версии 2.3 по умолчанию было True. псевдонимы: validate_certs |
| wait |
| Должен ли Ansible ждать, пока запрашиваемый ресурс будет завершён. |
Примечания
Примечание
- Стандартные переменные окружения OpenStack, такие как
OS_USERNAMEмогут быть использованы вместо явного указания значений. - Информация об авторизации управляется os-client-config, что означает, что значения могут поступать из файла конфигурации yaml в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, а затем из стандартных переменных окружения, а затем из явных параметров в plays. Более подробная информация доступна по адресу 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 |
Статус
Этот модуль помечен как предварительный просмотр, что означает, что он не гарантирует обратную совместимость интерфейса.
Автор
- Юлия Крегер (@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.5/modules/os_ironic_inspect_module.html
