Actualización de los agentes de Kubernetes habilitado para Azure Arc

  • Artículo

Kubernetes habilitado para Azure Arc proporciona funcionalidades tanto de actualización automática como manual para sus agentes de forma que estos estén actualizados con la versión más reciente. Si deshabilita la actualización automática y, en su lugar, recurre a la actualización manual, la directiva de compatibilidad de versiones será aplicable a los agentes de Arc y al clúster de Kubernetes subyacente.

Activación o desactivación de la actualización automática al conectar un clúster a Azure Arc

De forma predeterminada, Kubernetes habilitado para Azure Arc proporciona a sus agentes funcionalidades de actualización automática listas para usarse. Cuando la actualización automática está habilitada, el agente sondea Azure cada hora para comprobar si hay una versión más reciente. Cuando haya una nueva versión disponible, desencadena una actualización del gráfico Helm para los agentes de Azure Arc.

Al conectar un clúster a Azure Arc, la configuración predeterminada es habilitar la actualización automática.

El siguiente comando conecta un clúster a Azure Arc con la actualización automática habilitada:

az connectedk8s connect --name AzureArcTest1 --resource-group AzureArcTest

Importante

Asegúrese de que permite la conectividad a todos los puntos de conexión necesarios. En concreto, se requiere conectividad con dl.k8s.io para las actualizaciones automáticas.

Para deshabilitar la actualización automática, especifique el parámetro --disable-auto-upgrade al conectar el clúster a Azure Arc.

El siguiente comando conecta un clúster a Azure Arc con la actualización automática deshabilitada:

az connectedk8s connect --name AzureArcTest1 --resource-group AzureArcTest --disable-auto-upgrade

Sugerencia

Si tiene previsto deshabilitar la actualización automática, tenga en cuenta la directiva de compatibilidad de versiones de Kubernetes habilitado para Azure Arc.

Activación o desactivación de la actualización automática tras conectar un clúster a Azure Arc

Después de conectar un clúster a Azure Arc, puede cambiar la selección de actualización automática mediante el az connectedk8s update comando y la configuración --auto-upgrade a verdadero o falso.

El comando siguiente desactiva la actualización automática para un clúster conectado:

az connectedk8s update --name AzureArcTest1 --resource-group AzureArcTest --auto-upgrade false

Actualización manual de los agentes

Si ha deshabilitado la actualización automática, puede iniciar manualmente las actualizaciones de los agentes mediante el comando az connectedk8s upgrade. Al hacerlo, debe especificar la versión a la que desea actualizar.

Kubernetes habilitado para Azure Arc sigue el esquema de control de versiones semántico estándar de MAJOR.MINOR.PATCH para el control de versiones de sus agentes. Cada número en la versión indica compatibilidad general con la versión anterior:

  • Las versiones principales cambian cuando se producen actualizaciones de API incompatibles o la compatibilidad con versiones anteriores deja de funcionar.
  • Las versiones secundarias cambian cuando los cambios de funcionalidad son compatibles con otras versiones anteriores secundarias.
  • Las versiones de revisión cambian cuando se hacen correcciones de errores compatibles con versiones anteriores.

Aunque la programación puede variar, se publica aproximadamente una vez al mes una nueva versión secundaria de los agentes de Kubernetes habilitados para Azure Arc.

El siguiente comando actualiza manualmente los agentes a la versión 1.8.14:

az connectedk8s upgrade -g AzureArcTest1 -n AzureArcTest --agent-version 1.8.14

Comprobación de la versión del agente

Para enumerar los clústeres conectados y la versión del agente notificada, use el siguiente comando:

az connectedk8s list --query '[].{name:name,rg:resourceGroup,id:id,version:agentVersion}'

Comprobación de si la actualización automática está habilitada en un clúster

Para comprobar si un clúster está habilitado para la actualización automática, ejecute el siguiente comando de kubectl. Tenga en cuenta que la configuración de actualización automática no está disponible en la API pública para Kubernetes habilitado para Azure Arc.

kubectl -n azure-arc get cm azure-clusterconfig -o jsonpath="{.data['AZURE_ARC_AUTOUPDATE']}"

Directiva de compatibilidad de versiones

Cuando usted realiza una solicitud de soporte técnicopara Azure Arc habilitado con Kubernetes, se aplica la siguiente directiva de compatibilidad de versiones:

  • Los agentes de Kubernetes habilitado para Azure Arc tienen un período de compatibilidad de "N-2", donde "N" es la última versión secundaria de los agentes.

    • Por ejemplo, si Kubernetes habilitado para Azure Arc presenta la versión 0.28.a hoy, son compatibles las versiones 0.28.a, 0.28.b, 0.27.c, 0.27.d, 0.26.e y 0.26.f.

  • Los clústeres de Kubernetes que se conectan a Azure Arc tienen un período de compatibilidad de "N-2", donde "N" es la versión secundaria estable más reciente de Kubernetes ascendente.

    • Por ejemplo, si Kubernetes presenta la versión 1.20.a hoy, las versiones 1.20.a, 1.20.b, 1.19.c, 1.19.d, 1.18.e y 1.18.f son compatibles.

Si crea una solicitud de soporte técnico y usa una versión que está fuera de la directiva de soporte técnico (anterior a las versiones compatibles con "N-2" de agentes y clústeres de Kubernetes ascendentes), se le pedirá que actualice los clústeres y agentes a una versión compatible.

Pasos siguientes