os_ironic - Создание/удаление ресурсов Bare Metal из OpenStack
Новая версия 2.0.
Описание
- Создание или удаление узлов Ironic из OpenStack.
Требования (к хосту, на котором выполняется модуль)
- jsonpatch
- python >= 2.7
- shade
Параметры
| параметр | обязателен | значение по умолчанию | значения | комментарии | |||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| api_timeout | нет | None | Сколько времени должен ждать слой сокетов перед истечением времени ожидания для API-запросов. Если этот параметр опущен, ничего не будет передано в библиотеку запросов. | ||||||||||||||||||||||||||
| auth | нет | Словарь, содержащий информацию об авторизации, необходимую стратегии плагина авторизации облака. Для стандартного плагина password, он будет содержать auth_url, username, password, project_name и любую информацию о домене, если облако её поддерживает. Для других плагинов, этот параметр должен содержать параметры, требуемые данным плагином авторизации. Этот параметр не нужен, если указано имя облака или присутствуют переменные окружения OpenStack OS_*. | |||||||||||||||||||||||||||
| auth_type | нет | password | Имя плагина авторизации для использования. Если облако использует что-то кроме парольной аутентификации, здесь следует указать имя плагина, а содержимое параметра auth следует обновить соответствующим образом. | ||||||||||||||||||||||||||
| availability_zone | нет | Игнорируется. Присутствует для обратной совместимости | |||||||||||||||||||||||||||
| cacert | нет | None | Путь к пакету сертификатов CA, который может использоваться для проверки SSL API-запросов. | ||||||||||||||||||||||||||
| cert | нет | None | Путь к клиенту сертификату для использования в рамках SSL транзакции. | ||||||||||||||||||||||||||
| chassis_uuid | нет | None | Связать узел с предварительно определённым шасси. | ||||||||||||||||||||||||||
| cloud | нет | Имя облака для работы. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если указан auth или присутствуют переменные окружения OpenStack OS_*. | |||||||||||||||||||||||||||
| driver | да | None | Имя драйвера Ironic для использования с этим узлом. | ||||||||||||||||||||||||||
| driver_info | нет | Информация для драйвера этого сервера. Будет различаться в зависимости от используемого драйвера. Любое заполненное подполе будет валидировано при создании. |
|||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
| endpoint_type | нет | public |
| Тип URL конечной точки для извлечения из каталога служб. | |||||||||||||||||||||||||
| ironic_url | нет | None | Если используется режим noauth, это требуется для установки URL конечной точки для Ironic API. Используется с параметрами "auth" и "auth_type", установленным в None. | ||||||||||||||||||||||||||
| key | нет | None | Путь к клиенту ключу для использования в рамках SSL транзакции. | ||||||||||||||||||||||||||
| name | нет | None | Уникальный идентификатор имени, который будет присвоен ресурсу. | ||||||||||||||||||||||||||
| nics | да | Список сетевых интерфейсов, например, " - mac: aa:bb:cc:aa:bb:cc" | |||||||||||||||||||||||||||
| properties | нет | Описание физических характеристик этого сервера, используемых для планирования. |
|||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||
| region_name | нет | Имя региона. | |||||||||||||||||||||||||||
| skip_update_of_driver_password | нет | Позволяет коду, который бы утверждал изменения в узлах, пропустить обновление, если изменение представляет собой единственную строку, содержащую поле пароля. Начиная с версии Kilo, по умолчанию пароли всегда маскируются для API-запросов, что означает, что логика всегда пытается повторно установить поле пароля. | |||||||||||||||||||||||||||
| state | нет | present |
| Указывает желаемое состояние ресурса. | |||||||||||||||||||||||||
| timeout | нет | 180 | Сколько времени Ansible должен ждать завершения запрошенного ресурса. | ||||||||||||||||||||||||||
| uuid | нет | None | Уникальный глобальный идентификатор (UUID), который будет присвоен ресурсу. Будет сгенерирован автоматически, если не указан, и указано имя. Определение UUID всегда будет иметь приоритет над значением имени. | ||||||||||||||||||||||||||
| validate_certs | нет | Следует ли проверять API-запросы SSL. До версии 2.3 по умолчанию было True. псевдонимы: verify | |||||||||||||||||||||||||||
| wait | нет | yes |
| Следует ли Ansible ждать, пока запрошенный ресурс завершит работу. | |||||||||||||||||||||||||
Примеры
# 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"
Примечания
Примечание
- Стандартные переменные окружения 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
Статус
Этот модуль помечен как экспериментальный, что означает, что интерфейс не гарантируется как обратная совместимость.
Для помощи в разработке модулей, если вы заинтересованы, пожалуйста, прочтите Информацию о сообществе и содействие, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/os_ironic_module.html
