Udostępnij za pośrednictwem

Microsoft.HybridContainerService provisionedClusterInstances

  • Artykuł

Definicja zasobu Bicep

Typ zasobu provisionedClusterInstances można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.HybridContainerService/provisionedClusterInstances, dodaj następujący kod Bicep do szablonu.

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
      }
    }
  }
}

Wartości właściwości

AgentPoolProfileNodeLabels

Nazwa Opis Wartość

CloudProviderProfile

Nazwa Opis Wartość
infraNetworkProfile Profil sieci infrastruktury używanych przez aprowizowany klaster CloudProviderProfileInfraNetworkProfile

CloudProviderProfileInfraNetworkProfile

Nazwa Opis Wartość
vnetSubnetIds Lista identyfikatorów zasobów usługi ARM (maksymalnie 1) dla obiektu sieciowego infrastruktury, np. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName} string[]

ClusterVMAccessProfile

Nazwa Opis Wartość
authorizedIPRanges Adres IP lub CIDR dla dostępu SSH do maszyn wirtualnych w aprowizowanej klastrze struna

ControlPlaneProfile

Nazwa Opis Wartość
controlPlaneEndpoint Adres IP serwera interfejsu API Kubernetes ControlPlaneProfileControlPlaneEndpoint
hrabia Liczba węzłów płaszczyzny sterowania. Wartość domyślna to 1, a liczba powinna być liczbą nieparzysta Int
vmSize Rozmiar jednostki SKU maszyny wirtualnej węzłów płaszczyzny sterowania struna

ControlPlaneProfileControlPlaneEndpoint

Nazwa Opis Wartość
hostIP Adres IP serwera interfejsu API Kubernetes struna

ExtendedLocation

Nazwa Opis Wartość
nazwa Identyfikator arm lokalizacji rozszerzonej. struna
typ Typ lokalizacji rozszerzonej. Dozwolona wartość: "CustomLocation" "CustomLocation"

LinuxProfileProperties

Nazwa Opis Wartość
SSH Konfiguracja protokołu SSH dla maszyn wirtualnych aprowizowanego klastra. LinuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Nazwa Opis Wartość
publicKeys Lista kluczy publicznych SSH używanych do uwierzytelniania za pomocą maszyn wirtualnych. Można określić maksymalnie 1 klucz. LinuxProfilePropertiesSshPublicKeysItem[]

LinuxProfilePropertiesSshPublicKeysItem

Nazwa Opis Wartość
keyData Klucz publiczny certyfikatu używany do uwierzytelniania za pomocą maszyn wirtualnych za pośrednictwem protokołu SSH. Certyfikat musi być w formacie PEM z nagłówkami lub bez. struna

Microsoft.HybridContainerService/provisionedClusterInstances

Nazwa Opis Wartość
extendedLocation Lokalizacja rozszerzona wskazująca podstawową infrastrukturę ExtendedLocation
nazwa Nazwa zasobu "default" (wymagane)
Właściwości Właściwości aprowizowanego klastra. ProvisionedClusterProperties
zakres Użyj polecenia podczas tworzenia zasobu w zakresie innym niż zakres wdrożenia. Ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia .

NamedAgentPoolProfile

Nazwa Opis Wartość
hrabia Liczba węzłów w puli agentów. Wartość domyślna to 1. Int
enableAutoScaling Czy włączyć automatyczne skalowanie. Wartość domyślna to false Bool
maxCount Maksymalna liczba węzłów do automatycznego skalowania Int
maxPods Maksymalna liczba zasobników, które mogą być uruchamiane w węźle. Int
minCount Minimalna liczba węzłów do automatycznego skalowania Int
nazwa Unikatowa nazwa domyślnej puli agentów w kontekście aprowizowanego klastra. Wartość domyślna to <clusterName>-nodepool1 struna
nodeLabels Etykiety węzłów, które mają być utrwalane we wszystkich węzłach w puli agentów. AgentPoolProfileNodeLabels
nodeTaints Taints dodane do nowych węzłów podczas tworzenia i skalowania puli węzłów. Na przykład key=value:NoSchedule. string[]
osSKU Określa jednostkę SKU systemu operacyjnego używaną przez pulę agentów. Wartość domyślna to CBLMariner, jeśli OSType to Linux. Wartość domyślna to Windows2019, gdy typ systemu operacyjnego to Windows. "CBLMariner"
"Windows2019"
"Windows2022"
osType Konkretny typ systemu operacyjnego obrazu KubernetesVersion (Linux, Windows) "Linux"
"Windows"
vmSize Rozmiar jednostki SKU maszyny wirtualnej maszyn wirtualnych węzła puli agentów. struna

NetworkProfile

Nazwa Opis Wartość
loadBalancerProfile Profil modułu równoważenia obciążenia serwera proxy wysokiej dostępności. NetworkProfileLoadBalancerProfile
networkPolicy Zasady sieci używane do tworzenia sieci Kubernetes. Możliwe wartości to: "calico". "calico"
podCidr Zakres adresów IP notacji CIDR, z którego można przypisać adresy IP zasobników. struna

NetworkProfileLoadBalancerProfile

Nazwa Opis Wartość
hrabia Liczba maszyn wirtualnych modułu równoważenia obciążenia serwera proxy wysokiej dostępności. Wartość domyślna to 0. Int

ProvisionedClusterLicenseProfile

Nazwa Opis Wartość
azureHybridBenefit Wskazuje, czy korzyść użycia hybrydowego platformy Azure jest włączona. Wartość domyślna to false "Fałsz"
"NotApplicable"
"True"

ProvisionedClusterProperties

Nazwa Opis Wartość
agentPoolProfiles Właściwości puli agentów dla aprowizowanego klastra. NazwanyPoolProfile[]
autoScalerProfile Parametry, które mają być stosowane do skalowania automatycznego klastra po włączeniu automatycznego skalowania dla aprowizowanego klastra. ProvisionedClusterPropertiesAutoScalerProfile
cloudProviderProfile Profil bazowego dostawcy infrastruktury w chmurze dla aprowizowanego klastra. CloudProviderProfile
clusterVMAccessProfile Profil dostępu z ograniczeniami SSH dla maszyn wirtualnych w aprowizowanej klastrze. ClusterVMAccessProfile
controlPlane Profil płaszczyzny sterowania aprowizowanego klastra. ControlPlaneProfile
kubernetesVersion Wersja rozwiązania Kubernetes używana przez aprowizowany klaster. struna
licenseProfile Profil licencji aprowizowanego klastra. ProvisionedClusterLicenseProfile
linuxProfile Profil maszyn wirtualnych z systemem Linux w aprowizowanej klastrze. LinuxProfileProperties
networkProfile Profil konfiguracji sieci dla aprowizowanego klastra. NetworkProfile
storageProfile Profil konfiguracji magazynu dla aprowizowanego klastra. StorageProfile

ProvisionedClusterPropertiesAutoScalerProfile

Nazwa Opis Wartość
równoważenie podobnych grup węzłów Prawidłowe wartości to "true" i "false" struna
Expander Jeśli nie zostanie określony, wartość domyślna to "losowe". Aby uzyskać więcej informacji, zobacz rozszerzenia. "najmniej odpadów"
"most-pods"
"priorytet"
"losowe"
max-empty-bulk-delete Wartość domyślna to 10. struna
max-graceful-termination-sec Wartość domyślna to 600. struna
max-node-provision-time Wartość domyślna to "15m". Wartości muszą być liczbą całkowitą, po której następuje 'm'. Nie jest obsługiwana żadna jednostka czasu innego niż minuty (m). struna
max-total-unready-percentage Wartość domyślna to 45. Wartość maksymalna to 100, a wartość minimalna to 0. struna
nowe opóźnienie w skali zasobnika w górę W przypadku scenariuszy, takich jak skalowanie wsadowe/ wsadowe, w których nie chcesz, aby urząd certyfikacji działał przed zaplanowaniem harmonogramu kubernetes, można poinformować urząd certyfikacji, aby ignorował nieplanowane zasobniki przed upływem określonego wieku. Wartość domyślna to "0s". Wartości muszą być liczbą całkowitą, po której następuje jednostka (w sekundach, "m" przez minuty, "h" przez godziny itp.). struna
ok-total-unready-count Musi to być liczba całkowita. Wartość domyślna to 3. struna
scale-down-delay-after-add Wartość domyślna to "10m". Wartości muszą być liczbą całkowitą, po której następuje 'm'. Nie jest obsługiwana żadna jednostka czasu innego niż minuty (m). struna
scale-down-delay-after-delete Wartość domyślna to interwał skanowania. Wartości muszą być liczbą całkowitą, po której następuje 'm'. Nie jest obsługiwana żadna jednostka czasu innego niż minuty (m). struna
scale-down-delay-after-failure Wartość domyślna to "3m". Wartości muszą być liczbą całkowitą, po której następuje 'm'. Nie jest obsługiwana żadna jednostka czasu innego niż minuty (m). struna
skalowanie w dół — niepotrzebny czas Wartość domyślna to "10m". Wartości muszą być liczbą całkowitą, po której następuje 'm'. Nie jest obsługiwana żadna jednostka czasu innego niż minuty (m). struna
scale-down-unready-time Wartość domyślna to "20m". Wartości muszą być liczbą całkowitą, po której następuje 'm'. Nie jest obsługiwana żadna jednostka czasu innego niż minuty (m). struna
próg wykorzystania skalowania w dół Wartość domyślna to "0,5". struna
interwał skanowania Wartość domyślna to "10". Wartości muszą być liczbą całkowitą sekund. struna
skip-nodes-with-local-storage Wartość domyślna to true. struna
skip-nodes-with-system-pods Wartość domyślna to true. struna

StorageProfile

Nazwa Opis Wartość
nfsCsiDriver Ustawienia sterownika NFS CSI dla profilu magazynu. StorageProfileNfsCSIDriver
smbCsiDriver Ustawienia sterownika SMB CSI dla profilu magazynu. StorageProfileSmbCSIDriver

StorageProfileNfsCSIDriver

Nazwa Opis Wartość
Włączone Wskazuje, czy włączyć sterownik NFS CSI. Wartość domyślna to true. Bool

StorageProfileSmbCSIDriver

Nazwa Opis Wartość
Włączone Wskazuje, czy włączyć sterownik SMB CSI. Wartość domyślna to true. Bool

Przykłady użycia

Przykłady szybkiego startu platformy Azure

Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.

Plik Bicep Opis
Tworzenie klastra Kubernetes w usłudze Azure Stack HCI Ten szablon tworzy klaster Kubernetes w usłudze Azure Stack HCI w wersji 23H2+

Definicja zasobu szablonu usługi ARM

Typ zasobu provisionedClusterInstances można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.HybridContainerService/provisionedClusterInstances, dodaj następujący kod JSON do szablonu.

{
  "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"
      }
    }
  }
}

Wartości właściwości

AgentPoolProfileNodeLabels

Nazwa Opis Wartość

CloudProviderProfile

Nazwa Opis Wartość
infraNetworkProfile Profil sieci infrastruktury używanych przez aprowizowany klaster CloudProviderProfileInfraNetworkProfile

CloudProviderProfileInfraNetworkProfile

Nazwa Opis Wartość
vnetSubnetIds Lista identyfikatorów zasobów usługi ARM (maksymalnie 1) dla obiektu sieciowego infrastruktury, np. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName} string[]

ClusterVMAccessProfile

Nazwa Opis Wartość
authorizedIPRanges Adres IP lub CIDR dla dostępu SSH do maszyn wirtualnych w aprowizowanej klastrze struna

ControlPlaneProfile

Nazwa Opis Wartość
controlPlaneEndpoint Adres IP serwera interfejsu API Kubernetes ControlPlaneProfileControlPlaneEndpoint
hrabia Liczba węzłów płaszczyzny sterowania. Wartość domyślna to 1, a liczba powinna być liczbą nieparzysta Int
vmSize Rozmiar jednostki SKU maszyny wirtualnej węzłów płaszczyzny sterowania struna

ControlPlaneProfileControlPlaneEndpoint

Nazwa Opis Wartość
hostIP Adres IP serwera interfejsu API Kubernetes struna

ExtendedLocation

Nazwa Opis Wartość
nazwa Identyfikator arm lokalizacji rozszerzonej. struna
typ Typ lokalizacji rozszerzonej. Dozwolona wartość: "CustomLocation" "CustomLocation"

LinuxProfileProperties

Nazwa Opis Wartość
SSH Konfiguracja protokołu SSH dla maszyn wirtualnych aprowizowanego klastra. LinuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Nazwa Opis Wartość
publicKeys Lista kluczy publicznych SSH używanych do uwierzytelniania za pomocą maszyn wirtualnych. Można określić maksymalnie 1 klucz. LinuxProfilePropertiesSshPublicKeysItem[]

LinuxProfilePropertiesSshPublicKeysItem

Nazwa Opis Wartość
keyData Klucz publiczny certyfikatu używany do uwierzytelniania za pomocą maszyn wirtualnych za pośrednictwem protokołu SSH. Certyfikat musi być w formacie PEM z nagłówkami lub bez. struna

Microsoft.HybridContainerService/provisionedClusterInstances

Nazwa Opis Wartość
apiVersion Wersja interfejsu API '2024-01-01'
extendedLocation Lokalizacja rozszerzona wskazująca podstawową infrastrukturę ExtendedLocation
nazwa Nazwa zasobu "default" (wymagane)
Właściwości Właściwości aprowizowanego klastra. ProvisionedClusterProperties
typ Typ zasobu "Microsoft.HybridContainerService/provisionedClusterInstances"

NamedAgentPoolProfile

Nazwa Opis Wartość
hrabia Liczba węzłów w puli agentów. Wartość domyślna to 1. Int
enableAutoScaling Czy włączyć automatyczne skalowanie. Wartość domyślna to false Bool
maxCount Maksymalna liczba węzłów do automatycznego skalowania Int
maxPods Maksymalna liczba zasobników, które mogą być uruchamiane w węźle. Int
minCount Minimalna liczba węzłów do automatycznego skalowania Int
nazwa Unikatowa nazwa domyślnej puli agentów w kontekście aprowizowanego klastra. Wartość domyślna to <clusterName>-nodepool1 struna
nodeLabels Etykiety węzłów, które mają być utrwalane we wszystkich węzłach w puli agentów. AgentPoolProfileNodeLabels
nodeTaints Taints dodane do nowych węzłów podczas tworzenia i skalowania puli węzłów. Na przykład key=value:NoSchedule. string[]
osSKU Określa jednostkę SKU systemu operacyjnego używaną przez pulę agentów. Wartość domyślna to CBLMariner, jeśli OSType to Linux. Wartość domyślna to Windows2019, gdy typ systemu operacyjnego to Windows. "CBLMariner"
"Windows2019"
"Windows2022"
osType Konkretny typ systemu operacyjnego obrazu KubernetesVersion (Linux, Windows) "Linux"
"Windows"
vmSize Rozmiar jednostki SKU maszyny wirtualnej maszyn wirtualnych węzła puli agentów. struna

NetworkProfile

Nazwa Opis Wartość
loadBalancerProfile Profil modułu równoważenia obciążenia serwera proxy wysokiej dostępności. NetworkProfileLoadBalancerProfile
networkPolicy Zasady sieci używane do tworzenia sieci Kubernetes. Możliwe wartości to: "calico". "calico"
podCidr Zakres adresów IP notacji CIDR, z którego można przypisać adresy IP zasobników. struna

NetworkProfileLoadBalancerProfile

Nazwa Opis Wartość
hrabia Liczba maszyn wirtualnych modułu równoważenia obciążenia serwera proxy wysokiej dostępności. Wartość domyślna to 0. Int

ProvisionedClusterLicenseProfile

Nazwa Opis Wartość
azureHybridBenefit Wskazuje, czy korzyść użycia hybrydowego platformy Azure jest włączona. Wartość domyślna to false "Fałsz"
"NotApplicable"
"True"

ProvisionedClusterProperties

Nazwa Opis Wartość
agentPoolProfiles Właściwości puli agentów dla aprowizowanego klastra. NazwanyPoolProfile[]
autoScalerProfile Parametry, które mają być stosowane do skalowania automatycznego klastra po włączeniu automatycznego skalowania dla aprowizowanego klastra. ProvisionedClusterPropertiesAutoScalerProfile
cloudProviderProfile Profil bazowego dostawcy infrastruktury w chmurze dla aprowizowanego klastra. CloudProviderProfile
clusterVMAccessProfile Profil dostępu z ograniczeniami SSH dla maszyn wirtualnych w aprowizowanej klastrze. ClusterVMAccessProfile
controlPlane Profil płaszczyzny sterowania aprowizowanego klastra. ControlPlaneProfile
kubernetesVersion Wersja rozwiązania Kubernetes używana przez aprowizowany klaster. struna
licenseProfile Profil licencji aprowizowanego klastra. ProvisionedClusterLicenseProfile
linuxProfile Profil maszyn wirtualnych z systemem Linux w aprowizowanej klastrze. LinuxProfileProperties
networkProfile Profil konfiguracji sieci dla aprowizowanego klastra. NetworkProfile
storageProfile Profil konfiguracji magazynu dla aprowizowanego klastra. StorageProfile

ProvisionedClusterPropertiesAutoScalerProfile

Nazwa Opis Wartość
równoważenie podobnych grup węzłów Prawidłowe wartości to "true" i "false" struna
Expander Jeśli nie zostanie określony, wartość domyślna to "losowe". Aby uzyskać więcej informacji, zobacz rozszerzenia. "najmniej odpadów"
"most-pods"
"priorytet"
"losowe"
max-empty-bulk-delete Wartość domyślna to 10. struna
max-graceful-termination-sec Wartość domyślna to 600. struna
max-node-provision-time Wartość domyślna to "15m". Wartości muszą być liczbą całkowitą, po której następuje 'm'. Nie jest obsługiwana żadna jednostka czasu innego niż minuty (m). struna
max-total-unready-percentage Wartość domyślna to 45. Wartość maksymalna to 100, a wartość minimalna to 0. struna
nowe opóźnienie w skali zasobnika w górę W przypadku scenariuszy, takich jak skalowanie wsadowe/ wsadowe, w których nie chcesz, aby urząd certyfikacji działał przed zaplanowaniem harmonogramu kubernetes, można poinformować urząd certyfikacji, aby ignorował nieplanowane zasobniki przed upływem określonego wieku. Wartość domyślna to "0s". Wartości muszą być liczbą całkowitą, po której następuje jednostka (w sekundach, "m" przez minuty, "h" przez godziny itp.). struna
ok-total-unready-count Musi to być liczba całkowita. Wartość domyślna to 3. struna
scale-down-delay-after-add Wartość domyślna to "10m". Wartości muszą być liczbą całkowitą, po której następuje 'm'. Nie jest obsługiwana żadna jednostka czasu innego niż minuty (m). struna
scale-down-delay-after-delete Wartość domyślna to interwał skanowania. Wartości muszą być liczbą całkowitą, po której następuje 'm'. Nie jest obsługiwana żadna jednostka czasu innego niż minuty (m). struna
scale-down-delay-after-failure Wartość domyślna to "3m". Wartości muszą być liczbą całkowitą, po której następuje 'm'. Nie jest obsługiwana żadna jednostka czasu innego niż minuty (m). struna
skalowanie w dół — niepotrzebny czas Wartość domyślna to "10m". Wartości muszą być liczbą całkowitą, po której następuje 'm'. Nie jest obsługiwana żadna jednostka czasu innego niż minuty (m). struna
scale-down-unready-time Wartość domyślna to "20m". Wartości muszą być liczbą całkowitą, po której następuje 'm'. Nie jest obsługiwana żadna jednostka czasu innego niż minuty (m). struna
próg wykorzystania skalowania w dół Wartość domyślna to "0,5". struna
interwał skanowania Wartość domyślna to "10". Wartości muszą być liczbą całkowitą sekund. struna
skip-nodes-with-local-storage Wartość domyślna to true. struna
skip-nodes-with-system-pods Wartość domyślna to true. struna

StorageProfile

Nazwa Opis Wartość
nfsCsiDriver Ustawienia sterownika NFS CSI dla profilu magazynu. StorageProfileNfsCSIDriver
smbCsiDriver Ustawienia sterownika SMB CSI dla profilu magazynu. StorageProfileSmbCSIDriver

StorageProfileNfsCSIDriver

Nazwa Opis Wartość
Włączone Wskazuje, czy włączyć sterownik NFS CSI. Wartość domyślna to true. Bool

StorageProfileSmbCSIDriver

Nazwa Opis Wartość
Włączone Wskazuje, czy włączyć sterownik SMB CSI. Wartość domyślna to true. Bool

Przykłady użycia

Szablony szybkiego startu platformy Azure

Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.

Szablon Opis
Tworzenie klastra Kubernetes w usłudze Azure Stack HCI

wdrażanie w usłudze Azure		 Ten szablon tworzy klaster Kubernetes w usłudze Azure Stack HCI w wersji 23H2+

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu provisionedClusterInstances można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.HybridContainerService/provisionedClusterInstances, dodaj następujący program Terraform do szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.HybridContainerService/provisionedClusterInstances@2024-01-01"
  name = "string"
  parent_id = "string"
  body = {
    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
        }
      }
    }
  }
}

Wartości właściwości

AgentPoolProfileNodeLabels

Nazwa Opis Wartość

CloudProviderProfile

Nazwa Opis Wartość
infraNetworkProfile Profil sieci infrastruktury używanych przez aprowizowany klaster CloudProviderProfileInfraNetworkProfile

CloudProviderProfileInfraNetworkProfile

Nazwa Opis Wartość
vnetSubnetIds Lista identyfikatorów zasobów usługi ARM (maksymalnie 1) dla obiektu sieciowego infrastruktury, np. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName} string[]

ClusterVMAccessProfile

Nazwa Opis Wartość
authorizedIPRanges Adres IP lub CIDR dla dostępu SSH do maszyn wirtualnych w aprowizowanej klastrze struna

ControlPlaneProfile

Nazwa Opis Wartość
controlPlaneEndpoint Adres IP serwera interfejsu API Kubernetes ControlPlaneProfileControlPlaneEndpoint
hrabia Liczba węzłów płaszczyzny sterowania. Wartość domyślna to 1, a liczba powinna być liczbą nieparzysta Int
vmSize Rozmiar jednostki SKU maszyny wirtualnej węzłów płaszczyzny sterowania struna

ControlPlaneProfileControlPlaneEndpoint

Nazwa Opis Wartość
hostIP Adres IP serwera interfejsu API Kubernetes struna

ExtendedLocation

Nazwa Opis Wartość
nazwa Identyfikator arm lokalizacji rozszerzonej. struna
typ Typ lokalizacji rozszerzonej. Dozwolona wartość: "CustomLocation" "CustomLocation"

LinuxProfileProperties

Nazwa Opis Wartość
SSH Konfiguracja protokołu SSH dla maszyn wirtualnych aprowizowanego klastra. LinuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Nazwa Opis Wartość
publicKeys Lista kluczy publicznych SSH używanych do uwierzytelniania za pomocą maszyn wirtualnych. Można określić maksymalnie 1 klucz. LinuxProfilePropertiesSshPublicKeysItem[]

LinuxProfilePropertiesSshPublicKeysItem

Nazwa Opis Wartość
keyData Klucz publiczny certyfikatu używany do uwierzytelniania za pomocą maszyn wirtualnych za pośrednictwem protokołu SSH. Certyfikat musi być w formacie PEM z nagłówkami lub bez. struna

Microsoft.HybridContainerService/provisionedClusterInstances

Nazwa Opis Wartość
extendedLocation Lokalizacja rozszerzona wskazująca podstawową infrastrukturę ExtendedLocation
nazwa Nazwa zasobu "default" (wymagane)
parent_id Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia. ciąg (wymagany)
Właściwości Właściwości aprowizowanego klastra. ProvisionedClusterProperties
typ Typ zasobu "Microsoft.HybridContainerService/provisionedClusterInstances@2024-01-01"

NamedAgentPoolProfile

Nazwa Opis Wartość
hrabia Liczba węzłów w puli agentów. Wartość domyślna to 1. Int
enableAutoScaling Czy włączyć automatyczne skalowanie. Wartość domyślna to false Bool
maxCount Maksymalna liczba węzłów do automatycznego skalowania Int
maxPods Maksymalna liczba zasobników, które mogą być uruchamiane w węźle. Int
minCount Minimalna liczba węzłów do automatycznego skalowania Int
nazwa Unikatowa nazwa domyślnej puli agentów w kontekście aprowizowanego klastra. Wartość domyślna to <clusterName>-nodepool1 struna
nodeLabels Etykiety węzłów, które mają być utrwalane we wszystkich węzłach w puli agentów. AgentPoolProfileNodeLabels
nodeTaints Taints dodane do nowych węzłów podczas tworzenia i skalowania puli węzłów. Na przykład key=value:NoSchedule. string[]
osSKU Określa jednostkę SKU systemu operacyjnego używaną przez pulę agentów. Wartość domyślna to CBLMariner, jeśli OSType to Linux. Wartość domyślna to Windows2019, gdy typ systemu operacyjnego to Windows. "CBLMariner"
"Windows2019"
"Windows2022"
osType Konkretny typ systemu operacyjnego obrazu KubernetesVersion (Linux, Windows) "Linux"
"Windows"
vmSize Rozmiar jednostki SKU maszyny wirtualnej maszyn wirtualnych węzła puli agentów. struna

NetworkProfile

Nazwa Opis Wartość
loadBalancerProfile Profil modułu równoważenia obciążenia serwera proxy wysokiej dostępności. NetworkProfileLoadBalancerProfile
networkPolicy Zasady sieci używane do tworzenia sieci Kubernetes. Możliwe wartości to: "calico". "calico"
podCidr Zakres adresów IP notacji CIDR, z którego można przypisać adresy IP zasobników. struna

NetworkProfileLoadBalancerProfile

Nazwa Opis Wartość
hrabia Liczba maszyn wirtualnych modułu równoważenia obciążenia serwera proxy wysokiej dostępności. Wartość domyślna to 0. Int

ProvisionedClusterLicenseProfile

Nazwa Opis Wartość
azureHybridBenefit Wskazuje, czy korzyść użycia hybrydowego platformy Azure jest włączona. Wartość domyślna to false "Fałsz"
"NotApplicable"
"True"

ProvisionedClusterProperties

Nazwa Opis Wartość
agentPoolProfiles Właściwości puli agentów dla aprowizowanego klastra. NazwanyPoolProfile[]
autoScalerProfile Parametry, które mają być stosowane do skalowania automatycznego klastra po włączeniu automatycznego skalowania dla aprowizowanego klastra. ProvisionedClusterPropertiesAutoScalerProfile
cloudProviderProfile Profil bazowego dostawcy infrastruktury w chmurze dla aprowizowanego klastra. CloudProviderProfile
clusterVMAccessProfile Profil dostępu z ograniczeniami SSH dla maszyn wirtualnych w aprowizowanej klastrze. ClusterVMAccessProfile
controlPlane Profil płaszczyzny sterowania aprowizowanego klastra. ControlPlaneProfile
kubernetesVersion Wersja rozwiązania Kubernetes używana przez aprowizowany klaster. struna
licenseProfile Profil licencji aprowizowanego klastra. ProvisionedClusterLicenseProfile
linuxProfile Profil maszyn wirtualnych z systemem Linux w aprowizowanej klastrze. LinuxProfileProperties
networkProfile Profil konfiguracji sieci dla aprowizowanego klastra. NetworkProfile
storageProfile Profil konfiguracji magazynu dla aprowizowanego klastra. StorageProfile

ProvisionedClusterPropertiesAutoScalerProfile

Nazwa Opis Wartość
równoważenie podobnych grup węzłów Prawidłowe wartości to "true" i "false" struna
Expander Jeśli nie zostanie określony, wartość domyślna to "losowe". Aby uzyskać więcej informacji, zobacz rozszerzenia. "najmniej odpadów"
"most-pods"
"priorytet"
"losowe"
max-empty-bulk-delete Wartość domyślna to 10. struna
max-graceful-termination-sec Wartość domyślna to 600. struna
max-node-provision-time Wartość domyślna to "15m". Wartości muszą być liczbą całkowitą, po której następuje 'm'. Nie jest obsługiwana żadna jednostka czasu innego niż minuty (m). struna
max-total-unready-percentage Wartość domyślna to 45. Wartość maksymalna to 100, a wartość minimalna to 0. struna
nowe opóźnienie w skali zasobnika w górę W przypadku scenariuszy, takich jak skalowanie wsadowe/ wsadowe, w których nie chcesz, aby urząd certyfikacji działał przed zaplanowaniem harmonogramu kubernetes, można poinformować urząd certyfikacji, aby ignorował nieplanowane zasobniki przed upływem określonego wieku. Wartość domyślna to "0s". Wartości muszą być liczbą całkowitą, po której następuje jednostka (w sekundach, "m" przez minuty, "h" przez godziny itp.). struna
ok-total-unready-count Musi to być liczba całkowita. Wartość domyślna to 3. struna
scale-down-delay-after-add Wartość domyślna to "10m". Wartości muszą być liczbą całkowitą, po której następuje 'm'. Nie jest obsługiwana żadna jednostka czasu innego niż minuty (m). struna
scale-down-delay-after-delete Wartość domyślna to interwał skanowania. Wartości muszą być liczbą całkowitą, po której następuje 'm'. Nie jest obsługiwana żadna jednostka czasu innego niż minuty (m). struna
scale-down-delay-after-failure Wartość domyślna to "3m". Wartości muszą być liczbą całkowitą, po której następuje 'm'. Nie jest obsługiwana żadna jednostka czasu innego niż minuty (m). struna
skalowanie w dół — niepotrzebny czas Wartość domyślna to "10m". Wartości muszą być liczbą całkowitą, po której następuje 'm'. Nie jest obsługiwana żadna jednostka czasu innego niż minuty (m). struna
scale-down-unready-time Wartość domyślna to "20m". Wartości muszą być liczbą całkowitą, po której następuje 'm'. Nie jest obsługiwana żadna jednostka czasu innego niż minuty (m). struna
próg wykorzystania skalowania w dół Wartość domyślna to "0,5". struna
interwał skanowania Wartość domyślna to "10". Wartości muszą być liczbą całkowitą sekund. struna
skip-nodes-with-local-storage Wartość domyślna to true. struna
skip-nodes-with-system-pods Wartość domyślna to true. struna

StorageProfile

Nazwa Opis Wartość
nfsCsiDriver Ustawienia sterownika NFS CSI dla profilu magazynu. StorageProfileNfsCSIDriver
smbCsiDriver Ustawienia sterownika SMB CSI dla profilu magazynu. StorageProfileSmbCSIDriver

StorageProfileNfsCSIDriver

Nazwa Opis Wartość
Włączone Wskazuje, czy włączyć sterownik NFS CSI. Wartość domyślna to true. Bool

StorageProfileSmbCSIDriver

Nazwa Opis Wartość
Włączone Wskazuje, czy włączyć sterownik SMB CSI. Wartość domyślna to true. Bool

Przykłady użycia

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł Opis
usługi AKS Arc Moduł zasobów AVM dla usługi AKS Arc