Compartir a través de


Microsoft.HybridContainerService provisionedClusterInstances 2023-11-15-preview

Definición de recursos de Bicep

El tipo de recurso provisionedClusterInstances se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.HybridContainerService/provisionedClusterInstances, agregue el siguiente bicep a la plantilla.

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 propiedad

CloudProviderProfile

Nombre Descripción Valor
infraNetworkProfile InfraNetworkProfile: lista de perfiles de red de infraestructura para el clúster aprovisionado CloudProviderProfileInfraNetworkProfile

CloudProviderProfileInfraNetworkProfile

Nombre Descripción Valor
vnetSubnetIds Matriz de referencias a recursos de Azure correspondientes al objeto Network, por ejemplo, /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName} string[]

ControlPlaneEndpointProfileControlPlaneEndpoint

Nombre Descripción Valor
hostIP Dirección IP de host para el servidor de API cuerda
puerto Puerto para el servidor de API Int

ControlPlaneProfile

Nombre Descripción Valor
availabilityZones AvailabilityZones: la lista de zonas de disponibilidad que se van a usar para los nodos. Bastidores de centros de datos modelados como zonas string[]
controlPlaneEndpoint Punto de conexión del servidor de API para el plano de control ControlPlaneEndpointProfileControlPlaneEndpoint
contar Recuento: número de agentes para hospedar contenedores de Docker. Los valores permitidos deben estar en el intervalo de 1 a 100 (ambos incluidos). El valor predeterminado es 1. Int
linuxProfile Perfil de máquinas virtuales Linux en el clúster de servicios de contenedor. LinuxProfileProperties
nombre Nombre único del perfil del grupo de agentes en el contexto de la suscripción y el grupo de recursos. cuerda
nodeImageVersion La versión de la imagen de nodo cuerda
osSKU Especifica la SKU del sistema operativo utilizada por el grupo de agentes. El valor predeterminado es CBLMariner si OSType es Linux. El valor predeterminado es Windows2019 cuando OSType es Windows. 'CBLMariner'
'Windows2019'
'Windows2022'
osType Tipo de sistema operativo de la imagen de KubernetesVersion concreta (Linux, Windows) "Linux"
'Windows'
vmSize VmSize: tamaño de las máquinas virtuales del grupo de agentes. cuerda

ExtendedLocation

Nombre Descripción Valor
nombre Nombre de ubicación extendida. cuerda
tipo Tipo de ubicación extendida. 'CustomLocation'

LinuxProfileProperties

Nombre Descripción Valor
ssh SSH: configuración de SSH para máquinas virtuales basadas en Linux que se ejecutan en Azure. linuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Nombre Descripción Valor
publicKeys PublicKeys: la lista de claves públicas SSH que se usan para autenticarse con máquinas virtuales basadas en Linux. Solo se espera una clave especificada. LinuxProfilePropertiesSshPublicKeysItem[]

LinuxProfilePropertiesSshPublicKeysItem

Nombre Descripción Valor
keyData KeyData: clave pública de certificado que se usa para autenticarse con máquinas virtuales a través de SSH. El certificado debe estar en formato PEM con o sin encabezados. cuerda

Microsoft.HybridContainerService/provisionedClusterInstances

Nombre Descripción Valor
extendedLocation Definición de ubicación extendida ExtendedLocation
nombre El nombre del recurso 'default' (obligatorio)
Propiedades Todas las propiedades del clúster aprovisionado provisionedClusterProperties
alcance Use al crear un recurso en un ámbito diferente del ámbito de implementación. Establezca esta propiedad en el nombre simbólico de un recurso para aplicar el recurso de extensión .

NamedAgentPoolProfile

Nombre Descripción Valor
availabilityZones AvailabilityZones: la lista de zonas de disponibilidad que se van a usar para los nodos. Bastidores de centros de datos modelados como zonas string[]
contar Recuento: número de agentes para hospedar contenedores de Docker. Los valores permitidos deben estar en el intervalo de 1 a 100 (ambos incluidos). El valor predeterminado es 1. Int
nombre Nombre único del perfil del grupo de agentes en el contexto de la suscripción y el grupo de recursos. cuerda
nodeImageVersion La versión de la imagen de nodo cuerda
osSKU Especifica la SKU del sistema operativo utilizada por el grupo de agentes. El valor predeterminado es CBLMariner si OSType es Linux. El valor predeterminado es Windows2019 cuando OSType es Windows. 'CBLMariner'
'Windows2019'
'Windows2022'
osType Tipo de sistema operativo de la imagen de KubernetesVersion concreta (Linux, Windows) "Linux"
'Windows'
vmSize VmSize: tamaño de las máquinas virtuales del grupo de agentes. cuerda

NetworkProfile

Nombre Descripción Valor
loadBalancerProfile LoadBalancerProfile: perfil del equilibrador de carga del clúster. NetworkProfileLoadBalancerProfile
networkPolicy NetworkPolicy: directiva de red que se usa para compilar la red de Kubernetes. Entre los valores posibles se incluyen: 'calico', 'flannel'. El valor predeterminado es 'calico' 'calico'
'flannel'
podCidr PodCidr: intervalo IP de notación CIDR desde el que se van a asignar direcciones IP de pod cuando se usa kubenet. cuerda

NetworkProfileLoadBalancerProfile

Nombre Descripción Valor
contar Recuento: número de máquinas virtuales del equilibrador de carga. El valor predeterminado es 0. Int

ProvisionedClusterLicenseProfile

Nombre Descripción Valor
azureHybridBenefit Indica si se ha optado por la Ventaja híbrida de Azure. 'False'
'NotApplicable'
'True'

ProvisionedClusterProperties

Nombre Descripción Valor
agentPoolProfiles Los grupos de agentes del clúster. NamedAgentPoolProfile []
cloudProviderProfile Propiedades subyacentes del proveedor de infraestructuras en la nube. CloudProviderProfile
controlPlane ControlPlane: configuración de ControlPlane ControlPlaneProfile
kubernetesVersion KubernetesVersion: versión de Kubernetes especificada al crear el clúster administrado. cuerda
licenseProfile Perfil de licencia del clúster aprovisionado. ProvisionedClusterLicenseProfile
linuxProfile LinuxProfile: el perfil de las máquinas virtuales Linux en el clúster aprovisionado. LinuxProfileProperties
networkProfile NetworkProfile: perfil de configuración de red. networkProfile de

Ejemplos de inicio rápido

En los ejemplos de inicio rápido siguientes se implementa este tipo de recurso.

Archivo de Bicep Descripción
Creación de un clúster de Kubernetes en azure Stack HCI Esta plantilla crea un clúster de Kubernetes en Azure Stack HCI versión 23H2+

Definición de recursos de plantilla de ARM

El tipo de recurso provisionedClusterInstances se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.HybridContainerService/provisionedClusterInstances, agregue el siguiente JSON a la plantilla.

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

CloudProviderProfile

Nombre Descripción Valor
infraNetworkProfile InfraNetworkProfile: lista de perfiles de red de infraestructura para el clúster aprovisionado CloudProviderProfileInfraNetworkProfile

CloudProviderProfileInfraNetworkProfile

Nombre Descripción Valor
vnetSubnetIds Matriz de referencias a recursos de Azure correspondientes al objeto Network, por ejemplo, /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName} string[]

ControlPlaneEndpointProfileControlPlaneEndpoint

Nombre Descripción Valor
hostIP Dirección IP de host para el servidor de API cuerda
puerto Puerto para el servidor de API Int

ControlPlaneProfile

Nombre Descripción Valor
availabilityZones AvailabilityZones: la lista de zonas de disponibilidad que se van a usar para los nodos. Bastidores de centros de datos modelados como zonas string[]
controlPlaneEndpoint Punto de conexión del servidor de API para el plano de control ControlPlaneEndpointProfileControlPlaneEndpoint
contar Recuento: número de agentes para hospedar contenedores de Docker. Los valores permitidos deben estar en el intervalo de 1 a 100 (ambos incluidos). El valor predeterminado es 1. Int
linuxProfile Perfil de máquinas virtuales Linux en el clúster de servicios de contenedor. LinuxProfileProperties
nombre Nombre único del perfil del grupo de agentes en el contexto de la suscripción y el grupo de recursos. cuerda
nodeImageVersion La versión de la imagen de nodo cuerda
osSKU Especifica la SKU del sistema operativo utilizada por el grupo de agentes. El valor predeterminado es CBLMariner si OSType es Linux. El valor predeterminado es Windows2019 cuando OSType es Windows. 'CBLMariner'
'Windows2019'
'Windows2022'
osType Tipo de sistema operativo de la imagen de KubernetesVersion concreta (Linux, Windows) "Linux"
'Windows'
vmSize VmSize: tamaño de las máquinas virtuales del grupo de agentes. cuerda

ExtendedLocation

Nombre Descripción Valor
nombre Nombre de ubicación extendida. cuerda
tipo Tipo de ubicación extendida. 'CustomLocation'

LinuxProfileProperties

Nombre Descripción Valor
ssh SSH: configuración de SSH para máquinas virtuales basadas en Linux que se ejecutan en Azure. linuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Nombre Descripción Valor
publicKeys PublicKeys: la lista de claves públicas SSH que se usan para autenticarse con máquinas virtuales basadas en Linux. Solo se espera una clave especificada. LinuxProfilePropertiesSshPublicKeysItem[]

LinuxProfilePropertiesSshPublicKeysItem

Nombre Descripción Valor
keyData KeyData: clave pública de certificado que se usa para autenticarse con máquinas virtuales a través de SSH. El certificado debe estar en formato PEM con o sin encabezados. cuerda

Microsoft.HybridContainerService/provisionedClusterInstances

Nombre Descripción Valor
apiVersion La versión de api "2023-11-15-preview"
extendedLocation Definición de ubicación extendida ExtendedLocation
nombre El nombre del recurso 'default' (obligatorio)
Propiedades Todas las propiedades del clúster aprovisionado provisionedClusterProperties
tipo El tipo de recurso "Microsoft.HybridContainerService/provisionedClusterInstances"

NamedAgentPoolProfile

Nombre Descripción Valor
availabilityZones AvailabilityZones: la lista de zonas de disponibilidad que se van a usar para los nodos. Bastidores de centros de datos modelados como zonas string[]
contar Recuento: número de agentes para hospedar contenedores de Docker. Los valores permitidos deben estar en el intervalo de 1 a 100 (ambos incluidos). El valor predeterminado es 1. Int
nombre Nombre único del perfil del grupo de agentes en el contexto de la suscripción y el grupo de recursos. cuerda
nodeImageVersion La versión de la imagen de nodo cuerda
osSKU Especifica la SKU del sistema operativo utilizada por el grupo de agentes. El valor predeterminado es CBLMariner si OSType es Linux. El valor predeterminado es Windows2019 cuando OSType es Windows. 'CBLMariner'
'Windows2019'
'Windows2022'
osType Tipo de sistema operativo de la imagen de KubernetesVersion concreta (Linux, Windows) "Linux"
'Windows'
vmSize VmSize: tamaño de las máquinas virtuales del grupo de agentes. cuerda

NetworkProfile

Nombre Descripción Valor
loadBalancerProfile LoadBalancerProfile: perfil del equilibrador de carga del clúster. NetworkProfileLoadBalancerProfile
networkPolicy NetworkPolicy: directiva de red que se usa para compilar la red de Kubernetes. Entre los valores posibles se incluyen: 'calico', 'flannel'. El valor predeterminado es 'calico' 'calico'
'flannel'
podCidr PodCidr: intervalo IP de notación CIDR desde el que se van a asignar direcciones IP de pod cuando se usa kubenet. cuerda

NetworkProfileLoadBalancerProfile

Nombre Descripción Valor
contar Recuento: número de máquinas virtuales del equilibrador de carga. El valor predeterminado es 0. Int

ProvisionedClusterLicenseProfile

Nombre Descripción Valor
azureHybridBenefit Indica si se ha optado por la Ventaja híbrida de Azure. 'False'
'NotApplicable'
'True'

ProvisionedClusterProperties

Nombre Descripción Valor
agentPoolProfiles Los grupos de agentes del clúster. NamedAgentPoolProfile []
cloudProviderProfile Propiedades subyacentes del proveedor de infraestructuras en la nube. CloudProviderProfile
controlPlane ControlPlane: configuración de ControlPlane ControlPlaneProfile
kubernetesVersion KubernetesVersion: versión de Kubernetes especificada al crear el clúster administrado. cuerda
licenseProfile Perfil de licencia del clúster aprovisionado. ProvisionedClusterLicenseProfile
linuxProfile LinuxProfile: el perfil de las máquinas virtuales Linux en el clúster aprovisionado. LinuxProfileProperties
networkProfile NetworkProfile: perfil de configuración de red. networkProfile de

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Creación de un clúster de Kubernetes en azure Stack HCI

Implementación en Azure
Esta plantilla crea un clúster de Kubernetes en Azure Stack HCI versión 23H2+

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso provisionedClusterInstances se puede implementar con operaciones destinadas a:

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de recurso

Para crear un recurso Microsoft.HybridContainerService/provisionedClusterInstances, agregue el siguiente terraform a la plantilla.

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 propiedad

CloudProviderProfile

Nombre Descripción Valor
infraNetworkProfile InfraNetworkProfile: lista de perfiles de red de infraestructura para el clúster aprovisionado CloudProviderProfileInfraNetworkProfile

CloudProviderProfileInfraNetworkProfile

Nombre Descripción Valor
vnetSubnetIds Matriz de referencias a recursos de Azure correspondientes al objeto Network, por ejemplo, /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AzureStackHCI/logicalNetworks/{logicalNetworkName} string[]

ControlPlaneEndpointProfileControlPlaneEndpoint

Nombre Descripción Valor
hostIP Dirección IP de host para el servidor de API cuerda
puerto Puerto para el servidor de API Int

ControlPlaneProfile

Nombre Descripción Valor
availabilityZones AvailabilityZones: la lista de zonas de disponibilidad que se van a usar para los nodos. Bastidores de centros de datos modelados como zonas string[]
controlPlaneEndpoint Punto de conexión del servidor de API para el plano de control ControlPlaneEndpointProfileControlPlaneEndpoint
contar Recuento: número de agentes para hospedar contenedores de Docker. Los valores permitidos deben estar en el intervalo de 1 a 100 (ambos incluidos). El valor predeterminado es 1. Int
linuxProfile Perfil de máquinas virtuales Linux en el clúster de servicios de contenedor. LinuxProfileProperties
nombre Nombre único del perfil del grupo de agentes en el contexto de la suscripción y el grupo de recursos. cuerda
nodeImageVersion La versión de la imagen de nodo cuerda
osSKU Especifica la SKU del sistema operativo utilizada por el grupo de agentes. El valor predeterminado es CBLMariner si OSType es Linux. El valor predeterminado es Windows2019 cuando OSType es Windows. 'CBLMariner'
'Windows2019'
'Windows2022'
osType Tipo de sistema operativo de la imagen de KubernetesVersion concreta (Linux, Windows) "Linux"
'Windows'
vmSize VmSize: tamaño de las máquinas virtuales del grupo de agentes. cuerda

ExtendedLocation

Nombre Descripción Valor
nombre Nombre de ubicación extendida. cuerda
tipo Tipo de ubicación extendida. 'CustomLocation'

LinuxProfileProperties

Nombre Descripción Valor
ssh SSH: configuración de SSH para máquinas virtuales basadas en Linux que se ejecutan en Azure. linuxProfilePropertiesSsh

LinuxProfilePropertiesSsh

Nombre Descripción Valor
publicKeys PublicKeys: la lista de claves públicas SSH que se usan para autenticarse con máquinas virtuales basadas en Linux. Solo se espera una clave especificada. LinuxProfilePropertiesSshPublicKeysItem[]

LinuxProfilePropertiesSshPublicKeysItem

Nombre Descripción Valor
keyData KeyData: clave pública de certificado que se usa para autenticarse con máquinas virtuales a través de SSH. El certificado debe estar en formato PEM con o sin encabezados. cuerda

Microsoft.HybridContainerService/provisionedClusterInstances

Nombre Descripción Valor
extendedLocation Definición de ubicación extendida ExtendedLocation
nombre El nombre del recurso 'default' (obligatorio)
parent_id Identificador del recurso al que se va a aplicar este recurso de extensión. string (obligatorio)
Propiedades Todas las propiedades del clúster aprovisionado provisionedClusterProperties
tipo El tipo de recurso "Microsoft.HybridContainerService/provisionedClusterInstances@2023-11-15-preview"

NamedAgentPoolProfile

Nombre Descripción Valor
availabilityZones AvailabilityZones: la lista de zonas de disponibilidad que se van a usar para los nodos. Bastidores de centros de datos modelados como zonas string[]
contar Recuento: número de agentes para hospedar contenedores de Docker. Los valores permitidos deben estar en el intervalo de 1 a 100 (ambos incluidos). El valor predeterminado es 1. Int
nombre Nombre único del perfil del grupo de agentes en el contexto de la suscripción y el grupo de recursos. cuerda
nodeImageVersion La versión de la imagen de nodo cuerda
osSKU Especifica la SKU del sistema operativo utilizada por el grupo de agentes. El valor predeterminado es CBLMariner si OSType es Linux. El valor predeterminado es Windows2019 cuando OSType es Windows. 'CBLMariner'
'Windows2019'
'Windows2022'
osType Tipo de sistema operativo de la imagen de KubernetesVersion concreta (Linux, Windows) "Linux"
'Windows'
vmSize VmSize: tamaño de las máquinas virtuales del grupo de agentes. cuerda

NetworkProfile

Nombre Descripción Valor
loadBalancerProfile LoadBalancerProfile: perfil del equilibrador de carga del clúster. NetworkProfileLoadBalancerProfile
networkPolicy NetworkPolicy: directiva de red que se usa para compilar la red de Kubernetes. Entre los valores posibles se incluyen: 'calico', 'flannel'. El valor predeterminado es 'calico' 'calico'
'flannel'
podCidr PodCidr: intervalo IP de notación CIDR desde el que se van a asignar direcciones IP de pod cuando se usa kubenet. cuerda

NetworkProfileLoadBalancerProfile

Nombre Descripción Valor
contar Recuento: número de máquinas virtuales del equilibrador de carga. El valor predeterminado es 0. Int

ProvisionedClusterLicenseProfile

Nombre Descripción Valor
azureHybridBenefit Indica si se ha optado por la Ventaja híbrida de Azure. 'False'
'NotApplicable'
'True'

ProvisionedClusterProperties

Nombre Descripción Valor
agentPoolProfiles Los grupos de agentes del clúster. NamedAgentPoolProfile []
cloudProviderProfile Propiedades subyacentes del proveedor de infraestructuras en la nube. CloudProviderProfile
controlPlane ControlPlane: configuración de ControlPlane ControlPlaneProfile
kubernetesVersion KubernetesVersion: versión de Kubernetes especificada al crear el clúster administrado. cuerda
licenseProfile Perfil de licencia del clúster aprovisionado. ProvisionedClusterLicenseProfile
linuxProfile LinuxProfile: el perfil de las máquinas virtuales Linux en el clúster aprovisionado. LinuxProfileProperties
networkProfile NetworkProfile: perfil de configuración de red. networkProfile de