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, который может использоваться для проверки запросов API SSL. | ||
| cert | Путь к клиенту сертификат для использования в рамках SSL-транзакции. | ||
| chassis_uuid | Связать узел с предварительно определённым шасси. | ||
| cloud | Именованное облако или конфигурация облака для работы. Если cloud — строка, она ссылается на именованную конфигурацию облака, определённую в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если указан auth или присутствуют переменные окружения OpenStack OS_*. Если cloud — словарь, он содержит полную конфигурацию облака, как в разделе clouds.yaml. | ||
| driver обязательно | Имя Ironic драйвера, которое нужно использовать с этим узлом. | ||
| driver_info | Информация для драйвера данного сервера. Будет меняться в зависимости от используемого драйвера. Любой подпольный элемент, который заполнен, будет проверен во время создания. | ||
| power обязательно | Информация, необходимая для включения/выключения этого сервера. Часто включает имя пользователя IPMI, пароль и IP-адрес. | ||
| deploy | Информация, необходимая для непосредственного развертывания этого сервера без использования Nova. ЭТО НЕ РЕКОМЕНДУЕТСЯ. | ||
| console | Информация, необходимая для подключения к последовательному консоли этого сервера. Не все драйвера поддерживают это. | ||
| management обязательно | Информация, необходимая для взаимодействия с интерфейсом управления этого сервера. В некоторых случаях может совместно использоваться с power_info. | ||
| interface (добавлено в 2.3) |
| Тип 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 | Количество ядер процессора в этом компьютере. | |
| ram | Значение по умолчанию: 1 | Объём оперативной памяти этого компьютера в МБ. | |
| disk_size | Значение по умолчанию: 1 | Размер первого устройства хранения в этом компьютере (обычно /dev/sda) в ГБ. | |
| region_name | Название региона. | ||
| skip_update_of_driver_password bool |
| Позволяет коду, который выполняет утверждения изменений узлов, пропустить обновление, если изменение — это единственная строка, содержащая поле пароля. Начиная с Kilo, пароли по умолчанию всегда маскируются в запросах API, что означает, что логика всегда пытается повторно утвердить поле пароля. | |
| state |
| Указывает желаемое состояние ресурса. | |
| timeout | Значение по умолчанию: 180 | Время ожидания Ansible для завершения запрошенного ресурса. | |
| uuid | Уникальный глобальный идентификатор (UUID), который нужно присвоить ресурсу. Будет автоматически сгенерирован, если не указан, а указано имя. Определение UUID всегда будет иметь приоритет над значением имени. | ||
| verify bool |
| Указывает, нужно ли проверять запросы API SSL. До версии 2.3 значение по умолчанию было True. алиасы: validate_certs | |
| wait bool |
| Должен ли 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. См. Поддержка и техническое обслуживание модулей для получения дополнительной информации.
Список других модулей, поддерживаемых сообществом 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.6/modules/os_ironic_module.html
