Démarrage rapide : Créer un cluster automatique Azure Kubernetes Service (AKS)

S’applique à : ✔️ AKS Automatic

Azure Kubernetes Service (AKS) Automatique est une expérience Kubernetes managée qui automatise l’installation et les opérations du cluster AKS et incorpore les configurations de bonnes pratiques. AKS Automatic inclut également un [contrat SLA de préparation des pods][azure-sla] qui garantit 99,9% des opérations de préparation des pods éligibles dans les 5 minutes, garantissant une infrastructure fiable et auto-guérissante pour vos applications. Dans ce guide de démarrage rapide, vous apprenez à :

• Déployez un cluster AKS Automatic.
• Exécutez un exemple d’application multiconteneur avec un groupe de microservices et de serveurs web frontaux simulant un scénario de vente au détail.

Avant de commencer

• Ce guide de démarrage rapide suppose une compréhension élémentaire des concepts liés à Kubernetes. Pour plus d’informations, consultez Kubernetes concepts de base pour Azure Kubernetes Service (AKS).
• AKS Automatic enables Azure Policy sur votre cluster AKS, mais vous devez préinscrire le fournisseur de ressources Microsoft.PolicyInsights dans votre abonnement. Pour plus d’informations, consultez les fournisseurs de ressources Azure et les types.

Limites

Les limitations suivantes s’appliquent aux clusters automatiques AKS :

• AKS Automatic est généralement disponible dans les régions suivantes : australiaeast, austriaeast, belgiumcentral, brazilsouth, canadacentral, centralindia, centralus, chilecentral, denmarkeast, eastasia, eastus, eastus2, francecentral, germanywestcentral, indonesiacentral, israelcentral, italynorth, japaneast, japanwest, koreacentral, malaysiawest, mexicocentral, newzealandnorth, northeurope, norwayeast, polandcentral, southafricanorth, southcentralus, southeastasia, spaincentral, swedencentral, switzerlandnorth, uaenorth, uksouth, westeurope, westus2, westus3.
  • Par défaut, les nouveaux clusters automatiques AKS activent les pools de nœuds système managés et LocalDNS. Vous ne pouvez pas créer de clusters automatiques AKS sans pools de nœuds système managés dans n’importe quelle région.
• Le cluster automatique AKS est préconfiguré avec le verrouillage du groupe de ressources des nœuds, ce qui n’autorise pas les modifications du MC_ groupe de ressources et empêche les liens de réseau virtuel sur la zone DNS privée par défaut. Pour les scénarios DNS inter-réseaux virtuels ou personnalisés, utilisez un réseau personnalisé et un DNS privé en suivant Créer un cluster automatique de Azure Kubernetes Service (AKS) privé dans un réseau virtuel personnalisé.
• Azure CLI version 2.86.0 ou ultérieure est requise. Pour rechercher la version, exécutez az --version la commande. Si vous devez installer ou mettre à niveau, voir Installer Azure CLI.
• Les extensions suivantes ne sont pas prises en charge :
  • Dapr
  • Azure Machine Learning
• Les nœuds Windows ne sont pas pris en charge.
• La migration entre la référence SKU de base AKS et la référence SKU automatique n’est pas prise en charge.
• Les migrations entre les clusters automatiques AKS sans pools de nœuds système managés et les clusters automatiques AKS avec des pools de nœuds système managés ne sont pas prises en charge.

az group create --name myResourceGroup --location canadacentral

{
  "id": "/subscriptions/<guid>/resourceGroups/myResourceGroup",
  "location": "canadacentral",
  "managedBy": null,
  "name": "myResourceGroup",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null
}

az aks create \
    --resource-group myResourceGroup \
    --name myAKSAutomaticCluster \
    --sku automatic
    --enable-hosted-system

az aks show \
  --resource-group myResourceGroup \
  --name myAKSAutomaticCluster \
  --query hostedSystemProfile

{
  "enabled": true,
  "nodeSubnetId": null,
  "systemNodeSubnetId": null
}

@description('The name of the managed cluster resource.')
param clusterName string = 'myAKSAutomaticCluster'

@description('The location of the managed cluster resource.')
param location string = resourceGroup().location

resource aks 'Microsoft.ContainerService/managedClusters@2026-02-01' ' = {
  name: clusterName
  location: location
  sku: {
    name: 'Automatic'
  }
  identity: {
    type: 'SystemAssigned'
  }
}

Se connecter au cluster

Pour gérer un cluster Kubernetes, utilisez kubectl, le client de ligne de commande Kubernetes. kubectl est déjà installé si vous utilisez Azure Cloud Shell. Vous pouvez installer kubectl localement à l’aide de la az aks install-cli commande. Les clusters automatiques AKS sont configurés avec Microsoft Entra ID pour le contrôle d’accès en fonction du rôle Kubernetes (RBAC).

1. Configurez kubectl pour se connecter à votre cluster Kubernetes à l’aide de la commande az aks get-credentials. Cette commande télécharge les informations d’identification et configure l’interface CLI Kubernetes pour les utiliser.

   az aks get-credentials --resource-group myResourceGroup --name myAKSAutomaticCluster
   

2. Pour vérifier la connexion à votre cluster, exécutez la commande kubectl get. Cette commande renvoie la liste des nœuds de cluster.

   kubectl get nodes
   

   L’exemple de sortie suivant montre comment vous êtes invité à vous connecter :

   To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code AAAAAAAAA to authenticate.
   

   Une fois connecté, l’exemple de sortie suivant montre les pools de nœuds système managés. Assurez-vous que l’état du nœud est Prêt.

   NAME                           STATUS   ROLES    AGE   VERSION
   aks-hostedpool-16652789-vms1   Ready    <none>   19m   v1.34.7
   aks-hostedpool-16652789-vms2   Ready    <none>   19m   v1.34.7
   aks-hostedpool-16652789-vms3   Ready    <none>   19m   v1.34.7
   aks-system-surge-zq4d2         Ready    <none>   19m   v1.34.7
   

Déployer l’application

Pour déployer l’application, vous utilisez un fichier manifeste pour créer tous les objets requis pour exécuter l’application AKS Store. Un fichier manifeste Kubernetes définit un état souhaité d’un cluster, notamment les images conteneur à exécuter. Le manifeste inclut les déploiements et services Kubernetes suivants :

• Vitrine : application web permettant aux clients d’afficher les produits et de passer des commandes.
• Service de produit : affiche les informations sur le produit.
• Service de commande : passe des commandes.
• Rabbit MQ : file d’attente de messages pour une file d’attente de commandes.

1. Créez un espace de noms aks-store-demo pour y déployer les ressources Kubernetes.

   kubectl create ns aks-store-demo
   

2. Déployez l’application à l’aide de la commande kubectl apply dans l’espace de noms aks-store-demo. Le fichier YAML définissant le déploiement se trouve sur GitHub.

   kubectl apply -n aks-store-demo -f https://raw.githubusercontent.com/Azure-Samples/aks-store-demo/main/aks-store-ingress-quickstart.yaml
   

   L'exemple de sortie suivant montre les déploiements et les services :

   statefulset.apps/rabbitmq created
   configmap/rabbitmq-enabled-plugins created
   service/rabbitmq created
   deployment.apps/order-service created
   service/order-service created
   deployment.apps/product-service created
   service/product-service created
   deployment.apps/store-front created
   service/store-front created
   ingress/store-front created
   

Tester l’application

Quand l’application s’exécute, un service Kubernetes expose le front-end de l’application sur Internet. L’exécution de ce processus peut prendre plusieurs minutes.

1. Vérifiez l’état des pods déployés à l’aide de la commande kubectl get pods. Vérifiez que tous les pods sont Running avant de continuer. S’il s’agit de la première charge de travail que vous déployez, l’approvisionnement automatique de nœuds peut prendre quelques minutes pour créer un pool de nœuds pour exécuter les pods.

   kubectl get pods -n aks-store-demo
   

2. Recherchez une adresse IP publique pour l'application de vitrine. Surveillez la progression avec la commande kubectl get service et l’argument --watch.

   kubectl get ingress store-front -n aks-store-demo --watch
   

   La sortie ADDRESS pour le service store-front n’affiche rien initialement :

   NAME          CLASS                                HOSTS   ADDRESS        PORTS   AGE
   store-front   webapprouting.kubernetes.azure.com   *                      80      12m
   

3. Une fois qu’ADDRESS passe de rien à une adresse IP publique réelle, utilisez CTRL-C pour arrêter le processus de surveillance kubectl.

   L’exemple de sortie suivant montre une adresse IP publique valide affectée au service :

   NAME          CLASS                                HOSTS   ADDRESS        PORTS   AGE
   store-front   webapprouting.kubernetes.azure.com   *       4.255.22.196   80      12m
   

4. Ouvrez un navigateur web sur l’adresse IP externe de votre entrée pour afficher l’application Azure Store en action.

   

Supprimer le cluster

Si vous ne prévoyez pas de passer par le didacticiel AKS, supprimez les ressources inutiles pour éviter les frais Azure.

Supprimez le groupe de ressources, le service conteneur et toutes les ressources associées à l’aide de la commande az group delete.

az group delete --name myResourceGroup --yes --no-wait

Contenu connexe

Dans ce guide de démarrage rapide, vous avez déployé un cluster Kubernetes avec AKS Automatic, puis vous y avez déployé une application multiconteneur simple. Cet exemple d’application est fourni à des fins de version de démonstration uniquement et ne représente pas toutes les meilleures pratiques pour les applications Kubernetes. Pour obtenir des conseils sur la création de solutions complètes avec AKS pour la production, consultez Conseils pour les solutions AKS.

Pour en savoir plus sur AKS Automatic, consultez la Introduction pour Azure Kubernetes Service (AKS) Automatique