Sdílet prostřednictvím

Microsoft.HybridContainerService provisionedClusterInstances

  • Článek

Definice prostředku Bicep

Typ prostředku provisionedClusterInstances je možné nasadit s operacemi, které cílí:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.HybridContainerService/provisionedClusterInstances, přidejte do šablony následující bicep.

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

Hodnoty vlastností

AgentPoolProfileNodeLabels

Jméno Popis Hodnota

CloudProviderProfile

Jméno Popis Hodnota
infraNetworkProfile Profil pro sítě infrastruktury používané zřízeným clusterem CloudProviderProfileInfraNetworkProfile

CloudProviderProfileInfraNetworkProfile

Jméno Popis Hodnota
vnetSubnetIds Seznam ID prostředků ARM (maximálně 1) pro objekt sítě infrastruktury, například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName} string[]

ClusterVMAccessProfile

Jméno Popis Hodnota
authorizedIPRanges IP adresa nebo CIDR pro přístup SSH k virtuálním počítačům ve zřízeném clusteru řetězec

ControlPlaneProfile

Jméno Popis Hodnota
controlPlaneEndpoint IP adresa serveru rozhraní API Kubernetes ControlPlaneProfileControlPlaneEndpoint
počítat Počet uzlů řídicí roviny Výchozí hodnota je 1 a počet by měl být lichý. Int
vmSize Velikost skladové položky virtuálního počítače uzlů řídicí roviny řetězec

ControlPlaneProfileControlPlaneEndpoint

Jméno Popis Hodnota
hostIP IP adresa serveru rozhraní API Kubernetes řetězec

ExtendedLocation

Jméno Popis Hodnota
Jméno ID ARM rozšířeného umístění řetězec
typ Typ rozšířeného umístění. Povolená hodnota: CustomLocation CustomLocation

LinuxProfileProperties

Jméno Popis Hodnota
ssh Konfigurace SSH pro virtuální počítače zřízeného clusteru LinuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Jméno Popis Hodnota
publicKeys Seznam veřejných klíčů SSH sloužících k ověřování pomocí virtuálních počítačů Je možné zadat maximálně 1 klíč. LinuxProfilePropertiesSshPublicKeysItem[]

LinuxProfilePropertiesSshPublicKeysItem

Jméno Popis Hodnota
keyData Veřejný klíč certifikátu používaný k ověření s virtuálními počítači přes SSH. Certifikát musí být ve formátu PEM s hlavičkami nebo bez. řetězec

Microsoft.HybridContainerService/provisionedClusterInstances

Jméno Popis Hodnota
extendedLocation Rozšířené umístění odkazující na základní infrastrukturu ExtendedLocation
Jméno Název prostředku Výchozí (povinné)
vlastnosti Vlastnosti zřízeného clusteru provisionedClusterProperties
rozsah Slouží k vytvoření prostředku v oboru, který se liší od oboru nasazení. Nastavte tuto vlastnost na symbolický název prostředku, který použijeprostředku rozšíření .

NamedAgentPoolProfile

Jméno Popis Hodnota
počítat Počet uzlů ve fondu agentů Výchozí hodnota je 1. Int
enableAutoScaling Určuje, jestli chcete povolit automatické škálování. Výchozí hodnota je false Bool
maxCount Maximální počet uzlů pro automatické škálování Int
maxPods Maximální počet podů, které se dají spustit na uzlu. Int
minCount Minimální počet uzlů pro automatické škálování Int
Jméno Jedinečný název výchozího fondu agentů v kontextu zřízeného clusteru Výchozí hodnota je <clusterName>-nodepool1 řetězec
nodeLabels Popisky uzlů, které se mají uchovávat ve všech uzlech ve fondu agentů. AgentPoolProfileNodeLabels
nodeTaints Tainty přidané do nových uzlů během vytváření a škálování fondu uzlů Například key=value:NoSchedule. string[]
osSKU Určuje skladovou položku operačního systému používanou fondem agentů. Výchozí hodnota je CBLMariner, pokud je OSType Linux. Výchozí hodnota je Windows2019, pokud je OSType Windows. CBLMariner
Windows2019
Windows2022
osType Konkrétní typ operačního systému image KubernetesVersion (Linux, Windows) Linux
Windows
vmSize Velikost skladové položky virtuálního počítače uzlu fondu agentů řetězec

NetworkProfile

Jméno Popis Hodnota
loadBalancerProfile Profil nástroje pro vyrovnávání zatížení proxy serveru s vysokou dostupností NetworkProfileLoadBalancerProfile
networkPolicy Zásady sítě používané k vytváření sítě Kubernetes Mezi možné hodnoty patří: calico. "calico"
podCidr Rozsah IP adres zápisu CIDR, ze kterého se mají přiřazovat IP adresy podů. řetězec

NetworkProfileLoadBalancerProfile

Jméno Popis Hodnota
počítat Počet virtuálníchpočítačůch Výchozí hodnota je 0. Int

ProvisionedClusterLicenseProfile

Jméno Popis Hodnota
azureHybridBenefit Určuje, jestli je zvýhodněné hybridní využití Azure výslovné. Výchozí hodnota je false "Nepravda"
NotApplicable
Pravda

ProvisionedClusterProperties

Jméno Popis Hodnota
agentPoolProfiles Vlastnosti fondu agentů pro zřízený cluster. NamedAgentPoolProfile[]
autoScalerProfile Parametry, které se mají použít u automatického škálování clusteru, když je pro zřízený cluster povolené automatické škálování. provisionedClusterPropertiesAutoScalerProfile
cloudProviderProfile Profil poskytovatele základní cloudové infrastruktury pro zřízený cluster. CloudProviderProfile
clusterVMAccessProfile Profil omezeného přístupu SSH pro virtuální počítače ve zřízeném clusteru. clusterVMAccessProfile
řídicí rovina Profil řídicí roviny zřízeného clusteru. ControlPlaneProfile
KubernetesVersion Verze Kubernetes, kterou používá zřízený cluster. řetězec
licenseProfile Profil licence zřízeného clusteru. ProvisionedClusterLicenseProfile
linuxProfile Profil pro virtuální počítače s Linuxem ve zřízeném clusteru. LinuxProfileProperties
networkProfile Profil konfigurace sítě pro zřízený cluster. NetworkProfile
storageProfile Konfigurační profil úložiště pro zřízený cluster. storageProfile

ProvisionedClusterPropertiesAutoScalerProfile

Jméno Popis Hodnota
balance-similar-node-groups Platné hodnoty jsou true a false. řetězec
expander Pokud není zadáno, výchozí hodnota je náhodná. Další informace najdete v rozbalovacích. "nejmenší odpad"
Most-pods
Priorita
"náhodná"
max-empty-bulk-delete Výchozí hodnota je 10. řetězec
max-graceful-termination-sec Výchozí hodnota je 600. řetězec
max-node-provision-time Výchozí hodnota je 15 min. Hodnoty musí být celé číslo následované 'm'. Nepodporuje se žádná jednotka času kromě minut (m). řetězec
max-total-unready-percentage Výchozí hodnota je 45. Maximum je 100 a minimum je 0. řetězec
zpoždění vertikálního navýšení kapacity nového podu Ve scénářích, jako je nárazové nebo dávkové škálování, kdy nechcete, aby certifikační autorita fungovala před tím, než plánovač Kubernetes může naplánovat všechny pody, můžete certifikační autoritě říct, aby před určitým věkem ignorovala neplánované pody. Výchozí hodnota je 0s. Hodnoty musí být celé číslo následované jednotkou (po sekundách, "m" pro minuty, "h" pro hodiny atd.). řetězec
ok-total-unready-count Musí to být celé číslo. Výchozí hodnota je 3. řetězec
vertikální snížení kapacity po přidání Výchozí hodnota je 10 m. Hodnoty musí být celé číslo následované 'm'. Nepodporuje se žádná jednotka času kromě minut (m). řetězec
vertikální snížení kapacity po odstranění Výchozí hodnota je interval kontroly. Hodnoty musí být celé číslo následované 'm'. Nepodporuje se žádná jednotka času kromě minut (m). řetězec
vertikální snížení kapacity – zpoždění po selhání Výchozí hodnota je 3 min. Hodnoty musí být celé číslo následované 'm'. Nepodporuje se žádná jednotka času kromě minut (m). řetězec
vertikální snížení nepotřebné doby Výchozí hodnota je 10 m. Hodnoty musí být celé číslo následované 'm'. Nepodporuje se žádná jednotka času kromě minut (m). řetězec
vertikální snížení kapacity – nepřečtený čas Výchozí hodnota je 20 min. Hodnoty musí být celé číslo následované 'm'. Nepodporuje se žádná jednotka času kromě minut (m). řetězec
prahová hodnota vertikálního snížení využití Výchozí hodnota je 0,5. řetězec
interval kontroly Výchozí hodnota je 10. Hodnoty musí být celočíselné číslo sekund. řetězec
skip-nodes-with-local-storage Výchozí hodnota je true. řetězec
skip-nodes-with-system-pods Výchozí hodnota je true. řetězec

StorageProfile

Jméno Popis Hodnota
NfsCsiDriver Nastavení ovladače CSI systému souborů NFS pro profil úložiště StorageProfileNfsCSIDriver
smbCsiDriver Nastavení ovladače SMB CSI pro profil úložiště StorageProfileSmbCSIDriver

StorageProfileNfsCSIDriver

Jméno Popis Hodnota
zpřístupněný Určuje, zda se má povolit ovladač CSI systému souborů NFS. Výchozí hodnota je true. Bool

StorageProfileSmbCSIDriver

Jméno Popis Hodnota
zpřístupněný Určuje, jestli se má povolit ovladač SMB CSI. Výchozí hodnota je true. Bool

Ukázky rychlého startu

Následující ukázky rychlého startu nasadí tento typ prostředku.

Soubor Bicep Popis
vytvoření clusteru Kubernetes ve službě Azure Stack HCI Tato šablona vytvoří cluster Kubernetes ve službě Azure Stack HCI verze 23H2+

Definice prostředku šablony ARM

Typ prostředku provisionedClusterInstances je možné nasadit s operacemi, které cílí:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.HybridContainerService/provisionedClusterInstances, přidejte do šablony následující JSON.

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

Hodnoty vlastností

AgentPoolProfileNodeLabels

Jméno Popis Hodnota

CloudProviderProfile

Jméno Popis Hodnota
infraNetworkProfile Profil pro sítě infrastruktury používané zřízeným clusterem CloudProviderProfileInfraNetworkProfile

CloudProviderProfileInfraNetworkProfile

Jméno Popis Hodnota
vnetSubnetIds Seznam ID prostředků ARM (maximálně 1) pro objekt sítě infrastruktury, například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName} string[]

ClusterVMAccessProfile

Jméno Popis Hodnota
authorizedIPRanges IP adresa nebo CIDR pro přístup SSH k virtuálním počítačům ve zřízeném clusteru řetězec

ControlPlaneProfile

Jméno Popis Hodnota
controlPlaneEndpoint IP adresa serveru rozhraní API Kubernetes ControlPlaneProfileControlPlaneEndpoint
počítat Počet uzlů řídicí roviny Výchozí hodnota je 1 a počet by měl být lichý. Int
vmSize Velikost skladové položky virtuálního počítače uzlů řídicí roviny řetězec

ControlPlaneProfileControlPlaneEndpoint

Jméno Popis Hodnota
hostIP IP adresa serveru rozhraní API Kubernetes řetězec

ExtendedLocation

Jméno Popis Hodnota
Jméno ID ARM rozšířeného umístění řetězec
typ Typ rozšířeného umístění. Povolená hodnota: CustomLocation CustomLocation

LinuxProfileProperties

Jméno Popis Hodnota
ssh Konfigurace SSH pro virtuální počítače zřízeného clusteru LinuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Jméno Popis Hodnota
publicKeys Seznam veřejných klíčů SSH sloužících k ověřování pomocí virtuálních počítačů Je možné zadat maximálně 1 klíč. LinuxProfilePropertiesSshPublicKeysItem[]

LinuxProfilePropertiesSshPublicKeysItem

Jméno Popis Hodnota
keyData Veřejný klíč certifikátu používaný k ověření s virtuálními počítači přes SSH. Certifikát musí být ve formátu PEM s hlavičkami nebo bez. řetězec

Microsoft.HybridContainerService/provisionedClusterInstances

Jméno Popis Hodnota
apiVersion Verze rozhraní API '2024-01-01'
extendedLocation Rozšířené umístění odkazující na základní infrastrukturu ExtendedLocation
Jméno Název prostředku Výchozí (povinné)
vlastnosti Vlastnosti zřízeného clusteru provisionedClusterProperties
typ Typ prostředku Microsoft.HybridContainerService/provisionedClusterInstances

NamedAgentPoolProfile

Jméno Popis Hodnota
počítat Počet uzlů ve fondu agentů Výchozí hodnota je 1. Int
enableAutoScaling Určuje, jestli chcete povolit automatické škálování. Výchozí hodnota je false Bool
maxCount Maximální počet uzlů pro automatické škálování Int
maxPods Maximální počet podů, které se dají spustit na uzlu. Int
minCount Minimální počet uzlů pro automatické škálování Int
Jméno Jedinečný název výchozího fondu agentů v kontextu zřízeného clusteru Výchozí hodnota je <clusterName>-nodepool1 řetězec
nodeLabels Popisky uzlů, které se mají uchovávat ve všech uzlech ve fondu agentů. AgentPoolProfileNodeLabels
nodeTaints Tainty přidané do nových uzlů během vytváření a škálování fondu uzlů Například key=value:NoSchedule. string[]
osSKU Určuje skladovou položku operačního systému používanou fondem agentů. Výchozí hodnota je CBLMariner, pokud je OSType Linux. Výchozí hodnota je Windows2019, pokud je OSType Windows. CBLMariner
Windows2019
Windows2022
osType Konkrétní typ operačního systému image KubernetesVersion (Linux, Windows) Linux
Windows
vmSize Velikost skladové položky virtuálního počítače uzlu fondu agentů řetězec

NetworkProfile

Jméno Popis Hodnota
loadBalancerProfile Profil nástroje pro vyrovnávání zatížení proxy serveru s vysokou dostupností NetworkProfileLoadBalancerProfile
networkPolicy Zásady sítě používané k vytváření sítě Kubernetes Mezi možné hodnoty patří: calico. "calico"
podCidr Rozsah IP adres zápisu CIDR, ze kterého se mají přiřazovat IP adresy podů. řetězec

NetworkProfileLoadBalancerProfile

Jméno Popis Hodnota
počítat Počet virtuálníchpočítačůch Výchozí hodnota je 0. Int

ProvisionedClusterLicenseProfile

Jméno Popis Hodnota
azureHybridBenefit Určuje, jestli je zvýhodněné hybridní využití Azure výslovné. Výchozí hodnota je false "Nepravda"
NotApplicable
Pravda

ProvisionedClusterProperties

Jméno Popis Hodnota
agentPoolProfiles Vlastnosti fondu agentů pro zřízený cluster. NamedAgentPoolProfile[]
autoScalerProfile Parametry, které se mají použít u automatického škálování clusteru, když je pro zřízený cluster povolené automatické škálování. provisionedClusterPropertiesAutoScalerProfile
cloudProviderProfile Profil poskytovatele základní cloudové infrastruktury pro zřízený cluster. CloudProviderProfile
clusterVMAccessProfile Profil omezeného přístupu SSH pro virtuální počítače ve zřízeném clusteru. clusterVMAccessProfile
řídicí rovina Profil řídicí roviny zřízeného clusteru. ControlPlaneProfile
KubernetesVersion Verze Kubernetes, kterou používá zřízený cluster. řetězec
licenseProfile Profil licence zřízeného clusteru. ProvisionedClusterLicenseProfile
linuxProfile Profil pro virtuální počítače s Linuxem ve zřízeném clusteru. LinuxProfileProperties
networkProfile Profil konfigurace sítě pro zřízený cluster. NetworkProfile
storageProfile Konfigurační profil úložiště pro zřízený cluster. storageProfile

ProvisionedClusterPropertiesAutoScalerProfile

Jméno Popis Hodnota
balance-similar-node-groups Platné hodnoty jsou true a false. řetězec
expander Pokud není zadáno, výchozí hodnota je náhodná. Další informace najdete v rozbalovacích. "nejmenší odpad"
Most-pods
Priorita
"náhodná"
max-empty-bulk-delete Výchozí hodnota je 10. řetězec
max-graceful-termination-sec Výchozí hodnota je 600. řetězec
max-node-provision-time Výchozí hodnota je 15 min. Hodnoty musí být celé číslo následované 'm'. Nepodporuje se žádná jednotka času kromě minut (m). řetězec
max-total-unready-percentage Výchozí hodnota je 45. Maximum je 100 a minimum je 0. řetězec
zpoždění vertikálního navýšení kapacity nového podu Ve scénářích, jako je nárazové nebo dávkové škálování, kdy nechcete, aby certifikační autorita fungovala před tím, než plánovač Kubernetes může naplánovat všechny pody, můžete certifikační autoritě říct, aby před určitým věkem ignorovala neplánované pody. Výchozí hodnota je 0s. Hodnoty musí být celé číslo následované jednotkou (po sekundách, "m" pro minuty, "h" pro hodiny atd.). řetězec
ok-total-unready-count Musí to být celé číslo. Výchozí hodnota je 3. řetězec
vertikální snížení kapacity po přidání Výchozí hodnota je 10 m. Hodnoty musí být celé číslo následované 'm'. Nepodporuje se žádná jednotka času kromě minut (m). řetězec
vertikální snížení kapacity po odstranění Výchozí hodnota je interval kontroly. Hodnoty musí být celé číslo následované 'm'. Nepodporuje se žádná jednotka času kromě minut (m). řetězec
vertikální snížení kapacity – zpoždění po selhání Výchozí hodnota je 3 min. Hodnoty musí být celé číslo následované 'm'. Nepodporuje se žádná jednotka času kromě minut (m). řetězec
vertikální snížení nepotřebné doby Výchozí hodnota je 10 m. Hodnoty musí být celé číslo následované 'm'. Nepodporuje se žádná jednotka času kromě minut (m). řetězec
vertikální snížení kapacity – nepřečtený čas Výchozí hodnota je 20 min. Hodnoty musí být celé číslo následované 'm'. Nepodporuje se žádná jednotka času kromě minut (m). řetězec
prahová hodnota vertikálního snížení využití Výchozí hodnota je 0,5. řetězec
interval kontroly Výchozí hodnota je 10. Hodnoty musí být celočíselné číslo sekund. řetězec
skip-nodes-with-local-storage Výchozí hodnota je true. řetězec
skip-nodes-with-system-pods Výchozí hodnota je true. řetězec

StorageProfile

Jméno Popis Hodnota
NfsCsiDriver Nastavení ovladače CSI systému souborů NFS pro profil úložiště StorageProfileNfsCSIDriver
smbCsiDriver Nastavení ovladače SMB CSI pro profil úložiště StorageProfileSmbCSIDriver

StorageProfileNfsCSIDriver

Jméno Popis Hodnota
zpřístupněný Určuje, zda se má povolit ovladač CSI systému souborů NFS. Výchozí hodnota je true. Bool

StorageProfileSmbCSIDriver

Jméno Popis Hodnota
zpřístupněný Určuje, jestli se má povolit ovladač SMB CSI. Výchozí hodnota je true. Bool

Šablony pro rychlý start

Následující šablony pro rychlý start nasazují tento typ prostředku.

Šablona Popis
vytvoření clusteru Kubernetes ve službě Azure Stack HCI

nasazení do Azure		 Tato šablona vytvoří cluster Kubernetes ve službě Azure Stack HCI verze 23H2+

Definice prostředku Terraformu (poskytovatel AzAPI)

Typ prostředku provisionedClusterInstances je možné nasadit s operacemi, které cílí:

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.HybridContainerService/provisionedClusterInstances, přidejte do šablony následující Terraform.

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

Hodnoty vlastností

AgentPoolProfileNodeLabels

Jméno Popis Hodnota

CloudProviderProfile

Jméno Popis Hodnota
infraNetworkProfile Profil pro sítě infrastruktury používané zřízeným clusterem CloudProviderProfileInfraNetworkProfile

CloudProviderProfileInfraNetworkProfile

Jméno Popis Hodnota
vnetSubnetIds Seznam ID prostředků ARM (maximálně 1) pro objekt sítě infrastruktury, například /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName} string[]

ClusterVMAccessProfile

Jméno Popis Hodnota
authorizedIPRanges IP adresa nebo CIDR pro přístup SSH k virtuálním počítačům ve zřízeném clusteru řetězec

ControlPlaneProfile

Jméno Popis Hodnota
controlPlaneEndpoint IP adresa serveru rozhraní API Kubernetes ControlPlaneProfileControlPlaneEndpoint
počítat Počet uzlů řídicí roviny Výchozí hodnota je 1 a počet by měl být lichý. Int
vmSize Velikost skladové položky virtuálního počítače uzlů řídicí roviny řetězec

ControlPlaneProfileControlPlaneEndpoint

Jméno Popis Hodnota
hostIP IP adresa serveru rozhraní API Kubernetes řetězec

ExtendedLocation

Jméno Popis Hodnota
Jméno ID ARM rozšířeného umístění řetězec
typ Typ rozšířeného umístění. Povolená hodnota: CustomLocation CustomLocation

LinuxProfileProperties

Jméno Popis Hodnota
ssh Konfigurace SSH pro virtuální počítače zřízeného clusteru LinuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Jméno Popis Hodnota
publicKeys Seznam veřejných klíčů SSH sloužících k ověřování pomocí virtuálních počítačů Je možné zadat maximálně 1 klíč. LinuxProfilePropertiesSshPublicKeysItem[]

LinuxProfilePropertiesSshPublicKeysItem

Jméno Popis Hodnota
keyData Veřejný klíč certifikátu používaný k ověření s virtuálními počítači přes SSH. Certifikát musí být ve formátu PEM s hlavičkami nebo bez. řetězec

Microsoft.HybridContainerService/provisionedClusterInstances

Jméno Popis Hodnota
extendedLocation Rozšířené umístění odkazující na základní infrastrukturu ExtendedLocation
Jméno Název prostředku Výchozí (povinné)
parent_id ID prostředku, na který se má tento prostředek rozšíření použít. string (povinné)
vlastnosti Vlastnosti zřízeného clusteru provisionedClusterProperties
typ Typ prostředku Microsoft.HybridContainerService/provisionedClusterInstances@2024-01-01

NamedAgentPoolProfile

Jméno Popis Hodnota
počítat Počet uzlů ve fondu agentů Výchozí hodnota je 1. Int
enableAutoScaling Určuje, jestli chcete povolit automatické škálování. Výchozí hodnota je false Bool
maxCount Maximální počet uzlů pro automatické škálování Int
maxPods Maximální počet podů, které se dají spustit na uzlu. Int
minCount Minimální počet uzlů pro automatické škálování Int
Jméno Jedinečný název výchozího fondu agentů v kontextu zřízeného clusteru Výchozí hodnota je <clusterName>-nodepool1 řetězec
nodeLabels Popisky uzlů, které se mají uchovávat ve všech uzlech ve fondu agentů. AgentPoolProfileNodeLabels
nodeTaints Tainty přidané do nových uzlů během vytváření a škálování fondu uzlů Například key=value:NoSchedule. string[]
osSKU Určuje skladovou položku operačního systému používanou fondem agentů. Výchozí hodnota je CBLMariner, pokud je OSType Linux. Výchozí hodnota je Windows2019, pokud je OSType Windows. CBLMariner
Windows2019
Windows2022
osType Konkrétní typ operačního systému image KubernetesVersion (Linux, Windows) Linux
Windows
vmSize Velikost skladové položky virtuálního počítače uzlu fondu agentů řetězec

NetworkProfile

Jméno Popis Hodnota
loadBalancerProfile Profil nástroje pro vyrovnávání zatížení proxy serveru s vysokou dostupností NetworkProfileLoadBalancerProfile
networkPolicy Zásady sítě používané k vytváření sítě Kubernetes Mezi možné hodnoty patří: calico. "calico"
podCidr Rozsah IP adres zápisu CIDR, ze kterého se mají přiřazovat IP adresy podů. řetězec

NetworkProfileLoadBalancerProfile

Jméno Popis Hodnota
počítat Počet virtuálníchpočítačůch Výchozí hodnota je 0. Int

ProvisionedClusterLicenseProfile

Jméno Popis Hodnota
azureHybridBenefit Určuje, jestli je zvýhodněné hybridní využití Azure výslovné. Výchozí hodnota je false "Nepravda"
NotApplicable
Pravda

ProvisionedClusterProperties

Jméno Popis Hodnota
agentPoolProfiles Vlastnosti fondu agentů pro zřízený cluster. NamedAgentPoolProfile[]
autoScalerProfile Parametry, které se mají použít u automatického škálování clusteru, když je pro zřízený cluster povolené automatické škálování. provisionedClusterPropertiesAutoScalerProfile
cloudProviderProfile Profil poskytovatele základní cloudové infrastruktury pro zřízený cluster. CloudProviderProfile
clusterVMAccessProfile Profil omezeného přístupu SSH pro virtuální počítače ve zřízeném clusteru. clusterVMAccessProfile
řídicí rovina Profil řídicí roviny zřízeného clusteru. ControlPlaneProfile
KubernetesVersion Verze Kubernetes, kterou používá zřízený cluster. řetězec
licenseProfile Profil licence zřízeného clusteru. ProvisionedClusterLicenseProfile
linuxProfile Profil pro virtuální počítače s Linuxem ve zřízeném clusteru. LinuxProfileProperties
networkProfile Profil konfigurace sítě pro zřízený cluster. NetworkProfile
storageProfile Konfigurační profil úložiště pro zřízený cluster. storageProfile

ProvisionedClusterPropertiesAutoScalerProfile

Jméno Popis Hodnota
balance-similar-node-groups Platné hodnoty jsou true a false. řetězec
expander Pokud není zadáno, výchozí hodnota je náhodná. Další informace najdete v rozbalovacích. "nejmenší odpad"
Most-pods
Priorita
"náhodná"
max-empty-bulk-delete Výchozí hodnota je 10. řetězec
max-graceful-termination-sec Výchozí hodnota je 600. řetězec
max-node-provision-time Výchozí hodnota je 15 min. Hodnoty musí být celé číslo následované 'm'. Nepodporuje se žádná jednotka času kromě minut (m). řetězec
max-total-unready-percentage Výchozí hodnota je 45. Maximum je 100 a minimum je 0. řetězec
zpoždění vertikálního navýšení kapacity nového podu Ve scénářích, jako je nárazové nebo dávkové škálování, kdy nechcete, aby certifikační autorita fungovala před tím, než plánovač Kubernetes může naplánovat všechny pody, můžete certifikační autoritě říct, aby před určitým věkem ignorovala neplánované pody. Výchozí hodnota je 0s. Hodnoty musí být celé číslo následované jednotkou (po sekundách, "m" pro minuty, "h" pro hodiny atd.). řetězec
ok-total-unready-count Musí to být celé číslo. Výchozí hodnota je 3. řetězec
vertikální snížení kapacity po přidání Výchozí hodnota je 10 m. Hodnoty musí být celé číslo následované 'm'. Nepodporuje se žádná jednotka času kromě minut (m). řetězec
vertikální snížení kapacity po odstranění Výchozí hodnota je interval kontroly. Hodnoty musí být celé číslo následované 'm'. Nepodporuje se žádná jednotka času kromě minut (m). řetězec
vertikální snížení kapacity – zpoždění po selhání Výchozí hodnota je 3 min. Hodnoty musí být celé číslo následované 'm'. Nepodporuje se žádná jednotka času kromě minut (m). řetězec
vertikální snížení nepotřebné doby Výchozí hodnota je 10 m. Hodnoty musí být celé číslo následované 'm'. Nepodporuje se žádná jednotka času kromě minut (m). řetězec
vertikální snížení kapacity – nepřečtený čas Výchozí hodnota je 20 min. Hodnoty musí být celé číslo následované 'm'. Nepodporuje se žádná jednotka času kromě minut (m). řetězec
prahová hodnota vertikálního snížení využití Výchozí hodnota je 0,5. řetězec
interval kontroly Výchozí hodnota je 10. Hodnoty musí být celočíselné číslo sekund. řetězec
skip-nodes-with-local-storage Výchozí hodnota je true. řetězec
skip-nodes-with-system-pods Výchozí hodnota je true. řetězec

StorageProfile

Jméno Popis Hodnota
NfsCsiDriver Nastavení ovladače CSI systému souborů NFS pro profil úložiště StorageProfileNfsCSIDriver
smbCsiDriver Nastavení ovladače SMB CSI pro profil úložiště StorageProfileSmbCSIDriver

StorageProfileNfsCSIDriver

Jméno Popis Hodnota
zpřístupněný Určuje, zda se má povolit ovladač CSI systému souborů NFS. Výchozí hodnota je true. Bool

StorageProfileSmbCSIDriver

Jméno Popis Hodnota
zpřístupněný Určuje, jestli se má povolit ovladač SMB CSI. Výchozí hodnota je true. Bool