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, который может использоваться при проверке запросов API SSL.
cert -			Путь к клиенту сертификат для использования в рамках транзакции SSL.
cloud -			Имя облака или конфигурация облака для работы. Если 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 - добавлен в 2.3		Варианты: public ← internal admin	Тип URL конечной точки для извлечения из каталога служб. псевдонимы: endpoint_type
ironic_url -			Если используется режим noauth, необходимо установить этот параметр на URL конечной точки для API Ironic. Используется вместе с параметрами "auth" и "auth_type", установленными в None.
key -			Путь к ключу клиента для использования в рамках транзакции SSL.
maintenance boolean		Варианты: нет ← да	Настройка, позволяющая напрямую управлять режимом обслуживания узла.
maintenance_reason -			Строковое выражение относительно причины, по которой узел находится в режиме обслуживания.
power -		Варианты: present ← absent	Настройка, позволяющая указать состояние питания, что позволяет включать узлы, которые еще не развернуты, и отключать развернутые узлы.
region_name -			Название региона.
state -		Варианты: present ← absent	Указывает желаемое состояние ресурса.
timeout - добавлен в 2.1		Значение по умолчанию: 180	Целочисленное значение, представляющее количество секунд ожидания завершения активации или деактивации узла.
uuid -			Глобально уникальный идентификатор (UUID), который необходимо присвоить ресурсу.
verify boolean		Варианты: нет да	Требуется ли проверять запросы API SSL. До версии 2.3 по умолчанию это было True. псевдонимы: validate_certs
wait boolean добавлен в 2.1		Варианты: нет ← да	Булевое значение, которое инструктирует модуль ждать завершения активации или деактивации узла перед возвратом.

Примечания

Примечание

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

Статус

Этот модуль не гарантирует обратной совместимости интерфейса. [preview]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

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.7/modules/os_ironic_node_module.html