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 examinons la préparation de la machine virtuelle cliente pour gérer votre cluster pour les instances Azure Stack Hub connectées et déconnectées, vérifier l’installation et configurer la machine virtuelle cliente sur l’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 cette machine, vous utilisez le moteur AKS pour déployer les ressources IaaS et les logiciels nécessaires pour exécuter 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. Comment vous allez vous connecter à l’ordinateur client et comment l’ordinateur interagira avec votre cluster.

Installer 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 instance Azure Stack Hub. Pour obtenir des instructions, consultez Démarrage rapide : Créer une machine virtuelle de serveur Linux à l’aide du portail Azure Stack Hub.

2. Connectez-vous à votre machine virtuelle.

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

   • jq un processeur JSON.
   • curl : outil de transfert de fichiers à l’aide d’un large éventail de protocoles réseau.
   • openssh un client ssh.
   • tar outil utilisé pour travailler avec des archives TAR.

4. Installez Azure CLI. Les packages pour Azure CLI sont disponibles pour la plupart des distributions. Vous trouverez des instructions lors de l’installation d’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 dernière version, ce qui peut nécessiter une image de disque dur virtuel qui n’est pas disponible sur 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 AKS Engine 0.73.0 et antérieures :

   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 akS Engine versions 0.75.3 et ultérieures :

   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
   

   Remarque

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

Installer 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 disposant d’un 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 exempleaks-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 instance Azure Stack Hub. Pour obtenir des instructions, consultez Démarrage rapide : Créer une machine virtuelle de serveur Linux à l’aide du 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 AKS Engine 0.73.0 et antérieures :

   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 akS Engine versions 0.75.3 et ultérieures :

   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, vérifiez que vous avez installé le moteur AKS.

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

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. Vous trouverez le certificat racine dans la machine virtuelle dans ce répertoire : /var/lib/waagent/Certificates.pem. Copiez le fichier de certificat avec 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 d’ASDK

Vous devez ajouter un certificat lors de l’exécution de la machine virtuelle cliente pour le moteur AKS sur l’ASDK.

Lorsque vous utilisez un ASDK et que votre point de terminaison Azure Resource Manager utilise un certificat auto-signé, vous devez explicitement ajouter ce certificat au magasin de certificats approuvés de l’ordinateur. Vous trouverez le certificat racine ASDK dans n’importe quelle machine virtuelle que vous déployez dans l’ASDK. Par exemple, dans une machine virtuelle Ubuntu, vous le trouverez dans ce répertoire /var/lib/waagent/Certificates.pem.

Copiez le fichier de certificat avec la commande suivante :

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

sudo update-ca-certificates

Étapes suivantes