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.
Points importants relatifs à la mise à niveau
- Utilisez-vous les éléments de la Place de marché appropriés, AKS Base Ubuntu 20.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 (apimodel.json) et le groupe de ressources appropriés 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 le même que celui d’origine, mais prévoyez 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 événement se produit dans le processus d’exécution du moteur AKS. Examinez la cause de l’interruption, résolvez-la et envoyez à 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 d’exécution de la mise à jour, mais ne doivent pas affecter son achèvement.
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, la mise à niveau d’un cluster à 20 nœuds peut prendre environ 5 heures.
Instructions d’utilisation du 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).
- AkS Base Ubuntu 16.04-LTS Image Distro (déprécié - ne plus utiliser, modifier le modèle d’API pour utiliser 20.04 à la place).
- Aks Base Ubuntu 18.04-LTS Image Distro (déprécié - 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) :
- Image Windows Server de base AKS en conteneur.
- Docker de l’image Windows Server de base AKS.
De nouvelles versions de ces images sont disponibles avec cette mise à jour :
Vérifiez le moteur AKS et la table de mappage de versions Azure Stack pour 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. Consultez les instructions fournies dans Installer le moteur AKS sur Linux dans Azure Stack Hub (ou un 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 fichier 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 par 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 par 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 par 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 charge dockercontainerRuntime par containerd.
Pour la version v0.75.3 du moteur AKS, 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 conteneur.
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* |
Notes
*Soutenu. 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 ainsi que dans Azure Stack Hub.
Notes
*À partir de Kubernetes v1.21, seul le fournisseur de cloud pour Azure est pris en charge sur Azure Stack Hub.
Notes
** À 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
La version du moteur AKS v0.75.3, et toutes les futures versions du moteur AKS sur Azure Stack Hub proviennent 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 référentiel si vous rencontrez des problèmes.
La version du moteur AKS 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 Mise à niveau de clusters Kubernetes créés avec ubuntu 18.04 Distro .
À partir de Kubernetes v1.24, seul le containerd runtime est pris en charge. Pour plus d’informations, consultez Mise à niveau de clusters Kubernetes créés avec le runtime Docker . Pour la version du moteur AKS 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 Conteneur.
Vous trouverez d’autres 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 essayez 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 . Les versions 0.70.0 et ultérieures prennent uniquement en charge les pilotes CSI, et non le fournisseur de stockage hérité dans l’arborescence. Pour effectuer une mise à niveau, suivez les instructions de la 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é dans Azure et Azure Stack Hub, l’examen des nombreuses notes de publication et demandes de tirage peut vous amener à croire que l’outil prend en charge d’autres versions de Kubernetes et de la plateforme de système d’exploitation au-delà de celles répertoriées précédemment. 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 une 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 des 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
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.
Points importants relatifs à la mise à niveau
- Utilisez-vous les éléments de la place de marché appropriés, AKS Base Ubuntu 16.04-LTS ou distribution d’images 18.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 (apimodel.json) et le groupe de ressources appropriés 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 le même que celui d’origine, mais prévoyez 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 événement se produit dans le processus d’exécution du moteur AKS. Examinez la cause de l’interruption, résolvez-la et envoyez à 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 d’exécution de la mise à jour, mais ne doivent pas affecter son achèvement.
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, la 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 relative au moteur AKS pour Azure Stack Hub, le déploiement d’un cluster Kubernetes nécessite :
- Binaire aks-engine (obligatoire).
- Aks Base Ubuntu 16.04-LTS Image Distro (déprécié - 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 (requise pour les agents Windows).
De nouvelles versions de ces images sont disponibles avec cette mise à jour :
Vérifiez le moteur AKS et la table de mappage de versions Azure Stack pour 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. Consultez les instructions fournies dans Installer le moteur AKS sur Linux dans Azure Stack Hub (ou un 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 fichier 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.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 dans 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 ainsi que 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 version 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 (2020.05.13), 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 (2020.08.24), 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 (2020.09.14), AKS Base Windows Image (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
| V0.60.1 | 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) |
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.
Les nouvelles fonctionnalités incluent :
- 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é dans Azure et Azure Stack Hub, l’examen des nombreuses notes de publication et demandes de tirage peut vous amener à croire que l’outil prend en charge d’autres versions de Kubernetes et de la plateforme de système d’exploitation au-delà de celles répertoriées précédemment. 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 des 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.
Points importants relatifs à la mise à niveau
- Utilisez-vous les éléments de la place de marché appropriés, AKS Base Ubuntu 16.04-LTS ou distribution d’images 18.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 (apimodel.json) et le groupe de ressources appropriés 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 le même que celui d’origine, mais prévoyez 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 événement se produit dans le processus d’exécution du moteur AKS. Examinez la cause de l’interruption, résolvez-la et envoyez à 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 d’exécution de la mise à jour, mais ne doivent pas affecter son achèvement.
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, la 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 relative au moteur AKS sur Azure Stack Hub, le déploiement d’un cluster Kubernetes nécessite :
- Binaire aks-engine (obligatoire).
- Aks Base Ubuntu 16.04-LTS Image Distro (déprécié - 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 (requise 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 de base AKS 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 client d’Azure Stack Hub) doit télécharger le nouveau moteur aks. Consultez les instructions fournies dans Installer le moteur AKS sur Linux dans Azure Stack Hub (ou un 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 é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 d’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 ainsi que 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 version 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 (2020.05.13), 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 (2020.08.24), 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 (2020.09.14), AKS Base Windows Image (17763.1397.200820) | 1.15.12, 1.16.14, 1.17.11 | Linux, Windows |
| V0.60.1 | 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) |
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.
Les nouvelles fonctionnalités incluent :
- Disponibilité générale d’Ubuntu 18.04.
- Aperçu public de la rotation des certificats #4214.
- T4 Nvidia GPU Private Preview #4259.
- Préversion privée de l’intégration d’Azure Active Directory.
- Csi Driver for Azure Blobs Private Preview #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é dans Azure et Azure Stack Hub, l’examen des nombreuses notes de publication et demandes de tirage peut vous amener à croire que l’outil prend en charge d’autres versions de Kubernetes et de la plateforme de système d’exploitation au-delà de celles répertoriées précédemment. Vous pouvez les ignorer et utiliser la table de versions ci-dessus comme guide officiel pour cette mise à jour.
Référence
La liste suivante est l’ensemble complet des 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.
Points importants relatifs à la 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 (apimodel.json) et le groupe de ressources appropriés 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 le même que celui d’origine, mais prévoyez 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 événement se produit dans le processus d’exécution du moteur AKS. Examinez la cause de l’interruption, résolvez-la et envoyez à 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 d’exécution de la mise à jour, mais ne doivent pas affecter son achèvement.
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, la 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 relative au moteur AKS sur Azure Stack Hub, le déploiement d’un cluster Kubernetes nécessite deux composants main :
- Binaire aks-engine (obligatoire).
- Distribution d’images de base AKS Ubuntu 16.04-LTS
De 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é de tampons :
Nom : Distribution d’images de base AKS Ubuntu 16.04-LTS, 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. Consultez les instructions fournies dans Installer le moteur AKS sur Linux dans Azure Stack Hub (ou un 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 fichier 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 ainsi que 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 version 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 | Remarques |
|---|---|
| 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é dans Azure et Azure Stack Hub, l’examen des nombreuses notes de publication et demandes de tirage peut vous amener à croire que l’outil prend en charge d’autres versions de Kubernetes et de la plateforme de système d’exploitation au-delà de celles répertoriées précédemment. Vous pouvez les ignorer et utiliser le tableau de versions ci-dessus comme guide officiel pour cette mise à jour.
Informations de 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.
Points importants relatifs à la 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 (apimodel.json) et le groupe de ressources appropriés 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 à celui d’origine, mais prévoyez 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 événement se produit dans le processus d’exécution du moteur AKS. Examinez la cause de l’interruption, résolvez-la et envoyez à 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 d’exécution de la mise à jour, mais ne doivent pas affecter son achèvement.
Durée de mise à niveau estimée
Le temps de mise à niveau estimé est de 12 à 15 minutes par machine virtuelle dans le cluster. Par exemple, la 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 relative au moteur AKS sur Azure Stack Hub, le déploiement d’un cluster Kubernetes nécessite deux composants main :
- Binaire aks-engine (obligatoire).
- Distribution d’image 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é d’empreintes :
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 client d’Azure Stack Hub) doit télécharger le nouveau moteur aks. Consultez les instructions fournies dans Installer le moteur AKS sur Linux dans Azure Stack Hub (ou un 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 é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 d’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 ainsi que 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 mise en production et le numéro de version mineure 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 de Kubernetes n’est pas fournie explicitement dans le modèle d’API .json fichier, la version 1.15 sera utilisée (#2932) et la version orchestratorVersion sera par défaut 1.15.11, ce qui entraînera une erreur pendant le 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).
La 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 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 le Resource Manager Azure Stack Hub.
La nouvelle option aks-engine « --control-plane-only » dans la
upgradecommande permet à l’utilisateur de mettre à niveau les opérations pour cibler uniquement le master Machines Virtuelles (#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 pour le 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-versionsproduit 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é dans Azure et Azure Stack Hub, l’examen des nombreuses notes de publication et demandes de tirage peut vous amener à croire que l’outil prend en charge d’autres versions de Kubernetes et de la plateforme de système d’exploitation au-delà de celles répertoriées précédemment. Vous pouvez les ignorer et utiliser la table de versions ci-dessus comme guide officiel pour cette mise à jour.
Référence
Voici la liste de certains des bogues corrigés et l’ensemble complet de notes de publication de la version 0.44.0 à 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épassement du délai d’attente pour l’obtention de l’adresse IP de gestion sur les nœuds Windows (#2284)
Ajouter 1.0.28 Fichier .zip Azure CNI dans le disque dur virtuel Windows (#2268)
Ordre par défaut correct pour le paramètre
IPAddressCount(#2358)Mettre à jour pour utiliser le yaml omsagent unique pour toutes les versions de K8s afin d’éviter les erreurs manuelles et la 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
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour