Compartir a través de

Implementación de un host de Azure Kubernetes Service con objetos de servicio de clúster preconfigurados y registros DNS mediante PowerShell

  • Artículo

Se aplica a: AKS en Azure Stack HCI 22H2, AKS en Windows Server

En esta guía paso a paso se describe cómo usar PowerShell para configurar la implementación del host de AKS si tiene objetos de servicio de clúster preconfigurados y registros DNS en AKS habilitados por Azure Arc.

Antes de empezar

Paso 1: Preparación del servidor DNS y Active Directory para la implementación

Si no puede habilitar las actualizaciones dinámicas de DNS en el entorno DNS para permitir que ARC habilite AKS para registrar el nombre de clúster genérico del agente en la nube en Active Directory y el sistema DNS para la detección, debe crear previamente los registros respectivos en Active Directory y DNS.

Cree un servicio de clúster genérico en Active Directory con el nombre (o un nombre ca-cloudagent de su elección que no supere los 32 caracteres). Además, cree un registro DNS asociado que apunte al FQDN del servicio de clúster genérico con la dirección proporcionada cloudservicecidr . Para obtener más información sobre los pasos de este proceso, consulte la documentación sobre la agrupación en clústeres de conmutación por error.

La implementación de AKS intenta localizar el especificado clusterRoleName en Active Directory antes de continuar con la implementación.

Nota:

Una vez implementado AKS, esta información no se puede cambiar.

Paso 2: Preparación de las máquinas para la implementación

Ejecute comprobaciones en cada nodo físico para ver si se cumplen todos los requisitos para instalar AKS Arc. Abra PowerShell como administrador y ejecute el siguiente comando Initialize-AksHciNode :

Initialize-AksHciNode

Paso 3: Creación de una red virtual

Para crear una red virtual para los nodos de la implementación que se va a usar, cree una variable de entorno con el New-AksHciNetworkSetting comando de PowerShell. Esta variable se usa más adelante para configurar una implementación que usa ip estática. Si desea configurar la implementación de AKS con DHCP, consulte New-AksHciNetworkSetting para obtener ejemplos. También puede revisar algunos conceptos de nodo de red.

# static IP
$vnet = New-AksHciNetworkSetting -name mgmt-vnet -vSwitchName "extSwitch" -k8sNodeIpPoolStart "172.16.10.1" -k8sNodeIpPoolEnd "172.16.10.255" -vipPoolStart "172.16.255.0" -vipPoolEnd "172.16.255.254" -ipAddressPrefix "172.16.0.0/16" -gateway "172.16.0.1" -dnsServers "172.16.0.1"

Nota:

Debe personalizar los valores que se muestran en este comando de ejemplo para su entorno.

Paso 4: Configurar la implementación con los objetos de servicio de clúster preconfigurados y los registros DNS

Establezca los valores de configuración del host de AKS mediante el comando Set-AksHciConfig . Debe especificar los parámetros workingDir, cloudServiceCidr, cloudConfigLocation y clusterRoleName. Si desea restablecer los detalles de la configuración, vuelva a ejecutar el comando con los nuevos parámetros.

Configure la implementación con el siguiente comando:

Set-AksHciConfig -workingDir c:\ClusterStorage\Volume1\workingDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16" -clusterRoleName "ca-cloudagent"

Nota:

Personalice los valores que se muestran en este comando de ejemplo para su entorno.

Paso 5: Iniciar sesión en Azure y configurar las opciones de registro

Ejecute el siguiente comando set-AksHciRegistration de PowerShell con su suscripción y el nombre del grupo de recursos para iniciar sesión en Azure. Debe tener una suscripción de Azure y un grupo de recursos de Azure existente en las regiones de Azure Este de EE. UU., Sudeste asiático o Oeste de Europa para continuar:

Set-AksHciRegistration -subscriptionId "<subscriptionId>" -resourceGroupName "<resourceGroupName>"

Paso 6: Iniciar una nueva implementación

Después de configurar la implementación, debe iniciarla. Al iniciar la implementación se instalan los agentes o servicios de AKS y el host de AKS. Para comenzar la implementación, ejecute el siguiente comando:

Install-AksHci

Advertencia

Durante la instalación del host de AKS, se crea un tipo de recurso de Kubernetes: Azure Arc en el grupo de recursos que se establece durante el registro. No elimine este recurso, ya que representa el host de Azure Kubernetes Service. Puede identificar el recurso comprobando su campo de distribución para el aks_management valor. Al eliminar este recurso, se produce una implementación fuera de directiva.

Pasos siguientes