Actualización del host de AKS en AKS habilitado mediante Arc mediante PowerShell

  • Artículo

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

En este artículo se describe cómo actualizar el host de Azure Kubernetes Service en AKS habilitado por Azure Arc.

Introducción a las actualizaciones de host de AKS

Novedades al host de AKS siempre incluya la versión más reciente disponible. Aunque puede actualizar el host independientemente de las actualizaciones del clúster de cargas de trabajo, siempre debe actualizar el host antes de actualizar un clúster de cargas de trabajo.

Para evitar interrupciones y pérdida de disponibilidad de AKS, se realizan actualizaciones graduales. Si traslada un nodo nuevo con una nueva versión al clúster, los recursos se trasladarán del nodo antiguo al nuevo. Cuando haya retirado correctamente los recursos, el nodo anterior se retira y se quita del clúster.

Nota

Microsoft recomienda actualizar los clústeres de AKS en un plazo de 30 días a partir de una nueva versión. Si no actualiza dentro de esta ventana, tendrá hasta 90 días a partir de la última actualización antes de que expiren los certificados internos y los tokens. Una vez que expiren los certificados y los tokens, el clúster sigue funcionando; sin embargo, debe llamar a Soporte técnico de Microsoft para actualizar. Al reiniciar el clúster después del período de 90 días, permanece en un estado no funcional. Para obtener más información sobre los certificados y tokens internos, consulte la introducción a la administración de certificados.

Actualización del host de AKS

El primer paso de cualquier flujo de actualización es ejecutar el comando Update-AksHci para actualizar el host de AKS. El comando Update-AksHci no necesita ningún argumento y siempre actualiza el clúster de administración a la versión más reciente. Debe iniciar este paso antes de ejecutar Update-AksHciCluster para actualizar el clúster de Kubernetes a una nueva versión.

Importante

El comando update solo funciona si ha instalado la versión de disponibilidad general u otra posterior. No funciona para versiones anteriores. Este comando de actualización actualiza el host de AKS y la plataforma en la nube administrada por Microsoft local. Este comando no actualiza ningún clúster de carga de trabajo de AKS existente. Los nuevos clústeres de carga de trabajo de AKS creados después de actualizar el host de AKS pueden diferir de los clústeres de carga de trabajo de AKS existentes en su versión del sistema operativo y la versión de Kubernetes.

Se recomienda actualizar los clústeres de carga de trabajo de AKS inmediatamente después de actualizar el host de AKS para obtener las últimas versiones del sistema operativo y las correcciones recientes. Si un clúster de cargas de trabajo está en una versión de Kubernetes no compatible en la siguiente versión de AKS Arc, se produce un error en la actualización.

Flujo de ejemplo para actualizar un host de AKS

Actualización de los módulos de PowerShell

Asegúrese de que siempre tiene instalados los módulos de PowerShell más recientes en los nodos de AKS mediante la ejecución del siguiente comando en todos los nodos físicos de la implementación de AKS.

Importante

Tiene que cerrar todas las ventanas de PowerShell abiertas y, a continuación, abrir una nueva sesión para ejecutar el comando update. Si no cierra todas las ventanas de PowerShell, es posible que haya módulos que estén en uso y no se puedan actualizar.

Update-Module -Name AksHci -Force -AcceptLicense

Obtención de la versión actual de AKS Arc

Get-AksHciVersion                    

1.0.0.10517

Obtención de las actualizaciones de AKS Arc disponibles

Get-AksHciUpdates

La salida muestra las versiones disponibles a las que se puede actualizar este host de AKS:

1.0.2.10723

Control de versiones

Con la versión 1.0.2.10723 como ejemplo, en la tabla siguiente se muestra cómo se construyen los números de versión para las versiones de AKS Arc.

Valor Significado
1 Versión principal: +1 para cada versión con un gran cambio importante.
0 Versión secundaria: +1 para cada versión después de la versión principal más reciente con un cambio de funcionalidad principal.
2 Características & actualizaciones de revisiones: +1 para cada versión normal (normalmente mensual) después de la última versión principal.
1 Tipo de compilación: siempre 1 para compilaciones orientadas al público.
0723 Fecha de creación de la compilación: fecha de creación de la compilación en formato mmdd.

Inicio de la actualización de AKS Arc

Update-AksHci

Comprobación de que se actualizó el host de AKS

Get-AksHciVersion

La salida muestra la versión actualizada de AKS en el host de AKS:

1.0.2.10723

Pasos siguientes