Microsoft.HybridContainerService provisionedClusterInstances

Artikel
2024-12-20

Bicep-resursdefinition

Resurstypen provisionedClusterInstances kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.HybridContainerService/provisionedClusterInstances-resurs lägger du till följande Bicep i mallen.

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

Egenskapsvärden

AgentPoolProfileNodeLabels

Namn	Beskrivning	Värde

CloudProviderProfile

Namn	Beskrivning	Värde
infraNetworkProfile	Profilen för de infrastrukturnätverk som används av det etablerade klustret	CloudProviderProfileInfraNetworkProfile

CloudProviderProfileInfraNetworkProfile

Namn	Beskrivning	Värde
vnetSubnetIds	Lista över ARM-resurs-ID:n (högst 1) för infrastrukturnätverksobjektet, t.ex. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName}	string[]

ClusterVMAccessProfile

Namn	Beskrivning	Värde
auktoriseradeIPRanges	IP-adress eller CIDR för SSH-åtkomst till virtuella datorer i det etablerade klustret	sträng

ControlPlaneProfile

Namn	Beskrivning	Värde
controlPlaneEndpoint	IP-adress för Kubernetes API-servern	ControlPlaneProfileControlPlaneEndpoint
räkna	Antal kontrollplansnoder. Standardvärdet är 1 och antalet ska vara ett udda tal	Int
vmSize	VM-sku:ns storlek på kontrollplanets noder	sträng

ControlPlaneProfileControlPlaneEndpoint

Namn	Beskrivning	Värde
hostIP	IP-adressen för Kubernetes API-servern	sträng

ExtendedLocation

Namn	Beskrivning	Värde
Namn	ARM-ID för den utökade platsen.	sträng
typ	Den utökade platstypen. Tillåtet värde: "CustomLocation"	"CustomLocation"

LinuxProfileEgenskaper

Namn	Beskrivning	Värde
ssh	SSH-konfiguration för virtuella datorer i det etablerade klustret.	LinuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Namn	Beskrivning	Värde
publicKeys	Listan över offentliga SSH-nycklar som används för att autentisera med virtuella datorer. Högst 1 nyckel kan anges.	LinuxProfilePropertiesSshPublicKeysItem[]

LinuxProfilePropertiesSshPublicKeysItem

Namn	Beskrivning	Värde
keyData	Offentlig certifikatnyckel som används för att autentisera med virtuella datorer via SSH. Certifikatet måste vara i PEM-format med eller utan rubriker.	sträng

Microsoft.HybridContainerService/provisionedClusterInstances

Namn	Beskrivning	Värde
extendedLocation	Utökad plats som pekar på den underliggande infrastrukturen	ExtendedLocation
Namn	Resursnamnet	"standard" (krävs)
Egenskaper	Egenskaper för det etablerade klustret.	ProvisionedClusterEgenskaper
omfattning	Använd när du skapar en resurs i ett annat omfång än distributionsomfånget.	Ange den här egenskapen till det symboliska namnet på en resurs för att tillämpa -tilläggsresursen.

NamedAgentPoolProfile

Namn	Beskrivning	Värde
räkna	Antal noder i agentpoolen. Standardvärdet är 1.	Int
enableAutoScaling	Om du vill aktivera automatisk skalning. Standardvärdet är falskt	Bool
maxCount	Maximalt antal noder för automatisk skalning	Int
maxPods	Det maximala antalet poddar som kan köras på en nod.	Int
minCount	Det minsta antalet noder för automatisk skalning	Int
Namn	Unikt namn på standardagentpoolen i kontexten för det etablerade klustret. Standardvärdet är <clusterName>-nodepool1	sträng
nodeLabels	Nodetiketterna som ska bevaras över alla noder i agentpoolen.	AgentPoolProfileNodeLabels
nodeTaints	Taints har lagts till i nya noder när nodpoolen skapas och skalas. Till exempel key=value:NoSchedule.	string[]
osSKU	Anger os-SKU:n som används av agentpoolen. Standardvärdet är CBLMariner om OSType är Linux. Standardvärdet är Windows2019 när OSType är Windows.	"CBLMariner" "Windows2019" "Windows2022"
osType	Den specifika Typen av KubernetesVersion-avbildningsoperativsystem (Linux, Windows)	"Linux" "Windows"
vmSize	Vm-sku-storleken för de virtuella datorerna för agentpoolnoden.	sträng

NetworkProfile

Namn	Beskrivning	Värde
loadBalancerProfile	Profil för lastbalanseraren för HA Proxy.	NetworkProfileLoadBalancerProfile
networkPolicy	Nätverksprincip som används för att skapa Kubernetes-nätverk. Möjliga värden är: "calico".	"calico"
podCidr	Ett IP-adressintervall för CIDR-notation som podd-IP-adresser ska tilldelas från.	sträng

NetworkProfileLoadBalancerProfile

Namn	Beskrivning	Värde
räkna	Antal virtuella datorer med HA Proxy-lastbalanserare. Standardvärdet är 0.	Int

ProvisionedClusterLicenseProfile

Namn	Beskrivning	Värde
azureHybridBenefit	Anger om Azure Hybrid-förmånen har valts. Standardvärdet är falskt	"Falskt" "NotApplicable" "Sant"

ProvisionedClusterEgenskaper

Namn	Beskrivning	Värde
agentPoolProfiles	Agentpoolens egenskaper för det etablerade klustret.	NamedAgentPoolProfile[]
autoScalerProfile	Parametrar som ska tillämpas på kluster-autoskalning när automatisk skalning är aktiverat för det etablerade klustret.	ProvisionedClusterPropertiesAutoScalerProfile
cloudProviderProfile	Profilen för den underliggande molninfrastrukturprovidern för det etablerade klustret.	CloudProviderProfile
clusterVMAccessProfile	SSH-profilen för begränsad åtkomst för de virtuella datorerna i det etablerade klustret.	ClusterVMAccessProfile
controlPlane	Profilen för kontrollplanet för det etablerade klustret.	ControlPlaneProfile
kubernetesVersion	Den version av Kubernetes som används av det etablerade klustret.	sträng
licenseProfile	Licensprofilen för det etablerade klustret.	ProvisionedClusterLicenseProfile
linuxProfile	Profilen för virtuella Linux-datorer i det etablerade klustret.	LinuxProfileEgenskaper
networkProfile	Nätverkskonfigurationsprofilen för det etablerade klustret.	NetworkProfile
storageProfile	Lagringskonfigurationsprofilen för det etablerade klustret.	StorageProfile

ProvisionedClusterPropertiesAutoScalerProfile

Namn	Beskrivning	Värde
balance-similar-node-groups	Giltiga värden är "true" och "false"	sträng
Expander	Om det inte anges är standardvärdet "slumpmässigt". Mer information finns i expanderare.	"minst avfall" "de flesta poddar" "prioritet" "slumpmässigt"
max-empty-bulk-delete	Standardvärdet är 10.	sträng
max-graceful-termination-sec	Standardvärdet är 600.	sträng
max-node-provision-time	Standardvärdet är "15m". Värden måste vara ett heltal följt av ett "m". Ingen annan tidsenhet än minuter (m) stöds.	sträng
max-total-unready-percentage	Standardvärdet är 45. Maxvärdet är 100 och minimivärdet är 0.	sträng
new-pod-scale-up-delay	För scenarier som burst-/batchskala där du inte vill att ca ska agera innan kubernetes-schemaläggaren kan schemalägga alla poddar kan du be CA:en att ignorera oplanerade poddar innan de är i en viss ålder. Standardvärdet är "0s". Värdena måste vara ett heltal följt av en enhet (s för sekunder, "m" för minuter, "h" i timmar osv.).	sträng
ok-total-unready-count	Det här måste vara ett heltal. Standardvärdet är 3.	sträng
scale-down-delay-after-add	Standardvärdet är "10m". Värden måste vara ett heltal följt av ett "m". Ingen annan tidsenhet än minuter (m) stöds.	sträng
scale-down-delay-after-delete	Standardvärdet är genomsökningsintervallet. Värden måste vara ett heltal följt av ett "m". Ingen annan tidsenhet än minuter (m) stöds.	sträng
scale-down-delay-after-failure	Standardvärdet är "3m". Värden måste vara ett heltal följt av ett "m". Ingen annan tidsenhet än minuter (m) stöds.	sträng
scale-down-unneeded-time	Standardvärdet är "10m". Värden måste vara ett heltal följt av ett "m". Ingen annan tidsenhet än minuter (m) stöds.	sträng
scale-down-unready-time	Standardvärdet är "20m". Värden måste vara ett heltal följt av ett "m". Ingen annan tidsenhet än minuter (m) stöds.	sträng
scale-down-utilization-threshold	Standardvärdet är "0.5".	sträng
genomsökningsintervall	Standardvärdet är "10". Värden måste vara ett heltalsantal sekunder.	sträng
skip-nodes-with-local-storage	Standardvärdet är sant.	sträng
skip-nodes-with-system-pods	Standardvärdet är sant.	sträng

StorageProfile

Namn	Beskrivning	Värde
nfsCsiDriver	NFS CSI-drivrutinsinställningar för lagringsprofilen.	StorageProfileNfsCSIDriver
smbCsiDriver	SMB CSI-drivrutinsinställningar för lagringsprofilen.	StorageProfileSmbCSIDriver

StorageProfileNfsCSIDriver

Namn	Beskrivning	Värde
Aktiverat	Anger om NFS CSI-drivrutin ska aktiveras. Standardvärdet är sant.	Bool

StorageProfileSmbCSIDriver

Namn	Beskrivning	Värde
Aktiverat	Anger om SMB CSI-drivrutin ska aktiveras. Standardvärdet är sant.	Bool

Användningsexempel

Azure-snabbstartsexempel

Följande Azure-snabbstartsmallar innehålla Bicep-exempel för distribution av den här resurstypen.

Bicep-fil	Beskrivning
Skapa ett Kubernetes-kluster på Azure Stack HCI	Den här mallen skapar ett Kubernetes-kluster på Azure Stack HCI version 23H2+

Resursdefinition för ARM-mall

Resurstypen provisionedClusterInstances kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.HybridContainerService/provisionedClusterInstances-resurs lägger du till följande JSON i mallen.

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

Egenskapsvärden

AgentPoolProfileNodeLabels

Namn	Beskrivning	Värde

CloudProviderProfile

Namn	Beskrivning	Värde
infraNetworkProfile	Profilen för de infrastrukturnätverk som används av det etablerade klustret	CloudProviderProfileInfraNetworkProfile

CloudProviderProfileInfraNetworkProfile

Namn	Beskrivning	Värde
vnetSubnetIds	Lista över ARM-resurs-ID:n (högst 1) för infrastrukturnätverksobjektet, t.ex. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName}	string[]

ClusterVMAccessProfile

Namn	Beskrivning	Värde
auktoriseradeIPRanges	IP-adress eller CIDR för SSH-åtkomst till virtuella datorer i det etablerade klustret	sträng

ControlPlaneProfile

Namn	Beskrivning	Värde
controlPlaneEndpoint	IP-adress för Kubernetes API-servern	ControlPlaneProfileControlPlaneEndpoint
räkna	Antal kontrollplansnoder. Standardvärdet är 1 och antalet ska vara ett udda tal	Int
vmSize	VM-sku:ns storlek på kontrollplanets noder	sträng

ControlPlaneProfileControlPlaneEndpoint

Namn	Beskrivning	Värde
hostIP	IP-adressen för Kubernetes API-servern	sträng

ExtendedLocation

Namn	Beskrivning	Värde
Namn	ARM-ID för den utökade platsen.	sträng
typ	Den utökade platstypen. Tillåtet värde: "CustomLocation"	"CustomLocation"

LinuxProfileEgenskaper

Namn	Beskrivning	Värde
ssh	SSH-konfiguration för virtuella datorer i det etablerade klustret.	LinuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Namn	Beskrivning	Värde
publicKeys	Listan över offentliga SSH-nycklar som används för att autentisera med virtuella datorer. Högst 1 nyckel kan anges.	LinuxProfilePropertiesSshPublicKeysItem[]

LinuxProfilePropertiesSshPublicKeysItem

Namn	Beskrivning	Värde
keyData	Offentlig certifikatnyckel som används för att autentisera med virtuella datorer via SSH. Certifikatet måste vara i PEM-format med eller utan rubriker.	sträng

Microsoft.HybridContainerService/provisionedClusterInstances

Namn	Beskrivning	Värde
apiVersion	API-versionen	'2024-01-01'
extendedLocation	Utökad plats som pekar på den underliggande infrastrukturen	ExtendedLocation
Namn	Resursnamnet	"standard" (krävs)
Egenskaper	Egenskaper för det etablerade klustret.	ProvisionedClusterEgenskaper
typ	Resurstypen	"Microsoft.HybridContainerService/provisionedClusterInstances"

NamedAgentPoolProfile

Namn	Beskrivning	Värde
räkna	Antal noder i agentpoolen. Standardvärdet är 1.	Int
enableAutoScaling	Om du vill aktivera automatisk skalning. Standardvärdet är falskt	Bool
maxCount	Maximalt antal noder för automatisk skalning	Int
maxPods	Det maximala antalet poddar som kan köras på en nod.	Int
minCount	Det minsta antalet noder för automatisk skalning	Int
Namn	Unikt namn på standardagentpoolen i kontexten för det etablerade klustret. Standardvärdet är <clusterName>-nodepool1	sträng
nodeLabels	Nodetiketterna som ska bevaras över alla noder i agentpoolen.	AgentPoolProfileNodeLabels
nodeTaints	Taints har lagts till i nya noder när nodpoolen skapas och skalas. Till exempel key=value:NoSchedule.	string[]
osSKU	Anger os-SKU:n som används av agentpoolen. Standardvärdet är CBLMariner om OSType är Linux. Standardvärdet är Windows2019 när OSType är Windows.	"CBLMariner" "Windows2019" "Windows2022"
osType	Den specifika Typen av KubernetesVersion-avbildningsoperativsystem (Linux, Windows)	"Linux" "Windows"
vmSize	Vm-sku-storleken för de virtuella datorerna för agentpoolnoden.	sträng

NetworkProfile

Namn	Beskrivning	Värde
loadBalancerProfile	Profil för lastbalanseraren för HA Proxy.	NetworkProfileLoadBalancerProfile
networkPolicy	Nätverksprincip som används för att skapa Kubernetes-nätverk. Möjliga värden är: "calico".	"calico"
podCidr	Ett IP-adressintervall för CIDR-notation som podd-IP-adresser ska tilldelas från.	sträng

NetworkProfileLoadBalancerProfile

Namn	Beskrivning	Värde
räkna	Antal virtuella datorer med HA Proxy-lastbalanserare. Standardvärdet är 0.	Int

ProvisionedClusterLicenseProfile

Namn	Beskrivning	Värde
azureHybridBenefit	Anger om Azure Hybrid-förmånen har valts. Standardvärdet är falskt	"Falskt" "NotApplicable" "Sant"

ProvisionedClusterEgenskaper

Namn	Beskrivning	Värde
agentPoolProfiles	Agentpoolens egenskaper för det etablerade klustret.	NamedAgentPoolProfile[]
autoScalerProfile	Parametrar som ska tillämpas på kluster-autoskalning när automatisk skalning är aktiverat för det etablerade klustret.	ProvisionedClusterPropertiesAutoScalerProfile
cloudProviderProfile	Profilen för den underliggande molninfrastrukturprovidern för det etablerade klustret.	CloudProviderProfile
clusterVMAccessProfile	SSH-profilen för begränsad åtkomst för de virtuella datorerna i det etablerade klustret.	ClusterVMAccessProfile
controlPlane	Profilen för kontrollplanet för det etablerade klustret.	ControlPlaneProfile
kubernetesVersion	Den version av Kubernetes som används av det etablerade klustret.	sträng
licenseProfile	Licensprofilen för det etablerade klustret.	ProvisionedClusterLicenseProfile
linuxProfile	Profilen för virtuella Linux-datorer i det etablerade klustret.	LinuxProfileEgenskaper
networkProfile	Nätverkskonfigurationsprofilen för det etablerade klustret.	NetworkProfile
storageProfile	Lagringskonfigurationsprofilen för det etablerade klustret.	StorageProfile

ProvisionedClusterPropertiesAutoScalerProfile

Namn	Beskrivning	Värde
balance-similar-node-groups	Giltiga värden är "true" och "false"	sträng
Expander	Om det inte anges är standardvärdet "slumpmässigt". Mer information finns i expanderare.	"minst avfall" "de flesta poddar" "prioritet" "slumpmässigt"
max-empty-bulk-delete	Standardvärdet är 10.	sträng
max-graceful-termination-sec	Standardvärdet är 600.	sträng
max-node-provision-time	Standardvärdet är "15m". Värden måste vara ett heltal följt av ett "m". Ingen annan tidsenhet än minuter (m) stöds.	sträng
max-total-unready-percentage	Standardvärdet är 45. Maxvärdet är 100 och minimivärdet är 0.	sträng
new-pod-scale-up-delay	För scenarier som burst-/batchskala där du inte vill att ca ska agera innan kubernetes-schemaläggaren kan schemalägga alla poddar kan du be CA:en att ignorera oplanerade poddar innan de är i en viss ålder. Standardvärdet är "0s". Värdena måste vara ett heltal följt av en enhet (s för sekunder, "m" för minuter, "h" i timmar osv.).	sträng
ok-total-unready-count	Det här måste vara ett heltal. Standardvärdet är 3.	sträng
scale-down-delay-after-add	Standardvärdet är "10m". Värden måste vara ett heltal följt av ett "m". Ingen annan tidsenhet än minuter (m) stöds.	sträng
scale-down-delay-after-delete	Standardvärdet är genomsökningsintervallet. Värden måste vara ett heltal följt av ett "m". Ingen annan tidsenhet än minuter (m) stöds.	sträng
scale-down-delay-after-failure	Standardvärdet är "3m". Värden måste vara ett heltal följt av ett "m". Ingen annan tidsenhet än minuter (m) stöds.	sträng
scale-down-unneeded-time	Standardvärdet är "10m". Värden måste vara ett heltal följt av ett "m". Ingen annan tidsenhet än minuter (m) stöds.	sträng
scale-down-unready-time	Standardvärdet är "20m". Värden måste vara ett heltal följt av ett "m". Ingen annan tidsenhet än minuter (m) stöds.	sträng
scale-down-utilization-threshold	Standardvärdet är "0.5".	sträng
genomsökningsintervall	Standardvärdet är "10". Värden måste vara ett heltalsantal sekunder.	sträng
skip-nodes-with-local-storage	Standardvärdet är sant.	sträng
skip-nodes-with-system-pods	Standardvärdet är sant.	sträng

StorageProfile

Namn	Beskrivning	Värde
nfsCsiDriver	NFS CSI-drivrutinsinställningar för lagringsprofilen.	StorageProfileNfsCSIDriver
smbCsiDriver	SMB CSI-drivrutinsinställningar för lagringsprofilen.	StorageProfileSmbCSIDriver

StorageProfileNfsCSIDriver

Namn	Beskrivning	Värde
Aktiverat	Anger om NFS CSI-drivrutin ska aktiveras. Standardvärdet är sant.	Bool

StorageProfileSmbCSIDriver

Namn	Beskrivning	Värde
Aktiverat	Anger om SMB CSI-drivrutin ska aktiveras. Standardvärdet är sant.	Bool

Användningsexempel

Azure-snabbstartsmallar

Följande Azure-snabbstartsmallar distribuera den här resurstypen.

Mall	Beskrivning
Skapa ett Kubernetes-kluster på Azure Stack HCI	Den här mallen skapar ett Kubernetes-kluster på Azure Stack HCI version 23H2+

Resursdefinition för Terraform (AzAPI-provider)

Resurstypen provisionedClusterInstances kan distribueras med åtgärder som mål:

En lista över ändrade egenskaper i varje API-version finns i ändringsloggen.

Resursformat

Om du vill skapa en Microsoft.HybridContainerService/provisionedClusterInstances-resurs lägger du till följande Terraform i mallen.

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

Egenskapsvärden

AgentPoolProfileNodeLabels

Namn	Beskrivning	Värde

CloudProviderProfile

Namn	Beskrivning	Värde
infraNetworkProfile	Profilen för de infrastrukturnätverk som används av det etablerade klustret	CloudProviderProfileInfraNetworkProfile

CloudProviderProfileInfraNetworkProfile

Namn	Beskrivning	Värde
vnetSubnetIds	Lista över ARM-resurs-ID:n (högst 1) för infrastrukturnätverksobjektet, t.ex. /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName}	string[]

ClusterVMAccessProfile

Namn	Beskrivning	Värde
auktoriseradeIPRanges	IP-adress eller CIDR för SSH-åtkomst till virtuella datorer i det etablerade klustret	sträng

ControlPlaneProfile

Namn	Beskrivning	Värde
controlPlaneEndpoint	IP-adress för Kubernetes API-servern	ControlPlaneProfileControlPlaneEndpoint
räkna	Antal kontrollplansnoder. Standardvärdet är 1 och antalet ska vara ett udda tal	Int
vmSize	VM-sku:ns storlek på kontrollplanets noder	sträng

ControlPlaneProfileControlPlaneEndpoint

Namn	Beskrivning	Värde
hostIP	IP-adressen för Kubernetes API-servern	sträng

ExtendedLocation

Namn	Beskrivning	Värde
Namn	ARM-ID för den utökade platsen.	sträng
typ	Den utökade platstypen. Tillåtet värde: "CustomLocation"	"CustomLocation"

LinuxProfileEgenskaper

Namn	Beskrivning	Värde
ssh	SSH-konfiguration för virtuella datorer i det etablerade klustret.	LinuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Namn	Beskrivning	Värde
publicKeys	Listan över offentliga SSH-nycklar som används för att autentisera med virtuella datorer. Högst 1 nyckel kan anges.	LinuxProfilePropertiesSshPublicKeysItem[]

LinuxProfilePropertiesSshPublicKeysItem

Namn	Beskrivning	Värde
keyData	Offentlig certifikatnyckel som används för att autentisera med virtuella datorer via SSH. Certifikatet måste vara i PEM-format med eller utan rubriker.	sträng

Microsoft.HybridContainerService/provisionedClusterInstances

Namn	Beskrivning	Värde
extendedLocation	Utökad plats som pekar på den underliggande infrastrukturen	ExtendedLocation
Namn	Resursnamnet	"standard" (krävs)
parent_id	ID:t för resursen som den här tilläggsresursen ska tillämpas på.	sträng (krävs)
Egenskaper	Egenskaper för det etablerade klustret.	ProvisionedClusterEgenskaper
typ	Resurstypen	"Microsoft.HybridContainerService/provisionedClusterInstances@2024-01-01"

NamedAgentPoolProfile

Namn	Beskrivning	Värde
räkna	Antal noder i agentpoolen. Standardvärdet är 1.	Int
enableAutoScaling	Om du vill aktivera automatisk skalning. Standardvärdet är falskt	Bool
maxCount	Maximalt antal noder för automatisk skalning	Int
maxPods	Det maximala antalet poddar som kan köras på en nod.	Int
minCount	Det minsta antalet noder för automatisk skalning	Int
Namn	Unikt namn på standardagentpoolen i kontexten för det etablerade klustret. Standardvärdet är <clusterName>-nodepool1	sträng
nodeLabels	Nodetiketterna som ska bevaras över alla noder i agentpoolen.	AgentPoolProfileNodeLabels
nodeTaints	Taints har lagts till i nya noder när nodpoolen skapas och skalas. Till exempel key=value:NoSchedule.	string[]
osSKU	Anger os-SKU:n som används av agentpoolen. Standardvärdet är CBLMariner om OSType är Linux. Standardvärdet är Windows2019 när OSType är Windows.	"CBLMariner" "Windows2019" "Windows2022"
osType	Den specifika Typen av KubernetesVersion-avbildningsoperativsystem (Linux, Windows)	"Linux" "Windows"
vmSize	Vm-sku-storleken för de virtuella datorerna för agentpoolnoden.	sträng

NetworkProfile

Namn	Beskrivning	Värde
loadBalancerProfile	Profil för lastbalanseraren för HA Proxy.	NetworkProfileLoadBalancerProfile
networkPolicy	Nätverksprincip som används för att skapa Kubernetes-nätverk. Möjliga värden är: "calico".	"calico"
podCidr	Ett IP-adressintervall för CIDR-notation som podd-IP-adresser ska tilldelas från.	sträng

NetworkProfileLoadBalancerProfile

Namn	Beskrivning	Värde
räkna	Antal virtuella datorer med HA Proxy-lastbalanserare. Standardvärdet är 0.	Int

ProvisionedClusterLicenseProfile

Namn	Beskrivning	Värde
azureHybridBenefit	Anger om Azure Hybrid-förmånen har valts. Standardvärdet är falskt	"Falskt" "NotApplicable" "Sant"

ProvisionedClusterEgenskaper

Namn	Beskrivning	Värde
agentPoolProfiles	Agentpoolens egenskaper för det etablerade klustret.	NamedAgentPoolProfile[]
autoScalerProfile	Parametrar som ska tillämpas på kluster-autoskalning när automatisk skalning är aktiverat för det etablerade klustret.	ProvisionedClusterPropertiesAutoScalerProfile
cloudProviderProfile	Profilen för den underliggande molninfrastrukturprovidern för det etablerade klustret.	CloudProviderProfile
clusterVMAccessProfile	SSH-profilen för begränsad åtkomst för de virtuella datorerna i det etablerade klustret.	ClusterVMAccessProfile
controlPlane	Profilen för kontrollplanet för det etablerade klustret.	ControlPlaneProfile
kubernetesVersion	Den version av Kubernetes som används av det etablerade klustret.	sträng
licenseProfile	Licensprofilen för det etablerade klustret.	ProvisionedClusterLicenseProfile
linuxProfile	Profilen för virtuella Linux-datorer i det etablerade klustret.	LinuxProfileEgenskaper
networkProfile	Nätverkskonfigurationsprofilen för det etablerade klustret.	NetworkProfile
storageProfile	Lagringskonfigurationsprofilen för det etablerade klustret.	StorageProfile

ProvisionedClusterPropertiesAutoScalerProfile

Namn	Beskrivning	Värde
balance-similar-node-groups	Giltiga värden är "true" och "false"	sträng
Expander	Om det inte anges är standardvärdet "slumpmässigt". Mer information finns i expanderare.	"minst avfall" "de flesta poddar" "prioritet" "slumpmässigt"
max-empty-bulk-delete	Standardvärdet är 10.	sträng
max-graceful-termination-sec	Standardvärdet är 600.	sträng
max-node-provision-time	Standardvärdet är "15m". Värden måste vara ett heltal följt av ett "m". Ingen annan tidsenhet än minuter (m) stöds.	sträng
max-total-unready-percentage	Standardvärdet är 45. Maxvärdet är 100 och minimivärdet är 0.	sträng
new-pod-scale-up-delay	För scenarier som burst-/batchskala där du inte vill att ca ska agera innan kubernetes-schemaläggaren kan schemalägga alla poddar kan du be CA:en att ignorera oplanerade poddar innan de är i en viss ålder. Standardvärdet är "0s". Värdena måste vara ett heltal följt av en enhet (s för sekunder, "m" för minuter, "h" i timmar osv.).	sträng
ok-total-unready-count	Det här måste vara ett heltal. Standardvärdet är 3.	sträng
scale-down-delay-after-add	Standardvärdet är "10m". Värden måste vara ett heltal följt av ett "m". Ingen annan tidsenhet än minuter (m) stöds.	sträng
scale-down-delay-after-delete	Standardvärdet är genomsökningsintervallet. Värden måste vara ett heltal följt av ett "m". Ingen annan tidsenhet än minuter (m) stöds.	sträng
scale-down-delay-after-failure	Standardvärdet är "3m". Värden måste vara ett heltal följt av ett "m". Ingen annan tidsenhet än minuter (m) stöds.	sträng
scale-down-unneeded-time	Standardvärdet är "10m". Värden måste vara ett heltal följt av ett "m". Ingen annan tidsenhet än minuter (m) stöds.	sträng
scale-down-unready-time	Standardvärdet är "20m". Värden måste vara ett heltal följt av ett "m". Ingen annan tidsenhet än minuter (m) stöds.	sträng
scale-down-utilization-threshold	Standardvärdet är "0.5".	sträng
genomsökningsintervall	Standardvärdet är "10". Värden måste vara ett heltalsantal sekunder.	sträng
skip-nodes-with-local-storage	Standardvärdet är sant.	sträng
skip-nodes-with-system-pods	Standardvärdet är sant.	sträng

StorageProfile

Namn	Beskrivning	Värde
nfsCsiDriver	NFS CSI-drivrutinsinställningar för lagringsprofilen.	StorageProfileNfsCSIDriver
smbCsiDriver	SMB CSI-drivrutinsinställningar för lagringsprofilen.	StorageProfileSmbCSIDriver

StorageProfileNfsCSIDriver

Namn	Beskrivning	Värde
Aktiverat	Anger om NFS CSI-drivrutin ska aktiveras. Standardvärdet är sant.	Bool

StorageProfileSmbCSIDriver

Namn	Beskrivning	Värde
Aktiverat	Anger om SMB CSI-drivrutin ska aktiveras. Standardvärdet är sant.	Bool

Användningsexempel

Azure-verifierade moduler

Följande Azure-verifierade moduler kan användas för att distribuera den här resurstypen.

Modul	Beskrivning
AKS Arc	AVM-resursmodul för AKS Arc

Dela via

Microsoft.HybridContainerService provisionedClusterInstances

Bicep-resursdefinition

Resursformat

Egenskapsvärden

AgentPoolProfileNodeLabels

CloudProviderProfile

CloudProviderProfileInfraNetworkProfile

ClusterVMAccessProfile

ControlPlaneProfile

ControlPlaneProfileControlPlaneEndpoint

ExtendedLocation

LinuxProfileEgenskaper

LinuxProfilePropertiesSsh

LinuxProfilePropertiesSshPublicKeysItem

Microsoft.HybridContainerService/provisionedClusterInstances

NamedAgentPoolProfile

NetworkProfile

NetworkProfileLoadBalancerProfile

ProvisionedClusterLicenseProfile

ProvisionedClusterEgenskaper

ProvisionedClusterPropertiesAutoScalerProfile

StorageProfile

StorageProfileNfsCSIDriver

StorageProfileSmbCSIDriver

Användningsexempel

Azure-snabbstartsexempel

Resursdefinition för ARM-mall

Resursformat

Egenskapsvärden

AgentPoolProfileNodeLabels

CloudProviderProfile

CloudProviderProfileInfraNetworkProfile

ClusterVMAccessProfile

ControlPlaneProfile

ControlPlaneProfileControlPlaneEndpoint

ExtendedLocation

LinuxProfileEgenskaper

LinuxProfilePropertiesSsh

LinuxProfilePropertiesSshPublicKeysItem

Microsoft.HybridContainerService/provisionedClusterInstances

NamedAgentPoolProfile

NetworkProfile

NetworkProfileLoadBalancerProfile

ProvisionedClusterLicenseProfile

ProvisionedClusterEgenskaper

ProvisionedClusterPropertiesAutoScalerProfile

StorageProfile

StorageProfileNfsCSIDriver

StorageProfileSmbCSIDriver

Användningsexempel

Azure-snabbstartsmallar

Resursdefinition för Terraform (AzAPI-provider)

Resursformat

Egenskapsvärden

AgentPoolProfileNodeLabels

CloudProviderProfile

CloudProviderProfileInfraNetworkProfile

ClusterVMAccessProfile

ControlPlaneProfile

ControlPlaneProfileControlPlaneEndpoint

ExtendedLocation

LinuxProfileEgenskaper

LinuxProfilePropertiesSsh

LinuxProfilePropertiesSshPublicKeysItem

Microsoft.HybridContainerService/provisionedClusterInstances

NamedAgentPoolProfile

NetworkProfile

NetworkProfileLoadBalancerProfile

ProvisionedClusterLicenseProfile

ProvisionedClusterEgenskaper

ProvisionedClusterPropertiesAutoScalerProfile

StorageProfile

StorageProfileNfsCSIDriver

StorageProfileSmbCSIDriver

Användningsexempel

Azure-verifierade moduler

Feedback

Ytterligare resurser