os_ironic_node – Активация/Деактивация ресурсов Bare Metal из OpenStack
Новое в версии 2.0.
Краткое описание
- Развертывание на узлах, управляемых Ironic.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.7
- openstacksdk
Параметры
| Parameter | Choices/Defaults | Comments | |
|---|---|---|---|
| api_timeout integer | Сколько времени должен ждать сокетный слой перед истечением времени ожидания для вызовов API. Если это пропущено, ничего не будет передано в библиотеку запросов. | ||
| auth dictionary | Словарь, содержащий информацию об аутентификации, необходимую для стратегии плагина аутентификации облака. Для плагина password по умолчанию это будет содержать auth_url, username, password, project_name и любую информацию о доменах (например, os_user_domain_name или os_project_domain_name), если облако их поддерживает. Для других плагинов этот параметр должен содержать все параметры, необходимые этому плагину аутентификации. Этот параметр не нужен, если указано имя облака или присутствуют переменные окружения OpenStack OS_*. | ||
| auth_type string | Имя используемого плагина аутентификации. Если облако использует что-то другое, кроме парольной аутентификации, имя плагина должно быть указано здесь, а содержимое параметра auth должно быть обновлено соответствующим образом. | ||
| availability_zone - | Игнорируется. Присутствует для обратной совместимости | ||
| ca_cert string | Путь к пакету сертификатов CA, который может использоваться в качестве части проверки запросов API SSL. псевдонимы: cacert | ||
| client_cert string | Путь к клиентскому сертификату, используемому в рамках транзакции SSL. псевдонимы: cert | ||
| client_key string | Путь к клиентскому ключу, используемому в рамках транзакции SSL. псевдонимы: key | ||
| cloud raw | Именованное облако или конфигурация облака для работы. Если cloud — это строка, она ссылается на именованную конфигурацию облака, как определено в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если указан auth или если присутствуют переменные окружения OpenStack OS_*. Если cloud — это словарь, он содержит полную конфигурацию облака, как в разделе clouds.yaml. | ||
| config_drive - | Файл configdrive или URL HTTP(S), который будет передан узлу. | ||
| deploy boolean |
| Указывает, следует ли развертывать ресурс. Позволяет отключить логику развертывания и изменить состояние питания или обслуживания узла. | |
| instance_info - | Определение информации об экземпляре, которая используется для развертывания узла. Эта информация необходима только тогда, когда экземпляр установлен как присутствующий. | ||
| image_checksum - | Контрольная сумма image_source. | ||
| image_disk_format - | Тип образа, который был запрошен для развертывания. | ||
| image_source - | URL HTTP(S), по которому можно получить образ. | ||
| interface string добавлено в 2.3 |
| Тип URL конечной точки для получения из каталога служб. псевдонимы: endpoint_type | |
| ironic_url - | Если используется режим noauth, это необходимо установить в URL конечной точки для API Ironic. Используйте с настройками "auth" и "auth_type", установленными в None. | ||
| maintenance boolean |
| Настройка для разрешения прямого управления тем, находится ли узел в режиме обслуживания. | |
| maintenance_reason - | Строковое выражение, касающееся причины, по которой узел находится в режиме обслуживания. | ||
| power - |
| Настройка для разрешения установки состояния питания, позволяющая включать узлы, которые еще не развернуты, и выключать узлы, которые развернуты. | |
| region_name string | Имя региона. | ||
| state - |
| Указывает желаемое состояние ресурса | |
| timeout integer добавлено в 2.1 | По умолчанию: 180 | Целочисленное значение, представляющее количество секунд ожидания завершения активации или деактивации узла. | |
| uuid - | Универсальный уникальный идентификатор (UUID), который будет присвоен ресурсу. | ||
| validate_certs boolean |
| Следует ли проверять запросы API SSL. До Ansible 2.3 это значение по умолчанию было yes.псевдонимы: verify | |
| wait boolean добавлено в 2.1 |
| Булево значение, указывающее модулю ожидать завершения активации или деактивации узла перед возвратом. | |
Примечания
Примечание
- Вместо предоставления явных значений могут использоваться стандартные переменные среды OpenStack, такие как
OS_USERNAME. - Информация об аутентификации управляется openstacksdk, а это значит, что значения могут поступать из файла конфигурации yaml в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных среды, а затем, наконец, из явных параметров в пьесах. Дополнительную информацию можно найти по адресу https://docs.openstack.org/openstacksdk/
Примеры
# 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. [сообщество]
Авторы
- 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.8/modules/os_ironic_node_module.html