Mettre à niveau l’hôte AKS dans AKS activé par Arc à l’aide de PowerShell

  • Article

S’applique à : AKS sur Azure Stack HCI 22H2, AKS sur Windows Server

Cet article explique comment mettre à jour l’hôte Azure Kubernetes Service dans AKS activé par Azure Arc.

Vue d’ensemble des mises à jour de l’hôte AKS

Mises à jour à l’hôte AKS incluent toujours la dernière version disponible. Bien que vous puissiez mettre à jour l’hôte indépendamment des mises à jour du cluster de charge de travail, vous devez toujours mettre à jour l’hôte avant de mettre à jour un cluster de charge de travail.

Pour éviter les pannes et la perte de disponibilité d’AKS, des mises à jour propagées sont effectuées. Quand vous introduisez un nouveau nœud avec une build plus récente dans le cluster, les ressources sont déplacées de l’ancien nœud vers le nouveau. Une fois les ressources supprimées, l’ancien nœud est désactivé et supprimé du cluster.

Notes

Microsoft recommande de mettre à niveau vos clusters AKS dans les 30 jours suivant une nouvelle version. Si vous ne mettez pas à jour dans cette fenêtre, vous avez jusqu’à 90 jours à compter de votre dernière mise à niveau avant l’expiration des certificats et jetons internes. Une fois que les certificats et les jetons expirent, le cluster est toujours fonctionnel ; Toutefois, vous devez appeler Support Microsoft pour effectuer la mise à niveau. Lorsque vous redémarrez le cluster après la période de 90 jours, il reste dans un état non fonctionnel. Pour plus d’informations sur les certificats et les jetons internes, consultez la vue d’ensemble de la gestion des certificats.

Mettre à jour l’hôte AKS

La première étape d’un flux de mise à jour consiste à exécuter la commande Update-AksHci pour mettre à jour l’hôte AKS. Update-AksHci n’a pas besoin d’arguments et met toujours à jour le cluster de gestion vers la dernière version. Vous devez lancer cette étape avant d’exécuter Update-AksHciCluster pour mettre à jour le cluster Kubernetes vers une nouvelle version.

Important

La commande de mise à jour ne fonctionne que si vous avez installé la version en disponibilité générale ou ultérieure. Il ne fonctionne pas pour les versions antérieures. Cette commande de mise à jour met à jour l’hôte AKS et la plateforme cloud locale gérée par Microsoft. Cette commande ne met à jour aucun cluster de charges de travail existant. Les nouveaux clusters de charge de travail AKS créés après la mise à jour de l’hôte AKS peuvent différer des clusters de charge de travail AKS existants dans leur version de système d’exploitation et kubernetes.

Nous vous recommandons de mettre à jour les clusters de charge de travail AKS immédiatement après la mise à jour de l'hôte AKS afin de bénéficier des dernières versions du système d'exploitation et des correctifs les plus récents. Si un cluster de charge de travail se trouve sur une version de Kubernetes non prise en charge dans la prochaine version d’AKS Arc, la mise à niveau échoue.

Exemple de flux de mise à jour d’un hôte AKS

Mettre à jour les modules PowerShell

Vérifiez que les derniers modules PowerShell sont toujours installés sur les nœuds AKS en exécutant la commande suivante sur tous les nœuds physiques de votre déploiement AKS.

Important

Fermez toutes les fenêtres PowerShell ouvertes, puis ouvrez une nouvelle session pour exécuter la commande de mise à jour. Si vous ne fermez pas toutes les fenêtres PowerShell, il peut y avoir des modules qui sont en cours d’utilisation et qui ne peuvent pas être mis à jour.

Update-Module -Name AksHci -Force -AcceptLicense

Obtenir la version actuelle d’AKS Arc

Get-AksHciVersion                    

1.0.0.10517

Obtenir les mises à jour AKS Arc disponibles

Get-AksHciUpdates

La sortie montre les versions disponibles vers lesquelles cet hôte AKS peut être mis à jour :

1.0.2.10723

Gestion de version

À l’aide de la version 1.0.2.10723 à titre d’exemple, le tableau suivant montre comment les numéros de version sont construits pour les versions d’AKS Arc.

Valeur Signification
1 Version principale : +1 pour chaque version avec un changement cassant important.
0 Version mineure : +1 pour chaque version après la dernière version majeure avec un changement de fonctionnalité majeur.
2 Fonctionnalités & mises à jour correctives : +1 pour chaque publication régulière (généralement mensuelle) après la dernière version majeure.
1 Type de build : toujours 1 pour les builds publiques.
0723 Date de création de la build : date de création de la build au format mmdd.

Lancer la mise à jour d’AKS Arc

Update-AksHci

Vérifier que l’hôte AKS a été mis à jour

Get-AksHciVersion

La sortie affiche la version mise à jour d’AKS sur l’hôte AKS :

1.0.2.10723

Étapes suivantes