Partilhar via

Microsoft.HybridContainerService provisionedClusterInstances 2023-11-15-preview

  • Artigo

Definição de recursos do bíceps

O tipo de recurso provisionedClusterInstances pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.HybridContainerService/provisionedClusterInstances, adicione o seguinte Bíceps ao seu modelo.

resource symbolicname 'Microsoft.HybridContainerService/provisionedClusterInstances@2023-11-15-preview' = {
  scope: resourceSymbolicName or scope
  extendedLocation: {
    name: 'string'
    type: 'string'
  }
  name: 'default'
  properties: {
    agentPoolProfiles: [
      {
        availabilityZones: [
          'string'
        ]
        count: int
        name: 'string'
        nodeImageVersion: 'string'
        osSKU: 'string'
        osType: 'string'
        vmSize: 'string'
      }
    ]
    cloudProviderProfile: {
      infraNetworkProfile: {
        vnetSubnetIds: [
          'string'
        ]
      }
    }
    controlPlane: {
      availabilityZones: [
        'string'
      ]
      controlPlaneEndpoint: {
        hostIP: 'string'
        port: int
      }
      count: int
      linuxProfile: {
        ssh: {
          publicKeys: [
            {
              keyData: 'string'
            }
          ]
        }
      }
      name: 'string'
      nodeImageVersion: 'string'
      osSKU: 'string'
      osType: 'string'
      vmSize: 'string'
    }
    kubernetesVersion: 'string'
    licenseProfile: {
      azureHybridBenefit: 'string'
    }
    linuxProfile: {
      ssh: {
        publicKeys: [
          {
            keyData: 'string'
          }
        ]
      }
    }
    networkProfile: {
      loadBalancerProfile: {
        count: int
      }
      networkPolicy: 'string'
      podCidr: 'string'
    }
  }
}

Valores de propriedade

CloudProviderProfile

Designação Descrição Valor
infraNetworkProfile InfraNetworkProfile - Lista de perfis de infra-rede para o cluster provisionado CloudProviderProfileInfraNetworkProfile

CloudProviderProfileInfraNetworkProfile

Designação Descrição Valor
vnetSubnetIds Matriz de referências ao recurso azure correspondente ao objeto Network, por exemplo, /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName} string[]

ControlPlaneEndpointProfileControlPlaneEndpoint

Designação Descrição Valor
hostIP Endereço IP do host para o servidor de API string
porto Porta para o servidor de API Int

ControlPlaneProfile

Designação Descrição Valor
disponibilidadeZonas AvailabilityZones - A lista de zonas de disponibilidade a serem usadas para nós. Racks de datacenter modelados como zonas string[]
controlPlaneEndpoint Ponto de extremidade do servidor de API para o plano de controle ControlPlaneEndpointProfileControlPlaneEndpoint
contagem Contagem - Número de agentes para hospedar contêineres docker. Os valores permitidos devem estar no intervalo de 1 a 100 (inclusive). O valor padrão é 1. Int
linuxPerfil Perfil para VMs Linux no cluster de serviço de contêiner. LinuxProfileProperties
Designação Nome exclusivo do perfil do pool de agentes no contexto da assinatura e do grupo de recursos. string
nodeImageVersion A versão da imagem do nó string
osSKU Especifica a SKU do sistema operacional usada pelo pool de agentes. O padrão é CBLMariner se OSType for Linux. O padrão é Windows2019 quando OSType é Windows. 'CBLMariner'
'Windows2019'
'Windows2022'
osType O tipo de sistema operacional específico da imagem do KubernetesVersion (Linux, Windows) 'Linux'
'Janelas'
vmTamanho VmSize - O tamanho das VMs do pool de agentes. string

Localização Estendida

Designação Descrição Valor
Designação O nome do local estendido. string
tipo O tipo de local estendido. 'Localização personalizada'

LinuxProfileProperties

Designação Descrição Valor
SSH SSH - Configuração SSH para VMs baseadas em Linux em execução no Azure. LinuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Designação Descrição Valor
chaves públicas PublicKeys - A lista de chaves públicas SSH usadas para autenticar com VMs baseadas em Linux. Espere apenas uma chave especificada. LinuxProfilePropertiesSshPublicKeysItem []

LinuxProfilePropertiesSshPublicKeysItem

Designação Descrição Valor
dados-chave KeyData - Chave pública de certificado usada para autenticar com VMs por meio de SSH. O certificado deve estar em formato PEM com ou sem cabeçalhos. string

Microsoft.HybridContainerService/provisionedClusterInstances

Designação Descrição Valor
extendedLocalização Definição de localização estendida ExtendedLocation
Designação O nome do recurso 'default' (obrigatório)
propriedades Todas as propriedades do cluster provisionado ProvisionedClusterProperties
Âmbito de aplicação Use ao criar um recurso em um escopo diferente do escopo de implantação. Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .

NomedAgentPoolProfile

Designação Descrição Valor
disponibilidadeZonas AvailabilityZones - A lista de zonas de disponibilidade a serem usadas para nós. Racks de datacenter modelados como zonas string[]
contagem Contagem - Número de agentes para hospedar contêineres docker. Os valores permitidos devem estar no intervalo de 1 a 100 (inclusive). O valor padrão é 1. Int
Designação Nome exclusivo do perfil do pool de agentes no contexto da assinatura e do grupo de recursos. string
nodeImageVersion A versão da imagem do nó string
osSKU Especifica a SKU do sistema operacional usada pelo pool de agentes. O padrão é CBLMariner se OSType for Linux. O padrão é Windows2019 quando OSType é Windows. 'CBLMariner'
'Windows2019'
'Windows2022'
osType O tipo de sistema operacional específico da imagem do KubernetesVersion (Linux, Windows) 'Linux'
'Janelas'
vmTamanho VmSize - O tamanho das VMs do pool de agentes. string

Perfil de rede

Designação Descrição Valor
loadBalancerProfile LoadBalancerProfile - Perfil do balanceador de carga de cluster. NetworkProfileLoadBalancerProfile
networkPolicy NetworkPolicy - Política de rede usada para criar a rede Kubernetes. Os valores possíveis incluem: 'calico', 'flanela'. O padrão é 'calico' 'Calico'
«Flanela»
podCidr PodCidr - Um intervalo de IP de notação CIDR a partir do qual atribuir IPs pod quando kubenet é usado. string

NetworkProfileLoadBalancerProfile

Designação Descrição Valor
contagem Contagem - Número de VMs do balanceador de carga. O valor padrão é 0. Int

ProvisionedClusterLicenseProfile

Designação Descrição Valor
azureHybridBenefit Indica se o Benefício Híbrido do Azure foi aceito 'Falso'
'Não aplicável'
'Verdade'

ProvisionedClusterProperties

Designação Descrição Valor
agentPoolProfiles Os pools de agentes do cluster. NamedAgentPoolProfile[]
cloudProviderProfile As propriedades subjacentes do provedor de infraestrutura de nuvem. CloudProviderProfile
controlPlane ControlPlane - Configuração do ControlPlane ControlPlaneProfile
kubernetesVersão KubernetesVersion - Versão do Kubernetes especificada ao criar o cluster gerenciado. string
licenseProfile O perfil de licença do cluster provisionado. ProvisionedClusterLicenseProfile
linuxPerfil LinuxProfile - O perfil para VMs Linux no cluster provisionado. LinuxProfileProperties
networkProfile NetworkProfile - Perfil de configuração de rede. NetworkProfile

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep Descrição
Criar um cluster Kubernetes no Azure Stack HCI Este modelo cria um cluster Kubernetes no Azure Stack HCI versão 23H2+

Definição de recurso de modelo ARM

O tipo de recurso provisionedClusterInstances pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.HybridContainerService/provisionedClusterInstances, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.HybridContainerService/provisionedClusterInstances",
  "apiVersion": "2023-11-15-preview",
  "name": "string",
  "extendedLocation": {
    "name": "string",
    "type": "string"
  },
  "properties": {
    "agentPoolProfiles": [
      {
        "availabilityZones": [ "string" ],
        "count": "int",
        "name": "string",
        "nodeImageVersion": "string",
        "osSKU": "string",
        "osType": "string",
        "vmSize": "string"
      }
    ],
    "cloudProviderProfile": {
      "infraNetworkProfile": {
        "vnetSubnetIds": [ "string" ]
      }
    },
    "controlPlane": {
      "availabilityZones": [ "string" ],
      "controlPlaneEndpoint": {
        "hostIP": "string",
        "port": "int"
      },
      "count": "int",
      "linuxProfile": {
        "ssh": {
          "publicKeys": [
            {
              "keyData": "string"
            }
          ]
        }
      },
      "name": "string",
      "nodeImageVersion": "string",
      "osSKU": "string",
      "osType": "string",
      "vmSize": "string"
    },
    "kubernetesVersion": "string",
    "licenseProfile": {
      "azureHybridBenefit": "string"
    },
    "linuxProfile": {
      "ssh": {
        "publicKeys": [
          {
            "keyData": "string"
          }
        ]
      }
    },
    "networkProfile": {
      "loadBalancerProfile": {
        "count": "int"
      },
      "networkPolicy": "string",
      "podCidr": "string"
    }
  }
}

Valores de propriedade

CloudProviderProfile

Designação Descrição Valor
infraNetworkProfile InfraNetworkProfile - Lista de perfis de infra-rede para o cluster provisionado CloudProviderProfileInfraNetworkProfile

CloudProviderProfileInfraNetworkProfile

Designação Descrição Valor
vnetSubnetIds Matriz de referências ao recurso azure correspondente ao objeto Network, por exemplo, /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName} string[]

ControlPlaneEndpointProfileControlPlaneEndpoint

Designação Descrição Valor
hostIP Endereço IP do host para o servidor de API string
porto Porta para o servidor de API Int

ControlPlaneProfile

Designação Descrição Valor
disponibilidadeZonas AvailabilityZones - A lista de zonas de disponibilidade a serem usadas para nós. Racks de datacenter modelados como zonas string[]
controlPlaneEndpoint Ponto de extremidade do servidor de API para o plano de controle ControlPlaneEndpointProfileControlPlaneEndpoint
contagem Contagem - Número de agentes para hospedar contêineres docker. Os valores permitidos devem estar no intervalo de 1 a 100 (inclusive). O valor padrão é 1. Int
linuxPerfil Perfil para VMs Linux no cluster de serviço de contêiner. LinuxProfileProperties
Designação Nome exclusivo do perfil do pool de agentes no contexto da assinatura e do grupo de recursos. string
nodeImageVersion A versão da imagem do nó string
osSKU Especifica a SKU do sistema operacional usada pelo pool de agentes. O padrão é CBLMariner se OSType for Linux. O padrão é Windows2019 quando OSType é Windows. 'CBLMariner'
'Windows2019'
'Windows2022'
osType O tipo de sistema operacional específico da imagem do KubernetesVersion (Linux, Windows) 'Linux'
'Janelas'
vmTamanho VmSize - O tamanho das VMs do pool de agentes. string

Localização Estendida

Designação Descrição Valor
Designação O nome do local estendido. string
tipo O tipo de local estendido. 'Localização personalizada'

LinuxProfileProperties

Designação Descrição Valor
SSH SSH - Configuração SSH para VMs baseadas em Linux em execução no Azure. LinuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Designação Descrição Valor
chaves públicas PublicKeys - A lista de chaves públicas SSH usadas para autenticar com VMs baseadas em Linux. Espere apenas uma chave especificada. LinuxProfilePropertiesSshPublicKeysItem []

LinuxProfilePropertiesSshPublicKeysItem

Designação Descrição Valor
dados-chave KeyData - Chave pública de certificado usada para autenticar com VMs por meio de SSH. O certificado deve estar em formato PEM com ou sem cabeçalhos. string

Microsoft.HybridContainerService/provisionedClusterInstances

Designação Descrição Valor
apiVersion A versão api '2023-11-15-pré-visualização'
extendedLocalização Definição de localização estendida ExtendedLocation
Designação O nome do recurso 'default' (obrigatório)
propriedades Todas as propriedades do cluster provisionado ProvisionedClusterProperties
tipo O tipo de recurso 'Microsoft.HybridContainerService/provisionedClusterInstances'

NomedAgentPoolProfile

Designação Descrição Valor
disponibilidadeZonas AvailabilityZones - A lista de zonas de disponibilidade a serem usadas para nós. Racks de datacenter modelados como zonas string[]
contagem Contagem - Número de agentes para hospedar contêineres docker. Os valores permitidos devem estar no intervalo de 1 a 100 (inclusive). O valor padrão é 1. Int
Designação Nome exclusivo do perfil do pool de agentes no contexto da assinatura e do grupo de recursos. string
nodeImageVersion A versão da imagem do nó string
osSKU Especifica a SKU do sistema operacional usada pelo pool de agentes. O padrão é CBLMariner se OSType for Linux. O padrão é Windows2019 quando OSType é Windows. 'CBLMariner'
'Windows2019'
'Windows2022'
osType O tipo de sistema operacional específico da imagem do KubernetesVersion (Linux, Windows) 'Linux'
'Janelas'
vmTamanho VmSize - O tamanho das VMs do pool de agentes. string

Perfil de rede

Designação Descrição Valor
loadBalancerProfile LoadBalancerProfile - Perfil do balanceador de carga de cluster. NetworkProfileLoadBalancerProfile
networkPolicy NetworkPolicy - Política de rede usada para criar a rede Kubernetes. Os valores possíveis incluem: 'calico', 'flanela'. O padrão é 'calico' 'Calico'
«Flanela»
podCidr PodCidr - Um intervalo de IP de notação CIDR a partir do qual atribuir IPs pod quando kubenet é usado. string

NetworkProfileLoadBalancerProfile

Designação Descrição Valor
contagem Contagem - Número de VMs do balanceador de carga. O valor padrão é 0. Int

ProvisionedClusterLicenseProfile

Designação Descrição Valor
azureHybridBenefit Indica se o Benefício Híbrido do Azure foi aceito 'Falso'
'Não aplicável'
'Verdade'

ProvisionedClusterProperties

Designação Descrição Valor
agentPoolProfiles Os pools de agentes do cluster. NamedAgentPoolProfile[]
cloudProviderProfile As propriedades subjacentes do provedor de infraestrutura de nuvem. CloudProviderProfile
controlPlane ControlPlane - Configuração do ControlPlane ControlPlaneProfile
kubernetesVersão KubernetesVersion - Versão do Kubernetes especificada ao criar o cluster gerenciado. string
licenseProfile O perfil de licença do cluster provisionado. ProvisionedClusterLicenseProfile
linuxPerfil LinuxProfile - O perfil para VMs Linux no cluster provisionado. LinuxProfileProperties
networkProfile NetworkProfile - Perfil de configuração de rede. NetworkProfile

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
Criar um cluster Kubernetes no Azure Stack HCI

Implantar no Azure 		Este modelo cria um cluster Kubernetes no Azure Stack HCI versão 23H2+

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso provisionedClusterInstances pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.HybridContainerService/provisionedClusterInstances, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.HybridContainerService/provisionedClusterInstances@2023-11-15-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    extendedLocation = {
      name = "string"
      type = "string"
    }
    properties = {
      agentPoolProfiles = [
        {
          availabilityZones = [
            "string"
          ]
          count = int
          name = "string"
          nodeImageVersion = "string"
          osSKU = "string"
          osType = "string"
          vmSize = "string"
        }
      ]
      cloudProviderProfile = {
        infraNetworkProfile = {
          vnetSubnetIds = [
            "string"
          ]
        }
      }
      controlPlane = {
        availabilityZones = [
          "string"
        ]
        controlPlaneEndpoint = {
          hostIP = "string"
          port = int
        }
        count = int
        linuxProfile = {
          ssh = {
            publicKeys = [
              {
                keyData = "string"
              }
            ]
          }
        }
        name = "string"
        nodeImageVersion = "string"
        osSKU = "string"
        osType = "string"
        vmSize = "string"
      }
      kubernetesVersion = "string"
      licenseProfile = {
        azureHybridBenefit = "string"
      }
      linuxProfile = {
        ssh = {
          publicKeys = [
            {
              keyData = "string"
            }
          ]
        }
      }
      networkProfile = {
        loadBalancerProfile = {
          count = int
        }
        networkPolicy = "string"
        podCidr = "string"
      }
    }
  })
}

Valores de propriedade

CloudProviderProfile

Designação Descrição Valor
infraNetworkProfile InfraNetworkProfile - Lista de perfis de infra-rede para o cluster provisionado CloudProviderProfileInfraNetworkProfile

CloudProviderProfileInfraNetworkProfile

Designação Descrição Valor
vnetSubnetIds Matriz de referências ao recurso azure correspondente ao objeto Network, por exemplo, /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName} string[]

ControlPlaneEndpointProfileControlPlaneEndpoint

Designação Descrição Valor
hostIP Endereço IP do host para o servidor de API string
porto Porta para o servidor de API Int

ControlPlaneProfile

Designação Descrição Valor
disponibilidadeZonas AvailabilityZones - A lista de zonas de disponibilidade a serem usadas para nós. Racks de datacenter modelados como zonas string[]
controlPlaneEndpoint Ponto de extremidade do servidor de API para o plano de controle ControlPlaneEndpointProfileControlPlaneEndpoint
contagem Contagem - Número de agentes para hospedar contêineres docker. Os valores permitidos devem estar no intervalo de 1 a 100 (inclusive). O valor padrão é 1. Int
linuxPerfil Perfil para VMs Linux no cluster de serviço de contêiner. LinuxProfileProperties
Designação Nome exclusivo do perfil do pool de agentes no contexto da assinatura e do grupo de recursos. string
nodeImageVersion A versão da imagem do nó string
osSKU Especifica a SKU do sistema operacional usada pelo pool de agentes. O padrão é CBLMariner se OSType for Linux. O padrão é Windows2019 quando OSType é Windows. 'CBLMariner'
'Windows2019'
'Windows2022'
osType O tipo de sistema operacional específico da imagem do KubernetesVersion (Linux, Windows) 'Linux'
'Janelas'
vmTamanho VmSize - O tamanho das VMs do pool de agentes. string

Localização Estendida

Designação Descrição Valor
Designação O nome do local estendido. string
tipo O tipo de local estendido. 'Localização personalizada'

LinuxProfileProperties

Designação Descrição Valor
SSH SSH - Configuração SSH para VMs baseadas em Linux em execução no Azure. LinuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Designação Descrição Valor
chaves públicas PublicKeys - A lista de chaves públicas SSH usadas para autenticar com VMs baseadas em Linux. Espere apenas uma chave especificada. LinuxProfilePropertiesSshPublicKeysItem []

LinuxProfilePropertiesSshPublicKeysItem

Designação Descrição Valor
dados-chave KeyData - Chave pública de certificado usada para autenticar com VMs por meio de SSH. O certificado deve estar em formato PEM com ou sem cabeçalhos. string

Microsoft.HybridContainerService/provisionedClusterInstances

Designação Descrição Valor
extendedLocalização Definição de localização estendida ExtendedLocation
Designação O nome do recurso 'default' (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. string (obrigatório)
propriedades Todas as propriedades do cluster provisionado ProvisionedClusterProperties
tipo O tipo de recurso "Microsoft.HybridContainerService/provisionedClusterInstances@2023-11-15-preview"

NomedAgentPoolProfile

Designação Descrição Valor
disponibilidadeZonas AvailabilityZones - A lista de zonas de disponibilidade a serem usadas para nós. Racks de datacenter modelados como zonas string[]
contagem Contagem - Número de agentes para hospedar contêineres docker. Os valores permitidos devem estar no intervalo de 1 a 100 (inclusive). O valor padrão é 1. Int
Designação Nome exclusivo do perfil do pool de agentes no contexto da assinatura e do grupo de recursos. string
nodeImageVersion A versão da imagem do nó string
osSKU Especifica a SKU do sistema operacional usada pelo pool de agentes. O padrão é CBLMariner se OSType for Linux. O padrão é Windows2019 quando OSType é Windows. 'CBLMariner'
'Windows2019'
'Windows2022'
osType O tipo de sistema operacional específico da imagem do KubernetesVersion (Linux, Windows) 'Linux'
'Janelas'
vmTamanho VmSize - O tamanho das VMs do pool de agentes. string

Perfil de rede

Designação Descrição Valor
loadBalancerProfile LoadBalancerProfile - Perfil do balanceador de carga de cluster. NetworkProfileLoadBalancerProfile
networkPolicy NetworkPolicy - Política de rede usada para criar a rede Kubernetes. Os valores possíveis incluem: 'calico', 'flanela'. O padrão é 'calico' 'Calico'
«Flanela»
podCidr PodCidr - Um intervalo de IP de notação CIDR a partir do qual atribuir IPs pod quando kubenet é usado. string

NetworkProfileLoadBalancerProfile

Designação Descrição Valor
contagem Contagem - Número de VMs do balanceador de carga. O valor padrão é 0. Int

ProvisionedClusterLicenseProfile

Designação Descrição Valor
azureHybridBenefit Indica se o Benefício Híbrido do Azure foi aceito 'Falso'
'Não aplicável'
'Verdade'

ProvisionedClusterProperties

Designação Descrição Valor
agentPoolProfiles Os pools de agentes do cluster. NamedAgentPoolProfile[]
cloudProviderProfile As propriedades subjacentes do provedor de infraestrutura de nuvem. CloudProviderProfile
controlPlane ControlPlane - Configuração do ControlPlane ControlPlaneProfile
kubernetesVersão KubernetesVersion - Versão do Kubernetes especificada ao criar o cluster gerenciado. string
licenseProfile O perfil de licença do cluster provisionado. ProvisionedClusterLicenseProfile
linuxPerfil LinuxProfile - O perfil para VMs Linux no cluster provisionado. LinuxProfileProperties
networkProfile NetworkProfile - Perfil de configuração de rede. NetworkProfile