os_ironic – Создание/удаление ресурсов Bare Metal из OpenStack

Новая версия с 2.0.

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

Обзор

Создание или удаление узлов Ironic из OpenStack.

Требования

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

jsonpatch
openstacksdk
python >= 2.7

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
api_timeout -			Сколько времени должна ждать сокетная прослойка перед таймаутом вызовов API. Если этот параметр опущен, ничего не будет передано в библиотеку requests.
auth -			Словарь, содержащий информацию об авторизации, необходимую стратегии плагина авторизации облака. Для плагина password по умолчанию, он будет содержать auth_url, username, password, project_name и любую информацию о доменах, если облако их поддерживает. Для других плагинов этот параметр должен содержать требуемые параметры плагина авторизации. Этот параметр не нужен, если предоставлено имя облака или присутствуют переменные окружения OpenStack OS_*.
auth_type -			Имя плагина авторизации для использования. Если облако использует что-то кроме парольной аутентификации, имя плагина должно быть указано здесь, а содержимое параметра auth должно быть соответствующим образом обновлено.
availability_zone -			Игнорируется. Присутствует для обратной совместимости
cacert -			Путь к пакету CA Cert, который может использоваться для проверки запросов API SSL.
cert -			Путь к клиенту сертификату для использования в ходе SSL транзакции.
chassis_uuid -			Связывает узел с предварительно определённым шасси.
cloud -			Именованное облако или конфигурация облака для работы. Если cloud является строкой, она ссылается на именованную конфигурацию облака, определённую в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если предоставлен auth или присутствуют переменные окружения OpenStack OS_* . Если cloud является словарем, он содержит полную конфигурацию облака, как в разделе clouds.yaml.
driver - / обязательно			Имя драйвера Ironic для использования с этим узлом.
driver_info -			Информация для драйвера этого сервера. Будет отличаться в зависимости от используемого драйвера. Любой подполе, который заполнен, будет проверен во время создания.
	console -		Информация, необходимая для подключения к последовательному консоли этого сервера. Не все драйверы поддерживают это.
	deploy -		Информация, необходимая для непосредственного развертывания этого сервера без использования Nova. ЭТО НЕ РЕКОМЕНДУЕТСЯ.
	management - / обязательно		Информация, необходимая для взаимодействия с интерфейсом управления этим сервером. Может быть совмещена с power_info в некоторых случаях.
	power - / обязательно		Информация, необходимая для включения/выключения этого сервера. Часто включает такие вещи, как имя пользователя IPMI, пароль и IP-адрес.
interface - добавлено в 2.3		Варианты: public ← internal admin	Тип URL конечной точки для извлечения из каталога служб. псевдонимы: endpoint_type
ironic_url -			Если используется режим noauth, это необходимо установить на URL конечной точки для API Ironic. Используйте с параметрами "auth" и "auth_type", установленными в None.
key -			Путь к ключу клиента для использования в рамках SSL транзакции.
name -			Уникальный идентификатор имени для ресурса.
nics - / обязательно			Список сетевых интерфейсов, например, " - mac: aa:bb:cc:aa:bb:cc"
properties -			Определение физических характеристик этого сервера, используемых для планирования.
	cpu_arch -	По умолчанию: "x86_64"	Архитектура процессора (x86_64, i686, ...)
	cpus -	По умолчанию: 1	Количество ядер процессора у этой машины.
	disk_size -	По умолчанию: 1	размер первого хранилища в этой машине (обычно /dev/sda), в ГБ
	ram -	По умолчанию: 1	объём ОЗУ этой машины, в МБ
region_name -			Имя региона.
skip_update_of_driver_password boolean		Варианты: no ← yes	Позволяет коду, который подтверждает изменения в узлах, пропустить обновление, если изменение - это строка, состоящая из поля пароля. Начиная с Kilo, по умолчанию пароли всегда маскируются в запросах API, что означает, что логика в результате всегда пытается повторно подтвердить поле пароля.
state -		Варианты: present ← absent	Указывает желаемое состояние ресурса
timeout -		По умолчанию: 180	Сколько времени Ansible должен ждать запрошенного ресурса.
uuid -			Универсальный уникальный идентификатор (UUID) для ресурса. Будет сгенерирован автоматически, если не указан, а имя указано. Определение UUID всегда будет иметь приоритет над значением имени.
verify boolean		Варианты: no yes	Должны ли запросы API SSL проверяться. До версии 2.3 по умолчанию было True. псевдонимы: validate_certs
wait boolean		Варианты: no yes ←	Должен ли Ansible ждать завершения запрошенного ресурса.

Примечания

Примечание

Стандартные переменные окружения 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

Примеры

# Enroll a node with some basic properties and driver info
- os_ironic:
    cloud: "devstack"
    driver: "pxe_ipmitool"
    uuid: "00000000-0000-0000-0000-000000000002"
    properties:
      cpus: 2
      cpu_arch: "x86_64"
      ram: 8192
      disk_size: 64
    nics:
      - mac: "aa:bb:cc:aa:bb:cc"
      - mac: "dd:ee:ff:dd:ee:ff"
    driver_info:
      power:
        ipmi_address: "1.2.3.4"
        ipmi_username: "admin"
        ipmi_password: "adminpass"
    chassis_uuid: "00000000-0000-0000-0000-000000000001"

Статус

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

Авторы

Монти Тейлор (@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_module.html