openstack.cloud.os_ironic_node – Активировать/Деактивировать ресурсы голого железа из OpenStack

Примечание

Этот плагин является частью коллекции openstack.cloud (версия 1.2.1).

Для его установки используйте: ansible-galaxy collection install openstack.cloud.

Чтобы использовать его в книге сценариев, укажите: openstack.cloud.os_ironic_node.

Описание
Требования
Параметры
Примечания
Примеры

Описание

Развертывание на узлах, управляемых Ironic.

Требования

Ниже приведены требования к хосту, на котором будет выполняться этот модуль.

openstacksdk
openstacksdk >= 0.12.0
python >= 3.6

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
api_timeout целое число			Сколько времени должно ждать программное обеспечение уровня сокета, прежде чем истечёт время ожидания для вызовов API. Если это значение опущено, ничего не будет передано библиотеке запросов.
auth словарь			Словарь, содержащий информацию об авторизации, необходимую стратегии подключаемого модуля авторизации облака. Для стандартного подключаемого модуля password он будет содержать auth_url, username, password, project_name и любую информацию о доменах (например, user_domain_name или project_domain_name), если облако их поддерживает. Для других подключаемых модулей этот параметр должен содержать необходимые параметры подключаемого модуля авторизации. Этот параметр не нужен, если указано имя облака или присутствуют переменные среды OpenStack OS_*.
auth_type строка			Имя подключаемого модуля авторизации для использования. Если облако использует что-то кроме парольной аутентификации, имя подключаемого модуля должно быть указано здесь, а содержимое параметра auth должно быть соответствующим образом обновлено.
availability_zone строка			Игнорируется. Присутствует для обратной совместимости
ca_cert строка			Путь к пакету сертификатов CA, который может использоваться для проверки запросов SSL API. псевдонимы: cacert
client_cert строка			Путь к клиенту сертификат для использования в рамках SSL транзакции. псевдонимы: cert
client_key строка			Путь к ключу клиента для использования в рамках SSL транзакции. псевдонимы: key
cloud сырые данные			Именованное облако или конфигурация облака для работы. Если cloud является строкой, она ссылается на именованную конфигурацию облака, как определено в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если указан auth или присутствуют переменные среды OpenStack OS_. Если cloud* является словарем, он содержит полную конфигурацию облака, как в разделе clouds.yaml.
config_drive сырые данные			Файл configdrive или URL HTTP(S), который будет передан узлу.
deploy строка		По умолчанию: "да"	Указывает, должен ли ресурс быть развернут. Позволяет отключить логику развертывания и управлять состоянием питания или технического обслуживания узла.
instance_info словарь			Определение информации об экземпляре, которая используется для развертывания узла. Эта информация требуется только тогда, когда экземпляр установлен как присутствующий.
	image_checksum строка		Контрольная сумма image_source.
	image_disk_format строка		Тип образа, который запрошено развернуть.
	image_source строка		HTTP(S) URL, откуда можно получить образ.
interface строка		Варианты: admin internal public ←	Тип URL конечной точки для извлечения из каталога сервисов. псевдонимы: endpoint_type
ironic_url строка			Если используется режим noauth, это требуется для указания URL конечной точки для API Ironic. Используется вместе с параметрами "auth" и "auth_type", установленными в None.
maintenance строка			Параметр для прямого управления, находится ли узел в режиме технического обслуживания. maintenance может быть `'yes'`, `'no'`, `'True'`, или `'False'`.
maintenance_reason строка			Строковое выражение относительно причины, по которой узел находится в режиме технического обслуживания.
name строка			Имя узла для создания.
power строка		По умолчанию: "наличие"	Параметр для управления состоянием питания, позволяющий включить узлы, которые ещё не развернуты, и выключить узлы, которые развернуты. power может быть `'present'`, `'absent'`, `'maintenance'` или `'off'`.
region_name строка			Имя региона.
state строка		По умолчанию: "наличие"	Указывает желаемое состояние ресурса. state может быть `'present'`, `'absent'`, `'maintenance'` или `'off'`.
timeout целое число		По умолчанию: 1800	Целое число, представляющее количество секунд ожидания завершения активации или деактивации узла.
uuid строка			Глобально уникальный идентификатор (UUID), который будет присвоен ресурсу.
validate_certs логическое значение		Варианты: нет ← да	Подтверждать ли запросы API SSL. До Ansible 2.3 это по умолчанию `yes`. псевдонимы: verify
wait логическое значение		Варианты: нет ← да	Логическое значение, которое указывает модулю ожидать завершения активации или деактивации узла перед возвратом.

Примечания

Примечание

Могут быть использованы стандартные переменные среды 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
- openstack.cloud.baremetal_node_action:
    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

# Activate a node by booting an image with a configdrive json object
- openstack.cloud.baremetal_node_action:
    uuid: "d44666e1-35b3-4f6b-acb0-88ab7052da69"
    auth_type: None
    ironic_url: "http://192.168.1.1:6385/"
    config_drive:
      meta_data:
        hostname: node1
        public_keys:
          default: ssh-rsa AAA...BBB==
    instance_info:
      image_source: "http://192.168.1.1/deploy_image.img"
      image_checksum: "356a6b55ecc511a20c33c946c4e678af"
      image_disk_format: "qcow"
    delegate_to: localhost

Авторы

OpenStack Ansible SIG

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/openstack/cloud/os_ironic_node_module.html