openstack.cloud.baremetal_node_action – Активация/Деактивация ресурсов Bare Metal из OpenStack

Примечание

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

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

Чтобы использовать его в playbook, укажите: openstack.cloud.baremetal_node_action.

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

Описание

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

Требования

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

openstacksdk
openstacksdk >= 0.12.0
python >= 3.6

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
api_timeout целое число			Сколько времени должен ждать уровень сокетов перед истечением времени ожидания для API-запросов. Если этот параметр опущен, ничего не будет передано в библиотеку requests.
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 строка		URL HTTP(S), откуда можно получить образ.
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 строка		По умолчанию: "present"	Параметр для задания состояния питания, позволяющий включать узлы, которые еще не развернуты, и выключать развернутые узлы. power может быть `'present'`, `'absent'`, `'maintenance'` или `'off'`.
region_name строка			Название региона.
state строка		По умолчанию: "present"	Указывает желаемое состояние ресурса. state может быть `'present'`, `'absent'`, `'maintenance'` или `'off'`.
timeout целое число		По умолчанию: 1800	Целое число, представляющее количество секунд ожидания завершения активации или деактивации узла.
uuid строка			Уникальный идентификатор (UUID) ресурса.
validate_certs логическое значение		Варианты: нет ← да	Проверять ли SSL запросы к API. До Ansible 2.3 это по умолчанию было `yes`. псевдонимы: verify
wait логическое значение		Варианты: нет ← да	Логическое значение, указывающее модулю ждать завершения активации или деактивации узла перед возвратом.

Примечания

Примечание

Можно использовать стандартные переменные среды OpenStack, такие как OS_USERNAME, вместо явного указания значений.
Информация об авторизации управляется openstacksdk, что означает, что значения могут быть взяты из файла конфигурации yaml в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных среды, и, наконец, из явных параметров в playbooks. Более подробную информацию можно найти по адресу 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/baremetal_node_action_module.html