Модуль cisco.intersight.intersight_bios_ai_tuning — предустановки политик BIOS, оптимизированные для ИИ, для Cisco Intersight

Примечание

Этот модуль входит в коллекцию cisco.intersight (версия 2.18.0).

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

Для установки используйте: ansible-galaxy collection install cisco.intersight.

Чтобы использовать модуль в плейбуке, укажите: cisco.intersight.intersight_bios_ai_tuning.

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

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

Создаёт политики BIOS с предварительно проверенными настройками, оптимизированными для рабочих нагрузок ИИ и GPU.
Предоставляет именованные профили настройки, которые одновременно задают несколько параметров BIOS для распространённых сценариев использования ИИ.
Профили предназначены для серверов с GPU NVIDIA H100/B200 и платформ с CPU Intel/AMD, используемых в Cisco AI Factory.
После применения предустановки отдельные параметры BIOS можно переопределить.
Для полного контроля над параметрами BIOS используйте вместо этого cisco.intersight.intersight_bios_policy.
Дополнительную информацию см. в документации Cisco Intersight.

Параметры

Параметр	Комментарии
api_key_id string / обязательный	Общедоступный идентификатор ключа API, связанный с закрытым ключом. Если параметр не задан, используется значение переменной окружения INTERSIGHT_API_KEY_ID.
api_private_key path / обязательный	Имя файла (абсолютный путь) или строка с данными закрытого ключа в формате PEM для аутентификации в Intersight API. Если используется строка, для её шифрования следует использовать Ansible Vault. Ex. ansible-vault encrypt_string --vault-id tme@/Users/dsoper/Documents/vault_password_file ‘-----BEGIN EC PRIVATE KEY----- <your private key data> -----END EC PRIVATE KEY-----’ Если параметр не задан, используется значение переменной окружения INTERSIGHT_API_PRIVATE_KEY.
api_uri string	URI для доступа к Intersight API. Если параметр не задан, используется значение переменной окружения INTERSIGHT_API_URI. По умолчанию: `"https://intersight.com/api/v1"`
cpu_energy_performance string	Переопределяет настройку смещения между энергопотреблением и производительностью CPU. Варианты: `"platform-default"` `"balanced-energy"` `"balanced-performance"` `"energy-efficient"` `"performance"`
cpu_performance string	Переопределяет настройку производительности CPU из профиля настройки. Варианты: `"platform-default"` `"custom"` `"enterprise"` `"high-throughput"` `"hpc"`
cpu_power_management string	Переопределяет настройку управления питанием CPU из профиля настройки. Варианты: `"platform-default"` `"performance"` `"energy-efficient"` `"custom"`
description псевдонимы: descr string	Описание политики BIOS, заданное пользователем.
gpu_count integer	Количество GPU, для которых следует включить управление ACS (1–8). Применимо только к профилям gpu_inference и gpu_training. Для GPU, количество которых превышает это значение, управление ACS будет установлено в значение platform-default. По умолчанию: `8`
intel_turbo_boost_tech string	Переопределяет настройку технологии Intel Turbo Boost. Варианты: `"platform-default"` `"enabled"` `"disabled"`
name string / обязательный	Имя, присвоенное политике BIOS. Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_.
numa_optimized string	Переопределяет настройку оптимизации NUMA из профиля настройки. Варианты: `"platform-default"` `"enabled"` `"disabled"`
organization string	Имя организации, которой назначен этот ресурс. Профили и политики, созданные в пользовательской организации, применимы только к устройствам той же организации. По умолчанию: `"default"`
sriov string	Переопределяет настройку SR-IOV из профиля настройки. Для прямого доступа GPU в виртуализированных средах требуется SR-IOV. Варианты: `"platform-default"` `"enabled"` `"disabled"`
state string	Если задано значение `present`, проверяется наличие ресурса и при необходимости он создаётся. Если задано значение `absent`, проверяется отсутствие ресурса и при необходимости он удаляется. Варианты: `"present"` ← (по умолчанию) `"absent"`
tags list / elements=dictionary	Список тегов в формате Key:<определённый пользователем ключ> Value:<определённое пользователем значение>.
tuning_profile string / обязательный	Предустановленный профиль настройки ИИ для применения. `gpu_inference` оптимизирует систему для максимальной пропускной способности GPU и низкой задержки доступа к памяти. Включает управление ACS для GPU, оптимизацию NUMA, отключение аппаратных P-состояний для стабильной производительности, включение SR-IOV и оптимизацию чередования памяти. `gpu_training` оптимизирует систему для крупномасштабных рабочих нагрузок обучения GPU с максимальной пропускной способностью памяти. Включает все настройки gpu_inference, а также максимальную настройку производительности питания, сбалансированную конфигурацию рабочей нагрузки и ограничение состояния C пакета для поддержания пропускной способности. `cpu_inference` оптимизирует систему для вывода на основе CPU с настройками для низкой задержки. Включает аппаратные P-состояния для штатной производительности, Intel Turbo Boost, предварительную выборку LLC и оптимизацию NUMA без настроек, специфичных для GPU. `edge_ai` оптимизирует систему для узлов Cisco Unified Edge с настройками ИИ, учитывающими энергопотребление. Обеспечивает баланс производительности и энергоэффективности с помощью энергоэффективного режима turbo, аппаратных P-состояний и оптимизации NUMA, подходящих для ограничений периферийного развертывания. Варианты: `"gpu_inference"` `"gpu_training"` `"cpu_inference"` `"edge_ai"`
use_proxy boolean	Если задано значение `no`, прокси не используется, даже если он указан в переменной окружения на целевых узлах. Варианты: `false` `true` ← (по умолчанию)
validate_certs boolean	Логический параметр управления проверкой TLS-сертификата api_uri. Варианты: `false` `true` ← (по умолчанию)

Примеры

- name: Create GPU inference optimized BIOS policy for 8-GPU server
  cisco.intersight.intersight_bios_ai_tuning:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: AI-Factory
    name: bios-gpu-inference-h100
    description: BIOS tuning for H100 GPU inference servers
    tuning_profile: gpu_inference
    gpu_count: 8

- name: Create GPU training BIOS policy with power override
  cisco.intersight.intersight_bios_ai_tuning:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: bios-gpu-training
    tuning_profile: gpu_training
    cpu_power_management: performance

- name: Create CPU inference BIOS policy for non-GPU workloads
  cisco.intersight.intersight_bios_ai_tuning:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: bios-cpu-inference
    tuning_profile: cpu_inference
    intel_turbo_boost_tech: enabled

- name: Create edge AI BIOS policy for Unified Edge nodes
  cisco.intersight.intersight_bios_ai_tuning:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: bios-edge-ai
    tuning_profile: edge_ai
    gpu_count: 2

- name: Delete AI BIOS policy
  cisco.intersight.intersight_bios_ai_tuning:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: bios-gpu-inference-h100
    tuning_profile: gpu_inference
    state: absent

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

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

Ключ	Описание
api_response dictionary	Ответ API, возвращённый указанным ресурсом. Возвращается: всегда Пример: `{"api_response": {"AcsControlGpu1state": "enabled", "Name": "bios-gpu-inference-h100", "NumaOptimized": "enabled", "ObjectType": "bios.Policy"}}`
applied_settings dictionary	Настройки BIOS, применённые профилем настройки и всеми переопределениями. Возвращается: когда state имеет значение present

Авторы

Steve Fulmer (@stevefulme1)

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

© 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/cisco/intersight/intersight_bios_ai_tuning_module.html