Accéder à un cluster Azure Kubernetes Service (AKS) privé

Lorsque vous accédez à un cluster AKS privé, vous devez vous connecter à ce cluster à partir du réseau virtuel du cluster, d’un réseau appairé ou d’un point de terminaison privé configuré. Ces approches nécessitent la configuration d’un VPN, ExpressRoute, le déploiement d’un serveur de rebond au sein du réseau virtuel du cluster ou la création d’un point de terminaison privé dans un autre réseau virtuel.

Avec l’interface Azure CLI, vous pouvez également utiliser command invoke pour accéder aux clusters privés sans devoir configurer un VPN ou Express Route. command invoke vous permet d’invoquer à distance des commandes comme kubectl et helm sur votre cluster privé par le biais de l’API Azure sans vous connecter directement au cluster. Les actions Microsoft.ContainerService/managedClusters/runcommand/action et Microsoft.ContainerService/managedclusters/commandResults/read contrôlent les autorisations d’utilisation de command invoke.

Avec le Portail Azure, vous pouvez utiliser la fonctionnalité Run command pour exécuter des commandes sur votre cluster privé. La fonctionnalité Run command utilise la même fonctionnalité command invoke pour exécuter des commandes sur votre cluster.

Avant de commencer

Avant de commencer, assurez-vous de disposer des ressources et des autorisations suivantes :

• Un cluster privé existant. Si vous n’en avez pas, consultez Créer un cluster AKS privé.
• Azure CLI version 2.24.0 ou ultérieure. Exécutez az --version pour trouver la version. Si vous devez installer ou mettre à niveau, voir Installer Azure CLI.
• Accès aux rôles Microsoft.ContainerService/managedClusters/runcommand/action et Microsoft.ContainerService/managedclusters/commandResults/read sur le cluster.

Limites

Le pod créé par la commande run fournit helm et la dernière version compatible de kubectl pour votre cluster avec kustomize.

command invoke exécute les commandes à partir de votre cluster, de sorte que toutes les commandes exécutées de cette manière sont soumises aux restrictions réseau (et autres) que vous avez configurées sur votre cluster. Assurez-vous également qu’il existe suffisamment de nœuds et de ressources dans votre cluster pour planifier ce pod de commande.

Remarque

La sortie pour command invoke est limitée à 512 ko.

Exécuter des commandes sur votre cluster AKS

Azure CLI – command invoke

Utiliser command invoke pour exécuter une seule commande

• Exécutez une commande sur votre cluster à l’aide de la commande az aks command invoke --command. L’exemple de commande ci-dessous exécute la commande kubectl get pods -n kube-system sur le cluster myPrivateCluster dans myResourceGroup.

  az aks command invoke \
    --resource-group myResourceGroup \
    --name myPrivateCluster \
    --command "kubectl get pods -n kube-system"
  

Utiliser command invoke pour exécuter plusieurs commandes

• Exécutez plusieurs commandes sur votre cluster à l’aide de la commande az aks command invoke --command. L’exemple de commande ci-dessous exécute 3 commandes helm sur le cluster myPrivateCluster dans myResourceGroup.

  az aks command invoke \
    --resource-group myResourceGroup \
    --name myPrivateCluster \
    --command "helm repo add bitnami https://charts.bitnami.com/bitnami && helm repo update && helm install my-release bitnami/nginx"
  

Utiliser command invoke pour exécuter des commandes avec un fichier ou un répertoire attaché

• Exécutez des commandes avec un fichier ou un répertoire joint à l’aide de la commande az aks command invoke --command avec le paramètre --file. L’exemple de commande ci-dessous exécute kubectl apply -f deployment.yaml -n default sur le cluster myPrivateCluster dans myResourceGroup. Le fichier deployment.yaml est joint à partir du répertoire actif de l’ordinateur de développement où az aks command invoke a été exécuté.

  az aks command invoke \
    --resource-group myResourceGroup \
    --name myPrivateCluster \
    --command "kubectl apply -f deployment.yaml -n default" \
    --file deployment.yaml
  

Utilisez command invoke pour exécuter des commandes avec tous les fichiers du répertoire actif joints

• Exécutez des commandes avec tous les fichiers du répertoire actif joints à l’aide de la commande az aks command invoke --command avec le paramètre --file. L’exemple de commande ci-dessous exécute kubectl apply -f deployment.yaml configmap.yaml -n default sur le cluster myPrivateCluster dans myResourceGroup. Les fichiers deployment.yaml et configmap.yaml font partie du répertoire actif de l’ordinateur de développement où az aks command invoke a été exécuté.

  az aks command invoke \
    --resource-group myResourceGroup \
    --name myPrivateCluster \
    --command "kubectl apply -f deployment.yaml configmap.yaml -n default" \
    --file .
  

Portail Azure – Run command

Pour démarrer Run command, accédez à votre cluster privé dans le Portail Azure. Dans la section Ressources Kubernetes , sélectionnez Exécuter la commande.

Commandes Run command

Vous pouvez utiliser les commandes kubectl suivantes avec la fonctionnalité Run command :

• kubectl get nodes
• kubectl get deployments
• kubectl get pods
• kubectl describe nodes
• kubectl describe pod <pod-name>
• kubectl describe deployment <deployment-name>
• kubectl apply -f <file-name

Utiliser Run command pour exécuter une seule commande

1. Dans le Portail Azure, accédez à votre cluster privé.
2. Dans la section Ressources Kubernetes , sélectionnez Exécuter la commande.
3. Entrez la commande que vous souhaitez exécuter, puis sélectionnez Exécuter.

Utiliser Run command pour exécuter des commandes avec des fichiers joints

1. Dans le Portail Azure, accédez à votre cluster privé.

2. Dans la section Ressources Kubernetes , sélectionnez Exécuter la commande.

3. Sélectionnez Joindre des fichiers.

4. Sélectionnez Parcourir des fichiers.

   

5. Sélectionnez le ou les fichiers que vous souhaitez joindre, puis cliquez sur Joindre.

6. Entrez la commande que vous souhaitez exécuter, puis sélectionnez Exécuter.

--

Dépannage

Pour plus d’informations sur les problèmes les plus courants liés à az aks command invoke et sur la façon de les résoudre, consultez Résoudre les échecs « az aks command invoke ».

Étapes suivantes

Dans cet article, vous avez appris à accéder à un cluster privé et à y exécuter des commandes. Pour plus d’informations sur les clusters AKS, consultez la documentation suivante :

• Utiliser une connexion de point de terminaison privé dans AKS
• Appairage de réseaux virtuels dans AKS
• Schéma de hub-and-spoke avec DNS personnalisé dans AKS