Mettre à niveau l’hôte AKS dans AKS activé par Arc à l’aide de PowerShell
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
Les mises à jour de 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é AKS, les 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.
Remarque
Microsoft recommande de mettre à niveau vos clusters AKS dans les 30 jours suivant une nouvelle version. Si vous ne procédez pas à la mise à jour dans cette fenêtre, vous avez jusqu’à 90 jours à partir de votre dernière mise à niveau avant l’expiration des certificats et des jetons internes. Une fois les certificats et les jetons expirés, le cluster est toujours fonctionnel ; Toutefois, vous devez appeler Support Microsoft pour effectuer une 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 jetons internes, consultez la vue d’ensemble de la gestion des certificats.
Mettre à jour l’hôte AKS
La première étape de tout 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. Elle 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 du système d’exploitation et la version 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 Kubernetes non prise en charge dans la prochaine version d’AKS Arc, la mise à niveau échoue.
Exemple de flux pour la 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 affiche les versions disponibles auxquelles cet hôte AKS peut être mis à jour :
1.0.2.10723
Contrôle de version
À l’aide de la version 1.0.2.10723 comme exemple, le tableau suivant montre comment les numéros de version sont construits pour les versions d’AKS Arc.
| Valeur | Signification |
|---|---|
| 1 | Version majeure : +1 pour chaque version avec un changement cassant important. |
| 0 | Version mineure : +1 pour chaque version après la dernière version majeure avec une modification majeure des fonctionnalités. |
| 2 | Mises à jour des fonctionnalités et correctifs : +1 pour chaque version 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 build : date de création de build au format mmdd. |
Lancer la mise à jour 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