Installer le moteur AKS sur Windows dans Azure Stack Hub

Article
12/01/2023

Les téléchargements binaires de la dernière version d’AKS Engine sont disponibles sur Github. Téléchargez le package pour votre système d’exploitation, puis extrayez le fichier aks-engine pour les versions 0.73.0 et ultérieures du moteur AKS. Pour les versions 0.75.3 et ultérieures du moteur AKS, extrayez le fichier aks-engine-azurestack (et ajoutez-le éventuellement à votre $PATH variable d’environnement pour une utilisation plus pratique de l’interface CLI).

Préparer la machine virtuelle cliente

Le moteur AKS est un outil en ligne de commande utilisé pour déployer et gérer votre cluster Kubernetes. Vous pouvez exécuter le moteur sur une machine de votre infrastructure Azure Stack Hub. À partir de cette machine, exécutez le moteur AKS pour déployer les ressources Et logiciels IaaS nécessaires à l’exécution de votre cluster. Vous pouvez ensuite utiliser la machine qui exécute le moteur pour effectuer des tâches de gestion sur votre cluster.

Pour choisir votre machine cliente, tenez compte des points suivants :

Indique si l’ordinateur client doit être récupérable en cas de sinistre.
Comment vous allez vous connecter à l’ordinateur client et comment la machine interagira avec votre cluster ?

Installer le moteur AKS dans un environnement connecté

Vous pouvez installer la machine virtuelle cliente pour gérer votre cluster Kubernetes sur une infrastructure Azure Stack Hub connectée à Internet.

Créez une machine virtuelle Windows dans votre infrastructure Azure Stack Hub. Pour obtenir des instructions, consultez Démarrage rapide : Créer une machine virtuelle Windows Server sur le portail Azure Stack Hub.
Connectez-vous à votre machine virtuelle.
Installez Chocolatey en suivant les instructions PowerShell.

Selon le site web de Chocolatey : Chocolatey est un gestionnaire de package pour Windows, comme apt-get ou yum mais pour Windows. Il a été conçu pour servir de framework décentralisé afin d’installer rapidement les applications et outils dont vous avez besoin. Il s’appuie sur l’infrastructure NuGet qui utilise actuellement PowerShell en priorité pour remettre les packages des distributions à votre porte, erreur, ordinateur.
Installez Azure CLI. Sélectionnez le lien de téléchargement, puis choisissez Exécuter. Choisissez les étapes de configuration selon vos besoins.
Recherchez la version du moteur AKS dans le tableau moteur AKS et la table de mappage de version Azure Stack. Le moteur de base AKS doit être disponible dans votre Place de marché Azure Stack Hub. Lors de l’exécution de la commande, vous devez spécifier la version --version v0.xx.x. Si vous ne spécifiez pas la version, la commande installe la dernière version, qui peut nécessiter une image de disque dur virtuel qui n’est pas disponible dans votre Place de marché.

Remarque

Vous pouvez trouver le mappage d’Azure Stack Hub au numéro de version du moteur AKS dans les notes de publication du moteur AKS.
Exécutez la commande suivante à partir d’une invite avec élévation de privilèges et incluez le numéro de version :

Remarque

Pour AKSe version 0.75.3 et ultérieure, la commande permettant d’installer le moteur AKS est choco install aks-engine-azurestack.
```
    choco install aks-engine --version 0.xx.x -y
```
Notes

Si cette méthode d’installation échoue, vous pouvez essayer les étapes ci-dessous pour un environnement déconnecté.

Installer le moteur AKS dans un environnement déconnecté

Vous pouvez installer la machine virtuelle cliente pour gérer votre cluster Kubernetes sur une infrastructure Azure Stack Hub déconnectée d’Internet.

À partir d’une machine disposant d’un accès à Internet, accédez à GitHub Azure/aks-engine. Téléchargez une archive (*.tar.gz) pour une machine Windows, par exemple, aks-engine-v0.xx.x-windows-amd64.tar.gz. Recherchez la version du moteur AKS dans le tableau Versions de Kubernetes prises en charge.
Créez un compte de stockage dans votre instance Azure Stack Hub pour charger le fichier d’archive (*.tar.gz) avec le binaire du moteur AKS. Pour obtenir des instructions sur l’utilisation d’Explorateur Stockage Azure, consultez Explorateur Stockage Azure avec Azure Stack Hub.
Créez une machine virtuelle Windows dans votre infrastructure Azure Stack Hub. Pour obtenir des instructions, consultez Démarrage rapide : Créer une machine virtuelle Windows Server sur le portail Azure Stack Hub.
À partir de l’URL de l’objet blob du compte de stockage Azure Stack Hub où vous avez chargé le fichier d’archive (*.tar.gz), téléchargez le fichier sur votre machine virtuelle de gestion. Extrayez l’archive dans un répertoire auquel vous avez accès à partir de votre invite de commandes.
Connectez-vous à votre machine virtuelle.
Installez Chocolatey en suivant les instructions PowerShell.
Exécutez la commande suivante à partir d’une invite de commandes avec élévation de privilèges. Incluez le numéro de version approprié :

Notes

Pour AKSe version 0.75.3 et ultérieure, la commande permettant d’installer le moteur AKS est choco install aks-engine-azurestack.
```
    choco install aks-engine --version 0.xx.x -y
```

Vérifier l’installation

Une fois votre machine virtuelle cliente configurée, case activée que vous avez installé le moteur AKS.

Connectez-vous à votre machine virtuelle cliente.
Exécutez la commande suivante :

Notes

Pour AKSe version 0.75.3 et ultérieure, la commande permettant de case activée la version actuelle de votre moteur AKS est aks-engine-azurestack version.
```
aks-engine version
```

Si vous ne parvenez pas à vérifier que vous avez installé le moteur AKS sur votre machine virtuelle cliente, consultez Résoudre les problèmes d’installation du moteur AKS.

Installation du Kit de développement Azure Stack (ASDK)

Vous devez ajouter un certificat lors de l’exécution de la machine virtuelle cliente pour le moteur AKS sur l’ASDK sur une machine en dehors de l’ASDK. Si vous utilisez une machine virtuelle Windows au sein de l’environnement ASDK proprement dit, celle-ci approuve déjà le certificat ASDK. Si votre machine cliente se trouve en dehors de l’ASDK, vous devez extraire le certificat de l’ASDK, puis l’ajouter à votre machine Windows.

Quand vous utilisez un ASDK et que votre point de terminaison Azure Resource Manager utilise un certificat auto-signé, vous devez ajouter explicitement ce certificat au magasin de certificats approuvé de la machine. Vous pouvez trouver le certificat racine ASDK sur toutes les machines virtuelles que vous déployez sur l’ASDK.

Exportez le certificat racine de l’autorité de certification. Pour obtenir des instructions, consultez Exporter le certificat racine de l’autorité de certification Azure Stack Hub.
Approuvez le certificat d'autorité de certification racine Azure Stack Hub. Pour obtenir des instructions, consultez Approuver le certificat racine de l’autorité de certification Azure Stack Hub.

Étapes suivantes

Déployer un cluster Kubernetes avec le moteur AKS sur Azure Stack Hub