Installer le moteur AKS sur Linux dans Azure Stack Hub

Vous pouvez utiliser une machine Linux dans votre Azure Stack Hub pour héberger le moteur AKS afin de déployer et de gérer un cluster Kubernetes. Dans cet article, nous nous intéressons à la préparation de la machine virtuelle cliente en vue de gérer votre cluster pour des instances Azure Stack Hub à la fois connectées et déconnectées, à la vérification de l’installation et à la configuration de la machine virtuelle cliente sur le Kit de développement Azure Stack (ASDK).

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 cet ordinateur, vous utilisez le moteur AKS pour déployer les ressources et les 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 :

1. Indique si l’ordinateur client doit être récupérable en cas de sinistre.
2. La façon dont vous allez vous connecter à la machine cliente et dont la machine interagit avec votre cluster.

Installation 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.

1. Créez une machine virtuelle Linux dans votre infrastructure Azure Stack Hub. Pour obtenir des instructions, consultez Démarrage rapide : Créez une machine virtuelle serveur Linux sur le portail Azure Stack Hub.

2. Connectez-vous à votre machine virtuelle.

3. Utilisez le gestionnaire de package pour vérifier que les outils suivants sont installés :

   • jq - processeur JSON.
   • curl - un outil permettant de transférer des fichiers à l’aide de divers protocoles réseau.
   • openssh - client SSH.
   • tar - outil permettant d’utiliser des archives TAR.

4. Installez Azure CLI. Des packages pour Azure CLI sont disponibles pour la plupart des distributions. Pour obtenir des instructions, consultez Installer Azure CLI sur Linux.

5. Recherchez la version du moteur AKS dans le tableau moteur AKS et la table de mappage de version Azure Stack. L’image 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 version la plus récente, qui nécessite peut-être une image de disque dur virtuel non 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.

6. Exécutez la commande suivante :

   Pour les versions 0.73.0 et ultérieures du moteur AKS :

   sudo apt update
   sudo apt install jq
   curl -o get-akse.sh https://raw.githubusercontent.com/Azure/aks-engine/master/scripts/get-akse.sh
   chmod 700 get-akse.sh
   ./get-akse.sh --version v0.xx.x
   

   Pour les versions 0.75.3 et ultérieures du moteur AKS :

   sudo apt update
   sudo apt install jq
   curl -o get-akse.sh https://raw.githubusercontent.com/Azure/aks-engine-azurestack/master/scripts/get-akse.sh
   chmod 700 get-akse.sh
   ./get-akse.sh --version v0.xx.x
   

   Notes

   Si votre méthode d’installation échoue, essayez les étapes décrites dans l’environnement déconnecté.

Installation 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.

1. À partir d’un ordinateur ayant accès à Internet :

   Pour les versions 0.73.0 et ultérieures du moteur AKS, accédez à GitHub Azure/aks-engine. Téléchargez une archive (*.tar.gz) pour une machine Linux, par exemple, aks-engine-v0.xx.x-linux-amd64.tar.gz.

   Pour les versions 0.75.3 et ultérieures du moteur AKS, accédez à GitHub Azure/aks-engine-azurestack. Téléchargez une archive (*.tar.gz) pour une machine Linux, par exemple.aks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz

   Recherchez la version du moteur AKS dans le tableau Versions de Kubernetes prises en charge.

2. 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.

3. Créez une machine virtuelle Linux dans votre infrastructure Azure Stack Hub. Pour obtenir des instructions, consultez Démarrage rapide : Créez une machine virtuelle serveur Linux sur le portail Azure Stack Hub.

4. À 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 le répertoire /usr/local/bin.

5. Connectez-vous à votre machine virtuelle.

6. Exécutez la commande suivante :

   Pour les versions 0.73.0 et ultérieures du moteur AKS :

   curl -o aks-engine-v0.xx.x-linux-amd64.tar.gz <httpurl/aks-engine-v0.xx.x-linux-amd64.tar.gz>
   tar xvzf aks-engine-v0.xx.x-linux-amd64.tar.gz -C /usr/local/bin
   

   Pour les versions 0.75.3 et ultérieures du moteur AKS :

   curl -o aks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz <httpurl/aks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz>
   tar xvzf aks-engine-azurestack-v0.xx.x-linux-amd64.tar.gz -C /usr/local/bin
   

Vérifier l’installation

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

1. Connectez-vous à votre machine virtuelle cliente.
2. 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

3. Si le point de terminaison Azure Resource Manager utilise un certificat auto-signé, vous devez ajouter explicitement le certificat racine au magasin de certificats approuvé de la machine. Le certificat racine se trouve dans le répertoire suivant sur la machine virtuelle : /var/lib/waagent/Certificates.pem. Copiez le fichier de certificat à l’aide de la commande suivante :

   sudo cp /var/lib/waagent/Certificates.pem /usr/local/share/ca-certificates/azurestackca.crt 
   sudo update-ca-certificates
   

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.

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. Par exemple, sur une machine virtuelle Ubuntu, vous le trouverez dans ce répertoire /var/lib/waagent/Certificates.pem.

Copiez le fichier de certificat à l’aide de la commande suivante :

sudo cp /var/lib/waagent/Certificates.pem /usr/local/share/ca-certificates/azurestackca.crt

sudo update-ca-certificates

Étapes suivantes

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