модуль dellemc.openmanage.ome_device_quick_deploy — настройка параметров быстрого развертывания в OpenManage Enterprise Modular.

Примечание

Этот модуль входит в коллекцию dellemc.openmanage (версия 10.0.2).

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

Для установки используйте: ansible-galaxy collection install dellemc.openmanage. Для работы с этим модулем требуются дополнительные компоненты. Подробнее см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: dellemc.openmanage.ome_device_quick_deploy.

Добавлено в dellemc.openmanage 5.0.0

Краткое описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Краткое описание

Этот модуль позволяет настраивать параметры быстрого развертывания сервера или IOM в OpenManage Enterprise Modular.

Требования

На узле, выполняющем этот модуль, должны быть соблюдены следующие требования.

python >= 3.9.6

Параметры

Параметр	Комментарии
ca_path путь добавлено в dellemc.openmanage 5.0.0	Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA для проверки.
device_id целое число	Идентификатор шасси, для которого необходимо применить параметры быстрого развертывания. Если идентификатор устройства не указан, этот модуль обновляет параметры быстрого развертывания для hostname. device_id нельзя использовать вместе с device_service_tag.
device_service_tag строка	Тег обслуживания шасси, для которого необходимо применить параметры быстрого развертывания. Если тег обслуживания устройства не указан, этот модуль обновляет параметры быстрого развертывания для hostname. device_service_tag нельзя использовать вместе с device_id.
hostname строка / обязательный	IP-адрес или имя узла OpenManage Enterprise Modular.
job_wait логическое значение	Определяет, следует ли ожидать завершения задания. Варианты: `false` `true` ← (по умолчанию)
job_wait_timeout целое число	Максимальное время ожидания для job_wait в секундах. Задание отслеживается только в течение этого времени. Этот параметр применяется, если job_wait имеет значение `true`. По умолчанию: `120`
password строка	Пароль OpenManage Enterprise Modular. Если пароль не указан, используется переменная среды `OME_PASSWORD`. Пример: export OME_PASSWORD=password
port целое число	HTTPS-порт OpenManage Enterprise Modular. По умолчанию: `443`
quick_deploy_options словарь / обязательный	Параметры быстрого развертывания сервера и IOM.
ipv4_enabled логическое значение	Включает или отключает сеть IPv4. Варианты: `false` `true`
ipv4_gateway строка	Шлюз IPv4. ipv4_gateway обязателен, если ipv4_network_type имеет значение `Static`.
ipv4_network_type строка	Тип сети IPv4. ipv4_network_type обязателен, если ipv4_enabled имеет значение `true`. `Static` для настройки статических параметров IP. `DHCP` для настройки параметров динамического IP. Варианты: `"Static"` `"DHCP"`
ipv4_subnet_mask строка	Маска подсети IPv4. ipv4_subnet_mask обязательна, если ipv4_network_type имеет значение `Static`.
ipv6_enabled логическое значение	Включает или отключает сеть IPv6. Варианты: `false` `true`
ipv6_gateway строка	Шлюз IPv6. ipv6_gateway обязателен, если ipv6_network_type имеет значение `Static`.
ipv6_network_type строка	Тип сети IPv6. ipv6_network_type обязателен, если ipv6_enabled имеет значение `true`. `Static` для настройки статических параметров IP. `DHCP` для настройки параметров динамического IP. Варианты: `"Static"` `"DHCP"`
ipv6_prefix_length целое число	Длина префикса IPv6. ipv6_prefix_length обязательна, если ipv6_network_type имеет значение `Static`.
password строка	Пароль для входа на сервер или IOM. Модуль всегда сообщает об изменении, если добавлен параметр password.
slots список / элементы=словарь	Конфигурация слотов сервера или IOM.
slot_id целое число / обязательный	Идентификатор слота.
slot_ipv4_address строка	Адрес IPv4 слота.
slot_ipv6_address строка	Адрес IPv6 слота.
vlan_id целое число	Идентификатор VLAN.
setting_type строка / обязательный	Тип применяемых параметров быстрого развертывания. `ServerQuickDeploy` для применения параметров быстрого развертывания сервера. `IOMQuickDeploy` для применения параметров быстрого развертывания IOM. Варианты: `"ServerQuickDeploy"` `"IOMQuickDeploy"`
timeout целое число добавлено в dellemc.openmanage 5.0.0	Тайм-аут на уровне сокета в секундах. По умолчанию: `30`
username строка	Имя пользователя OpenManage Enterprise Modular. Если имя пользователя не указано, используется переменная среды `OME_USERNAME`. Пример: export OME_USERNAME=username
validate_certs логическое значение добавлено в dellemc.openmanage 5.0.0	Если `false`, SSL-сертификаты не проверяются. Настраивайте `false` только на контролируемых вами площадках, где используются самозаверяющие сертификаты. В версиях коллекции до `5.0.0` параметр validate_certs по умолчанию имеет значение `false`. Варианты: `false` `true` ← (по умолчанию)
x_auth_token строка добавлено в dellemc.openmanage 9.3.0	Токен аутентификации. Если x_auth_token не указан, используется переменная среды `OME_X_AUTH_TOKEN`. Пример: export OME_X_AUTH_TOKEN=x_auth_token

Примечания

Примечание

Запускайте этот модуль в системе, имеющей прямой доступ к OpenManage Enterprise Modular.
Этот модуль поддерживает check_mode.
Модуль всегда сообщает об изменении, если добавлен параметр password.
Если шасси входит в группу из нескольких шасси и назначено резервным ведущим шасси, операции, выполняемые с его помощью этим модулем, могут конфликтовать с операциями управления шасси, выполняемыми через ведущее шасси.

Примеры

---
- name: Configure server Quick Deploy settings of the chassis using device ID.
  dellemc.openmanage.ome_device_quick_deploy:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    device_id: 25011
    setting_type: ServerQuickDeploy
    ca_path: "/path/to/ca_cert.pem"
    quick_deploy_options:
      password: "password"
      ipv4_enabled: true
      ipv4_network_type: Static
      ipv4_subnet_mask: 255.255.255.0
      ipv4_gateway: 192.168.0.1
      ipv6_enabled: true
      ipv6_network_type: Static
      ipv6_prefix_length: 1
      ipv6_gateway: "::"
      slots:
        - slot_id: 1
          slot_ipv4_address: 192.168.0.2
          slot_ipv6_address: "::"
          vlan_id: 1
        - slot_id: 2
          slot_ipv4_address: 192.168.0.3
          slot_ipv6_address: "::"
          vlan_id: 2

- name: Configure server Quick Deploy settings of the chassis using device service tag.
  dellemc.openmanage.ome_device_quick_deploy:
    hostname: "192.168.0.1"
    username: "username"
    password: "password"
    device_service_tag: GHRT2RL
    setting_type: IOMQuickDeploy
    ca_path: "/path/to/ca_cert.pem"
    quick_deploy_options:
      password: "password"
      ipv4_enabled: true
      ipv4_network_type: Static
      ipv4_subnet_mask: 255.255.255.0
      ipv4_gateway: 192.168.0.1
      ipv6_enabled: true
      ipv6_network_type: Static
      ipv6_prefix_length: 1
      ipv6_gateway: "::"
      slots:
        - slot_id: 1
          slot_ipv4_address: 192.168.0.2
          slot_ipv6_address: "::"
          vlan_id: 1
        - slot_id: 2
          slot_ipv4_address: 192.168.0.3
          slot_ipv6_address: "::"
          vlan_id: 2

Возвращаемые значения

Общие возвращаемые значения описаны здесь. Ниже приведены поля, уникальные для этого модуля:

Ключ	Описание
error_info словарь	Сведения об ошибке HTTP. Возвращается: при ошибке HTTP Пример: `{"error": {"@Message.ExtendedInfo": [{"Message": "Unable to process the request because an error occurred.", "MessageArgs": [], "MessageId": "GEN1234", "RelatedProperties": [], "Resolution": "Retry the operation. If the issue persists, contact your system administrator.", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}`
job_id целое число	Идентификатор отправленного задания быстрого развертывания. Возвращается: при отправке задания быстрого развертывания. Пример: `1234`
msg строка	Общий статус параметров быстрого развертывания устройства. Возвращается: всегда Пример: `"Successfully deployed the quick deploy settings."`
quick_deploy_settings словарь	Возвращается при успешном применении параметров быстрого развертывания. Возвращается: при успешном выполнении Пример: {"DeviceId": 25011, "IpV4Gateway": "192.168.0.1", "IpV4SubnetMask": "255.255.255.0", "IpV6Gateway": "::", "NetworkTypeV4": "Static", "NetworkTypeV6": "Static", "PrefixLength": "2", "ProtocolTypeV4": true, "ProtocolTypeV6": true, "SettingType": "ServerQuickDeploy", "slots": [{"DeviceCapabilities": [18, 17, 16, 15, 14, 13, 12, 11, 10, 9, 41, 8, 7, 4, 3, 2, 1, 31, 30], "DeviceIPV4Address": "192.168.0.2", "DeviceIPV6Address": "::", "DeviceId": 25011, "Dhcpipv4": "Disabled", "Dhcpipv6": "Disabled", "Ipv4Enabled": "Enabled", "Ipv6Enabled": "Enabled", "Model": "PowerEdge MX840c", "SlotIPV4Address": "192.168.0.2", "SlotIPV6Address": "::", "SlotId": 1, "SlotSelected": true, "SlotSettingsApplied": true, "SlotType": "2000", "Type": "1000", "VlanId": "1"}, {"DeviceId": 0, "Model": "", "SlotIPV4Address": "0.0.0.0", "SlotIPV6Address": "::", "SlotId": 2, "SlotSelected": false, "SlotSettingsApplied": false, "SlotType": "2000", "Type": "0"}, {"DeviceId": 0, "Model": "", "SlotIPV4Address": "0.0.0.0", "SlotIPV6Address": "::", "SlotId": 3, "SlotSelected": false, "SlotSettingsApplied": false, "SlotType": "2000", "Type": "0"}, {"DeviceId": 0, "Model": "", "SlotIPV4Address": "0.0.0.0", "SlotIPV6Address": "::", "SlotId": 4, "SlotSelected": false, "SlotSettingsApplied": false, "SlotType": "2000", "Type": "0"}, {"DeviceId": 0, "Model": "", "SlotIPV4Address": "0.0.0.0", "SlotIPV6Address": "::", "SlotId": 5, "SlotSelected": false, "SlotSettingsApplied": false, "SlotType": "2000", "Type": "0"}, {"DeviceId": 0, "Model": "", "SlotIPV4Address": "0.0.0.0", "SlotIPV6Address": "::", "SlotId": 6, "SlotSelected": false, "SlotSettingsApplied": false, "SlotType": "2000", "Type": "0"}, {"DeviceId": 0, "Model": "", "SlotIPV4Address": "0.0.0.0", "SlotIPV6Address": "::", "SlotId": 7, "SlotSelected": false, "SlotSettingsApplied": false, "SlotType": "2000", "Type": "0"}, {"DeviceId": 0, "Model": "", "SlotIPV4Address": "0.0.0.0", "SlotIPV6Address": "::", "SlotId": 8, "SlotSelected": false, "SlotSettingsApplied": false, "SlotType": "2000", "Type": "0"}]}

Авторы

Felix Stephen (@felixs88)
Shivam Sharma (@ShivamSh3)
Kritika Bhateja (@Kritika-Bhateja-03)

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

© 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/dellemc/openmanage/ome_device_quick_deploy_module.html