os_ironic – Создание/удаление ресурсов Bare Metal из OpenStack
Обзор
- Создание или удаление узлов Ironic из OpenStack.
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- jsonpatch
- openstacksdk
- openstacksdk >= 0.12.0
- python >= 2.7
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| api_timeout целое число | Сколько времени в секундах должна ждать слои сокета, прежде чем истечёт время ожидания для вызовов API. Если этот параметр опущен, в библиотеку requests ничего не будет передано. | ||
| auth словарь | Словарь, содержащий информацию об авторизации, необходимую стратегии плагина авторизации облака. Для плагина по умолчанию password, он должен содержать auth_url, username, password, project_name и любую информацию о доменах (например, os_user_domain_name или os_project_domain_name), если облако их поддерживает. Для других плагинов этот параметр должен содержать параметры, необходимые для этого плагина авторизации. Этот параметр не нужен, если указано имя облака или присутствуют переменные окружения OpenStack OS_*. | ||
| auth_type строка | Имя плагина авторизации, который нужно использовать. Если облако использует что-то кроме парольной аутентификации, имя плагина должно быть указано здесь, а содержимое параметра auth должно быть соответствующим образом обновлено. | ||
| availability_zone - | Игнорируется. Присутствует для обратной совместимости | ||
| ca_cert строка | Путь к пакету CA Cert, который можно использовать для проверки запросов SSL API. псевдонимы: cacert | ||
| chassis_uuid - | Связать узел с предварительно определённым шасси. | ||
| client_cert строка | Путь к клиенту сертификата для использования в рамках транзакции SSL. псевдонимы: cert | ||
| client_key строка | Путь к ключу клиента для использования в рамках транзакции SSL. псевдонимы: key | ||
| 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 строка |
| Тип URL конечной точки для извлечения из каталога служб. псевдонимы: endpoint_type | |
| ironic_url - | Если используется режим noauth, этот параметр необходим для установки URL конечной точки API Ironic. Используйте с параметрами "auth" и "auth_type", установленных в None. | ||
| name - | уникальный идентификатор имени для ресурса. | ||
| nics - / обязательно | Список сетевых адаптеров, например, " - mac: aa:bb:cc:aa:bb:cc" | ||
| properties - | Определение физических характеристик этого сервера, используемых для планирования | ||
| capabilities - добавлен в 2.8 | По умолчанию: "" | специальные возможности узла, такие как boot_option, node_role и т. д. (см. https://docs.openstack.org/ironic/latest/install/advanced.html для получения дополнительной информации) | |
| cpu_arch - | По умолчанию: "x86_64" | Архитектура процессора (x86_64, i686, ...) | |
| cpus - | По умолчанию: 1 | Количество ядер процессора у этого компьютера | |
| disk_size - | По умолчанию: 1 | размер первого устройства хранения в этом компьютере (обычно /dev/sda), в ГБ | |
| ram - | По умолчанию: 1 | количество оперативной памяти этого компьютера, в МБ | |
| root_device - добавлен в 2.8 | По умолчанию: "" | Указания на устройство корневого диска для развертывания. (см. https://docs.openstack.org/ironic/latest/install/include/root-device-hints.html для разрешённых подсказок) | |
| region_name строка | Имя региона. | ||
| skip_update_of_driver_password булево |
| Разрешает коду, который утверждает изменения узлов, пропустить обновление, если изменение представляет собой единственную строку, состоящую из поля пароля. Начиная с Kilo, пароли по умолчанию всегда маскируются в запросах API, что означает, что логика в результате всегда пытается повторно утвердить поле пароля. | |
| state - |
| Указывает желаемое состояние ресурса | |
| timeout целое число | По умолчанию: 180 | Сколько времени Ansible должно ждать запрошенного ресурса. | |
| uuid - | глобально уникальный идентификатор (UUID), который будет присвоен ресурсу. Будет сгенерирован автоматически, если не указан, а имя указано. Определение UUID всегда будет иметь приоритет над значением имени. | ||
| validate_certs булево |
| Нужно ли проверять запросы SSL API. До Ansible 2.3 по умолчанию это было yes. псевдонимы: verify | |
| wait булево |
| Ansible должно ожидать, пока запрошенный ресурс будет завершён. | |
Примечания
Примечание
- Можно использовать стандартные переменные окружения OpenStack, такие как
OS_USERNAME, вместо явного указания значений. - Информация об авторизации обрабатывается модулем openstacksdk, что означает, что значения могут быть взяты из файла конфигурации yaml в /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, а затем из стандартных переменных среды, и, наконец, из явных параметров в задачах. Более подробную информацию можно найти на странице https://docs.openstack.org/openstacksdk/
Примеры
# 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
capabilities: "boot_option:local"
root_device:
wwn: "0x4000cca77fc4dba1"
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. [сообщество]
Авторы
- 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.9/modules/os_ironic_module.html
