Spec-Zone.ru › Ansible

Модуль 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

Указывает, следует ли развернуть ресурс. Позволяет отключить логику развертывания и изменить состояние питания узла или режим обслуживания.

Допустимые значения:

  • false
  • true ← (значение по умолчанию)

instance_info

dictionary

Описание сведений об экземпляре, используемых для развертывания узла. Эти сведения необходимы только в том случае, если для state задано значение present или on.

image_checksum

string

Контрольная сумма image_source.

image_disk_format

string

Тип образа, запрошенного для развертывания.

image_source

string

URL HTTP(S), по которому можно получить образ.

interface

псевдонимы: endpoint_type

string

Тип URL конечной точки, получаемой из каталога служб.

Допустимые значения:

  • "admin"
  • "internal"
  • "public" ← (значение по умолчанию)

maintenance

boolean

Перевести узел в режим обслуживания.

При изменении режима обслуживания узла состояние питания, задаваемое параметром power, не изменяется.

Допустимые значения:

  • false
  • true

maintenance_reason

string

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

name

псевдонимы: id, uuid

string / обязательный

Имя или идентификатор узла Bare Metal.

power

string

Параметр для задания состояния питания: он позволяет включать еще не развернутые узлы и выключать развернутые.

Значением power может быть present, absent, maintenance, on или off.

Допустимые значения:

  • "present" ← (значение по умолчанию)
  • "absent"
  • "maintenance"
  • "on"
  • "off"

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

псевдонимы: verify

boolean

Следует ли проверять запросы к API по SSL.

До 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

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

  • Отслеживание проблем
  • Репозиторий (исходный код)

© 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API