Installer et utiliser l’interface CLI agentique pour Azure Kubernetes Service (AKS) (préversion)

• Docker installé et en cours d’exécution sur votre ordinateur local. Pour obtenir des instructions d’installation, consultez Prise en main de Docker.
• Vérifiez que le démon Docker est démarré et en cours d’exécution avant de poursuivre l’installation.
• Vérifiez que vos informations d’identification Azure sont correctement configurées et que vous disposez des autorisations nécessaires pour accéder aux ressources du cluster.

• Avant d’installer, vous devez créer un compte de service Kubernetes requis avec des autorisations RBAC. (La configuration de l’identité de charge de travail est facultative.)
• Vous avez besoin d’un accès en écriture pour le déploiement dans l’espace de noms Kubernetes où l’agent sera déployé.

Vérifier l’installation de Docker et démarrer le démon Docker

1. Vérifiez que Docker est installé et que le démon Docker s’exécute à l’aide des commandes suivantes :

   docker --version
   docker ps
   

2. Si vous recevez une erreur indiquant que le démon Docker n’est pas en cours d’exécution, démarrez le service Docker en suivant les étapes appropriées pour votre système d’exploitation :

   • macOS / Windows :

     • Lancez Docker Desktop à partir de vos applications.
     • Attendez que Docker démarre.

   • Linux :

     • Démarrez le service Docker à l’aide des commandes suivantes :

       sudo systemctl start docker
       sudo systemctl enable docker  # Enable Docker to start on boot
       

3. Vérifiez que Docker s’exécute à l’aide de la commande suivante :

   docker info
   

   Cette commande doit retourner les informations système Docker sans erreurs.

Initialiser le mode client

1. Initialisez l’interface CLI agentique avec le mode client à l’aide de la az aks agent-init commande. Veillez à remplacer les valeurs d’espace réservé par le nom réel de votre groupe de ressources réel et de votre cluster.

   az aks agent-init --resource-group $RESOURCE_GROUP --name $CLUSTER_NAME
   

2. Lorsque vous êtes invité à sélectionner un mode de déploiement, entrez 2 pour le mode client.

   🚀 Welcome to AKS Agent initialization!
   
   Please select the mode you want to use:
     1. Cluster mode - Deploys agent as a pod in your AKS cluster
        Uses service account and workload identity for secure access to cluster and Azure resources
     2. Client mode - Runs agent locally using Docker
        Uses your local Azure credentials and cluster user credentials for access
   
   Enter your choice (1 or 2): 2
   

3. Configurez les détails de votre fournisseur LLM. Par exemple:

   Welcome to AKS Agent LLM configuration setup. Type '/exit' to exit.
    1. Azure Open AI (API Key)
    1. Azure Open AI (Microsoft Entra ID)
    3. OpenAI
    4. Anthropic
    5. Gemini
    6. Openai Compatible
   Enter the number of your LLM provider: 1
   Your selected provider: azure
   Enter value for MODEL_NAME:  (Hint: should be consistent with your deployed name, e.g., gpt-4.1) gpt-4.1
   Enter your API key: 
   Enter value for AZURE_API_BASE:  (Hint: https://{your-custom-endpoint}.openai.azure.com/) https://test-example.openai.azure.com
   Enter value for AZURE_API_VERSION:  (Default: 2025-04-01-preview)
   LLM configuration setup successfully.
   

   Note

   La clé API s’affiche vide lorsque vous tapez pour la sécurité. Veillez à entrer la clé API appropriée.

4. Vérifiez que l’initialisation a réussi. L’agent extrait automatiquement les images Docker nécessaires lorsque vous exécutez votre première commande.

Initialiser le mode cluster

1. Initialisez l’interface CLI agentique avec le mode cluster à l’aide de la az aks agent-init commande. Veillez à remplacer les valeurs d’espace réservé par le nom réel de votre groupe de ressources réel et de votre cluster.

   az aks agent-init --resource-group $RESOURCE_GROUP --name $CLUSTER_NAME
   

2. Lorsque vous êtes invité à sélectionner un mode de déploiement, entrez 1 pour le mode cluster.

   🚀 Welcome to AKS Agent initialization!
   
   Please select the mode you want to use:
     1. Cluster mode - Deploys agent as a pod in your AKS cluster
        Uses service account and workload identity for secure access to cluster and Azure resources
     2. Client mode - Runs agent locally using Docker
        Uses your local Azure credentials and cluster user credentials for access
   
   Enter your choice (1 or 2): 1
   

3. Lorsque vous êtes invité à spécifier l’espace de noms cible, entrez l’espace de noms où vous avez créé le compte de service. L’exemple suivant utilise your-namespace comme espace réservé. Veillez à le remplacer par l’espace de noms réel que vous avez utilisé.

   ✅ Cluster mode selected. This will set up the agent deployment in your cluster.
   
   Please specify the namespace where the agent will be deployed.
   
   Enter namespace (e.g., 'kube-system'): your-namespace
   

4. Configurez les détails de votre fournisseur LLM. Par exemple:

   📦 Using namespace: your-namespace
   No existing LLM configuration found. Setting up new configuration...
   Please provide your LLM configuration. Type '/exit' to exit.
    1. Azure OpenAI
    2. OpenAI
    3. Anthropic
    4. Gemini
    5. OpenAI Compatible
    6. For other providers, see https://aka.ms/aks/agentic-cli/init
   Please choose the LLM provider (1-5): 1
   

5. Fournissez les détails du compte de service à l’aide du compte de service Kubernetes que vous avez créé pour le déploiement de l’agent. L’exemple suivant utilise aks-mcp comme espace réservé pour le nom du compte de service. Veillez à le remplacer par le nom réel de votre compte de service.

   👤 Service Account Configuration
   The AKS agent requires a service account with appropriate permissions in the 'your-namespace'
   namespace.
   Please ensure you have created the necessary Role and RoleBinding in your namespace for 
   this service account.
   
   Enter service account name: aks-mcp
   

6. Attendez la fin du déploiement. L’initialisation déploie l’agent à l’aide de Helm.

   🚀 Deploying AKS agent (this typically takes less than 2 minutes)...
   ✅ AKS agent deployed successfully!
   Verifying deployment status...
   ✅ AKS agent is ready and running!
   
   🎉 Initialization completed successfully!
   

7. Vérifiez le déploiement réussi et vérifiez l’état de l’agent à l’aide de la az aks agent commande avec le --status paramètre.

   az aks agent \
   --status \
   --resource-group $RESOURCE_GROUP \
   --name $CLUSTER_NAME \
   --namespace $NAMESPACE
   

   Votre sortie doit indiquer que l’agent est prêt et en fonctionnement, comme suit :

   📊 Checking AKS agent status...
   
   ✅ Helm Release: deployed
   
   📦 Deployments:
     • aks-agent: 1/1 ready
     • aks-mcp: 1/1 ready
   
   🐳 Pods:
     • aks-agent-xxxxx-xxxxx: Running ✓
     • aks-mcp-xxxxx-xxxxx: Running ✓
   
   📋 LLM Configurations:
     • azure/gpt-4o
       API Base: https://your-service.openai.azure.com/
       API Version: 2025-04-01-preview
   
   ✅ AKS agent is ready and running!
   

   Note

   Vous pouvez également vérifier le bon déroulement du déploiement en vérifiant les pods et les déploiements dans l’espace de noms cible à l’aide de kubectl.

   kubectl get pods --namespace $NAMESPACE | grep aks-
   kubectl get deployment --namespace $NAMESPACE | grep aks-
   

Voici des exemples de requêtes de base que vous pouvez exécuter avec l’interface CLI agentique pour AKS en mode client :

az aks agent "How many nodes are in my cluster?" --resource-group $RESOURCE_GROUP --name $CLUSTER_NAME --mode client
az aks agent "What is the Kubernetes version on the cluster?" --resource-group $RESOURCE_GROUP --name $CLUSTER_NAME --mode client
az aks agent "Why is coredns not working on my cluster?" --resource-group $RESOURCE_GROUP --name $CLUSTER_NAME --mode client
az aks agent "Why is my cluster in a failed state?" --resource-group $RESOURCE_GROUP --name $CLUSTER_NAME --mode client

Voici des exemples de requêtes de base que vous pouvez exécuter avec l’interface CLI agentique pour AKS en mode cluster :

az aks agent "How many nodes are in my cluster?" --resource-group $RESOURCE_GROUP --name $CLUSTER_NAME --namespace $NAMESPACE
az aks agent "What is the Kubernetes version on the cluster?" --resource-group $RESOURCE_GROUP --name $CLUSTER_NAME --namespace $NAMESPACE
az aks agent "Why is coredns not working on my cluster?" --resource-group $RESOURCE_GROUP --name $CLUSTER_NAME --namespace $NAMESPACE
az aks agent "Why is my cluster in a failed state?" --resource-group $RESOURCE_GROUP --name $CLUSTER_NAME --namespace $NAMESPACE

az aks agent "How many pods are in the kube-system namespace" --resource-group $RESOURCE_GROUP --name $CLUSTER_NAME --mode client --model=azure/gpt-4o --no-interactive
az aks agent "Why are the pods in Crashloopbackoff in the kube-system namespace" --resource-group $RESOURCE_GROUP --name $CLUSTER_NAME --mode client --model=azure/gpt-4o --no-interactive --show-tool-output

az aks agent "How many pods are in the kube-system namespace" --resource-group $RESOURCE_GROUP --name $CLUSTER_NAME --namespace $NAMESPACE --model=azure/gpt-4o --no-interactive
az aks agent "Why are the pods in Crashloopbackoff in the kube-system namespace" --resource-group $RESOURCE_GROUP --name $CLUSTER_NAME --namespace $NAMESPACE --model=azure/gpt-4o --no-interactive --show-tool-output

Nettoyez votre déploiement en mode client à l’aide de la commande az aks agent-cleanup avec le paramètre --mode client. Cette commande supprime le fichier de configuration local et réinitialise la configuration de l’agent.

az aks agent-cleanup --resource-group $RESOURCE_GROUP --name $CLUSTER_NAME --mode client

Nettoyez votre déploiement en mode cluster à l’aide de la az aks agent-cleanup commande. Veillez à spécifier le --namespace paramètre avec l’espace de noms où l’agent est déployé. Cette commande supprime le pod de l’agent de l’espace de noms spécifié et supprime la configuration LLM stockée sur le cluster.

az aks agent-cleanup --resource-group $RESOURCE_GROUP --name $CLUSTER_NAME --namespace $NAMESPACE

Vérifiez que le fichier de configuration local et les images Docker ont été supprimés à l’aide des commandes suivantes :

# Check if configuration file was removed
ls ~/.azure/aksAgent.config

# Check for remaining Docker images
docker images | grep aks-agent

Vérifiez que le pod de l’agent et les ressources associées ont été supprimés du cluster à l’aide des commandes suivantes avec l’espace de noms approprié :

# Check if agent pod was removed
kubectl get pods --namespace $NAMESPACE

# Check if service account was removed
kubectl get serviceaccount --namespace $NAMESPACE

# Check if namespace was removed (if it was created during init)
kubectl get namespace $NAMESPACE