Configuración de actualizaciones para los miembros de Application Network de Azure Kubernetes (versión preliminar)

Importante

Las características en versión preliminar de AKS están disponibles a elección del usuario y en régimen de autoservicio. Las versiones preliminares se proporcionan "tal cual" y "como están disponibles", y están excluidas de los Acuerdos de nivel de servicio y garantía limitada. Las versiones preliminares de AKS cuentan con soporte parcial por parte del servicio al cliente en la medida de lo posible. Por lo tanto, estas características no están diseñadas para su uso en producción. Para más información, consulte los siguientes artículos de soporte:

Azure Kubernetes Application Network proporciona un control flexible sobre cómo se aplican las actualizaciones de versiones secundarias a los miembros. Cada clúster miembro inscrito en un recurso de Azure Kubernetes Application Network puede usar uno de los dos modos de actualización en función del nivel de control que necesite: autoadministrado (SelfManaged) o totalmente administrado (FullyManaged). Estos modos funcionan en el nivel de miembro, lo que le permite elegir si las actualizaciones se realizan manualmente o automáticamente para cada clúster.

En este artículo se explican las diferencias entre estos modos de actualización, cómo configurarlas para los miembros de Azure Kubernetes Application Network y consideraciones importantes que debe tener en cuenta al administrar las actualizaciones.

Consideraciones generales sobre el modo de actualización

Tenga en cuenta las siguientes limitaciones y consideraciones al configurar los modos de actualización para los miembros de Application Network de Azure Kubernetes:

  • Los modos de actualización de Azure Kubernetes Application Network se aplican solo a las versiones menores de los componentes de Azure Kubernetes Application Network. No controlan ni afectan a las actualizaciones de nivel de clúster, como las versiones de Kubernetes o las actualizaciones de imágenes de nodo.
  • Las actualizaciones de revisiones siempre se aplican automáticamente, independientemente del modo.
  • Seleccione el modo de actualización para cada miembro durante el proceso de unión. Una vez seleccionado, el modo permanece en vigor para ese miembro hasta que se quita del recurso de Azure Kubernetes Application Network. No puede cambiar el modo de actualización de un miembro sin quitarlo ni volver a unirlo primero al recurso de Azure Kubernetes Application Network.
  • Si no especifica un modo de actualización durante la incorporación de un miembro, el valor predeterminado es SelfManaged.

Modo autoadministrado

En el modo SelfManaged, especifique la versión menor de Azure Kubernetes Application Network para instalar y controlar cuándo se producen las actualizaciones. Este modo está pensado para escenarios en los que quiere administrar manualmente el proceso de actualización secundaria en lugar de confiar en actualizaciones automatizadas. En este modo, si --version no se especifica, se selecciona por defecto la primera versión disponible N-1. Este modo también es el predeterminado si no se especifica ningún modo de actualización durante la unión a miembros.

Consideraciones sobre el modo autoadministrado

Al usar el modo SelfManaged, tenga en cuenta las siguientes consideraciones:

  • Las actualizaciones solo se permiten entre versiones secundarias consecutivas (por ejemplo, de la versión N secundaria a N+1). No se admite saltar entre versiones (por ejemplo, la actualización de 1.1 a 1.3).
  • Solo puede revertir a la versión inmediatamente anterior N-1, siempre y cuando se haya instalado previamente en el mismo clúster. No se permite volver a una versión anterior.
  • No se permite realizar múltiples reversiones consecutivas. Puede revertir como máximo una versión.

Registrarse en modo autogestionado y seleccionar la versión durante el registro de miembros

  • Modo SelfManaged de inscripción y selección explícita de una versión durante la incorporación de miembros mediante el comando az appnet member join con el parámetro --upgrade-mode SelfManaged y el parámetro --version establecido en la versión deseada.

    az appnet member join \
        --resource-group $APPNET_RG \
        --appnet-name $APPNET_NAME \
        --member-name $APPNET_MEMBER_NAME \
        --member-resource-id /subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME \
        --upgrade-mode SelfManaged \
        --version $VERSION
    

Comprobación de la versión actual

  • Compruebe qué versión está instalada actualmente en un miembro mediante el az appnet member show comando y consulte la Version propiedad en la salida.

    az appnet member show --member-name $APPNET_MEMBER_NAME --appnet-name $APPNET_NAME --resource-group $APPNET_RG
    

Comprobación de las versiones de actualización disponibles

  • Compruebe qué versiones están disponibles para cada modo y la versión de Kubernetes en su región mediante el comando con el az appnet list-versions--location parámetro establecido en la región de interés. En la salida, consulte la AvailableUpgrades columna para ver qué versiones están disponibles.

    az appnet list-versions --location $LOCATION -o table
    

Iniciar una actualización

  • Inicie una actualización mediante el az appnet member update comando con el --version parámetro establecido en la versión deseada a la que se va a actualizar.

    az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --version $VERSION
    

Revertir a una versión anterior

  • Revierte a una versión instalada anteriormente utilizando el comando az appnet member update con el parámetro --version configurado para la versión deseada a la que hacer la reversión. Recuerde que solo se admite el revertir a la versión inmediatamente anterior (N-1).

    az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --version $VERSION
    

Modo totalmente administrado

En FullyManaged modo, Azure Kubernetes Application Network administra automáticamente las actualizaciones de versión de cada miembro en función del canal de versión seleccionado. Se recomienda este modo si prefiere Azure Kubernetes Application Network para controlar la evaluación de la estabilidad de la versión, el tiempo de lanzamiento y las actualizaciones en curso sin intervención manual.

Al usar FullyManaged el modo de actualización, elija un canal de versión que determine la rapidez con la que los clústeres de miembros adoptan nuevas versiones. Application Network de Azure Kubernetes supervisa la preparación de las versiones y actualiza a los miembros según los criterios de estabilidad del canal.

Los siguientes canales de distribución están disponibles para el modo FullyManaged.

  • Rapid: entrega la versión más reciente de Application Network tan pronto como esté disponible. Este canal está pensado para entornos de validación no de producción o tempranos en los que las pruebas de nuevas características y funcionalidades tienen prioridad sobre el tiempo de validación extendido.
  • Estable: entrega versiones que han completado pruebas y validación adicionales. Este canal está diseñado para entornos de producción y normalmente se alinea con la versión N-1secundaria, lo que garantiza una mayor confiabilidad y soluciona los problemas identificados en versiones anteriores.

Cuando el modo FullyManaged se selecciona, puede especificar el canal de lanzamiento en stable o rapid. Si se omite, el canal predeterminado es stable.

Importante

En el modo FullyManaged, Azure Kubernetes Application Network aplica automáticamente las actualizaciones a medida que se promueven nuevas versiones a través de los canales de distribución correspondientes. No se admite el control manual del tiempo de actualización o la selección de versiones.

Comprobación de las versiones de actualización disponibles para el modo totalmente administrado

  • Compruebe a qué versión corresponde cada canal para una región determinada y la versión de Kubernetes mediante el comando az appnet list-versions y grep para el modo FullyManaged.

    az appnet list-versions --location $LOCATION -o table | grep FullyManaged
    

Inscribirse en el modo completamente gestionado y seleccionar el canal de distribución durante la incorporación de miembros

  • Regístrese en modo FullyManaged y seleccione un canal de lanzamiento durante la incorporación de miembros usando el comando az appnet member join con los parámetros --upgrade-mode FullyManaged y --release-channel establecidos en el canal deseado. En el ejemplo siguiente se muestra cómo seleccionar el canal Rapid durante la incorporación de miembros:

    az appnet member join \
        --resource-group $APPNET_RG \
        --appnet-name $APPNET_NAME \
        --member-name $APPNET_MEMBER_NAME \
        --member-resource-id /subscriptions/$SUBSCRIPTION/resourcegroups/$AKS_RG/providers/Microsoft.ContainerService/managedClusters/$CLUSTER_NAME \
        --upgrade-mode FullyManaged \
        --release-channel Rapid \
        --member-location $LOCATION
    

Actualizar la selección del canal de lanzamiento

Puede actualizar la versión seleccionada en cualquier momento. Los cambios realizados en el canal de versión surten efecto inmediatamente.

  • Actualice la selección del canal de lanzamiento de un miembro existente utilizando el comando az appnet member update y configurando el parámetro --release-channel al canal deseado. En el ejemplo siguiente se muestra cómo cambiar al Stable canal de un miembro existente:

    az appnet member update --resource-group $APPNET_RG --appnet-name $APPNET_NAME --member-name $APPNET_MEMBER_NAME --release-channel Stable
    

Para más información sobre Azure Kubernetes Application Network, consulte los artículos siguientes: