Notas de la versión del motor de AKS en Azure Stack Hub

Se aplica a la versión v0.80.2 del motor de AKS.

En este artículo se describe el contenido del motor de Azure Kubernetes Service (AKS) en la actualización de Azure Stack Hub. La actualización incluye mejoras y correcciones de la versión más reciente del motor de AKS en la plataforma de Azure Stack Hub. En este artículo, no pretende documentar la información sobre la versión del motor de AKS para Azure global.

Consideraciones sobre actualizaciones

• ¿Usa los elementos de Marketplace correctos (distribución de la imagen base de AKS para Ubuntu 20.04 o la imagen base de AKS para Windows Server) para su versión del motor de AKS? Puede encontrar las versiones en la sección Descarga de nuevas imágenes y el motor de AKS.
• ¿Usa la especificación correcta del clúster (apimodel.json) y el grupo de recursos para el clúster de destino? Cuando implementó originalmente el clúster, este archivo se generó en el directorio de salida. Consulte los parámetros del comando "deploy" en Implementación de un clúster de Kubernetes.
• ¿Está usando una máquina confiable para ejecutar el motor de AKS desde el que realiza las operaciones de actualización?
• Si va a actualizar un clúster operativo con cargas de trabajo activas, puede aplicar la actualización sin que esto les afecte, siempre que el clúster tenga una carga normal. Sin embargo, debe tener un clúster de copia de seguridad en caso de que haya necesidad de redirigir a los usuarios a este. Es muy recomendable disponer de un clúster de copia de seguridad.
• Si es posible, ejecute el comando desde una máquina virtual en el entorno de Azure Stack Hub para disminuir los saltos de red y los posibles errores de conectividad.
• Asegúrese de que la suscripción tiene una cuota suficiente para todo el proceso. El proceso asigna nuevas máquinas virtuales durante el proceso. El número resultante de máquinas virtuales sería el mismo que el original, pero planee que se creen algunas máquinas virtuales más durante el proceso.
• No se prevén actualizaciones del sistema ni tareas programadas.
• Configure una actualización por fases en un clúster que esté configurado con los mismos valores que el clúster de producción y pruebe la actualización allí antes de hacerlo en el clúster de producción.

Uso del comando "upgrade"

Debe usar el aks-engine upgrade comando tal como se describe en Actualización de un clúster de Kubernetes en Azure Stack Hub.

Interrupciones de la actualización

En algunas ocasiones se producen factores inesperados que interrumpen la actualización del clúster. Se puede producir una interrupción cuando el motor de AKS notifica un error o ocurre algo al proceso de ejecución del motor de AKS. Examine la causa de la interrupción, la solucione y vuelva a enviar el mismo upgrade comando para continuar el proceso de actualización. El comando upgrade es idempotente y debe reanudar la actualización del clúster cuando se vuelva a enviar el comando. Normalmente, las interrupciones aumentan el tiempo para completar la actualización, pero no deberían afectar a su finalización.

Tiempo de actualización estimado

El tiempo de actualización estimado es de 12 a 15 minutos por máquina virtual en el clúster. Por ejemplo, un clúster de 20 nodos puede tardar aproximadamente 5 horas en actualizarse.

Descarga de la nueva imagen y el motor de AKS

Descargue las nuevas versiones de la imagen base de Ubuntu de AKS y el motor de AKS.

Como se explica en la documentación del motor de AKS para Azure Stack Hub, la implementación de un clúster de Kubernetes requiere:

• El archivo binario aks-engine (obligatorio).
• Distribución de imagen de Ubuntu 16.04-LTS base de AKS (en desuso; ya no se usa, cambie el modelo de API para usar 22.04 en su lugar).
• AKS Base Ubuntu 18.04-LTS Image Distro (en desuso: ya no se usa, cambio en el modelo de API para usar 22.04 en su lugar).
• AKS Base Ubuntu 20.04-LTS Image Distro (en desuso: ya no se usa, cambio en el modelo de API para usar 22.04 en su lugar).
• AKS Base Ubuntu 22.04-LTS Image Distro (obligatorio para agentes de Linux).
• Imagen base de Windows Server de AKS (se requiere una de las siguientes imágenes para los agentes de Windows):
  • Imagen base de Windows Server de AKS en contenedores.
  • Docker de imagen base de Windows Server de AKS.

Las nuevas versiones de estas imágenes están disponibles con esta actualización:

• Compruebe el motor de AKS y la tabla de asignación de versiones de Azure Stack para las imágenes base de AKS necesarias.

  Siga estas instrucciones para Agregar los requisitos previos del motor de Azure Kubernetes Service (AKS) al Marketplace de Azure Stack Hub.

• El administrador de clústeres de Kubernetes (normalmente un usuario de inquilino de Azure Stack Hub) debe descargar el nuevo motor de aks. Consulte las instrucciones de Instalación del motor de AKS en Linux en Azure Stack Hub (o artículo equivalente de Windows). Puede seguir el mismo proceso que utilizó para el instalar el clúster por primera vez. La actualización sobrescribe el binario anterior. Por ejemplo, si utilizó el script de get-akse.sh, siga los mismos pasos indicados en Instalar en un entorno conectado. El mismo proceso se aplica si va a instalar en un sistema Windows: instale el motor de AKS en Windows en Azure Stack Hub.

Actualización de clústeres de Kubernetes creados con la distribución 16.04 de Ubuntu

A partir de AKS Engine v0.63.0, la distribución de Ubuntu 16.04 ya no es una opción compatible, ya que el sistema operativo ha alcanzado su fin de vida. Para el moto de AKS v0.67.0 o versiones posteriores, la actualización de aks-engine sobrescribe automáticamente el valor de distribución aks-ubuntu-16.04 no compatible con aks-ubuntu-18.04. Para AKS Engine v0.75.3 o versiones posteriores, si usa Kubernetes v1.24 o posterior, la actualización aks-engine-azurestack sobrescribe automáticamente el valor de distribución no admitido aks-ubuntu-16.04 con aks-ubuntu-20.04.

Actualización de clústeres de Kubernetes creados con la distribución ubuntu 18.04 o 20.04

A partir de AKS Engine v0.75.3, la distribución de Ubuntu 18.04 ya no es una opción compatible, ya que el sistema operativo ha alcanzado su fin de vida. A partir de AKS Engine v0.82.2, la distribución de Ubuntu 20.04 ya no es una opción compatible. Para estas versiones del motor de AKS, la actualización aks-engine-azurestack sobrescribe automáticamente el valor de la distribución no compatible aks-ubuntu-18.04 o aks-ubuntu-20.04 con aks-ubuntu-20.04 o aks-ubuntu-22.04, respectivamente.

Actualización de clústeres de Kubernetes creados con el entorno de ejecución de contenedores de Docker

En Kubernetes v1.24, el componente dockershim se quitó de kubelet. Como resultado, el entorno de ejecución del contenedor de Docker ya no es una opción compatible. Consulte las notas de la versión de Kubernetes v1.24 para obtener más información. Para AKS Engine v0.75.3 o versiones posteriores, la actualización aks-engine-azurestack sobrescribe automáticamente el valor no admitido dockercontainerRuntime con containerd.

Para la versión v0.75.3 del motor de AKS, los clústeres con nodos de Windows en Kubernetes v1.23 pueden usar la imagen base de Windows con el entorno de ejecución de Docker. Los clústeres con nodos de Windows en Kubernetes v1.24 pueden usar la imagen base de Windows con el entorno de ejecución contenedor.

Asignación de versiones del motor de AKS y de Azure Stack

*Compatible. Para obtener más información, consulte la directiva de compatibilidad con la versión del motor de AKS.

Motor de AKS y la asignación de imagen correspondiente

Puede encontrar las versiones de Kubernetes compatibles para AKS Engine en Azure Stack Hub en la tabla siguiente. No use el comando aks-engine get-versions , que devuelve versiones compatibles con Azure global, así como en Azure Stack Hub.

Planeación de la actualización

El comando del motor upgrade de AKS automatiza completamente el proceso de actualización del clúster y controla las máquinas virtuales (VM), las redes, el almacenamiento, Kubernetes y las tareas de orquestación. Antes de aplicar la actualización, asegúrese de revisar la información de las notas de la versión.

Novedades de AKSe 0.82.2

• Se ha agregado compatibilidad con Kubernetes 1.29.15 y 1.30.10.
• La versión v0.82.2 del motor de AKS en Azure Stack Hub ofrece Ubuntu 22.04 LTS como imagen base de Linux. A partir de esta versión, Ya no se admite Ubuntu 20.04.
• Puede encontrar otras características en la página de GitHub v0.82.2.

Novedades de AKSe 0.75.3 y versiones posteriores

La versión v0.75.3 del motor de AKS y todas las versiones futuras del motor de AKS en Azure Stack Hub serán del nuevo repositorio aks-engine-azurestack. Por lo tanto, todos los aks-engine comandos deben reemplazarse por aks-engine-azurestack. Los comandos para obtener la versión más reciente del motor de AKS en Azure Stack Hub también han cambiado. Puede ver los nuevos comandos en Create Linux client (Crear cliente Linux) y Create Windows client (Crear cliente de Windows). Cree un problema en el nuevo repositorio si encuentra algún problema.

La versión v0.75.3 del motor de AKS en Azure Stack Hub ofrece Ubuntu 20.04 LTS como imagen base de Linux. A partir de esta versión, Ya no se admite Ubuntu 18.04. Consulte Actualización de clústeres de Kubernetes creados con la distribución de Ubuntu 18.04 para obtener más información.

A partir de Kubernetes v1.24, solo se admite el entorno de ejecución containerd. Consulte Actualización de clústeres de Kubernetes creados con el entorno de ejecución de Docker para obtener más información. Para la versión v0.75.3 del motor de AKS, los clústeres con nodos de Windows en Kubernetes v1.23 pueden usar la imagen base de Windows con el entorno de ejecución de Docker. Los clústeres con nodos de Windows en Kubernetes v1.24 pueden usar la imagen base de Windows con containerd runtime.

Puede encontrar más características en la página de GitHub v0.75.3.

Instrucciones para usar el motor de AKS 0.70.0 y versiones posteriores

Microsoft actualizó el proveedor de servicios en la nube de Azure a la versión 0.70.0. El proveedor de servicios en la nube de Azure es un componente principal compartido entre AKS para Azure y el motor de AKS en Azure Stack Hub.

Para usar el motor de AKS 0.70.0 y versiones posteriores:

• Si está intentando crear un nuevo clúster de Kubernetes por primera vez, utilice el modelo de API de ejemplo proporcionado para la versión adecuada en el AKS Engine y la tabla de asignación de imágenes correspondiente.

• Si va a crear un nuevo clúster, pero quiere usar el modelo de API existente: modifique el modelo de API siguiendo las instrucciones del proveedor de nube para Azure . Si no se incluye la nueva configuración, se produce un error de implementación.

• Si está usando volúmenes de almacenamiento: Asegúrese de que esté usando el controlador AzureDiskCSI. La versión 0.70.0 y posteriores solo admiten controladores CSI, no el proveedor de almacenamiento heredado en árbol. Para actualizar, siga las instrucciones de actualizar utilizando volúmenes de almacenamiento.

Problemas conocidos

• La implementación de varios servicios de Kubernetes en paralelo dentro de un único clúster puede provocar un error en la configuración básica del equilibrador de carga. Se recomienda implementar un servicio a la vez.
• Dado que la herramienta aks-engine de es un repositorio de código fuente compartido de todo Azure y Azure Stack Hub, tras leer las numerosas notas de las versiones y solicitudes de incorporación de cambios, podría creer que la herramienta admite otras versiones de Kubernetes y plataformas de sistemas operativos aparte de las enumeradas anteriormente. Puede omitirlos y usar la tabla de versiones anterior como guía oficial para esta actualización.
• AKS Engine v0.67.0 usa la imagen incorrecta de Windows al implementar clústeres de Windows. Use v0.70.0 para resolver este problema.

El demonio Chrony falla al reiniciarse

El demonio chrony en un nodo de Linux podría no reiniciarse con el mensaje de error: "Could not open /dev/ptp_hyperv: No such file or directory".

La solución alternativa para este problema es reiniciar manualmente los nodos de Linux afectados. Esta operación regenera el enlace simbólico /dev/ptp_hyperv y permite que el demonio chrony se reinicie correctamente.

Referencia

La siguiente lista son las notas de la versión combinadas para el motor AKS en Azure y Azure Stack Hub.

• https://github.com/Azure/aks-engine/releases/tag/v0.64.0
• https://github.com/Azure/aks-engine/releases/tag/v0.65.0
• https://github.com/Azure/aks-engine/releases/tag/v0.65.1
• https://github.com/Azure/aks-engine/releases/tag/v0.66.0
• https://github.com/Azure/aks-engine/releases/tag/v0.66.1
• https://github.com/Azure/aks-engine/releases/tag/v0.67.0
• https://github.com/Azure/aks-engine/releases/tag/v0.70.0
• https://github.com/Azure/aks-engine/releases/tag/v0.71.0
• https://github.com/Azure/aks-engine/releases/tag/v0.73.0
• https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.75.3
• https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.76.0
• https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.77.0
• https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.78.0
• https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.79.0
• https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.80.2
• https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.80.3
• https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.81.1
• (Lanzamiento de parche) https://github.com/Azure/aks-engine-azurestack/releases/tag/release-v0.81.2
• https://github.com/Azure/aks-engine-azurestack/releases/tag/release-v0.82.1
• (Lanzamiento de parche) https://github.com/Azure/aks-engine-azurestack/releases/tag/release-v0.82.2
• https://github.com/Azure/aks-engine-azurestack/releases/tag/release-v0.83.0
• (Lanzamiento de parche) https://github.com/Azure/aks-engine-azurestack/releases/tag/release-v0.83.1
• https://github.com/Azure/aks-engine-azurestack/releases/tag/release-v0.84.0

Se aplica a la versión v0.67.0 del motor de AKS.

En este artículo se describe el contenido del motor de Azure Kubernetes Service (AKS) en la actualización de Azure Stack Hub. La actualización incluye mejoras y correcciones de la versión más reciente del motor de AKS en la plataforma de Azure Stack Hub. En este artículo, no pretende documentar la información sobre la versión del motor de AKS para Azure global.

Planeación de la actualización

El comando del motor upgrade de AKS automatiza completamente el proceso de actualización del clúster. Controla las máquinas virtuales (VM), las redes, el almacenamiento, Kubernetes y las tareas de orquestación. Antes de aplicar la actualización, asegúrese de revisar la información de las notas de la versión.

Consideraciones sobre actualizaciones

• ¿Usas los elementos correctos de Marketplace, AKS Base Ubuntu 16.04-LTS o 18.04 Image Distro o AKS Base Windows Server para tu versión del motor de AKS? Puede encontrar las versiones en la sección "Descarga de nuevas imágenes y el motor de AKS".
• ¿Usa la especificación correcta del clúster (apimodel.json) y el grupo de recursos para el clúster de destino? Cuando implementó originalmente el clúster, este archivo se generó en el directorio de salida. Consulte los parámetros del comando "deploy" en Implementación de un clúster de Kubernetes.
• ¿Usa una máquina confiable para ejecutar el motor de AKS y desde la que está realizando operaciones de actualización?
• Si va a actualizar un clúster operativo con cargas de trabajo activas, puede aplicar la actualización sin que esto les afecte, siempre que el clúster tenga una carga normal. Sin embargo, debe tener un clúster de copia de seguridad en caso de que haya necesidad de redirigir a los usuarios a este. Es muy recomendable disponer de un clúster de copia de seguridad.
• Si es posible, ejecute el comando desde una máquina virtual en el entorno de Azure Stack Hub para disminuir los saltos de red y los posibles errores de conectividad.
• Asegúrese de que la suscripción tiene una cuota suficiente para todo el proceso. El proceso asigna nuevas máquinas virtuales durante el proceso. El número resultante de máquinas virtuales sería el mismo que el original, pero planee que se creen algunas máquinas virtuales más durante el proceso.
• No se prevén actualizaciones del sistema ni tareas programadas.
• Configure una actualización por fases en un clúster que esté configurado con los mismos valores que el clúster de producción y pruebe la actualización allí antes de hacerlo en el clúster de producción.

Uso del comando "upgrade"

Debe usar el aks-engine upgrade comando tal como se describe en Actualización de un clúster de Kubernetes en Azure Stack Hub.

Interrupciones de la actualización

En algunas ocasiones se producen factores inesperados que interrumpen la actualización del clúster. Se puede producir una interrupción cuando el motor de AKS notifica un error o ocurre algo al proceso de ejecución del motor de AKS. Examine la causa de la interrupción, la solucione y vuelva a enviar el mismo upgrade comando para continuar el proceso de actualización. El comando upgrade es idempotente y debe reanudar la actualización del clúster cuando se vuelva a enviar el comando. Normalmente, las interrupciones aumentan el tiempo para completar la actualización, pero no deberían afectar a su finalización.

Tiempo de actualización estimado

El tiempo de actualización estimado es de 12 a 15 minutos por máquina virtual en el clúster. Por ejemplo, un clúster de 20 nodos puede tardar aproximadamente 5 horas en actualizarse.

Descarga de la nueva imagen y el motor de AKS

Descargue las nuevas versiones de la imagen base de Ubuntu de AKS y el motor de AKS.

Como se explica en la documentación del motor de AKS para Azure Stack Hub, la implementación de un clúster de Kubernetes requiere:

• El archivo binario aks-engine (obligatorio).
• AKS Base Ubuntu 16.04-LTS Image Distro (en desuso: ya no se usa, cambio en el modelo de API para usar 18.04 en su lugar).
• AKS Base Ubuntu 18.04-LTS Image Distro (obligatorio para agentes de Linux).
• AKS Base Windows Server Image Distro (obligatorio para agentes de Windows).

Las nuevas versiones de estas imágenes están disponibles con esta actualización:

• Compruebe el motor de AKS y la tabla de asignación de versiones de Azure Stack para las imágenes base de AKS necesarias.

  Siga estas instrucciones para Agregar los requisitos previos del motor de Azure Kubernetes Service (AKS) al Marketplace de Azure Stack Hub.

• El administrador de clústeres de Kubernetes (normalmente un usuario de inquilino de Azure Stack Hub) debe descargar el nuevo motor de aks. Consulte las instrucciones de Instalación del motor de AKS en Linux en Azure Stack Hub (o artículo equivalente de Windows). Puede seguir el mismo proceso que utilizó para el instalar el clúster por primera vez. La actualización sobrescribe el binario anterior. Por ejemplo, si utilizó el script de get-akse.sh, siga los mismos pasos indicados en Instalar en un entorno conectado. El mismo proceso se aplica si va a instalar en un sistema Windows: instale el motor de AKS en Windows en Azure Stack Hub.

Actualización de clústeres de Kubernetes creados con la distribución 16.04 de Ubuntu

A partir de AKS Engine v0.67.0, la distribución de Ubuntu 16.04 ya no es una opción compatible, ya que el sistema operativo ha alcanzado su fin de vida. Para actualizar un clúster, asegúrese de establecer la distribución aks-ubuntu-18.04 del sistema operativo en el modelo de API de entrada, la generada por aks-engine deploy y pasada como entrada a aks-engine upgrade:

"masterProfile": {
    "distro": "aks-ubuntu-18.04"
},

"agentPoolProfiles": [{
    "distro": "aks-ubuntu-18.04"
}]

Asignación de versiones del motor de AKS y de Azure Stack

Ruta de actualización de la versión de Kubernetes en el motor de AKS v0.67.0

Puede encontrar la versión actual y la versión de actualización de Azure Stack Hub en la tabla siguiente. Esta tabla se aplica al clúster del motor de AKS en Azure Stack Hub. No use el comando aks-engine get-versions , que devuelve versiones compatibles con Azure global, así como en Azure Stack Hub.

En el archivo JSON del modelo de API, especifique los valores de lanzamiento y versión en la orchestratorProfile sección. Por ejemplo, si planea implementar Kubernetes 1.17.17,17, se deben establecer los dos valores siguientes (consulte el ejemplo kubernetes-azurestack.json):

-   "orchestratorRelease": "1.17",
-   "orchestratorVersion": "1.17.17"

Motor de AKS y la asignación de imagen correspondiente

Novedades

Si le interesa participar en una versión preliminar privada, puede solicitar el acceso a la versión preliminar.

Las nuevas características incluyen:

• Compatibilidad con Kubernetes 1.19.15 y 1.20.11.

Problemas conocidos

• La implementación de varios servicios de Kubernetes en paralelo dentro de un único clúster puede producir un error en la configuración del equilibrador de carga básico. Se recomienda implementar un servicio a la vez.
• Dado que la herramienta aks-engine es un repositorio de código fuente compartido en Azure y Azure Stack Hub, examinar las numerosas notas de versión y las solicitudes de extracción puede hacer que creas que la herramienta admite otras versiones de Kubernetes y plataforma de sistema operativo más allá de las enumeradas anteriormente. Puede omitirlos y usar la tabla de versiones anterior como guía oficial de esta actualización.

Referencia

A continuación se presenta el conjunto completo de notas de lanzamiento para Azure y Azure Stack Hub combinados.

• https://github.com/Azure/aks-engine/releases/tag/v0.64.0
• https://github.com/Azure/aks-engine/releases/tag/v0.65.0
• https://github.com/Azure/aks-engine/releases/tag/v0.65.1
• https://github.com/Azure/aks-engine/releases/tag/v0.66.0
• https://github.com/Azure/aks-engine/releases/tag/v0.66.1
• https://github.com/Azure/aks-engine/releases/tag/v0.67.0

Se aplica a la versión v0.60.1 del motor de AKS.

En este artículo se describe el contenido del motor de Azure Kubernetes Service (AKS) en la actualización de Azure Stack Hub. La actualización incluye mejoras y correcciones de la versión más reciente del motor de AKS en la plataforma de Azure Stack Hub. En este artículo, no pretende documentar la información sobre la versión del motor de AKS para Azure global.

Planeación de la actualización

El comando del motor upgrade de AKS automatiza completamente el proceso de actualización del clúster y controla las máquinas virtuales (VM), las redes, el almacenamiento, Kubernetes y las tareas de orquestación. Antes de aplicar la actualización, asegúrese de revisar la información de las notas de la versión.

Consideraciones sobre actualizaciones

• ¿Usas los elementos correctos de Marketplace, AKS Base Ubuntu 16.04-LTS o 18.04 Image Distro o AKS Base Windows Server para tu versión del motor de AKS? Puede encontrar las versiones en la sección "Descarga de nuevas imágenes y el motor de AKS".
• ¿Usa la especificación correcta del clúster (apimodel.json) y el grupo de recursos para el clúster de destino? Cuando implementó originalmente el clúster, este archivo se generó en el directorio de salida. Consulte los parámetros del comando "deploy" en Implementación de un clúster de Kubernetes.
• ¿Usa una máquina confiable para ejecutar el motor de AKS y desde la que está realizando operaciones de actualización?
• Si va a actualizar un clúster operativo con cargas de trabajo activas, puede aplicar la actualización sin que esto les afecte, siempre que el clúster tenga una carga normal. Sin embargo, debe tener un clúster de copia de seguridad en caso de que haya necesidad de redirigir a los usuarios a este. Es muy recomendable disponer de un clúster de copia de seguridad.
• Si es posible, ejecute el comando desde una máquina virtual en el entorno de Azure Stack Hub para disminuir los saltos de red y los posibles errores de conectividad.
• Asegúrese de que la suscripción tiene una cuota suficiente para todo el proceso. El proceso asigna nuevas máquinas virtuales durante el proceso. El número resultante de máquinas virtuales sería el mismo que el original, pero planee que se creen algunas máquinas virtuales más durante el proceso.
• No se prevén actualizaciones del sistema ni tareas programadas.
• Configure una actualización por fases en un clúster que esté configurado con los mismos valores que el clúster de producción y pruebe la actualización allí antes de hacerlo en el clúster de producción.

Uso del comando "upgrade"

Debe usar el aks-engine upgrade comando tal como se describe en Actualización de un clúster de Kubernetes en Azure Stack Hub.

Interrupciones de la actualización

En algunas ocasiones se producen factores inesperados que interrumpen la actualización del clúster. Se puede producir una interrupción cuando el motor de AKS notifica un error o ocurre algo al proceso de ejecución del motor de AKS. Examine la causa de la interrupción, la solucione y vuelva a enviar el mismo upgrade comando para continuar el proceso de actualización. El comando upgrade es idempotente y debe reanudar la actualización del clúster cuando se vuelva a enviar el comando. Normalmente, las interrupciones aumentan el tiempo para completar la actualización, pero no deberían afectar a su finalización.

Tiempo de actualización estimado

El tiempo de actualización estimado es de 12 a 15 minutos por máquina virtual en el clúster. Por ejemplo, un clúster de 20 nodos puede tardar aproximadamente 5 horas en actualizarse.

Descarga de la nueva imagen y el motor de AKS

Descargue las nuevas versiones de la imagen base de Ubuntu de AKS y el motor de AKS.

Como se explica en la documentación del motor de AKS en Azure Stack Hub, la implementación de un clúster de Kubernetes requiere lo siguiente:

• El archivo binario aks-engine (obligatorio).
• AKS Base Ubuntu 16.04-LTS Image Distro (en desuso: ya no se usa, cambio en el modelo de API para usar 18.04 en su lugar).
• AKS Base Ubuntu 18.04-LTS Image Distro (obligatorio para agentes de Linux).
• AKS Base Windows Server Image Distro (obligatorio para agentes de Windows).

Hay nuevas versiones de estas disponibles con esta actualización:

• El operador de Azure Stack Hub debe descargar las nuevas imágenes base de AKS en el marketplace de marcas:

  • Imagen base de AKS para la distribución Ubuntu 16.04-LTS, enero de 2021 (2021.01.28)

  • Distribución de imagen base de AKS para Ubuntu 18.04-LTS, primer trimestre de 2021 (2021.01.28)

  • Imagen base de AKS para Windows (17763.1697.210129)

    Siga estas instrucciones para Agregar los requisitos previos del motor de Azure Kubernetes Service (AKS) al Marketplace de Azure Stack Hub.

• El administrador de clústeres de Kubernetes (normalmente un usuario de inquilino de Azure Stack Hub) debe descargar el nuevo motor de aks. Consulte las instrucciones de Instalación del motor de AKS en Linux en Azure Stack Hub (o artículo equivalente de Windows). Puede seguir el mismo proceso que utilizó para el instalar el clúster por primera vez. La actualización sobrescribe el binario anterior. Por ejemplo, si utilizó el script de get-akse.sh, siga los mismos pasos indicados en Instalar en un entorno conectado. El mismo proceso se aplica si va a instalar en un sistema Windows: instale el motor de AKS en Windows en Azure Stack Hub.

Asignación de versiones del motor de AKS y de Azure Stack

Ruta de actualización de la versión de Kubernetes en el motor de AKS v0.60.1

Puede encontrar la versión actual y la versión de actualización de Azure Stack Hub en la tabla siguiente. Esta tabla se aplica al clúster del motor de AKS en Azure Stack Hub. No use el comando aks-engine get-versions , que devuelve versiones compatibles con Azure global, así como en Azure Stack Hub.

En el archivo JSON del modelo de API, especifique los valores de lanzamiento y versión en la orchestratorProfile sección. Por ejemplo, si planea implementar Kubernetes 1.17.17,17, se deben establecer los dos valores siguientes (consulte el ejemplo kubernetes-azurestack.json):

-   "orchestratorRelease": "1.17",
-   "orchestratorVersion": "1.17.17"

Motor de AKS y la asignación de imagen correspondiente

Novedades

Si le interesa participar en una versión preliminar privada, puede solicitar el acceso a la versión preliminar.

Las nuevas características incluyen:

• Disponibilidad general de Ubuntu 18.04.
• Versión preliminar pública de la rotación de certificados #4214.
• T4 Nvidia GPU Private Preview #4259.
• Versión preliminar privada de la integración de Azure Active Directory.
• Versión preliminar privada del controlador CSI para blobs de Azure #712
• Versión preliminar pública del controlador CSI para discos de Azure #712.
• Versión preliminar pública del controlador CSI para NFS #712.
• Compatibilidad con Kubernetes 1. 17.17 #4188 y 1.18.15 #4187.

Problemas conocidos

• La implementación de varios servicios de Kubernetes en paralelo dentro de un único clúster puede producir un error en la configuración del equilibrador de carga básico. Se recomienda implementar un servicio a la vez.
• Dado que la herramienta aks-engine es un repositorio de código fuente compartido en Azure y Azure Stack Hub, examinar las numerosas notas de versión y las solicitudes de extracción puede hacer que creas que la herramienta admite otras versiones de Kubernetes y plataforma de sistema operativo más allá de las enumeradas anteriormente. Puede omitirlos y usar la tabla de versiones anterior como guía oficial de esta actualización.

Referencia

A continuación se presenta el conjunto completo de notas de lanzamiento para Azure y Azure Stack Hub combinados.

• https://github.com/Azure/aks-engine/releases/tag/v0.56.0
• https://github.com/Azure/aks-engine/releases/tag/v0.56.1
• https://github.com/Azure/aks-engine/releases/tag/v0.60.0
• https://github.com/Azure/aks-engine/releases/tag/v0.60.1

Se aplica a la versión v0.55.4 del motor de AKS.

En este artículo se describe el contenido del motor de Azure Kubernetes Service (AKS) en la actualización de Azure Stack Hub. La actualización incluye mejoras y correcciones de la versión más reciente del motor de AKS en la plataforma de Azure Stack Hub. En este artículo, no pretende documentar la información sobre la versión del motor de AKS para Azure global.

Planeación de la actualización

El comando del motor upgrade de AKS automatiza completamente el proceso de actualización del clúster y controla las máquinas virtuales (VM), las redes, el almacenamiento, Kubernetes y las tareas de orquestación. Antes de aplicar la actualización, asegúrese de revisar la información de las notas de la versión.

Consideraciones sobre actualizaciones

• ¿Está utilizando el elemento adecuado del marketplace, es decir, AKS Base Ubuntu 16.04-LTS Image Distro para la versión de su motor AKS? Puede encontrar las versiones en la sección "Descargar nueva imagen y motor de AKS".
• ¿Usa la especificación correcta del clúster (apimodel.json) y el grupo de recursos para el clúster de destino? Cuando implementó originalmente el clúster, este archivo se generó en el directorio de salida. Consulte los parámetros del comando "deploy" en Implementación de un clúster de Kubernetes.
• ¿Está usando una máquina confiable para ejecutar el motor de AKS desde el que realiza las operaciones de actualización?
• Si va a actualizar un clúster operativo con cargas de trabajo activas, puede aplicar la actualización sin que esto les afecte, siempre que el clúster tenga una carga normal. Sin embargo, debe tener un clúster de copia de seguridad en caso de que haya necesidad de redirigir a los usuarios a este. Es muy recomendable disponer de un clúster de copia de seguridad.
• Si es posible, ejecute el comando desde una máquina virtual en el entorno de Azure Stack Hub para disminuir los saltos de red y los posibles errores de conectividad.
• Asegúrese de que la suscripción tiene una cuota suficiente para todo el proceso. El proceso asigna nuevas máquinas virtuales durante el proceso. El número resultante de máquinas virtuales sería el mismo que el original, pero planee que se creen algunas máquinas virtuales más durante el proceso.
• No se prevén actualizaciones del sistema ni tareas programadas.
• Configure una actualización por fases en un clúster que esté configurado con los mismos valores que el clúster de producción y pruebe la actualización allí antes de hacerlo en el clúster de producción.

Uso del comando "upgrade"

Debe usar el aks-engine upgrade comando tal como se describe en Actualización de un clúster de Kubernetes en Azure Stack Hub.

Interrupciones de la actualización

En algunas ocasiones se producen factores inesperados que interrumpen la actualización del clúster. Se puede producir una interrupción cuando el motor de AKS notifica un error o ocurre algo al proceso de ejecución del motor de AKS. Examine la causa de la interrupción, la solucione y vuelva a enviar el mismo upgrade comando para continuar el proceso de actualización. El comando upgrade es idempotente y debe reanudar la actualización del clúster cuando se vuelva a enviar el comando. Normalmente, las interrupciones aumentan el tiempo para completar la actualización, pero no deberían afectar a su finalización.

Tiempo de actualización estimado

El tiempo de actualización estimado es de 12 a 15 minutos por máquina virtual en el clúster. Por ejemplo, un clúster de 20 nodos puede tardar aproximadamente 5 horas en actualizarse.

Descarga de la nueva imagen y el motor de AKS

Descargue las nuevas versiones de la imagen base de Ubuntu para AKS y del motor AKS.

Como se explica en la documentación del motor de AKS en Azure Stack Hub, la implementación de un clúster de Kubernetes requiere dos componentes principales:

• El archivo binario aks-engine (obligatorio).
• Distribución de imágenes de la imagen base de AKS en Ubuntu 16.04-LTS

Las nuevas versiones de estas imágenes están disponibles con esta actualización:

• El operador de Azure Stack Hub debe descargar una nueva imagen base de AKS en Ubuntu en el marketplace de marcas:

• Nombre: AKS Base Ubuntu 16.04-LTS Image Distro, septiembre de 2020 (2020.09.14)

• Versión: 2020.09.14

  Siga estas instrucciones para Agregar los requisitos previos del motor de Azure Kubernetes Service (AKS) al Marketplace de Azure Stack Hub.

• El administrador de clústeres de Kubernetes (normalmente un usuario de inquilino de Azure Stack Hub) debe descargar el nuevo motor de aks. Consulte las instrucciones de Instalación del motor de AKS en Linux en Azure Stack Hub (o artículo equivalente de Windows). Puede seguir el mismo proceso que utilizó para el instalar el clúster por primera vez. La actualización sobrescribe el binario anterior. Por ejemplo, si utilizó el script de get-akse.sh, siga los mismos pasos indicados en Instalar en un entorno conectado. El mismo proceso se aplica si va a instalar en un sistema Windows: instale el motor de AKS en Windows en Azure Stack Hub.

Asignación de versiones del motor de AKS y de Azure Stack

Ruta de actualización de la versión de Kubernetes en el motor de AKS v0.55.4

Puede encontrar la versión actual y la versión de actualización de Azure Stack Hub en la tabla siguiente. Esta tabla se aplica al clúster del motor de AKS en Azure Stack Hub. No use el comando aks-engine get-versions , que devuelve versiones compatibles con Azure global, así como en Azure Stack Hub.

En el archivo JSON del modelo de API, especifique los valores de lanzamiento y versión en la orchestratorProfile sección. Por ejemplo, si planea implementar Kubernetes 1.17.17,17, se deben establecer los dos valores siguientes (consulte el ejemplo kubernetes-azurestack.json):

    -   "orchestratorRelease": "1.16",
    -   "orchestratorVersion": "1.16.14"

Motor de AKS y la asignación de imagen correspondiente

Novedades

• Actualice el disco duro virtual de Linux de Azure Stack a la versión 2020.09.14 #3828
• Agrega compatibilidad con K8s v1.17.11 en Azure Stack #3702
• Agrega compatibilidad con K8s v1.16.14 en Azure Stack #3704
• Actualización del disco duro virtual de Linux a 2020.09.14 #3750
• Actualización del disco duro virtual de Windows a la versión de agosto #3730
• Actualiza el servidor de métricas de Kubernetes a la versión v0.3.7 #3669
• Actualiza la versión de Docker para corregir el problema de la rotación del registro #3693
• Actualiza CoreDNS a v1.7.0 #3608
• Usa paquetes 19.03.x de Moby #3549
• Correcciones en la estrategia de actualización de Azure-CNI #3571

Problemas conocidos

• La implementación de varios servicios de Kubernetes en paralelo dentro de un único clúster puede producir un error en la configuración del equilibrador de carga básico. Se recomienda implementar un servicio a la vez.
• Al ejecutar aks-engine get-versions, la salida genera información aplicable a Azure y Azure Stack Hub; sin embargo, no hay ninguna manera explícita de distinguir lo que corresponde a Azure Stack Hub. No use este comando para determinar qué versiones están disponibles para actualizar. Use la tabla de referencia de actualización descrita en la sección anterior.
• Dado que la herramienta aks-engine es un repositorio de código fuente compartido en Azure y Azure Stack Hub, examinar las numerosas notas de versión y las solicitudes de extracción puede hacer que creas que la herramienta admite otras versiones de Kubernetes y plataforma de sistema operativo más allá de las enumeradas anteriormente. Puede omitirlos y usar la tabla de versiones anterior como guía oficial de esta actualización.

Referencia

Este es el conjunto completo de notas de la versión de Azure y Azure Stack Hub combinadas:

• https://github.com/Azure/aks-engine/releases/tag/v0.51.1
• https://github.com/Azure/aks-engine/releases/tag/v0.52.1
• https://github.com/Azure/aks-engine/releases/tag/v0.53.1
• https://github.com/Azure/aks-engine/releases/tag/v0.54.1
• https://github.com/Azure/aks-engine/releases/tag/v0.55.0
• https://github.com/Azure/aks-engine/releases/tag/v0.55.4

Se aplica a la versión 0.48.0 o anterior del motor de AKS.

En este artículo se describe el contenido del motor de Azure Kubernetes Service (AKS) en la actualización de Azure Stack Hub. La actualización incluye mejoras y correcciones de la versión más reciente del motor de AKS en la plataforma de Azure Stack Hub. En este artículo, no pretende documentar la información sobre la versión del motor de AKS para Azure global.

Planeación de la actualización

El comando del motor upgrade de AKS automatiza completamente el proceso de actualización del clúster y controla las máquinas virtuales (VM), las redes, el almacenamiento, Kubernetes y las tareas de orquestación. Antes de aplicar la actualización, asegúrese de revisar la información de las notas de la versión.

Consideraciones sobre actualizaciones

• ¿Está utilizando el elemento adecuado del marketplace, es decir, AKS Base Ubuntu 16.04-LTS Image Distro para la versión de su motor AKS? Puede encontrar las versiones en la sección Descarga de las nuevas versiones de la imagen base de Ubuntu de AKS y del motor de AKS.
• ¿Usa la especificación correcta del clúster (apimodel.json) y el grupo de recursos para el clúster de destino? Cuando implementó originalmente el clúster, este archivo se generó en el directorio de salida. Consulte los parámetros del comando "deploy" en Implementación de un clúster de Kubernetes.
• ¿Usa una máquina confiable para ejecutar el motor de AKS y desde la que está realizando operaciones de actualización?
• Si va a actualizar un clúster operativo con cargas de trabajo activas, puede aplicar la actualización sin que esto les afecte, siempre que el clúster tenga una carga normal. Sin embargo, debe tener un clúster de copia de seguridad en caso de que haya necesidad de redirigir a los usuarios a este. Es muy recomendable disponer de un clúster de copia de seguridad.
• Si es posible, ejecute el comando desde una máquina virtual en el entorno de Azure Stack Hub para disminuir los saltos de red y los posibles errores de conectividad.
• Asegúrese de que la suscripción tiene una cuota suficiente para todo el proceso. El proceso asigna nuevas máquinas virtuales durante el proceso. El número resultante de máquinas virtuales sería el mismo que el original, pero planee que se creen algunas máquinas virtuales más durante el proceso.
• No se prevén actualizaciones del sistema ni tareas programadas.
• Configure una actualización por fases en un clúster que esté configurado con los mismos valores que el clúster de producción y pruebe la actualización allí antes de hacerlo en el clúster de producción.

Uso del comando "upgrade"

Debe usar el aks-engine upgrade comando tal como se describe en Actualización de un clúster de Kubernetes en Azure Stack Hub.

Interrupciones de la actualización

En algunas ocasiones se producen factores inesperados que interrumpen la actualización del clúster. Se puede producir una interrupción cuando el motor de AKS notifica un error o ocurre algo al proceso de ejecución del motor de AKS. Examine la causa de la interrupción, la solucione y vuelva a enviar el mismo upgrade comando para continuar el proceso de actualización. El comando upgrade es idempotente y debe reanudar la actualización del clúster cuando se vuelva a enviar el comando. Normalmente, las interrupciones aumentan el tiempo para completar la actualización, pero no deberían afectar a su finalización.

Tiempo de actualización estimado

El tiempo de actualización estimado es de 12 a 15 minutos por máquina virtual en el clúster. Por ejemplo, un clúster de 20 nodos puede tardar aproximadamente 5 horas en actualizarse.

Descarga de la nueva imagen y el motor de AKS

Descargue las nuevas versiones de la imagen base de Ubuntu para AKS y del motor AKS.

Como se explica en la documentación del motor de AKS en Azure Stack Hub, la implementación de un clúster de Kubernetes requiere dos componentes principales:

• El archivo binario aks-engine (obligatorio).
• Distribución de imagen base de AKS Ubuntu 16.04-LTS.

Hay nuevas versiones de estas disponibles con esta actualización:

• El operador de Azure Stack Hub debe descargar las nuevas imágenes base de AKS en el marketplace de marcas:

  • Nombre: AKS Base Ubuntu 16.04-LTS Image Distro, March 2020

  • Versión: 2020.03.19

    Siga estas instrucciones para Agregar los requisitos previos del motor de Azure Kubernetes Service (AKS) al Marketplace de Azure Stack Hub.

• El administrador de clústeres de Kubernetes (normalmente un usuario de inquilino de Azure Stack Hub) debe descargar el nuevo motor de aks. Consulte las instrucciones de Instalación del motor de AKS en Linux en Azure Stack Hub (o artículo equivalente de Windows). Puede seguir el mismo proceso que utilizó para el instalar el clúster por primera vez. La actualización sobrescribe el binario anterior. Por ejemplo, si utilizó el script de get-akse.sh, siga los mismos pasos indicados en Instalar en un entorno conectado. El mismo proceso se aplica si va a instalar en un sistema Windows: instale el motor de AKS en Windows en Azure Stack Hub.

Ruta de actualización de la versión de Kubernetes

Puede encontrar la versión actual y la versión de actualización de Azure Stack Hub en la tabla siguiente. Esta tabla se aplica al clúster del motor de AKS en Azure Stack Hub. No use el comando aks-engine get-versions , que devuelve versiones compatibles con Azure global, así como en Azure Stack Hub.

Novedades

• Soporte técnico para la versión 1.15.10 (#2834) de Kubernetes. Al implementar un nuevo clúster, en el archivo modelo de API .json (también conocido como archivo de definición de clúster), especifique tanto el número de la versión de lanzamiento como el número de la versión secundaria en el formato siguiente. Para obtener un archivo de definición de clúster de ejemplo, consulte kubernetes-azurestack.json.

  • "orchestratorRelease": "1.15,

  • "orchestratorVersion": "1.15.10"

  Nota:

  Si la versión de Kubernetes no se proporciona explícitamente en el modelo de API .json archivo, se usará la versión 1.15 (2932) y orchestratorVersion tendrá como valor predeterminado la versión 1.15.11, lo que producirá un error durante la implementación del clúster.

• Con la versión v0.43.1 de aks-engine, la configuración de la frecuencia predeterminada del proveedor de nube para ejecutar su ciclo de control y otras tareas no funciona correctamente con los límites del Resource Manager de Azure Stack Hub para las solicitudes entrantes. Esta actualización cambia los valores predeterminados de Azure Stack Hub para reducir la carga de reintentos de Resource Manager en Azure Stack Hub (#2861).

• El nuevo paso de comprobación en aks-engine dará como resultado que la ejecución se detenga o muestre advertencias si el modelo de API .json archivo contiene propiedades no compatibles con Azure Stack Hub (2717).

• Con una nueva sincronización de comprobación, aks-engine comprobará la disponibilidad de la versión de la imagen base de AKS necesaria para la versión de aks-engine que ejecuta (#2342). Esto se producirá después de analizar el modelo de API .json archivo y antes de llamar a Resource Manager de Azure Stack Hub.

• La nueva opción aks-engine "--control-plane-only" en el comando upgrade permite al usuario actualizar las operaciones para que solo tengan como destino las Máquinas Virtuales principales (#2635).

• Actualizaciones de la versión 4.15.0-1071-azure del kernel de Linux para Ubuntu 16.04-LTS. Consulte "Paquete: linux-image-4.15.0-1071-azure (4.15.0-1071.76) [seguridad]" para obtener más información.

• Nuevas actualizaciones de hyperkube compatibles con las versiones 1.14.8 y 1.15.10 de Kubernetes.

• Actualice kubectl para que coincida con la versión de Kubernetes para el clúster. Este componente está disponible en los nodos del plano de control del clúster de Kubernetes. Puede ejecutarlo mediante SSH en un nodo maestro.

• Actualizaciones del complemento azure Container Monitor con la versión más reciente de febrero de 2020 (2850).

• Actualización de coredns a la versión v1.6.6 (#2555).

• Actualice etcd a la versión 3.3.18 (#2462).

• Actualice moby a la versión 3.0.11 (#2887).

• Con esta versión, el motor de AKS elimina su dependencia de k8s.gcr.io para usar ahora el Kubernetes MCR registry @ mcr.microsoft.com oficial al crear sus imágenes (#2722).

Problemas conocidos

• La implementación de varios servicios de Kubernetes en paralelo dentro de un único clúster puede producir un error en la configuración del equilibrador de carga básico. Se recomienda implementar un servicio a la vez.
• La ejecución de aks-engine get-versions genera información aplicable a Azure y Azure Stack Hub; sin embargo, no hay ninguna manera explícita de distinguir lo que corresponde a Azure Stack Hub. No use este comando para determinar qué versiones están disponibles para actualizar. Use la tabla de referencia de actualización descrita en la sección anterior.
• Dado que la herramienta aks-engine es un repositorio de código fuente compartido en Azure y Azure Stack Hub, examinar las numerosas notas de versión y las solicitudes de extracción puede hacer que creas que la herramienta admite otras versiones de Kubernetes y plataforma de sistema operativo más allá de las enumeradas anteriormente. Puede omitirlos y usar la tabla de versiones anterior como guía oficial de esta actualización.

Referencia

A continuación se muestra una lista de algunos de los errores corregidos y el conjunto completo de notas de la versión desde la versión 0.44.0 hasta la versión 0.48.0. Las notas de la versión incluyen tanto Azure como Azure Stack Hub.

Corrección de errores

• userAssignedIdentityId en Windows azure.json faltan comillas (#2327)

• Los complementos update config son solo para actualización (#2282)

• Ampliando el tiempo de espera para obtener la dirección IP de administración en los nodos de Windows (#2284)

• Adición del archivo .zip de Azure CNI 1.0.28 en el disco duro virtual de Windows (#2268)

• Orden predeterminado correcto para la configuración IPAddressCount (2358)

• Se ha actualizado para utilizar un único archivo YAML de omsagent para todas las versiones K8s para evitar los errores manuales y conseguir un mantenimiento fácil (#2692)

Notas de la versión

Este es el conjunto completo de notas de la versión de Azure y Azure Stack Hub combinadas:

• https://github.com/Azure/aks-engine/releases/tag/v0.44.0
• https://github.com/Azure/aks-engine/releases/tag/v0.44.1
• https://github.com/Azure/aks-engine/releases/tag/v0.44.2
• https://github.com/Azure/aks-engine/releases/tag/v0.45.0
• https://github.com/Azure/aks-engine/releases/tag/v0.46.0
• https://github.com/Azure/aks-engine/releases/tag/v0.46.1
• https://github.com/Azure/aks-engine/releases/tag/v0.46.2
• https://github.com/Azure/aks-engine/releases/tag/v0.46.3
• https://github.com/Azure/aks-engine/releases/tag/v0.47.0
• https://github.com/Azure/aks-engine/releases/tag/v0.48.0