Configurer des mises à niveau pour les membres du réseau d’applications Azure Kubernetes (préversion)

Important

Les fonctionnalités d’évaluation AKS sont disponibles en libre-service et font l’objet d’un abonnement. Les versions d'essai sont fournies « en l’état » et « selon disponibilité », et elles sont exclues des contrats de niveau de service et de la garantie limitée. Les versions préliminaires AKS sont, dans la mesure du possible, partiellement couvertes par le service clientèle. Par conséquent, ces fonctionnalités ne sont pas destinées à une utilisation en production. Pour plus d’informations, consultez les articles de support suivants :

Azure Kubernetes Application Network offre un contrôle flexible sur la façon dont les mises à niveau de version mineures sont appliquées aux membres. Chaque cluster membre inscrit dans une ressource Azure Kubernetes Application Network peut utiliser l’un des deux modes de mise à niveau en fonction du niveau de contrôle dont vous avez besoin : auto-géré (SelfManaged) ou entièrement géré (FullyManaged). Ces modes fonctionnent au niveau membre, ce qui vous permet de choisir si les mises à niveau sont effectuées manuellement ou automatiquement pour chaque cluster.

Cet article explique les différences entre ces modes de mise à niveau, comment les configurer pour vos membres Azure Kubernetes Application Network et les considérations importantes à prendre en compte lors de la gestion des mises à niveau.

Considérations générales relatives au mode de mise à niveau

Gardez à l’esprit les limitations et considérations suivantes lors de la configuration des modes de mise à niveau pour les membres du réseau d’applications Azure Kubernetes :

  • Les modes de mise à niveau du réseau d’applications Azure Kubernetes s’appliquent uniquement aux versions mineures des composants Azure Kubernetes Application Network. Ils ne contrôlent ni n’affectent les mises à niveau au niveau du cluster, telles que les versions de Kubernetes ou les mises à jour d’images de nœud.
  • Les mises à jour correctives sont toujours appliquées automatiquement, quel que soit le mode.
  • Vous sélectionnez le mode de mise à niveau pour chaque membre pendant le processus de jointure. Une fois sélectionné, le mode reste en vigueur pour ce membre jusqu’à ce qu’il soit supprimé de la ressource Réseau d’applications Azure Kubernetes. Vous ne pouvez pas modifier le mode de mise à niveau d’un membre sans commencer par le supprimer et le rejoindre à la ressource Azure Kubernetes Application Network.
  • Si vous ne spécifiez pas de mode de mise à niveau pendant la jointure de membre, la valeur par défaut SelfManagedest .

Mode auto-géré

En SelfManaged mode, vous spécifiez la version mineure d’Azure Kubernetes Application Network à installer et contrôler quand des mises à niveau se produisent. Ce mode est destiné aux scénarios dans lesquels vous souhaitez gérer manuellement le processus de mise à niveau secondaire plutôt que de vous appuyer sur des mises à jour automatisées. Dans ce mode, s’il --version n’est pas spécifié, il est défini par défaut sur la N-1version st disponible. Ce mode est également la valeur par défaut si aucun mode de mise à niveau n’est spécifié pendant la jointure de membre.

Considérations relatives au mode auto-managé

Lorsque vous utilisez le mode SelfManaged, gardez à l’esprit les points suivants :

  • Les mises à niveau sont autorisées uniquement entre les versions mineures consécutives (par exemple, de la version N mineure à N+1). Ignorer les versions (par exemple, la mise à niveau vers 1.11.3) n’est pas prise en charge.
  • Vous pouvez restaurer uniquement la version immédiatement précédente (N-1), à condition qu’elle ait été précédemment installée sur le même cluster. La restauration vers une autre version antérieure n’est pas prise en charge.
  • Plusieurs annulations consécutives ne sont pas supportées. Vous pouvez restaurer un maximum d’une version.

S’inscrire en mode autogéré et sélectionner une version pendant l'adhésion

  • Inscrivez-vous en mode SelfManaged et sélectionnez explicitement une version pendant l'adhésion de membre à l’aide de la commande az appnet member join avec le paramètre --upgrade-mode SelfManaged et le paramètre --version défini sur la version souhaitée.

    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

Vérifier la version actuelle

  • Vérifiez la version actuellement installée sur un membre à l’aide de la commande az appnet member show et reportez-vous à la propriété Version dans le résultat.

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

Vérifier les versions de mise à niveau disponibles

  • Vérifiez quelles versions sont disponibles pour chaque mode et la version Kubernetes dans votre région, à l’aide de la commande az appnet list-versions avec le paramètre --location défini sur la région d’intérêt. Dans la sortie, reportez-vous à la AvailableUpgrades colonne pour voir quelles versions sont disponibles.

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

Lancer une mise à niveau

  • Lancez une mise à niveau à l’aide de la az appnet member update commande avec le --version paramètre défini sur la version souhaitée vers laquelle effectuer la mise à niveau.

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

Revenir à une version précédente

  • Revenez à une version précédemment installée en utilisant la commande az appnet member update avec le paramètre --version défini sur la version souhaitée pour revenir en arrière. N’oubliez pas que seule la restauration vers la version immédiatement précédente (N-1) est prise en charge.

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

Mode complètement managé

En FullyManaged mode, Azure Kubernetes Application Network gère automatiquement les mises à niveau de version pour chaque membre en fonction du canal de mise en production sélectionné. Nous vous recommandons ce mode si vous préférez Azure Kubernetes Application Network pour gérer l’évaluation de la stabilité des versions, le délai de déploiement et les mises à jour en cours sans intervention manuelle.

Lorsque vous utilisez FullyManaged le mode de mise à niveau, vous choisissez un canal de mise en production qui détermine la rapidité avec laquelle vos clusters membres adoptent de nouvelles versions. Azure Kubernetes Application Network surveille la préparation des versions et met à niveau les membres en fonction des critères de stabilité du canal.

Les canaux de diffusion suivants sont disponibles pour FullyManaged mode :

  • Rapide : fournit la dernière version du réseau d’applications dès qu’elle est disponible. Ce canal est destiné aux environnements non destinés à la production ou à la validation précoce, où le test de nouvelles fonctionnalités et de la fonctionnalité est prioritisé par rapport au temps de validation prolongé.
  • Stable : fournit des versions qui ont effectué une validation et des tests supplémentaires. Ce canal est destiné aux environnements de production et s’aligne généralement sur la version N-1mineure, ce qui garantit une fiabilité plus élevée et résout les problèmes identifiés dans les versions antérieures.

Lorsque le mode FullyManaged est sélectionné, vous pouvez spécifier le canal de mise en production à stable ou rapid. S’il est omis, le canal par défaut est stable.

Important

En mode FullyManaged, Azure Kubernetes Application Network applique les mises à niveau automatiquement à mesure que de nouvelles versions sont promues via des canaux de publication. Le contrôle manuel du minutage de la mise à niveau ou de la sélection de version n’est pas pris en charge.

Vérifier les versions de mise à niveau disponibles pour le mode complètement managé

  • Vérifiez à quelle version chaque canal correspond pour une région donnée et une version Kubernetes, en utilisant la commande az appnet list-versions et en recherchant le mode FullyManaged avec grep.

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

S'inscrire en mode entièrement géré et sélectionner le canal de mise en production lors de l'adhésion d'un membre

  • Inscrivez-vous en mode FullyManaged et sélectionnez un canal de diffusion lors de l'adhésion d'un membre en utilisant la commande az appnet member join avec le paramètre --upgrade-mode FullyManaged et le paramètre --release-channel défini sur le canal souhaité. L’exemple suivant montre comment sélectionner le canal Rapid lors de l'adhésion d'un membre :

    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

Mise à jour de la sélection du canal de mise en production

Vous pouvez mettre à jour votre version sélectionnée à tout moment. Toutes les modifications apportées au canal de mise en production prennent effet immédiatement.

  • Mettez à jour la sélection du canal de distribution pour un membre existant à l’aide de la commande az appnet member update avec le paramètre --release-channel défini sur le canal souhaité. L’exemple suivant montre comment basculer vers le Stable canal d’un membre existant :

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

Contenu connexe

Pour en savoir plus sur Azure Kubernetes Application Network, consultez les articles suivants :

  • Dernière mise à jour :