Implementación de un host de Azure Kubernetes Service con objetos de servicio de clúster preconfigurados y registros DNS mediante PowerShell
Se aplica a: AKS en Azure Local 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
- Asegúrese de cumplir todos los requisitos previos de los requisitos del sistema.
- Descargue el módulo AksHci de PowerShell e instálelo.
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.