Notes de publication pour le moteur AKS sur Azure Stack Hub
S’applique à la version v0.80.2 du moteur AKS.
Cet article décrit le contenu du moteur Azure Kubernetes Service (AKS) sur la mise à jour d’Azure Stack Hub. La mise à jour inclut des améliorations et des correctifs pour la dernière version du moteur AKS ciblé sur la plateforme Azure Stack Hub. Cet article n’est pas destiné à documenter les informations de publication du moteur AKS pour Azure global.
Considérations de mise à niveau
- Utilisez-vous les éléments de la Place de marché appropriés, la distribution d’images AKS Base Ubuntu 20.04 ou AKS Base Windows Server pour votre version du moteur AKS ? Vous trouverez les versions à la section Télécharger de nouvelles images et le moteur AKS.
- Utilisez-vous la spécification de cluster correcte (apimodel.json) et le groupe de ressources pour le cluster cible ? Quand vous avez initialement déployé le cluster, ce fichier a été généré dans votre répertoire de sortie. Consultez les paramètres de la commande de déploiement dans Déployer un cluster Kubernetes.
- Utilisez-vous une machine fiable pour exécuter le moteur AKS et à partir de laquelle vous effectuez les opérations de mise à niveau ?
- Si vous mettez à jour un cluster opérationnel avec des charges de travail actives, vous pouvez appliquer la mise à niveau sans les affecter, en supposant que le cluster se trouve dans des conditions de charge normale. Toutefois, vous devez disposer d’un cluster de sauvegarde s’il s’avère nécessaire de rediriger les utilisateurs vers celui-ci. Un cluster de sauvegarde est fortement recommandé.
- Si possible, exécutez la commande à partir d’une machine virtuelle au sein de l’environnement Azure Stack Hub pour réduire les tronçons réseau et les échecs de connectivité potentiels.
- Vérifiez que votre abonnement dispose d’un quota suffisant pour l’ensemble du processus. De nouvelles machines virtuelles sont allouées pendant le processus. Le nombre de machines virtuelles résultant est identique à l’original, mais planifiez la création de quelques machines virtuelles supplémentaires pendant le processus.
- Aucune mise à jour système ni tâche planifiée ne sont prévues.
- Configurez une mise à niveau intermédiaire sur un cluster configuré avec les mêmes valeurs que le cluster de production et testez-y la mise à niveau avant de l’appliquer à votre cluster de production.
Utiliser la commande de mise à niveau
Vous devez utiliser la aks-engine upgrade commande comme décrit dans Mettre à niveau un cluster Kubernetes sur Azure Stack Hub.
Interruptions de la mise à niveau
Parfois, des facteurs inattendus interrompent la mise à niveau du cluster. Une interruption peut se produire lorsque le moteur AKS signale une erreur ou qu’un problème se produit dans le processus d’exécution du moteur AKS. Examinez la cause de l’interruption, résolvez-la et soumettez à nouveau la même upgrade commande pour poursuivre le processus de mise à niveau. La upgrade commande est idempotente et doit reprendre la mise à niveau du cluster une fois que vous renvoyez la commande. Normalement, les interruptions augmentent le temps nécessaire pour terminer la mise à jour, mais ne doivent pas affecter sa fin.
Durée de mise à niveau estimée
La durée de mise à niveau estimée est de 12 à 15 minutes par machine virtuelle dans le cluster. Par exemple, un cluster à 20 nœuds peut prendre environ 5 heures pour effectuer une mise à niveau.
Instructions pour utiliser le moteur AKS 0.70.0 et versions ultérieures
Télécharger une nouvelle image et le moteur AKS
Téléchargez les nouvelles versions de l’image Ubuntu de base AKS et du moteur AKS.
Comme expliqué dans la documentation relative au moteur AKS pour Azure Stack Hub, le déploiement d’un cluster Kubernetes nécessite :
- Binaire aks-engine (obligatoire).
- Distribution d’images Ubuntu 16.04-LTS de base AKS (déconseillée - ne plus utiliser, modifier le modèle d’API pour utiliser 20.04 à la place).
- Distribution d’images Ubuntu 18.04-LTS de base AKS (déconseillée - ne plus utiliser, modifier le modèle d’API pour utiliser 20.04 à la place).
- Distribution d’images Ubuntu 20.04-LTS de base AKS (obligatoire pour les agents Linux).
- Image Windows Server de base AKS (l’une des images suivantes est requise pour les agents Windows) :
- Conteneur d’images Windows Server de base AKS.
- Docker d’image Windows Server de base AKS.
Les nouvelles versions de ces images sont disponibles avec cette mise à jour :
Vérifiez le moteur AKS et la table de mappage de version Azure Stack pour connaître les images de base AKS requises.
Suivez les instructions fournies dans Ajouter les prérequis du moteur Azure Kubernetes Services (AKS) à la Place de marché Azure Stack Hub.
L’administrateur de cluster Kubernetes (normalement un utilisateur locataire d’Azure Stack Hub) doit télécharger le nouveau moteur aks-engine. Consultez les instructions de l’article Installer le moteur AKS sur Linux dans Azure Stack Hub (ou article Windows équivalent). Vous pouvez suivre le même processus que celui que vous avez utilisé pour installer le cluster pour la première fois. La mise à jour remplace le binaire précédent. Par exemple, si vous avez utilisé le script get-akse.sh , suivez les mêmes étapes décrites dans Installer dans un environnement connecté. Le même processus s’applique si vous installez sur un système Windows : installez le moteur AKS sur Windows dans Azure Stack Hub.
Mise à niveau de clusters Kubernetes créés avec la distribution Ubuntu 16.04
À compter d’AKS Engine v0.63.0, la distribution Ubuntu 16.04 n’est plus une option prise en charge, car le système d’exploitation a atteint sa fin de vie. Pour AKS Engine v0.67.0 ou versions ultérieures, la mise à niveau aks-engine remplace automatiquement la valeur de distribution non prise en charge aks-ubuntu-16.04 avec aks-ubuntu-18.04. Pour AKS Engine v0.75.3 ou versions ultérieures, si vous utilisez Kubernetes v1.24 ou version ultérieure, la mise à niveau aks-engine-azurestack remplace automatiquement la valeur de distribution non prise en charge aks-ubuntu-16.04 avec aks-ubuntu-20.04.
Mise à niveau des clusters Kubernetes créés avec la distribution Ubuntu 18.04
À compter d’AKS Engine v0.75.3, la distribution Ubuntu 18.04 n’est plus une option prise en charge, car le système d’exploitation a atteint sa fin de vie. Pour AKS Engine v0.75.3 ou versions ultérieures, la mise à niveau aks-engine-azurestack remplace automatiquement la valeur de distribution non prise en charge aks-ubuntu-18.04 avec aks-ubuntu-20.04.
Mise à niveau des clusters Kubernetes créés avec le runtime de conteneur Docker
Dans Kubernetes v1.24, le composant dockershim a été supprimé de kubelet. Par conséquent, le runtime de conteneur Docker n’est plus une option prise en charge. Pour plus d’informations, consultez les notes de publication de Kubernetes v1.24. Pour AKS Engine v0.75.3 ou versions ultérieures, la mise à niveau aks-engine-azurestack remplace automatiquement la valeur non prise en docker containerRuntime charge par containerd.
Pour AKS Engine version v0.75.3, les clusters avec des nœuds Windows sur Kubernetes v1.23 peuvent utiliser l’image de base Windows avec le runtime Docker. Les clusters avec des nœuds Windows sur Kubernetes v1.24 peuvent utiliser l’image de base Windows avec le runtime Containerd.
Mappage des versions du moteur AKS avec celles d’Azure Stack
| Version d’Azure Stack Hub | Version du moteur 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* |
| 2406 | 0.80.2*, 0.81.1* |
| 2408 | 0.80.2*, 0.81.1* |
Remarque
Pris en charge.* Pour plus d’informations, consultez la stratégie de prise en charge des versions du moteur AKS.
Moteur AKS et mappage d’image correspondant
Vous trouverez les versions de Kubernetes prises en charge pour le moteur AKS sur Azure Stack Hub dans le tableau suivant. N’utilisez pas la commande aks-engine get-versions , qui retourne les versions prises en charge dans Azure global et dans Azure Stack Hub.
Remarque
*À partir de Kubernetes v1.21, seul le fournisseur de cloud pour Azure est pris en charge sur Azure Stack Hub.
Remarque
** À partir de Kubernetes v1.24, seul le runtime de containerd conteneur est pris en charge. Pour plus d’informations, consultez la section Mise à niveau des clusters Kubernetes créés avec le runtime de conteneur Docker.
Planification des mises à jour
La commande du moteur upgrade AKS automatise entièrement le processus de mise à niveau de votre cluster et gère les machines virtuelles, la mise en réseau, le stockage, Kubernetes et les tâches d’orchestration. Avant d’appliquer la mise à jour, veillez à consulter les informations contenues dans la note de publication.
Nouveautés d’AKSe 0.76.0
- Ajout de la prise en charge de Kubernetes v1.24.11 et v1.25.7.
- Vous trouverez d’autres fonctionnalités sur la page GitHub v0.76.0.
Nouveautés d’AKSe 0.75.3 et versions ultérieures
AkS Engine version v0.75.3 et toutes les futures versions du moteur AKS sur Azure Stack Hub seront issues du nouveau référentiel aks-engine-azurestack. Par conséquent, toutes les aks-engine commandes doivent être remplacées par aks-engine-azurestack. Les commandes permettant d’obtenir la dernière version du moteur AKS sur Azure Stack Hub ont également changé. Vous pouvez voir les nouvelles commandes dans Créer un client Linux et créer un client Windows. Créez un problème dans le nouveau dépôt si vous rencontrez des problèmes.
AkS Engine version v0.75.3 sur Azure Stack Hub offre Ubuntu 20.04 LTS comme image de base Linux. À compter de cette version, Ubuntu 18.04 n’est plus pris en charge. Pour plus d’informations, consultez La mise à niveau des clusters Kubernetes créés avec la distribution Ubuntu 18.04.
À partir de Kubernetes v1.24, seul le containerd runtime est pris en charge. Pour plus d’informations, consultez Mise à niveau des clusters Kubernetes créés avec le runtime Docker. Pour AKS Engine version v0.75.3, les clusters avec des nœuds Windows sur Kubernetes v1.23 peuvent utiliser l’image de base Windows avec le runtime Docker. Les clusters avec des nœuds Windows sur Kubernetes v1.24 peuvent utiliser l’image de base Windows avec le runtime Containerd.
Vous trouverez plus de fonctionnalités sur la page GitHub v0.75.3.
Instructions pour utiliser le moteur AKS 0.70.0 et versions ultérieures
Microsoft a mis à niveau le fournisseur de cloud Azure dans la version 0.70.0. Le fournisseur de cloud Azure est un composant principal partagé entre AKS Azure et le moteur AKS sur Azure Stack Hub.
Pour utiliser le moteur AKS 0.70.0 et versions ultérieures :
Si vous tentez de créer un cluster Kubernetes pour la première fois : utilisez l’exemple de modèle d’API fourni pour la version appropriée dans le moteur AKS et la table de mappage d’images correspondante.
Si vous créez un cluster, mais que vous souhaitez utiliser votre modèle d’API existant : modifiez votre modèle d’API en suivant les instructions du fournisseur de cloud pour Azure . L’échec de l’ajout du nouveau paramètre entraîne une erreur de déploiement.
Si vous utilisez des volumes de stockage : vérifiez que vous utilisez le pilote AzureDiskCSI . La version 0.70.0 et ultérieure prend uniquement en charge les pilotes CSI, et non le fournisseur de stockage dans l’arborescence hérité. Pour effectuer une mise à niveau, suivez les instructions de mise à niveau lors de l’utilisation de volumes de stockage.
Problèmes connus
- Le déploiement de plusieurs services Kubernetes en parallèle à l’intérieur d’un même cluster peut entraîner une erreur dans la configuration de l’équilibreur de charge de base. Nous vous recommandons de déployer un service à la fois.
- Étant donné que l’outil aks-engine est un référentiel de code source partagé sur Azure et Azure Stack Hub, l’examen des nombreuses notes de publication et demandes de tirage peut vous conduire à croire que l’outil prend en charge d’autres versions de Kubernetes et de la plateforme du système d’exploitation au-delà de celles précédemment répertoriées. Vous pouvez les ignorer et utiliser le tableau de versions ci-dessus comme guide officiel pour cette mise à jour.
- AkS Engine v0.67.0 utilise l’image Windows incorrecte lors du déploiement de clusters Windows. Utilisez v0.70.0 pour résoudre ce problème.
Référence
La liste suivante est l’ensemble complet de notes de publication pour Azure et Azure Stack Hub combinés :
- 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
- https://github.com/Azure/aks-engine-azurestack/releases/tag/v0.80.2
S’applique à la version v0.67.0 du moteur AKS.
Cet article décrit le contenu du moteur Azure Kubernetes Service (AKS) sur la mise à jour d’Azure Stack Hub. La mise à jour inclut des améliorations et des correctifs pour la dernière version du moteur AKS ciblé sur la plateforme Azure Stack Hub. Cet article n’est pas destiné à documenter les informations de publication du moteur AKS pour Azure global.
Planification des mises à jour
La commande du moteur upgrade AKS automatise entièrement le processus de mise à niveau de votre cluster. Il gère les machines virtuelles, la mise en réseau, le stockage, Kubernetes et les tâches d’orchestration. Avant d’appliquer la mise à jour, veillez à consulter les informations contenues dans la note de publication.
Considérations de mise à niveau
- Utilisez-vous les éléments de la Place de marché appropriés, AKS Base Ubuntu 16.04-LTS ou 18.04 Image Distro ou AKS Base Windows Server pour votre version du moteur AKS ? Vous trouverez les versions à la section « Télécharger de nouvelles images et le moteur AKS ».
- Utilisez-vous la spécification de cluster correcte (apimodel.json) et le groupe de ressources pour le cluster cible ? Quand vous avez initialement déployé le cluster, ce fichier a été généré dans votre répertoire de sortie. Consultez les paramètres de la commande de déploiement dans Déployer un cluster Kubernetes.
- Utilisez-vous une machine fiable pour exécuter le moteur AKS et à partir de laquelle vous effectuez des opérations de mise à niveau ?
- Si vous mettez à jour un cluster opérationnel avec des charges de travail actives, vous pouvez appliquer la mise à niveau sans les affecter, en supposant que le cluster se trouve dans des conditions de charge normale. Toutefois, vous devez disposer d’un cluster de sauvegarde s’il s’avère nécessaire de rediriger les utilisateurs vers celui-ci. Un cluster de sauvegarde est fortement recommandé.
- Si possible, exécutez la commande à partir d’une machine virtuelle au sein de l’environnement Azure Stack Hub pour réduire les tronçons réseau et les échecs de connectivité potentiels.
- Vérifiez que votre abonnement dispose d’un quota suffisant pour l’ensemble du processus. De nouvelles machines virtuelles sont allouées pendant le processus. Le nombre de machines virtuelles résultant est identique à l’original, mais planifiez la création de quelques machines virtuelles supplémentaires pendant le processus.
- Aucune mise à jour système ni tâche planifiée ne sont prévues.
- Configurez une mise à niveau intermédiaire sur un cluster configuré avec les mêmes valeurs que le cluster de production et testez-y la mise à niveau avant de l’appliquer à votre cluster de production.
Utiliser la commande de mise à niveau
Vous devez utiliser la aks-engine upgrade commande comme décrit dans Mettre à niveau un cluster Kubernetes sur Azure Stack Hub.
Interruptions de la mise à niveau
Parfois, des facteurs inattendus interrompent la mise à niveau du cluster. Une interruption peut se produire lorsque le moteur AKS signale une erreur ou qu’un problème se produit dans le processus d’exécution du moteur AKS. Examinez la cause de l’interruption, résolvez-la et soumettez à nouveau la même upgrade commande pour poursuivre le processus de mise à niveau. La upgrade commande est idempotente et doit reprendre la mise à niveau du cluster une fois que vous renvoyez la commande. Normalement, les interruptions augmentent le temps nécessaire pour terminer la mise à jour, mais ne doivent pas affecter sa fin.
Durée de mise à niveau estimée
La durée de mise à niveau estimée est de 12 à 15 minutes par machine virtuelle dans le cluster. Par exemple, un cluster à 20 nœuds peut prendre environ 5 heures pour effectuer une mise à niveau.
Télécharger une nouvelle image et le moteur AKS
Téléchargez les nouvelles versions de l’image Ubuntu de base AKS et du moteur AKS.
Comme expliqué dans la documentation relative au moteur AKS pour Azure Stack Hub, le déploiement d’un cluster Kubernetes nécessite :
- Binaire aks-engine (obligatoire).
- Distribution d’images Ubuntu 16.04-LTS de base AKS (déconseillée - ne plus utiliser, modifier le modèle d’API pour utiliser 18.04 à la place).
- Distribution d’images Ubuntu 18.04-LTS de base AKS (obligatoire pour les agents Linux).
- Distribution d’images Windows Server de base AKS (obligatoire pour les agents Windows).
Les nouvelles versions de ces images sont disponibles avec cette mise à jour :
Vérifiez le moteur AKS et la table de mappage de version Azure Stack pour connaître les images de base AKS requises.
Suivez les instructions fournies dans Ajouter les prérequis du moteur Azure Kubernetes Services (AKS) à la Place de marché Azure Stack Hub.
L’administrateur de cluster Kubernetes (normalement un utilisateur locataire d’Azure Stack Hub) doit télécharger le nouveau moteur aks-engine. Consultez les instructions de l’article Installer le moteur AKS sur Linux dans Azure Stack Hub (ou article Windows équivalent). Vous pouvez suivre le même processus que celui que vous avez utilisé pour installer le cluster pour la première fois. La mise à jour remplace le binaire précédent. Par exemple, si vous avez utilisé le script get-akse.sh , suivez les mêmes étapes décrites dans Installer dans un environnement connecté. Le même processus s’applique si vous installez sur un système Windows : installez le moteur AKS sur Windows dans Azure Stack Hub.
Mise à niveau de clusters Kubernetes créés avec la distribution Ubuntu 16.04
À compter du moteur AKS v0.67.0, la distribution Ubuntu 16.04 n’est plus une option prise en charge, car le système d’exploitation a atteint sa fin de vie. Pour mettre à niveau un cluster, veillez à définir la distribution aks-ubuntu-18.04 du système d’exploitation sur votre modèle d’API d’entrée, celle générée par aks-engine deploy et passée en tant qu’entrée à aks-engine upgrade:
"masterProfile": {
"distro": "aks-ubuntu-18.04"
},
"agentPoolProfiles": [{
"distro": "aks-ubuntu-18.04"
}]
Mappage des versions du moteur AKS avec celles d’Azure Stack
| Version d’Azure Stack Hub | Version du moteur 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 |
Chemin de mise à niveau de la version de Kubernetes dans le moteur AKS v0.67.0
Vous trouverez la version actuelle et la version de mise à niveau pour Azure Stack Hub dans le tableau suivant. Ce tableau s’applique au cluster de moteur AKS dans Azure Stack Hub. N’utilisez pas la commande aks-engine get-versions , qui retourne les versions prises en charge dans Azure global et dans Azure Stack Hub.
| Version actuelle | Mise à niveau 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 |
Dans le fichier JSON du modèle d’API, spécifiez les valeurs de version et de mise en production sous la orchestratorProfile section. Par exemple, si vous envisagez de déployer Kubernetes 1.17.17, les deux valeurs suivantes doivent être définies (voir l’exemple kubernetes-azurestack.json) :
- "orchestratorRelease": "1.17",
- "orchestratorVersion": "1.17.17"
Moteur AKS et mappage d’image correspondant
| Moteur AKS | Image de base AKS | Version de Kubernetes | Échantillon de modèles d’API |
|---|---|---|---|
| v0.43.1 | AKS Base Ubuntu 16.04-LTS Image Distro, octobre 2019 (2019.10.24) | 1.15.5, 1.15.4, 1.14.8, 1.14.7 | |
| v0.48.0 | AKS Base Ubuntu 16.04-LTS Image Distro, mars 2020 (2020.03.19) | 1.15.10, 1.14.7 | |
| v0.51.0 | AKS Base Ubuntu 16.04-LTS Image Distro, mai 2020 (13/05/2020), AKS Base Windows Image (17763.1217.200513) | 1.15.12, 1.16.8, 1.16.9 | Linux, Windows |
| v0.55.0 | AKS Base Ubuntu 16.04-LTS Image Distro, août 2020 (24/08/2020), AKS Base Windows Image (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
| v0.55.4 | AKS Base Ubuntu 16.04-LTS Image Distro, septembre 2020 (14/09/2020), AKS Base Windows Image (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
| V0.60.1 | Distribution d’images Ubuntu 16.04-LTS de base AKS, janvier 2021 (2021.01.28), Distribution d’images Ubuntu 18.04-LTS de base AKS, 2021 Q1 (2021.01.28), Image de base Windows AKS (17763.1697.210129) |
1.16.14, 1.16.15, 1.17.17, 1.18.15 | Linux, Windows |
| v0.63.0 | AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q2 (24.05.2021), AKS Base Windows Image (17763.1935.210520) | 1.18.18, 1.19.10, 1.20.6 | Exemples de modèles d’API (Linux, Windows) |
| v0.67.0 | AKS Base Ubuntu 18.04-LTS Image Distro, 2021 Q3 (27.09.2021), AKS Base Windows Image (17763.2213.210927) | 1.19.15, 1.20.11 | Exemples de modèles d’API (Linux, Windows) |
Nouveautés
Si vous souhaitez participer à une préversion privée, vous pouvez demander un accès en préversion.
Nouvelles fonctionnalités :
- Support pour Kubernetes 1.19.15 et 1.20.11.
Problèmes connus
- Le déploiement de plusieurs services Kubernetes en parallèle à l’intérieur d’un même cluster peut entraîner une erreur dans la configuration de l’équilibreur de charge de base. Nous vous recommandons de déployer un service à la fois.
- Étant donné que l’outil aks-engine est un référentiel de code source partagé sur Azure et Azure Stack Hub, l’examen des nombreuses notes de publication et demandes de tirage peut vous conduire à croire que l’outil prend en charge d’autres versions de Kubernetes et de la plateforme du système d’exploitation au-delà de celles précédemment répertoriées. Vous pouvez les ignorer et utiliser le tableau de versions ci-dessus comme guide officiel pour cette mise à jour.
Référence
La liste suivante est l’ensemble complet de notes de publication pour Azure et Azure Stack Hub combinés :
- 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
S’applique à la version v0.60.1 du moteur AKS.
Cet article décrit le contenu du moteur Azure Kubernetes Service (AKS) sur la mise à jour d’Azure Stack Hub. La mise à jour inclut des améliorations et des correctifs pour la dernière version du moteur AKS ciblé sur la plateforme Azure Stack Hub. Cet article n’est pas destiné à documenter les informations de publication du moteur AKS pour Azure global.
Planification des mises à jour
La commande du moteur upgrade AKS automatise entièrement le processus de mise à niveau de votre cluster et gère les machines virtuelles, la mise en réseau, le stockage, Kubernetes et les tâches d’orchestration. Avant d’appliquer la mise à jour, veillez à consulter les informations contenues dans la note de publication.
Considérations de mise à niveau
- Utilisez-vous les éléments de la Place de marché appropriés, AKS Base Ubuntu 16.04-LTS ou 18.04 Image Distro ou AKS Base Windows Server pour votre version du moteur AKS ? Vous trouverez les versions à la section « Télécharger de nouvelles images et le moteur AKS ».
- Utilisez-vous la spécification de cluster correcte (apimodel.json) et le groupe de ressources pour le cluster cible ? Quand vous avez initialement déployé le cluster, ce fichier a été généré dans votre répertoire de sortie. Consultez les paramètres de la commande de déploiement dans Déployer un cluster Kubernetes.
- Utilisez-vous une machine fiable pour exécuter le moteur AKS et à partir de laquelle vous effectuez des opérations de mise à niveau ?
- Si vous mettez à jour un cluster opérationnel avec des charges de travail actives, vous pouvez appliquer la mise à niveau sans les affecter, en supposant que le cluster se trouve dans des conditions de charge normale. Toutefois, vous devez disposer d’un cluster de sauvegarde s’il s’avère nécessaire de rediriger les utilisateurs vers celui-ci. Un cluster de sauvegarde est fortement recommandé.
- Si possible, exécutez la commande à partir d’une machine virtuelle au sein de l’environnement Azure Stack Hub pour réduire les tronçons réseau et les échecs de connectivité potentiels.
- Vérifiez que votre abonnement dispose d’un quota suffisant pour l’ensemble du processus. De nouvelles machines virtuelles sont allouées pendant le processus. Le nombre de machines virtuelles résultant est identique à l’original, mais planifiez la création de quelques machines virtuelles supplémentaires pendant le processus.
- Aucune mise à jour système ni tâche planifiée ne sont prévues.
- Configurez une mise à niveau intermédiaire sur un cluster configuré avec les mêmes valeurs que le cluster de production et testez-y la mise à niveau avant de l’appliquer à votre cluster de production.
Utiliser la commande de mise à niveau
Vous devez utiliser la aks-engine upgrade commande comme décrit dans Mettre à niveau un cluster Kubernetes sur Azure Stack Hub.
Interruptions de la mise à niveau
Parfois, des facteurs inattendus interrompent la mise à niveau du cluster. Une interruption peut se produire lorsque le moteur AKS signale une erreur ou qu’un problème se produit dans le processus d’exécution du moteur AKS. Examinez la cause de l’interruption, résolvez-la et soumettez à nouveau la même upgrade commande pour poursuivre le processus de mise à niveau. La upgrade commande est idempotente et doit reprendre la mise à niveau du cluster une fois que vous renvoyez la commande. Normalement, les interruptions augmentent le temps nécessaire pour terminer la mise à jour, mais ne doivent pas affecter sa fin.
Durée de mise à niveau estimée
La durée de mise à niveau estimée est de 12 à 15 minutes par machine virtuelle dans le cluster. Par exemple, une mise à niveau d’un cluster à 20 nœuds peut prendre environ 5 heures.
Télécharger une nouvelle image et le moteur AKS
Téléchargez les nouvelles versions de l’image Ubuntu de base AKS et du moteur AKS.
Comme expliqué dans la documentation du moteur AKS sur Azure Stack Hub, le déploiement d’un cluster Kubernetes nécessite :
- Binaire aks-engine (obligatoire).
- Distribution d’images Ubuntu 16.04-LTS de base AKS (déconseillée - ne plus utiliser, modifier le modèle d’API pour utiliser 18.04 à la place).
- Distribution d’images Ubuntu 18.04-LTS de base AKS (obligatoire pour les agents Linux).
- Distribution d’images Windows Server de base AKS (obligatoire pour les agents Windows).
Les nouvelles versions de ces composants sont disponibles avec cette mise à jour :
L’opérateur Azure Stack Hub doit télécharger les nouvelles images AKS Base dans la Place de marché de tampons :
AKS base Ubuntu 16.04-LTS Image Distro, janvier 2021 (28/01/2021)
AKS Base Ubuntu 18.04-LTS Image Distro, 1er trimestre de 2021 (28/01/2021),
Image de base Windows AKS (17763.1697.210129)
Suivez les instructions fournies dans Ajouter les prérequis du moteur Azure Kubernetes Services (AKS) à la Place de marché Azure Stack Hub.
L’administrateur de cluster Kubernetes (normalement un utilisateur locataire d’Azure Stack Hub) doit télécharger le nouveau moteur aks-engine. Consultez les instructions de l’article Installer le moteur AKS sur Linux dans Azure Stack Hub (ou article Windows équivalent). Vous pouvez suivre le même processus que celui que vous avez utilisé pour installer le cluster pour la première fois. La mise à jour remplace le binaire précédent. Par exemple, si vous avez utilisé le script get-akse.sh , suivez les mêmes étapes décrites dans Installer dans un environnement connecté. Le même processus s’applique si vous installez sur un système Windows : installez le moteur AKS sur Windows dans Azure Stack Hub.
Mappage des versions du moteur AKS avec celles d’Azure Stack
| Version d’Azure Stack Hub | Version du moteur 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 |
Chemin de mise à niveau de la version de Kubernetes dans le moteur AKS v0.60.1
Vous trouverez la version actuelle et la version de mise à niveau pour Azure Stack Hub dans le tableau suivant. Ce tableau s’applique au cluster de moteur AKS dans Azure Stack Hub. N’utilisez pas la commande aks-engine get-versions , qui retourne les versions prises en charge dans Azure global et dans Azure Stack Hub.
| Version actuelle | Mise à niveau 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 |
Dans le fichier JSON du modèle d’API, spécifiez les valeurs de version et de mise en production sous la orchestratorProfile section. Par exemple, si vous envisagez de déployer Kubernetes 1.17.17, les deux valeurs suivantes doivent être définies (voir l’exemple kubernetes-azurestack.json) :
- "orchestratorRelease": "1.17",
- "orchestratorVersion": "1.17.17"
Moteur AKS et mappage d’image correspondant
| Moteur AKS | Image de base AKS | Version de Kubernetes | Échantillon de modèles d’API |
|---|---|---|---|
| v0.43.1 | AKS Base Ubuntu 16.04-LTS Image Distro, octobre 2019 (2019.10.24) | 1.15.5, 1.15.4, 1.14.8, 1.14.7 | |
| v0.48.0 | AKS Base Ubuntu 16.04-LTS Image Distro, mars 2020 (2020.03.19) | 1.15.10, 1.14.7 | |
| v0.51.0 | AKS Base Ubuntu 16.04-LTS Image Distro, mai 2020 (13/05/2020), AKS Base Windows Image (17763.1217.200513) | 1.15.12, 1.16.8, 1.16.9 | Linux, Windows |
| v0.55.0 | AKS Base Ubuntu 16.04-LTS Image Distro, août 2020 (24/08/2020), AKS Base Windows Image (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
| v0.55.4 | AKS Base Ubuntu 16.04-LTS Image Distro, septembre 2020 (14/09/2020), AKS Base Windows Image (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
| V0.60.1 | Distribution d’images Ubuntu 16.04-LTS de base AKS, janvier 2021 (2021.01.28), Distribution d’images Ubuntu 18.04-LTS de base AKS, 2021 Q1 (2021.01.28), Image de base Windows AKS (17763.1697.210129) |
1.16.14, 1.16.15, 1.17.17, 1.18.15 | Linux, Windows |
Nouveautés
Si vous souhaitez participer à une préversion privée, vous pouvez demander un accès en préversion.
Nouvelles fonctionnalités :
- Disponibilité générale d’Ubuntu 18.04.
- Préversion publique de rotation des certificats #4214.
- T4 Nvidia GPU Private Preview #4259.
- Préversion privée de l’intégration d’Azure Active Directory.
- Pilote CSI pour les objets blob Azure Préversion privée #712.
- Csi Driver Azure Disks Public Preview #712.
- Csi Driver NFS Public Preview #712.
- Prise en charge de Kubernetes 1. 17.17 #4188 et 1.18.15 #4187.
Problèmes connus
- Le déploiement de plusieurs services Kubernetes en parallèle à l’intérieur d’un même cluster peut entraîner une erreur dans la configuration de l’équilibreur de charge de base. Nous vous recommandons de déployer un service à la fois.
- Étant donné que l’outil aks-engine est un référentiel de code source partagé sur Azure et Azure Stack Hub, l’examen des nombreuses notes de publication et demandes de tirage peut vous conduire à croire que l’outil prend en charge d’autres versions de Kubernetes et de la plateforme du système d’exploitation au-delà de celles précédemment répertoriées. Vous pouvez les ignorer et utiliser le tableau de versions ci-dessus comme guide officiel pour cette mise à jour.
Référence
La liste suivante est l’ensemble complet de notes de publication pour Azure et Azure Stack Hub combinés :
S’applique à la version v0.55.4 du moteur AKS.
Cet article décrit le contenu du moteur Azure Kubernetes Service (AKS) sur la mise à jour d’Azure Stack Hub. La mise à jour inclut des améliorations et des correctifs pour la dernière version du moteur AKS ciblé sur la plateforme Azure Stack Hub. Cet article n’est pas destiné à documenter les informations de publication du moteur AKS pour Azure global.
Planification des mises à jour
La commande du moteur upgrade AKS automatise entièrement le processus de mise à niveau de votre cluster et gère les machines virtuelles, la mise en réseau, le stockage, Kubernetes et les tâches d’orchestration. Avant d’appliquer la mise à jour, veillez à consulter les informations contenues dans la note de publication.
Considérations de mise à niveau
- Utilisez-vous l’élément de place de marché approprié, AKS Base Ubuntu 16.04-LTS Image Distro pour votre version du moteur AKS ? Vous trouverez les versions dans la section « Télécharger une nouvelle image et le moteur AKS ».
- Utilisez-vous la spécification de cluster correcte (apimodel.json) et le groupe de ressources pour le cluster cible ? Quand vous avez initialement déployé le cluster, ce fichier a été généré dans votre répertoire de sortie. Consultez les paramètres de la commande de déploiement dans Déployer un cluster Kubernetes.
- Utilisez-vous une machine fiable pour exécuter le moteur AKS et à partir de laquelle vous effectuez les opérations de mise à niveau ?
- Si vous mettez à jour un cluster opérationnel avec des charges de travail actives, vous pouvez appliquer la mise à niveau sans les affecter, en supposant que le cluster se trouve dans des conditions de charge normale. Toutefois, vous devez disposer d’un cluster de sauvegarde s’il s’avère nécessaire de rediriger les utilisateurs vers celui-ci. Un cluster de sauvegarde est fortement recommandé.
- Si possible, exécutez la commande à partir d’une machine virtuelle au sein de l’environnement Azure Stack Hub pour réduire les tronçons réseau et les échecs de connectivité potentiels.
- Vérifiez que votre abonnement dispose d’un quota suffisant pour l’ensemble du processus. De nouvelles machines virtuelles sont allouées pendant le processus. Le nombre de machines virtuelles résultant est identique à l’original, mais planifiez la création de quelques machines virtuelles supplémentaires pendant le processus.
- Aucune mise à jour système ni tâche planifiée ne sont prévues.
- Configurez une mise à niveau intermédiaire sur un cluster configuré avec les mêmes valeurs que le cluster de production et testez-y la mise à niveau avant de l’appliquer à votre cluster de production.
Utiliser la commande de mise à niveau
Vous devez utiliser la aks-engine upgrade commande comme décrit dans Mettre à niveau un cluster Kubernetes sur Azure Stack Hub.
Interruptions de la mise à niveau
Parfois, des facteurs inattendus interrompent la mise à niveau du cluster. Une interruption peut se produire lorsque le moteur AKS signale une erreur ou qu’un problème se produit dans le processus d’exécution du moteur AKS. Examinez la cause de l’interruption, résolvez-la et soumettez à nouveau la même upgrade commande pour poursuivre le processus de mise à niveau. La upgrade commande est idempotente et doit reprendre la mise à niveau du cluster une fois que vous renvoyez la commande. Normalement, les interruptions augmentent le temps nécessaire pour terminer la mise à jour, mais ne doivent pas affecter sa fin.
Durée de mise à niveau estimée
La durée de mise à niveau estimée est de 12 à 15 minutes par machine virtuelle dans le cluster. Par exemple, une mise à niveau d’un cluster à 20 nœuds peut prendre environ 5 heures.
Télécharger une nouvelle image et le moteur AKS
Téléchargez les nouvelles versions de l’image de base Ubuntu AKS et du moteur AKS.
Comme expliqué dans la documentation du moteur AKS sur Azure Stack Hub, le déploiement d’un cluster Kubernetes nécessite deux composants principaux :
- Binaire aks-engine (obligatoire).
- Distribution d’images de base AKS Ubuntu 16.04-LTS
Les nouvelles versions de ces images sont disponibles avec cette mise à jour :
L’opérateur Azure Stack Hub doit télécharger une nouvelle image Ubuntu de base AKS dans la Place de marché des tampons :
Nom : Distribution d’images Ubuntu 16.04-LTS de base AKS, septembre 2020 (2020.09.14)
Version : 2020.09.14
Suivez les instructions fournies dans Ajouter les prérequis du moteur Azure Kubernetes Services (AKS) à la Place de marché Azure Stack Hub.
L’administrateur de cluster Kubernetes (normalement un utilisateur locataire d’Azure Stack Hub) doit télécharger le nouveau moteur aks-engine. Consultez les instructions de l’article Installer le moteur AKS sur Linux dans Azure Stack Hub (ou article Windows équivalent). Vous pouvez suivre le même processus que celui que vous avez utilisé pour installer le cluster pour la première fois. La mise à jour remplace le binaire précédent. Par exemple, si vous avez utilisé le script get-akse.sh , suivez les mêmes étapes décrites dans Installer dans un environnement connecté. Le même processus s’applique si vous installez sur un système Windows : installez le moteur AKS sur Windows dans Azure Stack Hub.
Mappage des versions du moteur AKS avec celles d’Azure Stack
| Version d’Azure Stack Hub | Version du moteur 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 |
Chemin de mise à niveau de la version de Kubernetes dans le moteur AKS v0.55.4
Vous trouverez la version actuelle et la version de mise à niveau pour Azure Stack Hub dans le tableau suivant. Ce tableau s’applique au cluster de moteur AKS dans Azure Stack Hub. N’utilisez pas la commande aks-engine get-versions , qui retourne les versions prises en charge dans Azure global et dans Azure Stack Hub.
| Version actuelle | Mise à niveau 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 |
Dans le fichier JSON du modèle d’API, spécifiez les valeurs de version et de mise en production sous la orchestratorProfile section. Par exemple, si vous envisagez de déployer Kubernetes 1.17.17, les deux valeurs suivantes doivent être définies (voir l’exemple kubernetes-azurestack.json) :
- "orchestratorRelease": "1.16",
- "orchestratorVersion": "1.16.14"
Moteur AKS et mappage d’image correspondant
| Version de Kubernetes | Notes |
|---|---|
| 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 | Exemples de modèles d’API (Linux, Windows) |
| 1.15.12, 1.16.14, 1.17.11 | Exemples de modèles d’API (Linux, Windows) |
| 1.15.12, 1.16.14, 1.17.11 | Exemples de modèles d’API (Linux, Windows) |
Nouveautés
- Mise à jour du disque dur virtuel Linux d’Azure Stack vers 2020.09.14 #3828
- Ajout de la prise en charge de K8s v1.17.11 sur Azure Stack #3702
- Ajout de la prise en charge de K8s v1.16.14 sur Azure Stack #3704
- Mise à jour du disque dur virtuel Linux vers 2020.09.14 #3750
- Mise à jour du disque dur virtuel Windows en août #3730
- Mise à niveau du serveur de métriques Kubernetes vers v0.3.7 #3669
- Mise à niveau de la version de Docker pour résoudre le problème de rotation du journal #3693
- Mise à niveau de CoreDNS vers v1.7.0 #3608
- Utilisation des packages Moby 19.03.x #3549
- Correctifs apportés à la stratégie de mise à jour Azure-CNI #3571
Problèmes connus
- Le déploiement de plusieurs services Kubernetes en parallèle à l’intérieur d’un même cluster peut entraîner une erreur dans la configuration de l’équilibreur de charge de base. Nous vous recommandons de déployer un service à la fois.
- Lorsque vous exécutez aks-engine
get-versions, la sortie produit des informations applicables à Azure et Azure Stack Hub. Toutefois, il n’existe aucun moyen explicite de discerner ce qui correspond à Azure Stack Hub. N’utilisez pas cette commande pour déterminer les versions disponibles pour la mise à niveau. Utilisez la table de référence de mise à niveau décrite dans la section précédente. - Étant donné que l’outil aks-engine est un référentiel de code source partagé sur Azure et Azure Stack Hub, l’examen des nombreuses notes de publication et demandes de tirage peut vous conduire à croire que l’outil prend en charge d’autres versions de Kubernetes et de la plateforme du système d’exploitation au-delà de celles précédemment répertoriées. Vous pouvez les ignorer et utiliser le tableau de versions ci-dessus comme guide officiel pour cette mise à jour.
Référence
Voici l’ensemble complet des notes de version combinées d’Azure et d’Azure Stack Hub :
- 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
S’applique à la version 0.48.0 ou antérieure du moteur AKS.
Cet article décrit le contenu du moteur Azure Kubernetes Service (AKS) sur la mise à jour d’Azure Stack Hub. La mise à jour inclut des améliorations et des correctifs pour la dernière version du moteur AKS ciblé sur la plateforme Azure Stack Hub. Cet article n’est pas destiné à documenter les informations de publication du moteur AKS pour Azure global.
Planification des mises à jour
La commande du moteur upgrade AKS automatise entièrement le processus de mise à niveau de votre cluster et gère les machines virtuelles, la mise en réseau, le stockage, Kubernetes et les tâches d’orchestration. Avant d’appliquer la mise à jour, veillez à consulter les informations contenues dans la note de publication.
Considérations de mise à niveau
- Utilisez-vous l’élément de place de marché approprié, AKS Base Ubuntu 16.04-LTS Image Distro pour votre version du moteur AKS ? Les versions sont disponibles dans la section Télécharger les versions de la nouvelle l’image de base Ubuntu AKS et du moteur AKS.
- Utilisez-vous la spécification de cluster correcte (apimodel.json) et le groupe de ressources pour le cluster cible ? Quand vous avez initialement déployé le cluster, ce fichier a été généré dans votre répertoire de sortie. Consultez les paramètres de la commande de déploiement dans Déployer un cluster Kubernetes.
- Utilisez-vous une machine fiable pour exécuter le moteur AKS et à partir de laquelle vous effectuez des opérations de mise à niveau ?
- Si vous mettez à jour un cluster opérationnel avec des charges de travail actives, vous pouvez appliquer la mise à niveau sans les affecter, en supposant que le cluster se trouve dans des conditions de charge normale. Toutefois, vous devez disposer d’un cluster de sauvegarde s’il s’avère nécessaire de rediriger les utilisateurs vers celui-ci. Un cluster de sauvegarde est fortement recommandé.
- Si possible, exécutez la commande à partir d’une machine virtuelle au sein de l’environnement Azure Stack Hub pour réduire les tronçons réseau et les échecs de connectivité potentiels.
- Vérifiez que votre abonnement dispose d’un quota suffisant pour l’ensemble du processus. De nouvelles machines virtuelles sont allouées pendant le processus. Le nombre de machines virtuelles résultant est identique à l’original, mais planifiez la création de quelques machines virtuelles supplémentaires pendant le processus.
- Aucune mise à jour système ni tâche planifiée ne sont prévues.
- Configurez une mise à niveau intermédiaire sur un cluster configuré avec les mêmes valeurs que le cluster de production et testez-y la mise à niveau avant de l’appliquer à votre cluster de production.
Utiliser la commande de mise à niveau
Vous devez utiliser la aks-engine upgrade commande comme décrit dans Mettre à niveau un cluster Kubernetes sur Azure Stack Hub.
Interruptions de la mise à niveau
Parfois, des facteurs inattendus interrompent la mise à niveau du cluster. Une interruption peut se produire lorsque le moteur AKS signale une erreur ou qu’un problème se produit dans le processus d’exécution du moteur AKS. Examinez la cause de l’interruption, résolvez-la et soumettez à nouveau la même upgrade commande pour poursuivre le processus de mise à niveau. La upgrade commande est idempotente et doit reprendre la mise à niveau du cluster une fois que vous renvoyez la commande. Normalement, les interruptions augmentent le temps nécessaire pour terminer la mise à jour, mais ne doivent pas affecter sa fin.
Durée de mise à niveau estimée
La durée de mise à niveau estimée est de 12 à 15 minutes par machine virtuelle dans le cluster. Par exemple, une mise à niveau d’un cluster à 20 nœuds peut prendre environ 5 heures.
Télécharger une nouvelle image et le moteur AKS
Téléchargez les nouvelles versions de l’image de base Ubuntu AKS et du moteur AKS.
Comme expliqué dans la documentation du moteur AKS sur Azure Stack Hub, le déploiement d’un cluster Kubernetes nécessite deux composants principaux :
- Binaire aks-engine (obligatoire).
- Distribution d’images Ubuntu 16.04-LTS de base AKS.
Les nouvelles versions de ces composants sont disponibles avec cette mise à jour :
L’opérateur Azure Stack Hub doit télécharger les nouvelles images AKS Base dans la Place de marché de tampons :
Nom :
AKS Base Ubuntu 16.04-LTS Image Distro, March 2020Version :
2020.03.19Suivez les instructions fournies dans Ajouter les prérequis du moteur Azure Kubernetes Services (AKS) à la Place de marché Azure Stack Hub.
L’administrateur de cluster Kubernetes (normalement un utilisateur locataire d’Azure Stack Hub) doit télécharger le nouveau moteur aks-engine. Consultez les instructions de l’article Installer le moteur AKS sur Linux dans Azure Stack Hub (ou article Windows équivalent). Vous pouvez suivre le même processus que celui que vous avez utilisé pour installer le cluster pour la première fois. La mise à jour remplace le binaire précédent. Par exemple, si vous avez utilisé le script get-akse.sh , suivez les mêmes étapes décrites dans Installer dans un environnement connecté. Le même processus s’applique si vous installez sur un système Windows : installez le moteur AKS sur Windows dans Azure Stack Hub.
Chemin de mise à niveau de la version de Kubernetes
Vous trouverez la version actuelle et la version de mise à niveau pour Azure Stack Hub dans le tableau suivant. Ce tableau s’applique au cluster de moteur AKS dans Azure Stack Hub. N’utilisez pas la commande aks-engine get-versions , qui retourne les versions prises en charge dans Azure global et dans Azure Stack Hub.
| Version actuelle | Mise à niveau 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 |
Nouveautés
Prise en charge de Kubernetes version 1.15.10 (#2834). Lorsque vous déployez un nouveau cluster, dans votre modèle d’API .json fichier (également appelé fichier de définition de cluster), spécifiez à la fois le numéro de version de publication et le numéro de version secondaire au format suivant. Pour obtenir un exemple de fichier de définition de cluster, consultez kubernetes-azurestack.json.
"orchestratorRelease": "1.15,"orchestratorVersion": "1.15.10"
Remarque
Si la version kubernetes n’est pas explicitement fournie dans le modèle d’API .json fichier, la version 1.15 sera utilisée (#2932) et l’orchestrateurVersion aura la valeur par défaut 1.15.11, ce qui entraînera une erreur lors du déploiement du cluster.
Avec aks-engine v0.43.1, les paramètres de fréquence par défaut du fournisseur de cloud pour exécuter sa boucle de contrôle et d’autres tâches ne fonctionnent pas correctement avec les limites de seuil Azure Stack Hub Resource Manager pour les demandes entrantes. Cette mise à jour change les valeurs par défaut d’Azure Stack Hub pour réduire le chargement de nouvelles tentatives vers Azure Stack Hub Resource Manager (#2861).
Une nouvelle étape de vérification dans aks-engine entraîne l’arrêt de l’exécution ou l’affichage d’avertissements si le modèle d’API .json fichier contient des propriétés non prises en charge par Azure Stack Hub (#2717).
Avec un nouvel archivage des vérifications, aks-engine valide la disponibilité de la version de l’image de base AKS nécessaire pour la version d’aks-engine en cours d’exécution (#2342). Cela se produit après l’analyse du modèle d’API .json fichier et avant d’appeler Azure Stack Hub Resource Manager.
La nouvelle option aks-engine « --control-plane-only » dans la
upgradecommande permet à l’utilisateur de mettre à niveau les opérations pour cibler uniquement le Machines Virtuelles maître (#2635).Mises à jour vers Linux Kernel version 4.15.0-1071-azure pour Ubuntu 16.04-LTS. Pour plus d’informations, consultez « Package: linux-image-4.15.0-1071-azure (4.15.0-1071.76) [security] ».
Nouvelles mises à jour d’hypercubes pour prendre en charge les versions 1.14.8 et 1.15.10 de Kubernetes.
Mettez à jour kubectl pour qu’il corresponde à la version de Kubernetes pour le cluster. Ce composant est disponible dans les nœuds du plan de contrôle du cluster Kubernetes. Vous pouvez l’exécuter par le biais de SSH dans un maître.
Mises à jour du complément Azure Container Monitor avec la dernière version de février 2020 (#2850).
Mise à niveau de
corednsvers la version v1.6.6 (#2555).Mise à niveau de
etcdvers la version 3.3.18 (#2462).Mise à niveau de
mobyvers la version 3.0.11 (#2887).Avec cette version, le moteur AKS réduit les dépendances de
k8s.gcr.ioafin d’utiliser maintenant leKubernetes MCR registry @ mcr.microsoft.comofficiel lors de la création de ses images (#2722).
Problèmes connus
- Le déploiement de plusieurs services Kubernetes en parallèle à l’intérieur d’un même cluster peut entraîner une erreur dans la configuration de l’équilibreur de charge de base. Nous vous recommandons de déployer un service à la fois.
- L’exécution d’aks-engine
get-versionsgénère des informations applicables à Azure et Azure Stack Hub. Toutefois, il n’existe aucun moyen explicite de discerner ce qui correspond à Azure Stack Hub. N’utilisez pas cette commande pour déterminer les versions disponibles pour la mise à niveau. Utilisez la table de référence de mise à niveau décrite dans la section précédente. - Étant donné que l’outil aks-engine est un référentiel de code source partagé sur Azure et Azure Stack Hub, l’examen des nombreuses notes de publication et demandes de tirage peut vous conduire à croire que l’outil prend en charge d’autres versions de Kubernetes et de la plateforme du système d’exploitation au-delà de celles précédemment répertoriées. Vous pouvez les ignorer et utiliser le tableau de versions ci-dessus comme guide officiel pour cette mise à jour.
Référence
Voici une liste de certains bogues corrigés et de l’ensemble complet de notes de publication de la version 0.44.0 vers la version 0.48.0. Les notes de publication incluent Azure et Azure Stack Hub.
Résolution des bogues
userAssignedIdentityIddans Windows azure.json guillemets manquants (#2327)Les compléments
update configsont mis à niveau uniquement (#2282)Délai d’expiration du délai d’attente pour obtenir l’adresse IP de gestion sur les nœuds Windows (#2284)
Ajouter le fichier .zip Azure CNI 1.0.28 dans le disque dur virtuel Windows (#2268)
Ordre par défaut correct pour le paramètre
IPAddressCount(#2358)Mise à jour pour utiliser yaml omsagent unique pour toutes les versions de K8s afin d’éviter toute erreur manuelle et facilité de maintenance (#2692)
Notes de publication
Voici l’ensemble complet des notes de version combinées d’Azure et d’Azure Stack Hub :
- 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
Étapes suivantes
- En savoir plus sur le moteur AKS sur Azure Stack Hub