Freigeben über

Microsoft.HybridContainerService provisionedClusterInstances 2024-01-01

  • Artikel

Bicep-Ressourcendefinition

Der ressourcentyp "provisionedClusterInstances" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.HybridContainerService/provisionedClusterInstances-Ressource zu erstellen, fügen Sie der Vorlage die folgende Bicep hinzu.

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

Eigenschaftswerte

AgentPoolProfileNodeLabels

Name Beschreibung Wert

CloudProviderProfile

Name Beschreibung Wert
infraNetworkProfile Das Profil für die Infrastrukturnetzwerke, die vom bereitgestellten Cluster verwendet werden CloudProviderProfileInfraNetworkProfile-

CloudProviderProfileInfraNetworkProfile

Name Beschreibung Wert
vnetSubnetIds Liste der ARM-Ressourcen-IDs (maximal 1) für das Infrastrukturnetzwerkobjekt, z. B. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName} string[]

ClusterVMAccessProfile

Name Beschreibung Wert
authorizedIPRanges IP-Adresse oder CIDR für SSH-Zugriff auf VMs im bereitgestellten Cluster Schnur

ControlPlaneProfile

Name Beschreibung Wert
controlPlaneEndpoint IP-Adresse des Kubernetes-API-Servers ControlPlaneProfileControlPlaneEndpoint-
zählen Anzahl der Steuerebenenknoten. Der Standardwert ist 1, und die Anzahl sollte eine ungerade Zahl sein. Int
vmSize VM-SKU-Größe der Steuerebenenknoten Schnur

ControlPlaneProfileControlPlaneEndpoint

Name Beschreibung Wert
hostIP IP-Adresse des Kubernetes-API-Servers Schnur

ExtendedLocation

Name Beschreibung Wert
Name ARM-ID des erweiterten Speicherorts. Schnur
Art Der erweiterte Standorttyp. Zulässiger Wert: 'CustomLocation' 'CustomLocation'

LinuxProfileProperties

Name Beschreibung Wert
ssh SSH-Konfiguration für VMs des bereitgestellten Clusters. LinuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Name Beschreibung Wert
publicKeys Die Liste der öffentlichen SSH-Schlüssel, die für die Authentifizierung mit VMs verwendet werden. Es kann maximal 1 Schlüssel angegeben werden. LinuxProfilePropertiesSshPublicKeysItem[]

LinuxProfilePropertiesSshPublicKeysItem

Name Beschreibung Wert
keyData Öffentlicher Zertifikatschlüssel, der für die Authentifizierung mit VMs über SSH verwendet wird. Das Zertifikat muss im PEM-Format mit oder ohne Kopfzeilen vorliegen. Schnur

Microsoft.HybridContainerService/provisionedClusterInstances

Name Beschreibung Wert
extendedLocation Erweiterter Standort, der auf die zugrunde liegende Infrastruktur verweist ExtendedLocation-
Name Der Ressourcenname "default" (erforderlich)
Eigenschaften Eigenschaften des bereitgestellten Clusters. ProvisionedClusterProperties
Umfang Verwenden Sie diese Verwendung beim Erstellen einer Ressource in einem Bereich, der sich von dem Bereitstellungsbereich unterscheidet. Legen Sie diese Eigenschaft auf den symbolischen Namen einer Ressource fest, um die Erweiterungsressourceanzuwenden.

NamedAgentPoolProfile

Name Beschreibung Wert
zählen Anzahl der Knoten im Agentpool. Der Standardwert ist 1. Int
enableAutoScaling Gibt an, ob die automatische Skalierung aktiviert werden soll. Standardwert ist "false". Bool
maxCount Die maximale Anzahl von Knoten für die automatische Skalierung Int
maxPods Die maximale Anzahl von Pods, die auf einem Knoten ausgeführt werden können. Int
minCount Die Mindestanzahl von Knoten für die automatische Skalierung Int
Name Eindeutiger Name des Standard-Agentpools im Kontext des bereitgestellten Clusters. Der Standardwert ist <clusterName>-nodepool1 Schnur
nodeLabels Die Knotenbeschriftungen, die über alle Knoten im Agentpool hinweg beibehalten werden sollen. AgentPoolProfileNodeLabels
nodeTaints Zu neuen Knoten hinzugefügteTaints während der Erstellung und Skalierung des Knotenpools. Beispiel: key=value:NoSchedule. string[]
osSKU Gibt die vom Agentpool verwendete Betriebssystem-SKU an. Der Standardwert ist CBLMarir, wenn OSType Linux ist. Der Standardwert ist Windows2019, wenn OSType Windows ist. "CBLMarin"
"Windows2019"
"Windows2022"
osType Der spezielle KubernetesVersion Image OS-Typ (Linux, Windows) "Linux"
"Windows"
vmSize Die VM-SKU-Größe der VMs des Agentpoolknotens. Schnur

NetworkProfile

Name Beschreibung Wert
loadBalancerProfile Profil des HA-Proxylastenausgleichs. NetworkProfileLoadBalancerProfile-
networkPolicy Netzwerkrichtlinie zum Erstellen des Kubernetes-Netzwerks. Mögliche Werte sind: 'calico'. 'calico'
podCidr Ein CIDR-Notation-IP-Adressbereich, aus dem Pod-IPs zugewiesen werden sollen. Schnur

NetworkProfileLoadBalancerProfile

Name Beschreibung Wert
zählen Anzahl der VMs des HA-Proxylastenausgleichs. Der Standardwert ist 0. Int

ProvisionedClusterLicenseProfile

Name Beschreibung Wert
azureHybridBenefit Gibt an, ob der Azure-Hybridvorteil aktiviert ist. Standardwert ist "false". 'False'
'NotApplicable'
'True'

ProvisionedClusterProperties

Name Beschreibung Wert
agentPoolProfiles Die Agentpooleigenschaften für den bereitgestellten Cluster. NamedAgentPoolProfile[]
autoScalerProfile Parameter, die auf die Cluster-Autoscaler angewendet werden sollen, wenn die automatische Skalierung für den bereitgestellten Cluster aktiviert ist. ProvisionedClusterPropertiesAutoScalerProfile
cloudProviderProfile Das Profil für den zugrunde liegenden Cloudinfrastrukturanbieter für den bereitgestellten Cluster. CloudProviderProfile-
clusterVMAccessProfile Das SSH-Profil für eingeschränkten Zugriff für die virtuellen Computer im bereitgestellten Cluster. ClusterVMAccessProfile-
controlPlane Das Profil für die Steuerungsebene des bereitgestellten Clusters. ControlPlaneProfile-
kubernetesVersion Die Version von Kubernetes, die vom bereitgestellten Cluster verwendet wird. Schnur
licenseProfile Das Lizenzprofil des bereitgestellten Clusters. ProvisionedClusterLicenseProfile
linuxProfile Das Profil für Linux-VMs im bereitgestellten Cluster. LinuxProfileProperties
networkProfile Das Netzwerkkonfigurationsprofil für den bereitgestellten Cluster. NetworkProfile-
storageProfile Das Speicherkonfigurationsprofil für den bereitgestellten Cluster. StorageProfile-

ProvisionedClusterPropertiesAutoScalerProfile

Name Beschreibung Wert
Balance-similar-node-groups Gültige Werte sind "true" und "false" Schnur
Expander Wenn nicht angegeben, lautet der Standardwert "random". Weitere Informationen finden Sie unter Erweiterung. "geringste Abfälle"
"most-pods"
"Priorität"
"zufällig"
max-empty-bulk-delete Der Standardwert ist 10. Schnur
max-graceful-termination-sec Der Standardwert ist 600. Schnur
max-node-provision-time Der Standardwert ist "15m". Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt. Schnur
max-total-unready-percentage Der Standardwert ist 45. Das Maximum beträgt 100 und das Minimum ist 0. Schnur
new-pod-scale-up-delay Für Szenarien wie Platz-/Batchmaßstab, in denen die Zertifizierungsstelle nicht reagieren soll, bevor der Kubernetes-Scheduler alle Pods planen kann, können Sie der Zertifizierungsstelle mitteilen, dass ungeplante Pods ignoriert werden, bevor sie ein bestimmtes Alter sind. Der Standardwert ist "0s". Werte müssen eine ganze Zahl sein, gefolgt von einer Einheit ('s' für Sekunden, 'm' für Minuten, 'h' für Stunden usw.). Schnur
ok-total-unready-count Dies muss eine ganze Zahl sein. Der Standardwert ist 3. Schnur
scale-down-delay-after-add Der Standardwert ist "10m". Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt. Schnur
scale-down-delay-after-delete Der Standardwert ist das Scanintervall. Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt. Schnur
Scale-down-delay-after-failure Der Standardwert ist "3m". Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt. Schnur
scale-down-unneeded-time Der Standardwert ist "10m". Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt. Schnur
Scale-down-unready-time Der Standardwert ist "20m". Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt. Schnur
Scale-Down-Auslastungsschwellenwert Der Standardwert ist "0.5". Schnur
Scanintervall Der Standardwert ist "10". Werte müssen eine ganze Zahl von Sekunden sein. Schnur
skip-nodes-with-local-storage Der Standardwert ist "true". Schnur
skip-nodes-with-system-pods Der Standardwert ist "true". Schnur

StorageProfile

Name Beschreibung Wert
nfsCsiDriver NFS CSI-Treibereinstellungen für das Speicherprofil. StorageProfileNfsCSIDriver-
smbCsiDriver SMB CSI-Treibereinstellungen für das Speicherprofil. StorageProfileSmbCSIDriver-

StorageProfileNfsCSIDriver

Name Beschreibung Wert
ermöglichte Gibt an, ob NFS CSI-Treiber aktiviert werden soll. Der Standardwert ist true. Bool

StorageProfileSmbCSIDriver

Name Beschreibung Wert
ermöglichte Gibt an, ob der SMB CSI-Treiber aktiviert werden soll. Der Standardwert ist true. Bool

Schnellstartbeispiele

Die folgenden Schnellstartbeispiele stellen diesen Ressourcentyp bereit.

Bicep-Datei Beschreibung
Erstellen eines Kubernetes-Clusters auf Azure Stack HCI- Diese Vorlage erstellt einen Kubernetes-Cluster auf Azure Stack HCI, Version 23H2+

ARM-Vorlagenressourcendefinition

Der ressourcentyp "provisionedClusterInstances" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.HybridContainerService/provisionedClusterInstances-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

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

Eigenschaftswerte

AgentPoolProfileNodeLabels

Name Beschreibung Wert

CloudProviderProfile

Name Beschreibung Wert
infraNetworkProfile Das Profil für die Infrastrukturnetzwerke, die vom bereitgestellten Cluster verwendet werden CloudProviderProfileInfraNetworkProfile-

CloudProviderProfileInfraNetworkProfile

Name Beschreibung Wert
vnetSubnetIds Liste der ARM-Ressourcen-IDs (maximal 1) für das Infrastrukturnetzwerkobjekt, z. B. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName} string[]

ClusterVMAccessProfile

Name Beschreibung Wert
authorizedIPRanges IP-Adresse oder CIDR für SSH-Zugriff auf VMs im bereitgestellten Cluster Schnur

ControlPlaneProfile

Name Beschreibung Wert
controlPlaneEndpoint IP-Adresse des Kubernetes-API-Servers ControlPlaneProfileControlPlaneEndpoint-
zählen Anzahl der Steuerebenenknoten. Der Standardwert ist 1, und die Anzahl sollte eine ungerade Zahl sein. Int
vmSize VM-SKU-Größe der Steuerebenenknoten Schnur

ControlPlaneProfileControlPlaneEndpoint

Name Beschreibung Wert
hostIP IP-Adresse des Kubernetes-API-Servers Schnur

ExtendedLocation

Name Beschreibung Wert
Name ARM-ID des erweiterten Speicherorts. Schnur
Art Der erweiterte Standorttyp. Zulässiger Wert: 'CustomLocation' 'CustomLocation'

LinuxProfileProperties

Name Beschreibung Wert
ssh SSH-Konfiguration für VMs des bereitgestellten Clusters. LinuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Name Beschreibung Wert
publicKeys Die Liste der öffentlichen SSH-Schlüssel, die für die Authentifizierung mit VMs verwendet werden. Es kann maximal 1 Schlüssel angegeben werden. LinuxProfilePropertiesSshPublicKeysItem[]

LinuxProfilePropertiesSshPublicKeysItem

Name Beschreibung Wert
keyData Öffentlicher Zertifikatschlüssel, der für die Authentifizierung mit VMs über SSH verwendet wird. Das Zertifikat muss im PEM-Format mit oder ohne Kopfzeilen vorliegen. Schnur

Microsoft.HybridContainerService/provisionedClusterInstances

Name Beschreibung Wert
apiVersion Die API-Version '2024-01-01'
extendedLocation Erweiterter Standort, der auf die zugrunde liegende Infrastruktur verweist ExtendedLocation-
Name Der Ressourcenname "default" (erforderlich)
Eigenschaften Eigenschaften des bereitgestellten Clusters. ProvisionedClusterProperties
Art Der Ressourcentyp "Microsoft.HybridContainerService/provisionedClusterInstances"

NamedAgentPoolProfile

Name Beschreibung Wert
zählen Anzahl der Knoten im Agentpool. Der Standardwert ist 1. Int
enableAutoScaling Gibt an, ob die automatische Skalierung aktiviert werden soll. Standardwert ist "false". Bool
maxCount Die maximale Anzahl von Knoten für die automatische Skalierung Int
maxPods Die maximale Anzahl von Pods, die auf einem Knoten ausgeführt werden können. Int
minCount Die Mindestanzahl von Knoten für die automatische Skalierung Int
Name Eindeutiger Name des Standard-Agentpools im Kontext des bereitgestellten Clusters. Der Standardwert ist <clusterName>-nodepool1 Schnur
nodeLabels Die Knotenbeschriftungen, die über alle Knoten im Agentpool hinweg beibehalten werden sollen. AgentPoolProfileNodeLabels
nodeTaints Zu neuen Knoten hinzugefügteTaints während der Erstellung und Skalierung des Knotenpools. Beispiel: key=value:NoSchedule. string[]
osSKU Gibt die vom Agentpool verwendete Betriebssystem-SKU an. Der Standardwert ist CBLMarir, wenn OSType Linux ist. Der Standardwert ist Windows2019, wenn OSType Windows ist. "CBLMarin"
"Windows2019"
"Windows2022"
osType Der spezielle KubernetesVersion Image OS-Typ (Linux, Windows) "Linux"
"Windows"
vmSize Die VM-SKU-Größe der VMs des Agentpoolknotens. Schnur

NetworkProfile

Name Beschreibung Wert
loadBalancerProfile Profil des HA-Proxylastenausgleichs. NetworkProfileLoadBalancerProfile-
networkPolicy Netzwerkrichtlinie zum Erstellen des Kubernetes-Netzwerks. Mögliche Werte sind: 'calico'. 'calico'
podCidr Ein CIDR-Notation-IP-Adressbereich, aus dem Pod-IPs zugewiesen werden sollen. Schnur

NetworkProfileLoadBalancerProfile

Name Beschreibung Wert
zählen Anzahl der VMs des HA-Proxylastenausgleichs. Der Standardwert ist 0. Int

ProvisionedClusterLicenseProfile

Name Beschreibung Wert
azureHybridBenefit Gibt an, ob der Azure-Hybridvorteil aktiviert ist. Standardwert ist "false". 'False'
'NotApplicable'
'True'

ProvisionedClusterProperties

Name Beschreibung Wert
agentPoolProfiles Die Agentpooleigenschaften für den bereitgestellten Cluster. NamedAgentPoolProfile[]
autoScalerProfile Parameter, die auf die Cluster-Autoscaler angewendet werden sollen, wenn die automatische Skalierung für den bereitgestellten Cluster aktiviert ist. ProvisionedClusterPropertiesAutoScalerProfile
cloudProviderProfile Das Profil für den zugrunde liegenden Cloudinfrastrukturanbieter für den bereitgestellten Cluster. CloudProviderProfile-
clusterVMAccessProfile Das SSH-Profil für eingeschränkten Zugriff für die virtuellen Computer im bereitgestellten Cluster. ClusterVMAccessProfile-
controlPlane Das Profil für die Steuerungsebene des bereitgestellten Clusters. ControlPlaneProfile-
kubernetesVersion Die Version von Kubernetes, die vom bereitgestellten Cluster verwendet wird. Schnur
licenseProfile Das Lizenzprofil des bereitgestellten Clusters. ProvisionedClusterLicenseProfile
linuxProfile Das Profil für Linux-VMs im bereitgestellten Cluster. LinuxProfileProperties
networkProfile Das Netzwerkkonfigurationsprofil für den bereitgestellten Cluster. NetworkProfile-
storageProfile Das Speicherkonfigurationsprofil für den bereitgestellten Cluster. StorageProfile-

ProvisionedClusterPropertiesAutoScalerProfile

Name Beschreibung Wert
Balance-similar-node-groups Gültige Werte sind "true" und "false" Schnur
Expander Wenn nicht angegeben, lautet der Standardwert "random". Weitere Informationen finden Sie unter Erweiterung. "geringste Abfälle"
"most-pods"
"Priorität"
"zufällig"
max-empty-bulk-delete Der Standardwert ist 10. Schnur
max-graceful-termination-sec Der Standardwert ist 600. Schnur
max-node-provision-time Der Standardwert ist "15m". Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt. Schnur
max-total-unready-percentage Der Standardwert ist 45. Das Maximum beträgt 100 und das Minimum ist 0. Schnur
new-pod-scale-up-delay Für Szenarien wie Platz-/Batchmaßstab, in denen die Zertifizierungsstelle nicht reagieren soll, bevor der Kubernetes-Scheduler alle Pods planen kann, können Sie der Zertifizierungsstelle mitteilen, dass ungeplante Pods ignoriert werden, bevor sie ein bestimmtes Alter sind. Der Standardwert ist "0s". Werte müssen eine ganze Zahl sein, gefolgt von einer Einheit ('s' für Sekunden, 'm' für Minuten, 'h' für Stunden usw.). Schnur
ok-total-unready-count Dies muss eine ganze Zahl sein. Der Standardwert ist 3. Schnur
scale-down-delay-after-add Der Standardwert ist "10m". Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt. Schnur
scale-down-delay-after-delete Der Standardwert ist das Scanintervall. Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt. Schnur
Scale-down-delay-after-failure Der Standardwert ist "3m". Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt. Schnur
scale-down-unneeded-time Der Standardwert ist "10m". Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt. Schnur
Scale-down-unready-time Der Standardwert ist "20m". Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt. Schnur
Scale-Down-Auslastungsschwellenwert Der Standardwert ist "0.5". Schnur
Scanintervall Der Standardwert ist "10". Werte müssen eine ganze Zahl von Sekunden sein. Schnur
skip-nodes-with-local-storage Der Standardwert ist "true". Schnur
skip-nodes-with-system-pods Der Standardwert ist "true". Schnur

StorageProfile

Name Beschreibung Wert
nfsCsiDriver NFS CSI-Treibereinstellungen für das Speicherprofil. StorageProfileNfsCSIDriver-
smbCsiDriver SMB CSI-Treibereinstellungen für das Speicherprofil. StorageProfileSmbCSIDriver-

StorageProfileNfsCSIDriver

Name Beschreibung Wert
ermöglichte Gibt an, ob NFS CSI-Treiber aktiviert werden soll. Der Standardwert ist true. Bool

StorageProfileSmbCSIDriver

Name Beschreibung Wert
ermöglichte Gibt an, ob der SMB CSI-Treiber aktiviert werden soll. Der Standardwert ist true. Bool

Schnellstartvorlagen

Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.

Schablone Beschreibung
Erstellen eines Kubernetes-Clusters auf Azure Stack HCI-

Bereitstellen in Azure 		Diese Vorlage erstellt einen Kubernetes-Cluster auf Azure Stack HCI, Version 23H2+

Terraform -Ressourcendefinition (AzAPI-Anbieter)

Der ressourcentyp "provisionedClusterInstances" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.HybridContainerService/provisionedClusterInstances-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.

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

Eigenschaftswerte

AgentPoolProfileNodeLabels

Name Beschreibung Wert

CloudProviderProfile

Name Beschreibung Wert
infraNetworkProfile Das Profil für die Infrastrukturnetzwerke, die vom bereitgestellten Cluster verwendet werden CloudProviderProfileInfraNetworkProfile-

CloudProviderProfileInfraNetworkProfile

Name Beschreibung Wert
vnetSubnetIds Liste der ARM-Ressourcen-IDs (maximal 1) für das Infrastrukturnetzwerkobjekt, z. B. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName} string[]

ClusterVMAccessProfile

Name Beschreibung Wert
authorizedIPRanges IP-Adresse oder CIDR für SSH-Zugriff auf VMs im bereitgestellten Cluster Schnur

ControlPlaneProfile

Name Beschreibung Wert
controlPlaneEndpoint IP-Adresse des Kubernetes-API-Servers ControlPlaneProfileControlPlaneEndpoint-
zählen Anzahl der Steuerebenenknoten. Der Standardwert ist 1, und die Anzahl sollte eine ungerade Zahl sein. Int
vmSize VM-SKU-Größe der Steuerebenenknoten Schnur

ControlPlaneProfileControlPlaneEndpoint

Name Beschreibung Wert
hostIP IP-Adresse des Kubernetes-API-Servers Schnur

ExtendedLocation

Name Beschreibung Wert
Name ARM-ID des erweiterten Speicherorts. Schnur
Art Der erweiterte Standorttyp. Zulässiger Wert: 'CustomLocation' 'CustomLocation'

LinuxProfileProperties

Name Beschreibung Wert
ssh SSH-Konfiguration für VMs des bereitgestellten Clusters. LinuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Name Beschreibung Wert
publicKeys Die Liste der öffentlichen SSH-Schlüssel, die für die Authentifizierung mit VMs verwendet werden. Es kann maximal 1 Schlüssel angegeben werden. LinuxProfilePropertiesSshPublicKeysItem[]

LinuxProfilePropertiesSshPublicKeysItem

Name Beschreibung Wert
keyData Öffentlicher Zertifikatschlüssel, der für die Authentifizierung mit VMs über SSH verwendet wird. Das Zertifikat muss im PEM-Format mit oder ohne Kopfzeilen vorliegen. Schnur

Microsoft.HybridContainerService/provisionedClusterInstances

Name Beschreibung Wert
extendedLocation Erweiterter Standort, der auf die zugrunde liegende Infrastruktur verweist ExtendedLocation-
Name Der Ressourcenname "default" (erforderlich)
parent_id Die ID der Ressource, auf die diese Erweiterungsressource angewendet werden soll. Zeichenfolge (erforderlich)
Eigenschaften Eigenschaften des bereitgestellten Clusters. ProvisionedClusterProperties
Art Der Ressourcentyp "Microsoft.HybridContainerService/provisionedClusterInstances@2024-01-01"

NamedAgentPoolProfile

Name Beschreibung Wert
zählen Anzahl der Knoten im Agentpool. Der Standardwert ist 1. Int
enableAutoScaling Gibt an, ob die automatische Skalierung aktiviert werden soll. Standardwert ist "false". Bool
maxCount Die maximale Anzahl von Knoten für die automatische Skalierung Int
maxPods Die maximale Anzahl von Pods, die auf einem Knoten ausgeführt werden können. Int
minCount Die Mindestanzahl von Knoten für die automatische Skalierung Int
Name Eindeutiger Name des Standard-Agentpools im Kontext des bereitgestellten Clusters. Der Standardwert ist <clusterName>-nodepool1 Schnur
nodeLabels Die Knotenbeschriftungen, die über alle Knoten im Agentpool hinweg beibehalten werden sollen. AgentPoolProfileNodeLabels
nodeTaints Zu neuen Knoten hinzugefügteTaints während der Erstellung und Skalierung des Knotenpools. Beispiel: key=value:NoSchedule. string[]
osSKU Gibt die vom Agentpool verwendete Betriebssystem-SKU an. Der Standardwert ist CBLMarir, wenn OSType Linux ist. Der Standardwert ist Windows2019, wenn OSType Windows ist. "CBLMarin"
"Windows2019"
"Windows2022"
osType Der spezielle KubernetesVersion Image OS-Typ (Linux, Windows) "Linux"
"Windows"
vmSize Die VM-SKU-Größe der VMs des Agentpoolknotens. Schnur

NetworkProfile

Name Beschreibung Wert
loadBalancerProfile Profil des HA-Proxylastenausgleichs. NetworkProfileLoadBalancerProfile-
networkPolicy Netzwerkrichtlinie zum Erstellen des Kubernetes-Netzwerks. Mögliche Werte sind: 'calico'. 'calico'
podCidr Ein CIDR-Notation-IP-Adressbereich, aus dem Pod-IPs zugewiesen werden sollen. Schnur

NetworkProfileLoadBalancerProfile

Name Beschreibung Wert
zählen Anzahl der VMs des HA-Proxylastenausgleichs. Der Standardwert ist 0. Int

ProvisionedClusterLicenseProfile

Name Beschreibung Wert
azureHybridBenefit Gibt an, ob der Azure-Hybridvorteil aktiviert ist. Standardwert ist "false". 'False'
'NotApplicable'
'True'

ProvisionedClusterProperties

Name Beschreibung Wert
agentPoolProfiles Die Agentpooleigenschaften für den bereitgestellten Cluster. NamedAgentPoolProfile[]
autoScalerProfile Parameter, die auf die Cluster-Autoscaler angewendet werden sollen, wenn die automatische Skalierung für den bereitgestellten Cluster aktiviert ist. ProvisionedClusterPropertiesAutoScalerProfile
cloudProviderProfile Das Profil für den zugrunde liegenden Cloudinfrastrukturanbieter für den bereitgestellten Cluster. CloudProviderProfile-
clusterVMAccessProfile Das SSH-Profil für eingeschränkten Zugriff für die virtuellen Computer im bereitgestellten Cluster. ClusterVMAccessProfile-
controlPlane Das Profil für die Steuerungsebene des bereitgestellten Clusters. ControlPlaneProfile-
kubernetesVersion Die Version von Kubernetes, die vom bereitgestellten Cluster verwendet wird. Schnur
licenseProfile Das Lizenzprofil des bereitgestellten Clusters. ProvisionedClusterLicenseProfile
linuxProfile Das Profil für Linux-VMs im bereitgestellten Cluster. LinuxProfileProperties
networkProfile Das Netzwerkkonfigurationsprofil für den bereitgestellten Cluster. NetworkProfile-
storageProfile Das Speicherkonfigurationsprofil für den bereitgestellten Cluster. StorageProfile-

ProvisionedClusterPropertiesAutoScalerProfile

Name Beschreibung Wert
Balance-similar-node-groups Gültige Werte sind "true" und "false" Schnur
Expander Wenn nicht angegeben, lautet der Standardwert "random". Weitere Informationen finden Sie unter Erweiterung. "geringste Abfälle"
"most-pods"
"Priorität"
"zufällig"
max-empty-bulk-delete Der Standardwert ist 10. Schnur
max-graceful-termination-sec Der Standardwert ist 600. Schnur
max-node-provision-time Der Standardwert ist "15m". Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt. Schnur
max-total-unready-percentage Der Standardwert ist 45. Das Maximum beträgt 100 und das Minimum ist 0. Schnur
new-pod-scale-up-delay Für Szenarien wie Platz-/Batchmaßstab, in denen die Zertifizierungsstelle nicht reagieren soll, bevor der Kubernetes-Scheduler alle Pods planen kann, können Sie der Zertifizierungsstelle mitteilen, dass ungeplante Pods ignoriert werden, bevor sie ein bestimmtes Alter sind. Der Standardwert ist "0s". Werte müssen eine ganze Zahl sein, gefolgt von einer Einheit ('s' für Sekunden, 'm' für Minuten, 'h' für Stunden usw.). Schnur
ok-total-unready-count Dies muss eine ganze Zahl sein. Der Standardwert ist 3. Schnur
scale-down-delay-after-add Der Standardwert ist "10m". Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt. Schnur
scale-down-delay-after-delete Der Standardwert ist das Scanintervall. Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt. Schnur
Scale-down-delay-after-failure Der Standardwert ist "3m". Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt. Schnur
scale-down-unneeded-time Der Standardwert ist "10m". Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt. Schnur
Scale-down-unready-time Der Standardwert ist "20m". Werte müssen eine ganze Zahl sein, gefolgt von einem "m". Es wird keine Andere Zeiteinheit als Minuten (m) unterstützt. Schnur
Scale-Down-Auslastungsschwellenwert Der Standardwert ist "0.5". Schnur
Scanintervall Der Standardwert ist "10". Werte müssen eine ganze Zahl von Sekunden sein. Schnur
skip-nodes-with-local-storage Der Standardwert ist "true". Schnur
skip-nodes-with-system-pods Der Standardwert ist "true". Schnur

StorageProfile

Name Beschreibung Wert
nfsCsiDriver NFS CSI-Treibereinstellungen für das Speicherprofil. StorageProfileNfsCSIDriver-
smbCsiDriver SMB CSI-Treibereinstellungen für das Speicherprofil. StorageProfileSmbCSIDriver-

StorageProfileNfsCSIDriver

Name Beschreibung Wert
ermöglichte Gibt an, ob NFS CSI-Treiber aktiviert werden soll. Der Standardwert ist true. Bool

StorageProfileSmbCSIDriver

Name Beschreibung Wert
ermöglichte Gibt an, ob der SMB CSI-Treiber aktiviert werden soll. Der Standardwert ist true. Bool