Microsoft.HybridContainerService подготовленоClusterInstances

• последние
• 2024-01-01
• 2023-11-15-preview

Определение ресурсов Bicep

Тип ресурса provisionedClusterInstances можно развернуть с помощью операций, целевых:

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

Формат ресурса

Чтобы создать ресурс Microsoft.HybridContainerService/provisionedClusterInstances, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.HybridContainerService/provisionedClusterInstances@2024-01-01' = {
  scope: resourceSymbolicName or scope
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  name: 'default'
  properties: {
    agentPoolProfiles: [
      {
        count: int
        enableAutoScaling: bool
        maxCount: int
        maxPods: int
        minCount: int
        name: 'string'
        nodeLabels: {
          {customized property}: 'string'
        }
        nodeTaints: [
          'string'
        ]
        osSKU: 'string'
        osType: 'string'
        vmSize: 'string'
      }
    ]
    autoScalerProfile: {
      balance-similar-node-groups: 'string'
      expander: 'string'
      max-empty-bulk-delete: 'string'
      max-graceful-termination-sec: 'string'
      max-node-provision-time: 'string'
      max-total-unready-percentage: 'string'
      new-pod-scale-up-delay: 'string'
      ok-total-unready-count: 'string'
      scale-down-delay-after-add: 'string'
      scale-down-delay-after-delete: 'string'
      scale-down-delay-after-failure: 'string'
      scale-down-unneeded-time: 'string'
      scale-down-unready-time: 'string'
      scale-down-utilization-threshold: 'string'
      scan-interval: 'string'
      skip-nodes-with-local-storage: 'string'
      skip-nodes-with-system-pods: 'string'
    }
    cloudProviderProfile: {
      infraNetworkProfile: {
        vnetSubnetIds: [
          'string'
        ]
      }
    }
    clusterVMAccessProfile: {
      authorizedIPRanges: 'string'
    }
    controlPlane: {
      controlPlaneEndpoint: {
        hostIP: 'string'
      }
      count: int
      vmSize: 'string'
    }
    kubernetesVersion: 'string'
    licenseProfile: {
      azureHybridBenefit: 'string'
    }
    linuxProfile: {
      ssh: {
        publicKeys: [
          {
            keyData: 'string'
          }
        ]
      }
    }
    networkProfile: {
      loadBalancerProfile: {
        count: int
      }
      networkPolicy: 'string'
      podCidr: 'string'
    }
    storageProfile: {
      nfsCsiDriver: {
        enabled: bool
      }
      smbCsiDriver: {
        enabled: bool
      }
    }
  }
}

Значения свойств

AgentPoolProfileNodeLabels

Имя	Описание	Ценность

CloudProviderProfile

Имя	Описание	Ценность
infraNetworkProfile	Профиль для сетей инфраструктуры, используемых подготовленным кластером	CloudProviderProfileInfraNetworkProfile

CloudProviderProfileInfraNetworkProfile

Имя	Описание	Ценность
vnetSubnetIds	Список идентификаторов ресурсов ARM (максимум 1) для сетевого объекта инфраструктуры, например /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName}	string[]

ClusterVMAccessProfile

Имя	Описание	Ценность
authorizedIPRanges	IP-адрес или CIDR для доступа SSH к виртуальным машинам в подготовленном кластере	струна

ControlPlaneProfile

Имя	Описание	Ценность
controlPlaneEndpoint	IP-адрес сервера API Kubernetes	ControlPlaneProfileControlPlaneEndpoint
считать	Количество узлов плоскости управления. Значение по умолчанию равно 1, а число должно быть нечетным числом.	int
vmSize	Размер SKU виртуальной машины узлов уровня управления	струна

ControlPlaneProfileControlPlaneEndpoint

Имя	Описание	Ценность
hostIP	IP-адрес сервера API Kubernetes	струна

ExtendedLocation

Имя	Описание	Ценность
имя	Идентификатор ARM расширенного расположения.	струна
тип	Тип расширенного расположения. Допустимое значение: CustomLocation	CustomLocation

LinuxProfileProperties

Имя	Описание	Ценность
SSH	Конфигурация SSH для виртуальных машин подготовленного кластера.	LinuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Имя	Описание	Ценность
publicKeys	Список открытых ключей SSH, используемых для проверки подлинности с помощью виртуальных машин. Можно указать не более 1 ключа.	LinuxProfilePropertiesSshPublicKeysItem[]

LinuxProfilePropertiesSshPublicKeysItem

Имя	Описание	Ценность
keyData	Открытый ключ сертификата, используемый для проверки подлинности с помощью SSH виртуальных машин. Сертификат должен быть в формате PEM с заголовками или без него.	струна

Microsoft.HybridContainerService/provisionedClusterInstances

Имя	Описание	Ценность
extendedLocation	Расширенное расположение, указывающее на базовую инфраструктуру	ExtendedLocation
имя	Имя ресурса	"default" (обязательно)
свойства	Свойства подготовленного кластера.	ProvisionedClusterProperties
размах	Используется при создании ресурса в области, отличной от области развертывания.	Задайте для этого свойства символьное имя ресурса, чтобы применить ресурс расширения.

NamedAgentPoolProfile

Имя	Описание	Ценность
считать	Количество узлов в пуле агентов. Значение по умолчанию — 1.	int
enableAutoScaling	Следует ли включить автомасштабирование. Значение по умолчанию равно false	bool
maxCount	Максимальное количество узлов для автоматического масштабирования	int
maxPods	Максимальное количество модулей pod, которые могут выполняться на узле.	int
minCount	Минимальное количество узлов для автоматического масштабирования	int
имя	Уникальное имя пула агентов по умолчанию в контексте подготовленного кластера. Значение по умолчанию — <clusterName>-nodepool1	струна
nodeLabels	Метки узлов, которые необходимо сохранить во всех узлах в пуле агентов.	AgentPoolProfileNodeLabels
nodeTaints	Таинты добавляются к новым узлам во время создания и масштабирования пула узлов. Например, key=value:NoSchedule.	string[]
osSKU	Указывает номер SKU ОС, используемый пулом агентов. Значение по умолчанию — CBLMariner, если OSType — Linux. Значение по умолчанию — Windows2019, если osType — Windows.	CBLMariner "Windows2019" 'Windows2022'
osType	Конкретный тип ОС образа KubernetesVersion (Linux, Windows)	Linux "Windows"
vmSize	Размер SKU виртуальной машины виртуальных машин пула агентов.	струна

NetworkProfile

Имя	Описание	Ценность
loadBalancerProfile	Профиль подсистемы балансировки нагрузки прокси-сервера высокого уровня доступности.	NetworkProfileLoadBalancerProfile
networkPolicy	Политика сети, используемая для создания сети Kubernetes. Возможные значения включают: "calico".	'calico'
podCidr	Диапазон IP-адресов нотации CIDR, из которого следует назначать IP-адреса pod.	струна

NetworkProfileLoadBalancerProfile

Имя	Описание	Ценность
считать	Количество виртуальных машин подсистемы балансировки нагрузки прокси-сервера высокой доступности. Значение по умолчанию — 0.	int

ProvisionedClusterLicenseProfile

Имя	Описание	Ценность
azureHybridBenefit	Указывает, включено ли преимущество гибридного использования Azure. Значение по умолчанию равно false	"False" NotApplicable "True"

ProvisionedClusterProperties

Имя	Описание	Ценность
agentPoolProfiles	Свойства пула агентов для подготовленного кластера.	NamedAgentPoolProfile[]
autoScalerProfile	Параметры для применения к кластеру автомасштабирования при включении автоматического масштабирования для подготовленного кластера.	ProvisionedClusterPropertiesAutoScalerProfile
cloudProviderProfile	Профиль базового поставщика облачной инфраструктуры для подготовленного кластера.	CloudProviderProfile
clusterVMAccessProfile	Профиль ограниченного доступа SSH для виртуальных машин в подготовленном кластере.	ClusterVMAccessProfile
controlPlane	Профиль уровня управления подготовленного кластера.	ControlPlaneProfile
kubernetesVersion	Версия Kubernetes, используемая подготовленным кластером.	струна
licenseProfile	Профиль лицензии подготовленного кластера.	ProvisionedClusterLicenseProfile
linuxProfile	Профиль для виртуальных машин Linux в подготовленном кластере.	LinuxProfileProperties
networkProfile	Профиль конфигурации сети для подготовленного кластера.	NetworkProfile
storageProfile	Профиль конфигурации хранилища для подготовленного кластера.	StorageProfile

ProvisionedClusterPropertiesAutoScalerProfile

Имя	Описание	Ценность
Balance-similar-node-groups	Допустимые значения: "true" и "false"	струна
расширитель	Если значение не указано, значение по умолчанию — "случайный". Дополнительные сведения см. в расширяющих.	"наименьший объем отходов" "most-pods" "приоритет" "случайный"
max-empty-bulk-delete	Значение по умолчанию — 10.	струна
max-graceful-termination-sec	Значение по умолчанию — 600.	струна
max-node-provision-time	Значение по умолчанию — 15 млн. Значения должны быть целым числом, за которым следует значение "m". Не поддерживается единица времени, отличного от минут (m).	струна
max-total-unready-percentage	Значение по умолчанию — 45. Максимальное значение — 100, а минимальное — 0.	струна
задержка new-pod-up-up-delay	В таких сценариях, как ускорение или пакетное масштабирование, в которых вы не хотите, чтобы ЦС действовал до того, как планировщик kubernetes может запланировать все модули pod, вы можете сообщить ЦС игнорировать незапланированные модули pod до того, как они будут иметь определенный возраст. Значение по умолчанию — 0s. Значения должны быть целым числом, за которым следует единица (в секундах, "m" в минутах, "h" в течение часов и т. д.).	струна
ok-total-unready-count	Это должно быть целое число. Значение по умолчанию — 3.	струна
Горизонтальное масштабирование отложенной задержки после добавления	Значение по умолчанию — 10 млн. Значения должны быть целым числом, за которым следует значение "m". Не поддерживается единица времени, отличного от минут (m).	струна
Горизонтальное масштабирование с задержкой после удаления	По умолчанию используется интервал сканирования. Значения должны быть целым числом, за которым следует значение "m". Не поддерживается единица времени, отличного от минут (m).	струна
Сбой горизонтального уменьшения масштаба отложенной задержки	Значение по умолчанию — "3m". Значения должны быть целым числом, за которым следует значение "m". Не поддерживается единица времени, отличного от минут (m).	струна
горизонтальное масштабирование безумного времени	Значение по умолчанию — 10 млн. Значения должны быть целым числом, за которым следует значение "m". Не поддерживается единица времени, отличного от минут (m).	струна
горизонтальное масштабирование с непрочитанным временем	Значение по умолчанию — 20 млн. Значения должны быть целым числом, за которым следует значение "m". Не поддерживается единица времени, отличного от минут (m).	струна
пороговое значение масштабирования	Значение по умолчанию — 0.5.	струна
интервал сканирования	Значение по умолчанию — 10. Значения должны быть целым числом секунд.	струна
skip-nodes-with-local-storage	Значение по умолчанию — true.	струна
skip-nodes-with-system-pods	Значение по умолчанию — true.	струна

StorageProfile

Имя	Описание	Ценность
nfsCsiDriver	Параметры драйвера CSI NFS для профиля хранилища.	StorageProfileNfsCSIDriver
smbCsiDriver	Параметры драйвера CSI SMB для профиля хранилища.	StorageProfileSmbCSIDriver

StorageProfileNfsCSIDriver

Имя	Описание	Ценность
Включен	Указывает, следует ли включить драйвер CSI NFS. Значение по умолчанию — true.	bool

StorageProfileSmbCSIDriver

Имя	Описание	Ценность
Включен	Указывает, следует ли включить драйвер CSI SMB. Значение по умолчанию — true.	bool

Примеры использования

Проверенные модули Azure

Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.

Модуль	Описание
гибридной службы контейнеров — подготовленного экземпляра кластера	Модуль ресурсов AVM для гибридной службы контейнеров — подготовленный экземпляр кластера

Примеры быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.

Bicep-файл	Описание
Создание кластера Kubernetes в Azure Stack HCI	Этот шаблон создает кластер Kubernetes в Azure Stack HCI версии 23H2+

Определение ресурса шаблона ARM

Тип ресурса provisionedClusterInstances можно развернуть с помощью операций, целевых:

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

Формат ресурса

Чтобы создать ресурс Microsoft.HybridContainerService/provisionedClusterInstances, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.HybridContainerService/provisionedClusterInstances",
  "apiVersion": "2024-01-01",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "properties": {
    "agentPoolProfiles": [
      {
        "count": "int",
        "enableAutoScaling": "bool",
        "maxCount": "int",
        "maxPods": "int",
        "minCount": "int",
        "name": "string",
        "nodeLabels": {
          "{customized property}": "string"
        },
        "nodeTaints": [ "string" ],
        "osSKU": "string",
        "osType": "string",
        "vmSize": "string"
      }
    ],
    "autoScalerProfile": {
      "balance-similar-node-groups": "string",
      "expander": "string",
      "max-empty-bulk-delete": "string",
      "max-graceful-termination-sec": "string",
      "max-node-provision-time": "string",
      "max-total-unready-percentage": "string",
      "new-pod-scale-up-delay": "string",
      "ok-total-unready-count": "string",
      "scale-down-delay-after-add": "string",
      "scale-down-delay-after-delete": "string",
      "scale-down-delay-after-failure": "string",
      "scale-down-unneeded-time": "string",
      "scale-down-unready-time": "string",
      "scale-down-utilization-threshold": "string",
      "scan-interval": "string",
      "skip-nodes-with-local-storage": "string",
      "skip-nodes-with-system-pods": "string"
    },
    "cloudProviderProfile": {
      "infraNetworkProfile": {
        "vnetSubnetIds": [ "string" ]
      }
    },
    "clusterVMAccessProfile": {
      "authorizedIPRanges": "string"
    },
    "controlPlane": {
      "controlPlaneEndpoint": {
        "hostIP": "string"
      },
      "count": "int",
      "vmSize": "string"
    },
    "kubernetesVersion": "string",
    "licenseProfile": {
      "azureHybridBenefit": "string"
    },
    "linuxProfile": {
      "ssh": {
        "publicKeys": [
          {
            "keyData": "string"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerProfile": {
        "count": "int"
      },
      "networkPolicy": "string",
      "podCidr": "string"
    },
    "storageProfile": {
      "nfsCsiDriver": {
        "enabled": "bool"
      },
      "smbCsiDriver": {
        "enabled": "bool"
      }
    }
  }
}

Значения свойств

AgentPoolProfileNodeLabels

Имя	Описание	Ценность

CloudProviderProfile

Имя	Описание	Ценность
infraNetworkProfile	Профиль для сетей инфраструктуры, используемых подготовленным кластером	CloudProviderProfileInfraNetworkProfile

CloudProviderProfileInfraNetworkProfile

Имя	Описание	Ценность
vnetSubnetIds	Список идентификаторов ресурсов ARM (максимум 1) для сетевого объекта инфраструктуры, например /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName}	string[]

ClusterVMAccessProfile

Имя	Описание	Ценность
authorizedIPRanges	IP-адрес или CIDR для доступа SSH к виртуальным машинам в подготовленном кластере	струна

ControlPlaneProfile

Имя	Описание	Ценность
controlPlaneEndpoint	IP-адрес сервера API Kubernetes	ControlPlaneProfileControlPlaneEndpoint
считать	Количество узлов плоскости управления. Значение по умолчанию равно 1, а число должно быть нечетным числом.	int
vmSize	Размер SKU виртуальной машины узлов уровня управления	струна

ControlPlaneProfileControlPlaneEndpoint

Имя	Описание	Ценность
hostIP	IP-адрес сервера API Kubernetes	струна

ExtendedLocation

Имя	Описание	Ценность
имя	Идентификатор ARM расширенного расположения.	струна
тип	Тип расширенного расположения. Допустимое значение: CustomLocation	CustomLocation

LinuxProfileProperties

Имя	Описание	Ценность
SSH	Конфигурация SSH для виртуальных машин подготовленного кластера.	LinuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Имя	Описание	Ценность
publicKeys	Список открытых ключей SSH, используемых для проверки подлинности с помощью виртуальных машин. Можно указать не более 1 ключа.	LinuxProfilePropertiesSshPublicKeysItem[]

LinuxProfilePropertiesSshPublicKeysItem

Имя	Описание	Ценность
keyData	Открытый ключ сертификата, используемый для проверки подлинности с помощью SSH виртуальных машин. Сертификат должен быть в формате PEM с заголовками или без него.	струна

Microsoft.HybridContainerService/provisionedClusterInstances

Имя	Описание	Ценность
apiVersion	Версия API	'2024-01-01'
extendedLocation	Расширенное расположение, указывающее на базовую инфраструктуру	ExtendedLocation
имя	Имя ресурса	"default" (обязательно)
свойства	Свойства подготовленного кластера.	ProvisionedClusterProperties
тип	Тип ресурса	"Microsoft.HybridContainerService/provisionedClusterInstances"

NamedAgentPoolProfile

Имя	Описание	Ценность
считать	Количество узлов в пуле агентов. Значение по умолчанию — 1.	int
enableAutoScaling	Следует ли включить автомасштабирование. Значение по умолчанию равно false	bool
maxCount	Максимальное количество узлов для автоматического масштабирования	int
maxPods	Максимальное количество модулей pod, которые могут выполняться на узле.	int
minCount	Минимальное количество узлов для автоматического масштабирования	int
имя	Уникальное имя пула агентов по умолчанию в контексте подготовленного кластера. Значение по умолчанию — <clusterName>-nodepool1	струна
nodeLabels	Метки узлов, которые необходимо сохранить во всех узлах в пуле агентов.	AgentPoolProfileNodeLabels
nodeTaints	Таинты добавляются к новым узлам во время создания и масштабирования пула узлов. Например, key=value:NoSchedule.	string[]
osSKU	Указывает номер SKU ОС, используемый пулом агентов. Значение по умолчанию — CBLMariner, если OSType — Linux. Значение по умолчанию — Windows2019, если osType — Windows.	CBLMariner "Windows2019" 'Windows2022'
osType	Конкретный тип ОС образа KubernetesVersion (Linux, Windows)	Linux "Windows"
vmSize	Размер SKU виртуальной машины виртуальных машин пула агентов.	струна

NetworkProfile

Имя	Описание	Ценность
loadBalancerProfile	Профиль подсистемы балансировки нагрузки прокси-сервера высокого уровня доступности.	NetworkProfileLoadBalancerProfile
networkPolicy	Политика сети, используемая для создания сети Kubernetes. Возможные значения включают: "calico".	'calico'
podCidr	Диапазон IP-адресов нотации CIDR, из которого следует назначать IP-адреса pod.	струна

NetworkProfileLoadBalancerProfile

Имя	Описание	Ценность
считать	Количество виртуальных машин подсистемы балансировки нагрузки прокси-сервера высокой доступности. Значение по умолчанию — 0.	int

ProvisionedClusterLicenseProfile

Имя	Описание	Ценность
azureHybridBenefit	Указывает, включено ли преимущество гибридного использования Azure. Значение по умолчанию равно false	"False" NotApplicable "True"

ProvisionedClusterProperties

Имя	Описание	Ценность
agentPoolProfiles	Свойства пула агентов для подготовленного кластера.	NamedAgentPoolProfile[]
autoScalerProfile	Параметры для применения к кластеру автомасштабирования при включении автоматического масштабирования для подготовленного кластера.	ProvisionedClusterPropertiesAutoScalerProfile
cloudProviderProfile	Профиль базового поставщика облачной инфраструктуры для подготовленного кластера.	CloudProviderProfile
clusterVMAccessProfile	Профиль ограниченного доступа SSH для виртуальных машин в подготовленном кластере.	ClusterVMAccessProfile
controlPlane	Профиль уровня управления подготовленного кластера.	ControlPlaneProfile
kubernetesVersion	Версия Kubernetes, используемая подготовленным кластером.	струна
licenseProfile	Профиль лицензии подготовленного кластера.	ProvisionedClusterLicenseProfile
linuxProfile	Профиль для виртуальных машин Linux в подготовленном кластере.	LinuxProfileProperties
networkProfile	Профиль конфигурации сети для подготовленного кластера.	NetworkProfile
storageProfile	Профиль конфигурации хранилища для подготовленного кластера.	StorageProfile

ProvisionedClusterPropertiesAutoScalerProfile

Имя	Описание	Ценность
Balance-similar-node-groups	Допустимые значения: "true" и "false"	струна
расширитель	Если значение не указано, значение по умолчанию — "случайный". Дополнительные сведения см. в расширяющих.	"наименьший объем отходов" "most-pods" "приоритет" "случайный"
max-empty-bulk-delete	Значение по умолчанию — 10.	струна
max-graceful-termination-sec	Значение по умолчанию — 600.	струна
max-node-provision-time	Значение по умолчанию — 15 млн. Значения должны быть целым числом, за которым следует значение "m". Не поддерживается единица времени, отличного от минут (m).	струна
max-total-unready-percentage	Значение по умолчанию — 45. Максимальное значение — 100, а минимальное — 0.	струна
задержка new-pod-up-up-delay	В таких сценариях, как ускорение или пакетное масштабирование, в которых вы не хотите, чтобы ЦС действовал до того, как планировщик kubernetes может запланировать все модули pod, вы можете сообщить ЦС игнорировать незапланированные модули pod до того, как они будут иметь определенный возраст. Значение по умолчанию — 0s. Значения должны быть целым числом, за которым следует единица (в секундах, "m" в минутах, "h" в течение часов и т. д.).	струна
ok-total-unready-count	Это должно быть целое число. Значение по умолчанию — 3.	струна
Горизонтальное масштабирование отложенной задержки после добавления	Значение по умолчанию — 10 млн. Значения должны быть целым числом, за которым следует значение "m". Не поддерживается единица времени, отличного от минут (m).	струна
Горизонтальное масштабирование с задержкой после удаления	По умолчанию используется интервал сканирования. Значения должны быть целым числом, за которым следует значение "m". Не поддерживается единица времени, отличного от минут (m).	струна
Сбой горизонтального уменьшения масштаба отложенной задержки	Значение по умолчанию — "3m". Значения должны быть целым числом, за которым следует значение "m". Не поддерживается единица времени, отличного от минут (m).	струна
горизонтальное масштабирование безумного времени	Значение по умолчанию — 10 млн. Значения должны быть целым числом, за которым следует значение "m". Не поддерживается единица времени, отличного от минут (m).	струна
горизонтальное масштабирование с непрочитанным временем	Значение по умолчанию — 20 млн. Значения должны быть целым числом, за которым следует значение "m". Не поддерживается единица времени, отличного от минут (m).	струна
пороговое значение масштабирования	Значение по умолчанию — 0.5.	струна
интервал сканирования	Значение по умолчанию — 10. Значения должны быть целым числом секунд.	струна
skip-nodes-with-local-storage	Значение по умолчанию — true.	струна
skip-nodes-with-system-pods	Значение по умолчанию — true.	струна

StorageProfile

Имя	Описание	Ценность
nfsCsiDriver	Параметры драйвера CSI NFS для профиля хранилища.	StorageProfileNfsCSIDriver
smbCsiDriver	Параметры драйвера CSI SMB для профиля хранилища.	StorageProfileSmbCSIDriver

StorageProfileNfsCSIDriver

Имя	Описание	Ценность
Включен	Указывает, следует ли включить драйвер CSI NFS. Значение по умолчанию — true.	bool

StorageProfileSmbCSIDriver

Имя	Описание	Ценность
Включен	Указывает, следует ли включить драйвер CSI SMB. Значение по умолчанию — true.	bool

Примеры использования

Шаблоны быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.

Шаблон	Описание
Создание кластера Kubernetes в Azure Stack HCI развертывание	Этот шаблон создает кластер Kubernetes в Azure Stack HCI версии 23H2+

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса provisionedClusterInstances можно развернуть с помощью операций, целевых:

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

Формат ресурса

Чтобы создать ресурс Microsoft.HybridContainerService/provisionedClusterInstances, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.HybridContainerService/provisionedClusterInstances@2024-01-01"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      agentPoolProfiles = [
        {
          count = int
          enableAutoScaling = bool
          maxCount = int
          maxPods = int
          minCount = int
          name = "string"
          nodeLabels = {
            {customized property} = "string"
          }
          nodeTaints = [
            "string"
          ]
          osSKU = "string"
          osType = "string"
          vmSize = "string"
        }
      ]
      autoScalerProfile = {
        balance-similar-node-groups = "string"
        expander = "string"
        max-empty-bulk-delete = "string"
        max-graceful-termination-sec = "string"
        max-node-provision-time = "string"
        max-total-unready-percentage = "string"
        new-pod-scale-up-delay = "string"
        ok-total-unready-count = "string"
        scale-down-delay-after-add = "string"
        scale-down-delay-after-delete = "string"
        scale-down-delay-after-failure = "string"
        scale-down-unneeded-time = "string"
        scale-down-unready-time = "string"
        scale-down-utilization-threshold = "string"
        scan-interval = "string"
        skip-nodes-with-local-storage = "string"
        skip-nodes-with-system-pods = "string"
      }
      cloudProviderProfile = {
        infraNetworkProfile = {
          vnetSubnetIds = [
            "string"
          ]
        }
      }
      clusterVMAccessProfile = {
        authorizedIPRanges = "string"
      }
      controlPlane = {
        controlPlaneEndpoint = {
          hostIP = "string"
        }
        count = int
        vmSize = "string"
      }
      kubernetesVersion = "string"
      licenseProfile = {
        azureHybridBenefit = "string"
      }
      linuxProfile = {
        ssh = {
          publicKeys = [
            {
              keyData = "string"
            }
          ]
        }
      }
      networkProfile = {
        loadBalancerProfile = {
          count = int
        }
        networkPolicy = "string"
        podCidr = "string"
      }
      storageProfile = {
        nfsCsiDriver = {
          enabled = bool
        }
        smbCsiDriver = {
          enabled = bool
        }
      }
    }
  })
}

Значения свойств

AgentPoolProfileNodeLabels

Имя	Описание	Ценность

CloudProviderProfile

Имя	Описание	Ценность
infraNetworkProfile	Профиль для сетей инфраструктуры, используемых подготовленным кластером	CloudProviderProfileInfraNetworkProfile

CloudProviderProfileInfraNetworkProfile

Имя	Описание	Ценность
vnetSubnetIds	Список идентификаторов ресурсов ARM (максимум 1) для сетевого объекта инфраструктуры, например /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName}	string[]

ClusterVMAccessProfile

Имя	Описание	Ценность
authorizedIPRanges	IP-адрес или CIDR для доступа SSH к виртуальным машинам в подготовленном кластере	струна

ControlPlaneProfile

Имя	Описание	Ценность
controlPlaneEndpoint	IP-адрес сервера API Kubernetes	ControlPlaneProfileControlPlaneEndpoint
считать	Количество узлов плоскости управления. Значение по умолчанию равно 1, а число должно быть нечетным числом.	int
vmSize	Размер SKU виртуальной машины узлов уровня управления	струна

ControlPlaneProfileControlPlaneEndpoint

Имя	Описание	Ценность
hostIP	IP-адрес сервера API Kubernetes	струна

ExtendedLocation

Имя	Описание	Ценность
имя	Идентификатор ARM расширенного расположения.	струна
тип	Тип расширенного расположения. Допустимое значение: CustomLocation	CustomLocation

LinuxProfileProperties

Имя	Описание	Ценность
SSH	Конфигурация SSH для виртуальных машин подготовленного кластера.	LinuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Имя	Описание	Ценность
publicKeys	Список открытых ключей SSH, используемых для проверки подлинности с помощью виртуальных машин. Можно указать не более 1 ключа.	LinuxProfilePropertiesSshPublicKeysItem[]

LinuxProfilePropertiesSshPublicKeysItem

Имя	Описание	Ценность
keyData	Открытый ключ сертификата, используемый для проверки подлинности с помощью SSH виртуальных машин. Сертификат должен быть в формате PEM с заголовками или без него.	струна

Microsoft.HybridContainerService/provisionedClusterInstances

Имя	Описание	Ценность
extendedLocation	Расширенное расположение, указывающее на базовую инфраструктуру	ExtendedLocation
имя	Имя ресурса	"default" (обязательно)
parent_id	Идентификатор ресурса для применения этого ресурса расширения.	строка (обязательно)
свойства	Свойства подготовленного кластера.	ProvisionedClusterProperties
тип	Тип ресурса	"Microsoft.HybridContainerService/provisionedClusterInstances@2024-01-01"

NamedAgentPoolProfile

Имя	Описание	Ценность
считать	Количество узлов в пуле агентов. Значение по умолчанию — 1.	int
enableAutoScaling	Следует ли включить автомасштабирование. Значение по умолчанию равно false	bool
maxCount	Максимальное количество узлов для автоматического масштабирования	int
maxPods	Максимальное количество модулей pod, которые могут выполняться на узле.	int
minCount	Минимальное количество узлов для автоматического масштабирования	int
имя	Уникальное имя пула агентов по умолчанию в контексте подготовленного кластера. Значение по умолчанию — <clusterName>-nodepool1	струна
nodeLabels	Метки узлов, которые необходимо сохранить во всех узлах в пуле агентов.	AgentPoolProfileNodeLabels
nodeTaints	Таинты добавляются к новым узлам во время создания и масштабирования пула узлов. Например, key=value:NoSchedule.	string[]
osSKU	Указывает номер SKU ОС, используемый пулом агентов. Значение по умолчанию — CBLMariner, если OSType — Linux. Значение по умолчанию — Windows2019, если osType — Windows.	CBLMariner "Windows2019" 'Windows2022'
osType	Конкретный тип ОС образа KubernetesVersion (Linux, Windows)	Linux "Windows"
vmSize	Размер SKU виртуальной машины виртуальных машин пула агентов.	струна

NetworkProfile

Имя	Описание	Ценность
loadBalancerProfile	Профиль подсистемы балансировки нагрузки прокси-сервера высокого уровня доступности.	NetworkProfileLoadBalancerProfile
networkPolicy	Политика сети, используемая для создания сети Kubernetes. Возможные значения включают: "calico".	'calico'
podCidr	Диапазон IP-адресов нотации CIDR, из которого следует назначать IP-адреса pod.	струна

NetworkProfileLoadBalancerProfile

Имя	Описание	Ценность
считать	Количество виртуальных машин подсистемы балансировки нагрузки прокси-сервера высокой доступности. Значение по умолчанию — 0.	int

ProvisionedClusterLicenseProfile

Имя	Описание	Ценность
azureHybridBenefit	Указывает, включено ли преимущество гибридного использования Azure. Значение по умолчанию равно false	"False" NotApplicable "True"

ProvisionedClusterProperties

Имя	Описание	Ценность
agentPoolProfiles	Свойства пула агентов для подготовленного кластера.	NamedAgentPoolProfile[]
autoScalerProfile	Параметры для применения к кластеру автомасштабирования при включении автоматического масштабирования для подготовленного кластера.	ProvisionedClusterPropertiesAutoScalerProfile
cloudProviderProfile	Профиль базового поставщика облачной инфраструктуры для подготовленного кластера.	CloudProviderProfile
clusterVMAccessProfile	Профиль ограниченного доступа SSH для виртуальных машин в подготовленном кластере.	ClusterVMAccessProfile
controlPlane	Профиль уровня управления подготовленного кластера.	ControlPlaneProfile
kubernetesVersion	Версия Kubernetes, используемая подготовленным кластером.	струна
licenseProfile	Профиль лицензии подготовленного кластера.	ProvisionedClusterLicenseProfile
linuxProfile	Профиль для виртуальных машин Linux в подготовленном кластере.	LinuxProfileProperties
networkProfile	Профиль конфигурации сети для подготовленного кластера.	NetworkProfile
storageProfile	Профиль конфигурации хранилища для подготовленного кластера.	StorageProfile

ProvisionedClusterPropertiesAutoScalerProfile

Имя	Описание	Ценность
Balance-similar-node-groups	Допустимые значения: "true" и "false"	струна
расширитель	Если значение не указано, значение по умолчанию — "случайный". Дополнительные сведения см. в расширяющих.	"наименьший объем отходов" "most-pods" "приоритет" "случайный"
max-empty-bulk-delete	Значение по умолчанию — 10.	струна
max-graceful-termination-sec	Значение по умолчанию — 600.	струна
max-node-provision-time	Значение по умолчанию — 15 млн. Значения должны быть целым числом, за которым следует значение "m". Не поддерживается единица времени, отличного от минут (m).	струна
max-total-unready-percentage	Значение по умолчанию — 45. Максимальное значение — 100, а минимальное — 0.	струна
задержка new-pod-up-up-delay	В таких сценариях, как ускорение или пакетное масштабирование, в которых вы не хотите, чтобы ЦС действовал до того, как планировщик kubernetes может запланировать все модули pod, вы можете сообщить ЦС игнорировать незапланированные модули pod до того, как они будут иметь определенный возраст. Значение по умолчанию — 0s. Значения должны быть целым числом, за которым следует единица (в секундах, "m" в минутах, "h" в течение часов и т. д.).	струна
ok-total-unready-count	Это должно быть целое число. Значение по умолчанию — 3.	струна
Горизонтальное масштабирование отложенной задержки после добавления	Значение по умолчанию — 10 млн. Значения должны быть целым числом, за которым следует значение "m". Не поддерживается единица времени, отличного от минут (m).	струна
Горизонтальное масштабирование с задержкой после удаления	По умолчанию используется интервал сканирования. Значения должны быть целым числом, за которым следует значение "m". Не поддерживается единица времени, отличного от минут (m).	струна
Сбой горизонтального уменьшения масштаба отложенной задержки	Значение по умолчанию — "3m". Значения должны быть целым числом, за которым следует значение "m". Не поддерживается единица времени, отличного от минут (m).	струна
горизонтальное масштабирование безумного времени	Значение по умолчанию — 10 млн. Значения должны быть целым числом, за которым следует значение "m". Не поддерживается единица времени, отличного от минут (m).	струна
горизонтальное масштабирование с непрочитанным временем	Значение по умолчанию — 20 млн. Значения должны быть целым числом, за которым следует значение "m". Не поддерживается единица времени, отличного от минут (m).	струна
пороговое значение масштабирования	Значение по умолчанию — 0.5.	струна
интервал сканирования	Значение по умолчанию — 10. Значения должны быть целым числом секунд.	струна
skip-nodes-with-local-storage	Значение по умолчанию — true.	струна
skip-nodes-with-system-pods	Значение по умолчанию — true.	струна

StorageProfile

Имя	Описание	Ценность
nfsCsiDriver	Параметры драйвера CSI NFS для профиля хранилища.	StorageProfileNfsCSIDriver
smbCsiDriver	Параметры драйвера CSI SMB для профиля хранилища.	StorageProfileSmbCSIDriver

StorageProfileNfsCSIDriver

Имя	Описание	Ценность
Включен	Указывает, следует ли включить драйвер CSI NFS. Значение по умолчанию — true.	bool

StorageProfileSmbCSIDriver

Имя	Описание	Ценность
Включен	Указывает, следует ли включить драйвер CSI SMB. Значение по умолчанию — true.	bool

Примеры использования

Проверенные модули Azure

Следующие проверенные модули Azure можно использовать для развертывания этого типа ресурсов.

Модуль	Описание
AKS Arc	Модуль ресурсов AVM для AKS Arc