os_ironic_inspect – Явно запускает интроспекцию узла baremetal в ironic
Новая версия 2.1.
Обзор
- Запрашивает у Ironic установить узел в состояние инспекции для сбора метаданных об узле. Эта команда может быть вне очереди или в очереди в зависимости от конфигурации драйвера ironic. Это возможно только для узлов в состоянии «управляемый» и «доступный».
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- openstacksdk
- python >= 2.7
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| api_timeout целое число | Сколько времени слой сокетов должен ждать перед истечением времени ожидания для вызовов API. Если это опущено, ничего не будет передано в библиотеку запросов. | |
| auth словарь | Словарь, содержащий информацию об авторизации, необходимую стратегии плагина авторизации облака. Для плагина по умолчанию password, он будет содержать auth_url, username, password, project_name и любую информацию о доменах (например, os_user_domain_name или os_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 строка добавлен в 2.3 |
| Тип 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 |
| Ожидание boolean |
| Должен ли 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
- os_ironic_inspect:
name: "testnode1"
Возвращаемые Факты
Возвращаемые фактами модуля добавляются/обновляются в фактах хоста hostvars и могут быть использованы по имени, как и любые другие факты хоста. Их не нужно регистрировать для использования.
| Факт | Возвращаемое значение | Описание |
|---|---|---|
| cpu_arch строка | Обнаруженный тип архитектуры процессора Пример: x86_64 | |
| cpus строка | Количество ядер процессора, определённых в обновлённых свойствах узла. Пример: 1 | |
| local_gb строка | Общий размер локального дискового хранилища, как обновлённый в свойствах узла. Пример: 10 | |
| memory_mb строка | Объём памяти узла, как обновлённый в свойствах узла Пример: 1024 |
Статус
- Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Юлия Крегер (@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.8/modules/os_ironic_inspect_module.html
