os_ironic_node — Активация/деактивация ресурсов Bare Metal из OpenStack
Новая версия с 2.0.
Обзор
- Развертывание на узлах, управляемых Ironic.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.7
- shade
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| 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. | ||
| config_drive | По умолчанию: None | Файл configdrive или URL HTTP(S), которые будут переданы узлу. | |
| deploy |
yes | Указывает, нужно ли развернуть ресурс. Позволяет отключить логику развертывания и управлять состоянием питания или технического обслуживания узла. | |
| instance_info | Определение информации об экземпляре, используемой для развертывания узла. Эта информация требуется только при указании экземпляра. | ||
| image_disk_format | Тип изображения, которое требуется развернуть. | ||
| image_source | URL HTTP(S), откуда можно получить изображение. | ||
| image_checksum | Контрольная сумма image_source. | ||
| interface (добавлено в 2.3) |
| Тип URL конечной точки для извлечения из каталога сервисов. псевдонимы: endpoint_type | |
| ironic_url | По умолчанию: None | Если используется режим noauth, это требуется для установки URL конечной точки для API Ironic. Используется с параметрами "auth" и "auth_type", установленных в None. | |
| key | Путь к ключу клиента для использования в рамках SSL-транзакции. | ||
| maintenance | По умолчанию: no | Настройка для прямого управления, если узел находится в режиме технического обслуживания. | |
| maintenance_reason | По умолчанию: None | Строковое выражение о причине нахождения узла в режиме технического обслуживания. | |
| power |
| Настройка для принудительного установления состояния питания, позволяющая включать узлы, которые ещё не развернуты, и выключать развернутые узлы. | |
| region_name | Имя региона. | ||
| state |
| Указывает желаемое состояние ресурса | |
| timeout (добавлено в 2.1) | По умолчанию: 180 | Целое значение, представляющее количество секунд, которое необходимо подождать для завершения активации или деактивации узла. | |
| uuid | По умолчанию: None | Уникальный глобальный идентификатор (UUID), который будет присвоен ресурсу. | |
| verify |
| Необходимо ли проверять SSL-API-запросы. До версии 2.3 по умолчанию было True. псевдонимы: validate_certs | |
| wait (добавлено в 2.1) |
| Булево значение, инструктирующее модуль дождаться завершения активации или деактивации узла перед возвратом. | |
Примечания
Примечание
- Можно использовать стандартные переменные окружения 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
Примеры
# Activate a node by booting an image with a configdrive attached
os_ironic_node:
cloud: "openstack"
uuid: "d44666e1-35b3-4f6b-acb0-88ab7052da69"
state: present
power: present
deploy: True
maintenance: False
config_drive: "http://192.168.1.1/host-configdrive.iso"
instance_info:
image_source: "http://192.168.1.1/deploy_image.img"
image_checksum: "356a6b55ecc511a20c33c946c4e678af"
image_disk_format: "qcow"
delegate_to: localhost
Статус
Этот модуль помечен как предварительный, что означает, что его интерфейс не гарантируется как обратной совместимый.
Автор
- Monty Taylor (@emonty)
Подсказка
Если вы заметили какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 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_node_module.html
