os_ironic_node - Активация/деактивация ресурсов Bare Metal из OpenStack
Новая в версии 2.0.
Описание
- Развертывание на узлах, управляемых Ironic.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.7
- openstacksdk
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| api_timeout | Сколько времени должна ждать сетевая сокет-слой, прежде чем истечёт время ожидания для API-запросов. Если это опущено, ничего не будет передано в библиотеку запросов. | ||
| 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 | Файл configdrive или URL HTTP(S), который будет передан узлу. | ||
| deploy bool |
| Указывает, следует ли развертывать ресурс. Позволяет отключить логику развертывания и управлять состоянием питания или технического обслуживания узла. | |
| instance_info | Определение информации об экземпляре, используемой для развертывания узла. Эта информация необходима только в том случае, когда экземпляр задан в виде «присутствующий». | ||
| image_source | URL HTTP(S), откуда можно извлечь образ. | ||
| image_checksum | Контрольная сумма image_source. | ||
| image_disk_format | Тип образа, который был запрошен для развертывания. | ||
| interface (добавлено в 2.3) |
| Тип URL конечной точки для извлечения из каталога сервисов. псевдонимы: endpoint_type | |
| ironic_url | Если используется режим noauth, это обязательный параметр, который устанавливает URL-адрес конечной точки для Ironic API. Используется вместе с параметрами "auth" и "auth_type", установленных в None. | ||
| key | Путь к клиенту ключ для использования в рамках SSL-транзакции. | ||
| maintenance bool |
| Настройка для прямого управления, если узел находится в режиме технического обслуживания. | |
| maintenance_reason | Строковое выражение относительно причины, по которой узел находится в режиме технического обслуживания. | ||
| power |
| Настройка для управления состоянием питания, позволяющая включать узлы, которые ещё не развернуты, и выключать развернутые узлы. | |
| region_name | Имя региона. | ||
| state |
| Указывает желаемое состояние ресурса | |
| timeout (добавлено в 2.1) | По умолчанию: 180 | Целочисленное значение, представляющее количество секунд ожидания завершения активации или деактивации узла. | |
| uuid | Глобально уникальный идентификатор (UUID), который будет присвоен ресурсу. | ||
| verify bool |
| Нужно ли проверять SSL API-запросы. До версии 2.3 это по умолчанию было True. псевдонимы: validate_certs | |
| wait bool (добавлено в 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
Статус
Этот модуль помечен как предварительный просмотр, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Подробнее см. Техническое обслуживание модулей и поддержка.
Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.
Автор
- 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.6/modules/os_ironic_node_module.html
