os_ironic_node - Активация/деактивация ресурсов Bare Metal из OpenStack
Новое в версии 2.0.
Краткое описание
- Развертывание на узлах, управляемых Ironic.
Требования (к хосту, на котором выполняется модуль)
- python >= 2.7
- shade
Параметры
| параметр | обязательно | значение по умолчанию | возможные значения | комментарии | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| api_timeout | нет | None | Сколько времени должно ждать сокетное подключение перед таймаутом вызовов API. Если этот параметр опущен, он не будет передан в библиотеку запросов. | |||||||||||||||||||||
| auth | нет | Словарь, содержащий информацию об авторизации, необходимую стратегии плагина авторизации облака. Для плагина password он должен содержать auth_url, username, password, project_name и любую информацию о доменах, если облако ее поддерживает. Для других плагинов этот параметр должен содержать необходимые параметры. Этот параметр не нужен, если указано имя облака или присутствуют переменные среды OpenStack OS_*. | ||||||||||||||||||||||
| auth_type | нет | password | Имя плагина авторизации для использования. Если облако использует что-то помимо парольной авторизации, имя плагина должно быть указано здесь, а содержимое параметра auth должно быть соответствующим образом обновлено. | |||||||||||||||||||||
| availability_zone | нет | Игнорируется. Присутствует для обратной совместимости | ||||||||||||||||||||||
| cacert | нет | None | Путь к пакету сертификатов CA, который можно использовать для проверки запросов SSL API. | |||||||||||||||||||||
| cert | нет | None | Путь к клиенту сертификату для использования в рамках SSL-транзакции. | |||||||||||||||||||||
| cloud | нет | Имя облака для работы. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если указан auth или присутствуют переменные среды OpenStack OS_*. | ||||||||||||||||||||||
| config_drive | нет | None | Файл configdrive или HTTP(S) URL, который будет передан узлу. | |||||||||||||||||||||
| deploy | нет | True |
| Указывает, должен ли ресурс развертываться. Позволяет отключить логику развертывания и управлять состоянием питания или технического обслуживания узла. | ||||||||||||||||||||
| endpoint_type | нет | public |
| Тип URL конечной точки для получения из каталога сервисов. | ||||||||||||||||||||
| instance_info | нет | Определение информации об экземпляре, которая используется для развертывания узла. Эта информация требуется только тогда, когда экземпляр установлен как присутствующий. |
||||||||||||||||||||||
| ||||||||||||||||||||||||
| ironic_url | нет | None | Если используется режим noauth, этот параметр требуется и должен быть установлен на URL-адрес конечной точки Ironic API. Используйте вместе с параметрами "auth" и "auth_type", установленными в None. | |||||||||||||||||||||
| key | нет | None | Путь к клиентскому ключу для использования в рамках SSL-транзакции. | |||||||||||||||||||||
| maintenance | нет | Настройка для прямого управления, находится ли узел в режиме технического обслуживания. | ||||||||||||||||||||||
| maintenance_reason | нет | None | Строковое выражение, касающееся причины, по которой узел находится в режиме технического обслуживания. | |||||||||||||||||||||
| power | нет | present |
| Настройка для управления состоянием питания. Разрешает включение узлов, которые еще не развернуты, и отключение развернутых узлов. | ||||||||||||||||||||
| region_name | нет | Имя региона. | ||||||||||||||||||||||
| state | нет | present |
| Указывает желаемое состояние ресурса. | ||||||||||||||||||||
| timeout (добавлено в 2.1)
| нет | Целое число, представляющее количество секунд ожидания завершения активации или деактивации узла. | ||||||||||||||||||||||
| uuid | нет | None | Глобально уникальный идентификатор (UUID) для ресурса. | |||||||||||||||||||||
| validate_certs | нет | Выполнять ли проверку SSL-API запросов. До версии 2.3 по умолчанию равно True. алиасы: verify | ||||||||||||||||||||||
| wait (добавлено в 2.1)
| нет | Логическое значение, указывающее модулю подождать завершения активации или деактивации узла перед возвратом. | ||||||||||||||||||||||
Примеры
# 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
Примечания
Примечание
- Можно использовать стандартные переменные среды 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
Статус
Этот модуль помечен как preview, что означает, что он не гарантирует обратную совместимость интерфейса.
Для получения помощи в разработке модулей, если вас это интересует, пожалуйста, прочитайте Информацию о сообществе и участие, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/os_ironic_node_module.html
