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. Este artículo no está pensado para documentar la información de versión del motor de AKS para Azure global.
Consideraciones sobre la actualización
- ¿Usa los elementos de Marketplace correctos, distribución de imágenes base de AKS Ubuntu 20.04 o Windows Server base de AKS 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 tiene previsto crear 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 y 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 algo que ocurre con el proceso de ejecución del motor de AKS. Examine la causa de la interrupción, solucionarla y vuelva a enviar el mismo upgrade comando para continuar con el proceso de actualización. El upgrade comando es idempotente y debe reanudar la actualización del clúster una vez que vuelva a enviar el comando. Normalmente, las interrupciones aumentan el tiempo para completar la actualización, pero no deben 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.
Instrucciones para usar el motor de AKS 0.70.0 y versiones posteriores
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 lo siguiente:
- Binario aks-engine (obligatorio).
- Distribución de imágenes base de AKS para Ubuntu 16.04-LTS (en desuso; ya no se usa, cambie el modelo de API para usar 20.04 en su lugar).
- Distribución de imagen base de AKS para Ubuntu 18.04-LTS (en desuso; ya no se usa, cambie el modelo de API para usar 20.04 en su lugar).
- Distribución de imagen base de AKS para Ubuntu 20.04-LTS (necesaria para los 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 contenedor.
- Docker de la 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 ver las imágenes base de AKS necesarias.
Siga las instrucciones de Incorporación de los requisitos previos del motor de Azure Kubernetes Services (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 aks-engine. Consulte las instrucciones de Instalación del motor de AKS en Linux en Azure Stack Hub (o el 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 usó el script de get-akse.sh , siga los mismos pasos descritos en Instalación 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 AKS Engine v0.67.0 o versiones posteriores, la actualización de aks-engine sobrescribe automáticamente el valor de distribución no admitido aks-ubuntu-16.04 con .aks-ubuntu-18.04 En el caso de 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 de Ubuntu 18.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. Para AKS Engine v0.75.3 o versiones posteriores, la actualización aks-engine-azurestack sobrescribe automáticamente el valor de distribución no admitido aks-ubuntu-18.04 con aks-ubuntu-20.04.
Actualización de clústeres de Kubernetes creados con el entorno de ejecución del contenedor 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
| Versión de Azure Stack Hub | Versión del motor de AKS |
|---|---|
| 1910 | 0.43.0, 0.43.1 |
| 2002 | 0.48.0, 0.51.0 |
| 2005 | 0.48.0, 0.51.0, 0.55.0, 0.55.4 |
| 2008 | 0.55.4, 0.60.1 |
| 2102 | 0.60.1, 0.63.0, 0.67.0, 0.67.3 |
| 2108 | 0.63.0, 0.67.0, 0.67.3, 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0 |
| 2206 | 0.70.0, 0.71.0, 0.73.0, 0.75.3, 0.76.0, 0.77.0 |
| 2301 | 0.75.3, 0.76.0, 0.77.0, 0.78.0, 0.79.0 |
| 2306 | 0.78.0, 0.79.0*, 0.80.2* |
| 2311 | 0.80.2* |
Nota
*Apoyado. Consulte la directiva de compatibilidad con versiones del motor de AKS para obtener más información.
Motor de AKS y la asignación de imagen correspondiente
Puede encontrar las versiones admitidas de Kubernetes 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.
| Motor de AKS | Imagen base de AKS | Versiones de Kubernetes | Ejemplos de modelo de API |
|---|---|---|---|
| v0.43.1 | Distribución de imágenes de la imagen base de AKS en Ubuntu 16.04-LTS, octubre de 2019 (2019.10.24) | 1.15.5, 1.15.4, 1.14.8, 1.14.7 | |
| v0.48.0 | Distribución de la imagen base de AKS en Ubuntu 16.04-LTS, marzo de 2020 (2020.03.19) | 1.15.10, 1.14.7 | |
| v0.51.0 | Distribución de la imagen base de AKS en Ubuntu 16.04-LTS, mayo de 2020 (2020.05.13), imagen base de AKS en Windows (17763.1217.200513) | 1.15.12, 1.16.8, 1.16.9 | Linux, Windows |
| v0.55.0 | Distribución de la imagen base de AKS en Ubuntu 16.04-LTS, agosto de 2020 (2020.08.24), imagen base de AKS en Windows (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
| v0.55.4 | Distribución de la imagen base de AKS en Ubuntu 16.04-LTS, septiembre de 2020 (2020.09.14), imagen base de AKS en Windows (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
| V0.60.1 | Distribución de la imagen base de AKS para Ubuntu 16.04-LTS, enero de 2021 (2021.01.28), Distribución de la 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) |
1.16.14, 1.16.15, 1.17.17, 1.18.15 | Linux, Windows |
| v0.63.0 | Distribución de la imagen base de AKS para Ubuntu 18.04-LTS, segundo trimestre de 2021 (2021.05.24), Imagen base de AKS para Windows (17763.1935.210520) | 1.18.18, 1.19.10, 1.20.6 | Ejemplos del modelo de API (Linux y Windows) |
| v0.67.0 | Distribución de la imagen base de AKS para Ubuntu 18.04-LTS, segundo trimestre de 2021 (2021.09.27), Imagen base de AKS para Windows (17763.2213.210927) | 1.19.15, 1.20.11 | Ejemplos del modelo de API (Linux y Windows) |
| v0.67.3 | Distribución de la imagen base de AKS para Ubuntu 18.04-LTS, segundo trimestre de 2021 (2021.09.27), Imagen base de AKS para Windows (17763.2213.210927) | 1.19.15, 1.20.11 | Ejemplos del modelo de API (Linux y Windows) |
| v0.70.0 | Distribución de imagen base de AKS para Ubuntu 18.04-LTS, 2022 Q2 (2022.04.07),imagen base de AKS de Windows (17763.2565.220408) | 1.21.10*, 1.22.7* | Ejemplos del modelo de API (Linux y Windows) |
| v0.71.0 | Distribución de imágenes base de AKS para Ubuntu 18.04-LTS, 2022 Q3 (2022.08.12),imagen base de AKS de Windows (17763.3232.220805) | 1.22.7*, 1.23.6* | Ejemplos del modelo de API (Linux y Windows) |
| v0.73.0 | Distribución de la imagen base de AKS ubuntu 18.04-LTS, 2022 Q4 (2022.11.02),imagen base de WINDOWS de AKS (17763.3532.221102) | 1.22.15*, 1.23.13* | Ejemplos del modelo de API (Linux y Windows) |
| v0.75.3 | Distribución de imágenes base de AKS para Ubuntu 20.04-LTS (2023.032.2),, Docker de imagen base de AKS para Windows Server 2019 (17763.3887.20230332),AKS Base Windows Server 2019 Image Containerd (17763.3887.20230332) | 1.23.15*, 1.24.9** | Ejemplos del modelo de API (Linux y Windows) |
| v0.76.0 | Distribución de imágenes base de AKS para Ubuntu 20.04-LTS (2023.116.3),AKS Base Windows Server 2019 Image Containerd (17763.4252.20231163) | 1.24.11**, 1.25.7** | Ejemplos del modelo de API (Linux y Windows) |
| v0.77.0 | Distribución de imágenes base de AKS para Ubuntu 20.04-LTS (2023.206.1),AKS Base Windows Server 2019 Image Containerd (17763.4645.20232061) | 1.25.7**, 1.26.6** | Ejemplos del modelo de API (Linux y Windows) |
| v0.78.0 | Distribución de imágenes base de AKS para Ubuntu 20.04-LTS (2023.242.3),AKS Base Windows Server 2019 Image Containerd (17763.4737.20232423) | 1.25.13**, 1.26.8** | Ejemplos del modelo de API (Linux y Windows) |
| v0.79.0 | Distribución de imagen base de AKS para Ubuntu 20.04-LTS (2023.296.1), imagen base de AKS en contenedores de Windows Server 2019 (17763.4974.20232961) | 1.26.9**, 1.27.6** | Ejemplos del modelo de API (Linux y Windows) |
| v0.80.2 | Distribución de imágenes base de AKS para Ubuntu 20.04-LTS (2024.032.1),AKS Base Windows Server 2019 Image Containerd (17763.5329.20240321) | 1.27.10**, 1.28.6** | Ejemplos del modelo de API (Linux y Windows) |
Nota
*A partir de Kubernetes v1.21, solo se admite el proveedor de nube para Azure en Azure Stack Hub.
Nota
** A partir de Kubernetes v1.24, solo se admite el entorno de ejecución del containerd contenedor. Consulte la sección Actualización de clústeres de Kubernetes creados con el entorno de ejecución del contenedor de Docker para más información.
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 siguiente sobre las notas de versión.
Novedades de AKSe 0.76.0
- Se ha agregado compatibilidad con Kubernetes v1.24.11 y v1.25.7.
- Puede encontrar otras características en la página de GitHub v0.76.0.
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 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 containerd entorno de ejecución. Consulte Actualización de clústeres de Kubernetes creados con el entorno de ejecución de Docker para obtener más información. En el caso de 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.
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 intenta crear un nuevo clúster de Kubernetes por primera vez: use el modelo de API de ejemplo proporcionado para la versión adecuada en el motor de AKS 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 usa volúmenes de almacenamiento: asegúrese de que usa 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 actualización al usar volúmenes de almacenamiento.
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 cada vez.
- Dado que la herramienta aks-engine es un repositorio de código fuente compartido en Azure y Azure Stack Hub, examinar las muchas notas de la versión y las solicitudes de incorporación de cambios pueden llevar a creer que la herramienta admite otras versiones de Kubernetes y la plataforma del sistema operativo más allá 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.
Referencia
La lista siguiente es el conjunto completo de notas de la versión 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
- 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
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. Este artículo no está pensado para documentar la información de 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 siguiente sobre las notas de versión.
Consideraciones sobre la actualización
- ¿Usa los elementos correctos de Marketplace, AKS Base Ubuntu 16.04-LTS o 18.04 Image Distro o AKS Base 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 de clúster correcta (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 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 algo que ocurre con el proceso de ejecución del motor de AKS. Examine la causa de la interrupción, adíguela y vuelva a enviar el mismo upgrade comando para continuar con el proceso de actualización. El upgrade comando es idempotente y debe reanudar la actualización del clúster una vez que vuelva a enviar el comando. Normalmente, las interrupciones aumentan el tiempo para completar la actualización, pero no deben 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:
- Binario aks-engine (obligatorio).
- Distribución de imágenes base de AKS Ubuntu 16.04-LTS (en desuso; ya no se usa, cambie en el modelo de API para usar 18.04 en su lugar).
- Distribución de imágenes base de AKS Ubuntu 18.04-LTS (necesaria para los agentes de Linux).
- Distribución de imagen de Windows Server base de AKS (necesaria para agentes de Windows).
Hay disponibles nuevas versiones de estas imágenes con esta actualización:
Compruebe el motor de AKS y la tabla de asignación de versiones de Azure Stack para ver las imágenes base de AKS necesarias.
Siga las instrucciones de Incorporación de los requisitos previos del motor de Azure Kubernetes Services (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 aks-engine. Consulte las instrucciones de Instalación del motor de AKS en Linux en Azure Stack Hub (o artículo de Windows equivalente). 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 usó el script de get-akse.sh , siga los mismos pasos descritos en Instalación 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, el generado por aks-engine deploy y pasado 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
| Versión de Azure Stack Hub | Versión del motor de AKS |
|---|---|
| 1910 | 0.43.0, 0.43.1 |
| 2002 | 0.48.0, 0.51.0 |
| 2005 | 0.48.0, 0.51.0, 0.55.0, 0.55.4 |
| 2008 | 0.55.4, 0.60.1 |
| 2102 | 0.60.1, 0.63.0, 0.67.0 |
| 2108 | 0.63.0, 0.67.0 |
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.
| Versión actual | Actualización disponible |
|---|---|
| 1.15.12 | 1.16.14, 1.16.15 |
| 1.16.14 | 1.16.15, 1.17.17 |
| 1.17.11, 1.17.17 | 1.18.18 |
| 1.18.15, 1.18.18 | 1.19.10 |
| 1.19.10 | 1.19.15, 1.20.11 |
| 1.20.6 | 1.20.11 |
En el archivo JSON del modelo de API, especifique los valores de versión y versión en la orchestratorProfile sección . Por ejemplo, si planea implementar Kubernetes 1.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
| Motor de AKS | Imagen base de AKS | Versiones de Kubernetes | Ejemplos de modelo de API |
|---|---|---|---|
| v0.43.1 | Distribución de imágenes de la imagen base de AKS en Ubuntu 16.04-LTS, octubre de 2019 (2019.10.24) | 1.15.5, 1.15.4, 1.14.8, 1.14.7 | |
| v0.48.0 | Distribución de la imagen base de AKS en Ubuntu 16.04-LTS, marzo de 2020 (2020.03.19) | 1.15.10, 1.14.7 | |
| v0.51.0 | Distribución de la imagen base de AKS en Ubuntu 16.04-LTS, mayo de 2020 (2020.05.13), imagen base de AKS en Windows (17763.1217.200513) | 1.15.12, 1.16.8, 1.16.9 | Linux, Windows |
| v0.55.0 | Distribución de la imagen base de AKS en Ubuntu 16.04-LTS, agosto de 2020 (2020.08.24), imagen base de AKS en Windows (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
| v0.55.4 | Distribución de la imagen base de AKS en Ubuntu 16.04-LTS, septiembre de 2020 (2020.09.14), imagen base de AKS en Windows (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
| V0.60.1 | Distribución de la imagen base de AKS para Ubuntu 16.04-LTS, enero de 2021 (2021.01.28), Distribución de la 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) |
1.16.14, 1.16.15, 1.17.17, 1.18.15 | Linux, Windows |
| v0.63.0 | Distribución de la imagen base de AKS para Ubuntu 18.04-LTS, segundo trimestre de 2021 (2021.05.24), Imagen base de AKS para Windows (17763.1935.210520) | 1.18.18, 1.19.10, 1.20.6 | Ejemplos del modelo de API (Linux y Windows) |
| v0.67.0 | Distribución de la imagen base de AKS para Ubuntu 18.04-LTS, segundo trimestre de 2021 (2021.09.27), Imagen base de AKS para Windows (17763.2213.210927) | 1.19.15, 1.20.11 | Ejemplos del modelo de API (Linux y Windows) |
Novedades
Si le interesa participar en una versión preliminar privada, puede solicitar el acceso a la versión preliminar.
Nuevas características:
- 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 muchas notas de la versión y las solicitudes de incorporación de cambios pueden llevar a creer que la herramienta admite otras versiones de Kubernetes y la plataforma del sistema operativo más allá de las enumeradas anteriormente. Puede omitirlos y usar la tabla de versiones anterior como guía oficial para esta actualización.
Referencia
La lista siguiente es el conjunto completo de notas de la versión 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. Este artículo no está pensado para documentar la información de 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 siguiente sobre las notas de versión.
Consideraciones sobre la actualización
- ¿Usa los elementos de Marketplace correctos, la distribución de imágenes base de AKS Ubuntu 16.04-LTS o 18.04 o Windows Server base de AKS 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.
- ¿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 tiene previsto crear 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 y 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 algo que ocurre con el proceso de ejecución del motor de AKS. Examine la causa de la interrupción, solucionarla y vuelva a enviar el mismo upgrade comando para continuar con el proceso de actualización. El upgrade comando es idempotente y debe reanudar la actualización del clúster una vez que vuelva a enviar el comando. Normalmente, las interrupciones aumentan el tiempo para completar la actualización, pero no deben 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:
- Binario aks-engine (obligatorio).
- Distribución de imágenes base de AKS para Ubuntu 16.04-LTS (en desuso; ya no se usa, cambie el modelo de API para usar 18.04 en su lugar).
- Distribución de imagen base de AKS para Ubuntu 18.04-LTS (necesaria para los agentes de Linux).
- Distribución de imagen de Windows Server base de AKS (necesaria 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 stamps:
Distribución de la imagen base de AKS para Ubuntu 16.04-LTS, enero de 2021 (2021.01.28)
Distribución de la 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 las instrucciones de Incorporación de los requisitos previos del motor de Azure Kubernetes Services (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 aks-engine. Consulte las instrucciones de Instalación del motor de AKS en Linux en Azure Stack Hub (o el 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 usó el script de get-akse.sh , siga los mismos pasos descritos en Instalación 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
| Versión de Azure Stack Hub | Versión del motor de AKS |
|---|---|
| 1910 | 0.43.0, 0.43.1 |
| 2002 | 0.48.0, 0.51.0 |
| 2005 | 0.48.0, 0.51.0, 0.55.0, 0.55.4 |
| 2008 | 0.55.4, 0.60.1 |
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.
| Versión actual | Actualización disponible |
|---|---|
| 1.15.12 | 1.16.14, 1.16.15 |
| 1.16.14 | 1.16.15, 1.17.17 |
| 1.17.11 | 1.17.17, 1.18.15 |
| 1.17.17 | 1.18.15 |
En el archivo JSON del modelo de API, especifique los valores de versión y versión en la orchestratorProfile sección . Por ejemplo, si planea implementar Kubernetes 1.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
| Motor de AKS | Imagen base de AKS | Versiones de Kubernetes | Ejemplos de modelo de API |
|---|---|---|---|
| v0.43.1 | Distribución de imágenes de la imagen base de AKS en Ubuntu 16.04-LTS, octubre de 2019 (2019.10.24) | 1.15.5, 1.15.4, 1.14.8, 1.14.7 | |
| v0.48.0 | Distribución de la imagen base de AKS en Ubuntu 16.04-LTS, marzo de 2020 (2020.03.19) | 1.15.10, 1.14.7 | |
| v0.51.0 | Distribución de la imagen base de AKS en Ubuntu 16.04-LTS, mayo de 2020 (2020.05.13), imagen base de AKS en Windows (17763.1217.200513) | 1.15.12, 1.16.8, 1.16.9 | Linux, Windows |
| v0.55.0 | Distribución de la imagen base de AKS en Ubuntu 16.04-LTS, agosto de 2020 (2020.08.24), imagen base de AKS en Windows (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
| v0.55.4 | Distribución de la imagen base de AKS en Ubuntu 16.04-LTS, septiembre de 2020 (2020.09.14), imagen base de AKS en Windows (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
| V0.60.1 | Distribución de la imagen base de AKS para Ubuntu 16.04-LTS, enero de 2021 (2021.01.28), Distribución de la 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) |
1.16.14, 1.16.15, 1.17.17, 1.18.15 | Linux, Windows |
Novedades
Si le interesa participar en una versión preliminar privada, puede solicitar el acceso a la versión preliminar.
Nuevas características:
- Disponibilidad general de Ubuntu 18.04.
- Versión preliminar pública de rotación de certificados n.º 4214.
- T4 Nvidia GPU Private Preview #4259.
- Versión preliminar privada de la integración de Azure Active Directory.
- Controlador CSI para azure Blobs Private Preview #712.
- Versión preliminar pública de Azure Disks del controlador CSI n.º 712.
- Versión preliminar pública de NFS del controlador CSI n.º 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 muchas notas de la versión y las solicitudes de incorporación de cambios pueden llevar a creer que la herramienta admite otras versiones de Kubernetes y la plataforma del sistema operativo más allá de las enumeradas anteriormente. Puede omitirlos y usar la tabla de versiones anterior como guía oficial para esta actualización.
Referencia
La lista siguiente es el conjunto completo de notas de la versión para Azure y Azure Stack Hub combinados:
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. Este artículo no está pensado para documentar la información de 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 siguiente sobre las notas de versión.
Consideraciones sobre la actualización
- ¿Usa el elemento de Marketplace correcto, distribución de imagen base de AKS Ubuntu 16.04-LTS para la versión del motor de 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 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 algo que ocurre con el proceso de ejecución del motor de AKS. Examine la causa de la interrupción, adíguela y vuelva a enviar el mismo upgrade comando para continuar con el proceso de actualización. El upgrade comando es idempotente y debe reanudar la actualización del clúster una vez que vuelva a enviar el comando. Normalmente, las interrupciones aumentan el tiempo para completar la actualización, pero no deben 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 dos componentes principales:
- Binario aks-engine (obligatorio).
- Distribución de imágenes de la imagen base de AKS en Ubuntu 16.04-LTS
Hay disponibles nuevas versiones de estas imágenes con esta actualización:
El operador de Azure Stack Hub debe descargar una nueva imagen base de Ubuntu de AKS en el marketplace de marca:
Nombre: Distribución de imágenes de la imagen base de AKS en Ubuntu 16.04-LTS, septiembre de 2020 (2020.09.14)
Versión: 2020.09.14
Siga las instrucciones de Incorporación de los requisitos previos del motor de Azure Kubernetes Services (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 aks-engine. Consulte las instrucciones de Instalación del motor de AKS en Linux en Azure Stack Hub (o artículo de Windows equivalente). 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 usó el script de get-akse.sh , siga los mismos pasos descritos en Instalación 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
| Versión de Azure Stack Hub | Versión del motor de AKS |
|---|---|
| 1910 | 0.43.0, 0.43.1 |
| 2002 | 0.48.0, 0.51.0 |
| 2005 | 0.48.0, 0.51.0, 0.55.0, 0.55.4 |
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.
| Versión actual | Actualización disponible |
|---|---|
| 1.15.10 | 1.15.12 |
| 1.15.12, 1.16.8, 1.16.9 | 1.16.14 |
| 1.16.8, 1.16.9, 1.16.14 | 1.17.11 |
En el archivo JSON del modelo de API, especifique los valores de versión 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
| Versiones de Kubernetes | Notas |
|---|---|
| 1.15.5, 1.15.4, 1.14.8, 1.14.7 | |
| 1.15.10, 1.14.7 | |
| 1.15.12, 1.16.8, 1.16.9 | Ejemplos de modelos de API (Linux, Windows) |
| 1.15.12, 1.16.14, 1.17.11 | Ejemplos de modelos de API (Linux, Windows) |
| 1.15.12, 1.16.14, 1.17.11 | Ejemplos de modelos de API (Linux, Windows) |
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 cada 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 muchas notas de la versión y las solicitudes de incorporación de cambios pueden llevar a creer que la herramienta admite otras versiones de Kubernetes y la plataforma del sistema operativo más allá de las enumeradas anteriormente. Puede omitirlos y usar la tabla de versiones anterior como guía oficial para 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. Este artículo no está pensado para documentar la información de 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 siguiente sobre las notas de versión.
Consideraciones sobre la actualización
- ¿Usa el elemento de Marketplace correcto, distribución de imágenes base de AKS Ubuntu 16.04-LTS para la versión del motor de 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 de clúster correcta (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 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 algo que ocurre con el proceso de ejecución del motor de AKS. Examine la causa de la interrupción, adíguela y vuelva a enviar el mismo upgrade comando para continuar con el proceso de actualización. El upgrade comando es idempotente y debe reanudar la actualización del clúster una vez que vuelva a enviar el comando. Normalmente, las interrupciones aumentan el tiempo para completar la actualización, pero no deben 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 dos componentes principales:
- Binario aks-engine (obligatorio).
- Distribución de imágenes base de AKS para 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 marca:
Nombre:
AKS Base Ubuntu 16.04-LTS Image Distro, March 2020Versión:
2020.03.19Siga las instrucciones de Incorporación de los requisitos previos del motor de Azure Kubernetes Services (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 aks-engine. Consulte las instrucciones de Instalación del motor de AKS en Linux en Azure Stack Hub (o artículo de Windows equivalente). 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 usó el script de get-akse.sh , siga los mismos pasos descritos en Instalación 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.
| Versión actual | Actualización disponible |
|---|---|
| 1.14.7 | 1.15.10 |
| 1.14.8 | 1.15.10 |
| 1.15.4 | 1.15.10 |
| 1.15.5 | 1.15.10 |
Novedades
Soporte técnico para la versión 1.15.10 (#2834) de Kubernetes. Al implementar un nuevo clúster, en el modelo de API .json archivo (también conocido como archivo de definición de clúster), especifique el número de versión de lanzamiento y el número de 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 archivo .json del modelo de API, 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 aks-engine v0.43.1, la configuración de la frecuencia predeterminada del proveedor de nube para realizar su bucle de control y otras tareas no funciona correctamente con los límites de Resource Manager para 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á lugar a 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 archivo .json del modelo de API y antes de llamar al Resource Manager de Azure Stack Hub.
La nueva opción aks-engine "--control-plane-only" en el
upgradecomando permite al usuario actualizar las operaciones para que solo el Virtual Machines maestro (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.
Novedades para el complemento de Azure Container Monitor con la versión más reciente de febrero de 2020 (2850).
Actualización de
corednsa la versión v1.6.6 (#2555).Actualice
etcda la versión 3.3.18 (#2462).Actualice
mobya la versión 3.0.11 (#2887).Con esta versión, el motor de AKS elimina su dependencia de
k8s.gcr.iopara usar ahora elKubernetes MCR registry @ mcr.microsoft.comoficial 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 cada vez.
- La ejecución de aks-engine
get-versionsgenera 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 muchas notas de la versión y las solicitudes de incorporación de cambios pueden llevar a creer que la herramienta admite otras versiones de Kubernetes y la plataforma del sistema operativo más allá de las enumeradas anteriormente. Puede omitirlos y usar la tabla de versiones anterior como guía oficial para 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 de la versión 0.44.0 a la versión 0.48.0. Las notas de la versión incluyen Azure y Azure Stack Hub.
Corrección de errores
userAssignedIdentityIden Windows azure.json faltan comillas (2327)Los complementos
update configson de solo actualización (2282)Se ha agotado el tiempo de espera para obtener la dirección IP de administración en los nodos de Windows (2284)
Agregue el archivo 1.0.28 de Azure CNI .zip al disco duro virtual de Windows (2268)
Orden predeterminado correcto para la configuración
IPAddressCount(2358)Actualización para usar yaml de omsagent único para todas las versiones de K8s para evitar errores manuales y facilidad de mantenimiento (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
Pasos siguientes
- Obtenga información sobre el motor de AKS en Azure Stack Hub.
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de