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

Примечание

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

Возможно, эта коллекция уже установлена, если вы используете пакет 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 целое число	Идентификатор шасси, для которого будут развернуты настройки Quick Deploy. Если идентификатор устройства не указан, этот модуль обновляет настройки Quick Deploy для hostname. device_id взаимоисключает device_service_tag.
device_service_tag строка	Серийный номер шасси, для которого будут развернуты настройки Quick Deploy. Если серийный номер не указан, этот модуль обновляет настройки Quick Deploy для 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 словарь / обязательный	Настройки Quick Deploy для сервера и 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 строка	IP-адрес слота версии IPv4.
slot_ipv6_address строка	IP-адрес слота версии IPv6.
vlan_id целое число	Идентификатор VLAN.
setting_type строка / обязательно	Тип настроек Quick Deploy, которые нужно применить. `ServerQuickDeploy` для применения настроек Quick Deploy сервера. `IOMQuickDeploy` для применения настроек Quick Deploy 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 целое число	Идентификатор задачи отправленной работы Quick Deploy. Возвращается: при отправке задачи Quick Deploy. Пример: `1234`
msg строка	Общий статус настроек Quick Deploy устройства. Возвращается: всегда Пример: `"Successfully deployed the quick deploy settings."`
quick_deploy_settings словарь	возвращается, когда настройки Quick Deploy были успешно развернуты. Возвращается: успех Пример: {"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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/dellemc/openmanage/ome_device_quick_deploy_module.html