Spec-Zone.ru › Ansible

Модуль cisco.intersight.intersight_server_pool_qualification_policy — настройка политики квалификации пула серверов для Cisco Intersight

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install cisco.intersight.

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

  • Обзор
  • Параметры
  • Примеры
  • Возвращаемые значения

Обзор

  • Управляет настройкой политики квалификации пула серверов в Cisco Intersight.
  • Политика квалификации пула серверов определяет условия для допуска серверов в пулы ресурсов на основе различных аппаратных атрибутов и атрибутов конфигурации.
  • Поддерживаются различные типы критериев, включая критерии для домена, стоечного сервера, блейд-сервера, тегов, памяти, графического процессора, процессора и сетевого адаптера.
  • Дополнительную информацию см. в документации Cisco Intersight.

Параметры

Параметр

Комментарии

api_key_id

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

Идентификатор открытого API-ключа, связанного с закрытым ключом.

Если не задано, используется значение переменной среды INTERSIGHT_API_KEY_ID.

api_private_key

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

Имя файла (абсолютный путь) или строка с данными закрытого ключа в формате PEM для аутентификации в API Intersight.

Если используется строка, для шифрования строковых данных следует использовать Ansible Vault.

Например: 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 для доступа к API Intersight.

Если не задано, используется значение переменной среды INTERSIGHT_API_URI.

По умолчанию: "https://intersight.com/api/v1"

blade_qualifier

dictionary

Критерии для выбора серверов на базе блейд-серверов.

asset_tags

list / elements=string

Список инвентарных меток для выбора блейд-серверов.

Серверы выбираются на основе свойства AssetTag.

chassis_pids

list / elements=string

Список PID шасси для выбора (не более 20).

Блейд-серверы выбираются на основе PID шасси.

chassis_slot_ranges

list / elements=dictionary

Список диапазонов идентификаторов шасси и слотов для выбора блейд-серверов.

chassis_id_range

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

Задание диапазона идентификаторов шасси.

max_value

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

Максимальное значение идентификатора шасси (min_value–40).

min_value

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

Минимальное значение идентификатора шасси (1–40).

slot_id_ranges

list / elements=dictionary

Список диапазонов идентификаторов слотов в шасси.

Можно указать только в том случае, если задан chassis_id_range.

max_value

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

Максимальное значение идентификатора слота (min_value–8).

min_value

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

Минимальное значение идентификатора слота (1–8).

pids

list / elements=string

Список PID блейд-серверов для выбора (не более 20).

Блейд-серверы выбираются на основе их PID.

user_labels

list / elements=string

Список пользовательских меток для выбора блейд-серверов.

Серверы выбираются на основе свойства UserLabel.

description

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

string

Описание политики выбора пула серверов, заданное пользователем.

Описание может содержать буквы (a–z, A–Z), цифры (0–9), дефис (-), точку (.), двоеточие (:) или символ подчеркивания (_).

domain_qualifier

dictionary

Критерии для выбора Fabric Interconnect и ресурсов на основе домена.

domain_names

list / elements=string

Список имен доменов для выбора ресурсов.

Ресурсы выбираются на основе свойства DomainName.

fabric_interconnect_pids

list / elements=string

Список PID Fabric Interconnect для выбора ресурсов.

Ресурсы выбираются на основе свойства PID устройств Fabric Interconnect.

gpu_qualifier

dictionary

Критерии для выбора серверов на основе характеристик GPU.

Если не задано, автоматически добавляется критерий GPU по умолчанию с типом оценки servers_without_gpu.

evaluation_type

string

Тип оценки GPU для выбора серверов.

servers_without_gpu — выбирает серверы без GPU (по умолчанию).

all_servers — выбирает все серверы независимо от наличия GPU.

servers_with_gpu — выбирает только серверы с GPU.

Варианты:

  • "servers_without_gpu" ← (по умолчанию)
  • "all_servers"
  • "servers_with_gpu"

gpu_count_range

dictionary

Диапазон количества GPU (применяется только при evaluation_type, равном servers_with_gpu).

max_value

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

Максимальное количество GPU (min_value–16).

min_value

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

Минимальное количество GPU (1–16).

pids

list / elements=string

Список PID GPU для выбора (не более 20; только для servers_with_gpu).

vendor

string

Производитель GPU (применяется только при evaluation_type, равном servers_with_gpu).

Варианты:

  • "nvidia"
  • "intel"
  • "amd"

memory_qualifier

dictionary

Критерии для выбора серверов на основе характеристик памяти.

capacity_range

dictionary

Диапазон емкости памяти в ГиБ.

max_value

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

Максимальная емкость памяти в ГиБ (min_value–999999).

min_value

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

Минимальная емкость памяти в ГиБ (1–999999).

units_range

dictionary

Диапазон количества модулей памяти.

max_value

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

Максимальное количество модулей памяти (min_value–99999).

min_value

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

Минимальное количество модулей памяти (1–99999).

name

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

Имя, присвоенное политике выбора пула серверов.

Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_.

network_adaptor_qualifier

dictionary

Критерии для выбора серверов на основе количества сетевых адаптеров.

adaptors_range

dictionary

Диапазон количества сетевых адаптеров.

max_value

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

Максимальное количество сетевых адаптеров (min_value–16).

min_value

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

Минимальное количество сетевых адаптеров (1–16).

organization

string

Имя организации, которой назначен этот ресурс.

Профили и политики, созданные в пользовательской организации, применимы только к устройствам той же организации.

По умолчанию: "default"

processor_qualifier

dictionary

Критерии для выбора серверов на основе характеристик процессора.

cores_range

dictionary

Диапазон количества ядер CPU.

max_value

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

Максимальное количество ядер CPU (min_value–9999).

min_value

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

Минимальное количество ядер CPU (1–9999).

pids

list / elements=string

Список PID процессоров для выбора (не более 100).

speed_range

dictionary

Диапазон тактовой частоты CPU в ГГц.

max_value

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

Максимальная тактовая частота CPU в ГГц (min_value–99).

min_value

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

Минимальная тактовая частота CPU в ГГц (1–99).

vendor

string

Производитель процессора.

Варианты:

  • "intel"
  • "amd"

rack_server_qualifier

dictionary

Критерии для выбора стоечных серверов.

asset_tags

list / elements=string

Список инвентарных меток для выбора серверов.

Серверы выбираются на основе свойства AssetTag.

pids

list / elements=string

Список PID стоечных серверов для выбора (не более 20).

Стоечные серверы выбираются на основе их PID.

rack_id_ranges

list / elements=dictionary

Список диапазонов идентификаторов стоек для выбора серверов.

Каждый диапазон задает min_value и max_value для идентификаторов стоек.

max_value

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

Максимальное значение идентификатора стойки (min_value–256).

min_value

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

Минимальное значение идентификатора стойки (1–256).

user_labels

list / elements=string

Список пользовательских меток для выбора серверов.

Серверы выбираются на основе свойства UserLabel.

state

string

Если present, проверяется наличие ресурса и при необходимости он создается.

Если absent, проверяется отсутствие ресурса и при необходимости он удаляется.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

tag_qualifier

dictionary

Квалификатор тегов для отбора ресурсов на основе тегов.

chassis_tags

list / elements=dictionary

Список тегов шасси в формате «ключ-значение».

key

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

Ключ тега.

value

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

Значение тега.

domain_profile_tags

list / elements=dictionary

Список тегов профиля домена в формате «ключ-значение».

key

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

Ключ тега.

value

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

Значение тега.

server_tags

list / elements=dictionary

Список тегов сервера в формате «ключ-значение».

key

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

Ключ тега.

value

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

Значение тега.

tags

list / elements=dictionary

Список тегов в формате Key:<user-defined key> Value:<user-defined value>.

use_proxy

boolean

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

Варианты:

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

validate_certs

boolean

Логический параметр, управляющий проверкой TLS-сертификата api_uri

Варианты:

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

Примеры

- name: Create minimal Server Pool Qualification Policy
  cisco.intersight.intersight_server_pool_qualification_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "ServerPool-Minimal-Policy"
    description: "Minimal policy - GPU qualifier automatically added with servers_without_gpu"
    state: present

- name: Create Server Pool Qualification Policy with domain and rack qualifiers
  cisco.intersight.intersight_server_pool_qualification_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "ServerPool-Qual-Policy-01"
    description: "Server pool qualification with domain and rack filters"
    domain_qualifier:
      fabric_interconnect_pids:
        - ucs-fi-6454
        - ucs-fi-64108
      domain_names:
        - "AC08-6454"
    rack_server_qualifier:
      rack_id_ranges:
        - min_value: 2
          max_value: 4
        - min_value: 5
          max_value: 8
      pids:
        - "UCSC-C245-M8SX"
        - "UCSC-C220-M8S"
      asset_tags:
        - "production"
      user_labels:
        - "datacenter-a"
    state: present

- name: Create Server Pool Qualification Policy with blade and memory qualifiers
  cisco.intersight.intersight_server_pool_qualification_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "ServerPool-Blade-Policy"
    blade_qualifier:
      pids:
        - "UCSB-B480-M5"
        - "UCSB-B200-M5"
      chassis_pids:
        - "N20-C6508"
      chassis_slot_ranges:
        - chassis_id_range:
            min_value: 2
            max_value: 10
          slot_id_ranges:
            - min_value: 4
              max_value: 6
    memory_qualifier:
      capacity_range:
        min_value: 64
        max_value: 512
      units_range:
        min_value: 10
        max_value: 20
    state: present

- name: Create Server Pool Qualification Policy with GPU requirements
  cisco.intersight.intersight_server_pool_qualification_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "ServerPool-GPU-Policy"
    description: "Policy for servers with NVIDIA GPUs"
    gpu_qualifier:
      evaluation_type: servers_with_gpu
      gpu_count_range:
        min_value: 2
        max_value: 4
      vendor: nvidia
    processor_qualifier:
      cores_range:
        min_value: 16
        max_value: 64
      vendor: intel
    state: present

- name: Create Server Pool Qualification Policy with tag qualifiers
  cisco.intersight.intersight_server_pool_qualification_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "ServerPool-Tag-Policy"
    tag_qualifier:
      server_tags:
        - key: "environment"
          value: "production"
        - key: "tier"
          value: "1"
      chassis_tags:
        - key: "location"
          value: "datacenter-a"
    network_adaptor_qualifier:
      adaptors_range:
        min_value: 2
        max_value: 8
    state: present

- name: Create comprehensive Server Pool Qualification Policy
  cisco.intersight.intersight_server_pool_qualification_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "Production"
    name: "ServerPool-Comprehensive-Policy"
    description: "Comprehensive qualification policy with multiple qualifiers"
    domain_qualifier:
      fabric_interconnect_pids:
        - ucs-fi-6454
    rack_server_qualifier:
      pids:
        - "UCSC-C220-M6S"
        - "UCSC-C240-M6S"
    blade_qualifier:
      pids:
        - "UCSX-210C-M7"
        - "UCSX-410C-M7"
    memory_qualifier:
      capacity_range:
        min_value: 128
        max_value: 1024
    processor_qualifier:
      cores_range:
        min_value: 32
        max_value: 128
      vendor: intel
    gpu_qualifier:
      evaluation_type: servers_without_gpu
    network_adaptor_qualifier:
      adaptors_range:
        min_value: 2
        max_value: 4
    tags:
      - Key: "Environment"
        Value: "Production"
    state: present

- name: Delete Server Pool Qualification Policy
  cisco.intersight.intersight_server_pool_qualification_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "ServerPool-Qual-Policy-01"
    state: absent

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

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

Ключ

Описание

api_response

dictionary

Выходные данные ответа API, возвращённые указанным ресурсом.

Возвращается: всегда

Пример: {"api_response": {"Name": "ServerPool-Qual-Policy-01", "ObjectType": "resourcepool.QualificationPolicy", "Organization": {"Moid": "675450ee69726530014753e2", "ObjectType": "organization.Organization"}, "Qualifiers": [{"DomainNames": ["AC08-6454"], "FabricInterConnectPids": ["UCS-FI-6454", "UCS-FI-64108"], "ObjectType": "resource.DomainQualifier"}, {"ObjectType": "resource.RackServerQualifier", "Pids": ["UCSC-C245-M8SX"], "RackIdRange": [{"MaxValue": 4, "MinValue": 2}]}]}}

Авторы

  • Ron Gershburg (@rgershbu)

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

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

© 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_server_pool_qualification_policy_module.html

Spec-Zone.ru

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