Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Vous pouvez installer le moteur AKS sur des machines virtuelles dans votre environnement ou toute machine cliente ayant accès à votre point de terminaison Azure Stack Hub Resource Manager. Disposez des éléments suivants avant d’exécuter le moteur : un serveur Ubuntu de base AKS et une extension de script personnalisé Linux disponibles dans votre abonnement, une identité de principal de service affectée à un rôle contributeur et une paire de clés privée/publique pour l’accès SSH à votre serveur Ubuntu. En outre, si vous utilisez le Kit de développement Azure Stack, vous devez faire confiance à votre machine aux certificats appropriés.
Si vous avez vos prérequis, vous pouvez commencer à définir votre cluster.
Si vous êtes l’opérateur cloud pour Azure Stack Hub et que vous souhaitez offrir le moteur AKS, suivez les instructions de l’ajout du moteur AKS à la Place de marché Azure Stack Hub.
Conditions préalables pour le moteur AKS
Pour utiliser le moteur AKS, vous devez disposer des ressources suivantes. N’oubliez pas que le moteur AKS est destiné à être utilisé par les locataires d’Azure Stack Hub pour déployer des clusters Kubernetes dans leur abonnement client. La seule partie où l’implication de l’opérateur Azure Stack Hub peut être nécessaire consiste à télécharger des éléments de la Place de marché et à créer une identité de principal de service. Vous trouverez des détails dans le tableau suivant.
Votre opérateur cloud doit disposer des éléments suivants en place.
| Prérequis | Descriptif | Obligatoire | Les instructions |
|---|---|---|---|
| Azure Stack Hub 1910 ou version ultérieure | Le moteur AKS nécessite Azure Stack Hub 1910 ou version ultérieure. | Obligatoire | Si vous n’êtes pas sûr de votre version d’Azure Stack Hub, contactez votre opérateur cloud. |
| Extension de script personnalisé Linux | Extension de script personnalisé Linux 2.0 Offre : script personnalisé pour Linux 2.0 Version : 2.0.6 (ou dernière version) Éditeur : Microsoft Corp |
Obligatoire | Si vous n’avez pas cet élément dans votre abonnement, contactez votre opérateur cloud. |
| Images de base AKS | Image Ubuntu et Windows de base AKS Pour plus d’informations sur la dépendance de version, voir Moteur correspondant à la version de l’image de base |
Obligatoire | Si vous n’avez pas cet élément dans votre abonnement, contactez votre opérateur cloud. Si vous êtes l’opérateur cloud pour Azure Stack Hub et que vous souhaitez offrir le moteur AKS, suivez les instructions fournies à l’adresse Ajouter un moteur AKS à la Place de marché Azure Stack Hub. |
| Identité de principal du service (SPN) | Une application qui a besoin pour déployer ou configurer des ressources via Azure Resource Manager doit être représentée par un principal de service. | Obligatoire | Vous devrez peut-être contacter votre opérateur cloud Azure Stack Hub pour obtenir un SPN et un secret actuel. Si une identité de principal de service Microsoft Entra est utilisée, l’accès Internet est requis à partir des machines virtuelles du cluster Kubernetes afin que le principal de service puisse s’authentifier avec l’ID Microsoft Entra. Vous avez également besoin d’un secret actif. Lorsque votre secret expire, votre cluster ne sera pas fonctionnel. Si votre environnement n’a pas d’accès à Internet, le cluster Kubernetes ne sera pas fonctionnel. Pour obtenir des instructions, consultez Utiliser une identité d’application pour accéder aux ressources |
| Rôle contributeur affecté (SPN) | Pour autoriser une application à accéder aux ressources de votre abonnement en utilisant son principal du service, vous devez attribuer à ce dernier un rôle pour une ressource spécifique. | Obligatoire | Pour obtenir des instructions, consultez Affecter un rôle |
Vous pouvez définir les éléments suivants.
| Prérequis | Descriptif | Obligatoire | Les instructions |
|---|---|---|---|
| Abonnement Azure Stack Hub | Vous accédez à des offres dans azure Stack Hub par le biais d’abonnements. L’offre contient les services qui sont à votre disposition. | Obligatoire | Pour pouvoir déployer toutes les charges de travail de locataire dans Azure Stack Hub, vous devez d’abord obtenir un abonnement Azure Stack Hub. |
| groupe de ressources | Un groupe de ressources est un conteneur réunissant les ressources associées d’une solution Azure. Si vous ne spécifiez pas de groupe de ressources existant, l’outil en crée un pour vous. | Optionnel | Gérer les groupes de ressources Azure Resource Manager à l’aide du portail Azure |
| Clé publique privée | Pour utiliser une connexion SSH ouverte de votre machine de développement à la machine virtuelle serveur dans votre instance Azure Stack Hub qui héberge votre application web, vous devez créer une paire de clés publique et privée Secure Shell (SSH). | Obligatoire | Pour obtenir des instructions sur la génération d’une clé, consultez Génération de clé SSH. |
Remarque
Vous pouvez également créer les prérequis pour le moteur AKS avec Azure CLI pour Azure Stack Hub ou Azure Stack Hub PowerShell.
Moteur correspondant à la version d’image de base
Le moteur AKS déploie un système d’exploitation Ubuntu server personnalisé sur chaque image de nœud de cluster, la distribution d’images Ubuntu et Windows de base AKS. Toute version du moteur AKS dépend d’une version d’image spécifique mise à disposition dans votre opérateur Azure Stack Hub par votre opérateur Azure Stack Hub. Vous trouverez un tableau répertoriant les versions du moteur AKS et les versions de Kubernetes prises en charge correspondantes dans les versions Kubernetes prises en charge. Par exemple, la version v0.55.0 du moteur AKS dépend de la version 2020.08.24 de la distribution d’images Ubuntu et Windows de base AKS. Demandez à votre opérateur Azure Stack Hub de télécharger la version d’image spécifique à partir de la Place de marché Azure sur la Place de marché Azure Stack Hub.
Vous déclencherez une erreur si l’image n’est pas disponible dans votre Place de marché Azure Stack Hub. Par exemple, si vous utilisez actuellement la version du moteur AKS v0.55.0 et AKS Base Ubuntu et que la version 2020.08.24 de distribution d’images Windows n’est pas disponible, vous verrez l’erreur suivante lors de l’exécution du moteur AKS :
The platform image 'microsoft-aks:aks:aks-ubuntu-1604-202003:2020.08.24' is not available.
Verify that all fields in the storage profile are correct.
Vous pouvez vérifier la version actuelle de votre moteur AKS en exécutant la commande suivante :
Remarque
Pour AKSe version 0.75.3 et ultérieure, la commande permettant de vérifier la version actuelle de votre moteur AKS est aks-engine-azurestack version.
$ aks-engine version
Version: v0.55.0
GitCommit: 44a35c00c
GitTreeState: clean