Share via

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 AKS habilitado por Arc registre 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 ca-cloudagent (o un nombre de su elección que no supere los 32 caracteres). También debe crear un registro DNS asociado que apunte al FQDN del servicio de clúster genérico con la dirección proporcionada cloudservicecidr . Puede encontrar más detalles sobre los pasos de este proceso en la documentación de 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: preparar 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 van 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 una dirección 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 proporcionados 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 para el 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 proporcionados en este comando de ejemplo para su entorno.

Paso 5: Inicio de sesión en Azure y configuración de los valores de registro

Ejecute el siguiente comando de PowerShell Set-AksHciRegistration 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

Una vez configurada 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. Para identificar el recurso, busque en el campo de distribución un valor de aks_management. La eliminación de este recurso da como resultado una implementación fuera de la directiva.

En esta guía paso a paso, ha aprendido a configurar un host de AKS mediante PowerShell si tiene objetos de servicio de clúster preconfigurados y registros DNS.

Pasos siguientes