Модуль openstack.cloud.baremetal_node_action — активация/деактивация узлов Bare Metal из OpenStack
Примечание
Этот модуль входит в коллекцию openstack.cloud (версия 2.5.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install openstack.cloud. Для использования этого модуля необходимы дополнительные требования; подробности см. в разделе Требования.
Чтобы использовать модуль в плейбуке, укажите: openstack.cloud.baremetal_node_action.
Краткое описание
- Развертывание на узлах Bare Metal под управлением Ironic.
Требования
Перечисленные ниже требования должны быть выполнены на хосте, на котором выполняется этот модуль.
- python >= 3.6
- openstacksdk >= 1.0.0
Параметры
Параметр | Комментарии |
|---|---|
api_timeout integer | Как долго уровень сокетов должен ожидать выполнения вызовов API до истечения времени ожидания. Если этот параметр не указан, библиотеке requests ничего не передается. |
auth dictionary | Словарь с данными аутентификации, необходимыми выбранному облачному плагину аутентификации. Для плагина password, используемого по умолчанию, здесь указываются auth_url, username, password, project_name и любые сведения о доменах (например, user_domain_name или project_domain_name), если облако их поддерживает. Для других плагинов этот параметр должен содержать все параметры, необходимые соответствующему плагину аутентификации. Этот параметр не требуется, если указано именованное облако или заданы переменные среды OpenStack OS_*. |
auth_type string | Имя используемого плагина аутентификации. Если облако использует не аутентификацию по паролю, здесь следует указать имя плагина и соответствующим образом изменить содержимое параметра auth. |
ca_cert псевдонимы: cacert string | Путь к пакету сертификатов центра сертификации, который можно использовать для проверки запросов к API по SSL. |
client_cert псевдонимы: cert string | Путь к клиентскому сертификату, используемому при SSL-соединении. |
client_key псевдонимы: key string | Путь к клиентскому ключу, используемому при SSL-соединении. |
cloud any | Именованное облако или конфигурация облака, с которыми нужно работать. Если cloud — строка, она задает ссылку на именованную конфигурацию облака из файла OpenStack clouds.yaml. Параметр задает значения по умолчанию для auth и auth_type. Этот параметр не требуется, если указан auth или заданы переменные среды OpenStack OS_*. Если cloud — словарь, он содержит полную конфигурацию облака, аналогичную разделу файла clouds.yaml. |
config_drive any | Файл configdrive или URL HTTP(S), который будет передан узлу. |
deploy boolean | Указывает, следует ли развернуть ресурс. Позволяет отключить логику развертывания и изменить состояние питания узла или режим обслуживания. Допустимые значения:
|
instance_info dictionary | Описание сведений об экземпляре, используемых для развертывания узла. Эти сведения необходимы только в том случае, если для state задано значение |
|
image_checksum string |
Контрольная сумма image_source. |
|
image_disk_format string |
Тип образа, запрошенного для развертывания. |
|
image_source string |
URL HTTP(S), по которому можно получить образ. |
interface псевдонимы: endpoint_type string | Тип URL конечной точки, получаемой из каталога служб. Допустимые значения:
|
maintenance boolean | Перевести узел в режим обслуживания. При изменении режима обслуживания узла состояние питания, задаваемое параметром power, не изменяется. Допустимые значения:
|
maintenance_reason string | Строка с указанием причины, по которой узел находится в режиме обслуживания. |
name псевдонимы: id, uuid string / обязательный | Имя или идентификатор узла Bare Metal. |
power string | Параметр для задания состояния питания: он позволяет включать еще не развернутые узлы и выключать развернутые. Значением power может быть Допустимые значения:
|
region_name string | Название региона. |
sdk_log_level string | Уровень ведения журнала OpenStackSDK Допустимые значения:
|
sdk_log_path string | Путь к файлу журнала OpenStackSDK. Если значение не указано, журнал не ведется. |
state string | Задает требуемое состояние ресурса. Значением state может быть Допустимые значения:
|
timeout integer | Количество секунд ожидания завершения активации или деактивации узла. По умолчанию: |
validate_certs псевдонимы: verify boolean | Следует ли проверять запросы к API по SSL. До Ansible 2.3 значением по умолчанию было Допустимые значения:
|
wait boolean | Должен ли Ansible ожидать завершения обработки запрошенного ресурса. Допустимые значения:
|
Примечания
Примечание
- Вместо явного указания значений можно использовать стандартные переменные среды OpenStack, например
OS_USERNAME. - Данные аутентификации обрабатываются openstacksdk. Это означает, что значения могут быть получены из файла конфигурации YAML /etc/ansible/openstack.yaml, /etc/openstack/clouds.yaml или ~/.config/openstack/clouds.yaml, затем из стандартных переменных среды и, наконец, из явно заданных параметров плейбука. Дополнительную информацию см. на странице https://docs.openstack.org/openstacksdk/
Примеры
# Activate a node by booting an image with a configdrive attached
- openstack.cloud.baremetal_node_action:
instance_info:
image_source: "http://192.168.1.1/deploy_image.img"
image_checksum: "356a6b55ecc511a20c33c946c4e678af"
image_disk_format: "qcow"
delegate_to: localhost
deploy: true
cloud: "openstack"
config_drive: "http://192.168.1.1/host-configdrive.iso"
maintenance: false
power: present
uuid: "d44666e1-35b3-4f6b-acb0-88ab7052da69"
state: present
# Activate a node by booting an image with a configdrive json object
- openstack.cloud.baremetal_node_action:
auth_type: None
auth:
endpoint: "http://192.168.1.1:6385/"
id: "d44666e1-35b3-4f6b-acb0-88ab7052da69"
config_drive:
meta_data:
hostname: node1
public_keys:
default: ssh-rsa AAA...BBB==
delegate_to: localhost
instance_info:
image_source: "http://192.168.1.1/deploy_image.img"
image_checksum: "356a6b55ecc511a20c33c946c4e678af"
image_disk_format: "qcow"
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/openstack/cloud/baremetal_node_action_module.html