Модуль openstack.cloud.baremetal_node_action — Активация/деактивация узлов баре-метала из OpenStack

Примечание

Этот модуль входит в коллекцию openstack.cloud (версия 2.2.0).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install openstack.cloud. Для использования этого модуля необходимы дополнительные требования, см. Требования для подробностей.

Для использования в плейбуке укажите: openstack.cloud.baremetal_node_action.

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

Описание

Развертывание на узлах баре-метала, управляемых Ironic.

Требования

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

python >= 3.6
openstacksdk >= 1.0.0

END_OF_DOCUMENT_MARKER

Параметры

Параметр	Комментарии
api_timeout целое число	Сколько времени должна ждать транспортная прослойка, прежде чем прекратить ожидание API-запросов из-за истечения времени. Если это значение опущено, запросы к библиотеке requests не будут передавать ничего подобного.
auth словарь	Словарь, содержащий информацию об авторизации, необходимую стратегии плагина авторизации облака. Для плагина по умолчанию password, он будет содержать auth_url, username, password, project_name и любую информацию о доменах (например, user_domain_name или project_domain_name), если облако их поддерживает. Для других плагинов этот параметр должен содержать необходимые для него параметры. Этот параметр не нужен, если указано имя облака или присутствуют переменные окружения OpenStack OS_*.
auth_type строка	Имя плагина авторизации для использования. Если облако использует что-то, кроме парольной авторизации, имя плагина должно быть указано здесь, а содержимое параметра auth должно быть соответствующим образом обновлено.
ca_cert псевдонимы: cacert строка	Путь к пакету сертификата CA, который можно использовать для проверки запросов API SSL.
client_cert псевдонимы: cert строка	Путь к клиенту сертификата для использования в рамках транзакции SSL.
client_key псевдонимы: key строка	Путь к ключу клиента для использования в рамках транзакции SSL.
cloud любой	Названное облако или конфигурация облака для работы. Если cloud является строкой, она ссылается на конфигурацию облака с именем, как определено в файле OpenStack clouds.yaml. Предоставляет значения по умолчанию для auth и auth_type. Этот параметр не нужен, если предоставлен auth или присутствуют переменные окружения OpenStack OS_. Если cloud* является словарем, он содержит полную конфигурацию облака, как в секции clouds.yaml.
config_drive любой	Файл configdrive или URL HTTP(S), который будет передан узлу.
deploy булево	Указывает, следует ли развернуть ресурс. Позволяет отключить логику развертывания и управлять состоянием питания или технического обслуживания узла. Варианты: `false` `true` ← (по умолчанию)
instance_info словарь	Определение информации об экземпляре, используемой для развертывания узла. Эта информация необходима только в том случае, если state установлен на `present` или `on`.
image_checksum строка	Контрольная сумма image_source.
image_disk_format строка	Тип изображения, которое требуется развернуть.
image_source строка	HTTP(S) URL, откуда можно извлечь изображение.
interface псевдонимы: endpoint_type строка	Тип URL конечной точки для извлечения из каталога служб. Варианты: `"admin"` `"internal"` `"public"` ← (по умолчанию)
maintenance булево	Установить узел в режим технического обслуживания. Состояние питания, управляемое параметром power, не будет изменено при изменении режима технического обслуживания узла. Варианты: `false` `true`
maintenance_reason строка	Строковое выражение, касающееся причины, по которой узел находится в режиме технического обслуживания.
name псевдонимы: id, uuid строка / обязательно	Имя или идентификатор узла Bare Metal.
power строка	Параметр для задания состояния питания, позволяющий включать узлы, которые еще не развернуты, и выключать узлы, которые уже развернуты. power может быть `present`, `absent`, `maintenance`, `on` или `off`. Варианты: `"present"` ← (по умолчанию) `"absent"` `"maintenance"` `"on"` `"off"`

END_OF_DOCUMENT_MARKER

region_name string	Имя региона.
sdk_log_level string	Уровень ведения журнала OpenStackSDK Варианты: `"INFO"` ← (по умолчанию) `"DEBUG"`
sdk_log_path string	Путь к файлу журнала OpenStackSDK. Если пусто, журнал не записывается
state string	Указывает желаемое состояние ресурса. state может быть `present`, `absent`, `maintenance`, `on` или `off`. Варианты: `"present"` ← (по умолчанию) `"absent"` `"maintenance"` `"on"` `"off"`
timeout integer	Количество секунд ожидания завершения активации или деактивации узла. По умолчанию: `1800`
validate_certs aliases: verify boolean	Нужно ли проверять запросы SSL API? В Ansible версии 2.3 по умолчанию было `true`. Варианты: `false` `true`
wait boolean	Должен ли Ansible ждать завершения запрошенного ресурса? Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Можно использовать стандартные переменные окружения 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"

Авторы

OpenStack Ansible SIG

Ссылки на коллекции

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/openstack/cloud/baremetal_node_action_module.html