Démarrage rapide : Déployer et gérer des applications à l’aide d’AKS Desktop

Le déploiement et la gestion des applications Kubernetes nécessitent généralement l’écriture de manifestes YAML, l’exécution de commandes kubectl et le basculement entre plusieurs outils. Le bureau AKS supprime cette complexité avec des flux de travail guidés qui permettent aux développeurs et aux ingénieurs DevOps de déployer, surveiller, dépanner et nettoyer les applications sans expertise approfondie de Kubernetes.

Ce guide vous guide tout au long du déploiement d’une application TypeScript à l’aide d’AKS Desktop, de la création d’un cluster via l’exploration des journaux d’application, des métriques, de la mise à l’échelle et des outils de dépannage intégrés.

Prerequisites

  • Un abonnement Azure. Si vous n’avez pas d’abonnement Azure, vous pouvez créer un compte Azure gratuit.
  • Azure CLI version 2.64.0 ou ultérieure doit être installé. Vérifiez votre version en utilisant la commande az --version. Pour installer ou mettre à niveau, consultez Install Azure CLI.
  • L'extension aks-preview Azure CLI. Installez-le à l’aide de la az extension add --name aks-preview commande.
  • AKS desktop installé. AKS Desktop prend en charge les systèmes d’exploitation suivants : Windows, Linux et Mac.
  • Si vous utilisez un cluster existant, le cluster doit être authentifié par l’ID Microsoft Entra. Pour vous assurer que votre cluster est authentifié par l’ID Microsoft Entra, utilisez un cluster automatique AKS. Vous avez également besoin du rôle Administrateur du cluster RBAC Azure Kubernetes Service ou des autorisations équivalentes sur le cluster cible.

Créer des ressources Azure

Si vous ne disposez pas d’un cluster AKS existant et d’Azure Container Registry (ACR), vous pouvez les créer à l’aide d’Azure CLI. Ces sections montrent comment créer un groupe de ressources, un cluster AKS et ACR. Si vous disposez déjà de ces ressources, vous pouvez ignorer l’inscription de votre cluster auprès d’AKS Desktop.

Définir des variables d’environnement

Pour simplifier les commandes, définissez les variables d’environnement suivantes dans votre terminal. Veillez à définir myLocation sur votre région Azure. L’exemple ci-dessous utilise RAND pour créer des noms de ressources uniques. Vous pouvez les remplacer par vos propres valeurs si vous préférez.

RAND=$RANDOM
export RAND
echo "Random resource identifier will be: ${RAND}"
myResourceGroup=bbash$RAND
myLocation=westus3
myClusterName=clu-$RAND
registryName=bbashreg$RAND

Créer un groupe de ressources

Créez un groupe de ressources Azure à l’aide de la commande az group create.

az group create --name $myResourceGroup --location $myLocation

Créer un registre de conteneurs Azure

Créez un registre de conteneurs Azure à l’aide de la commande az acr create.

az acr create --resource-group $myResourceGroup --name $registryName --sku Basic

Créer un cluster AKS avec intégration ACR

Créez un cluster AKS avec l’intégration ACR à l’aide de la az aks create commande. Le --attach-acr paramètre accorde l’autorisation de cluster AKS pour extraire des images à partir de l’ACR. Cet exemple de commande définit également la valeur de --sku à automatic. Nous vous recommandons d’utiliser des clusters automatiques AKS pour une expérience optimale avec le bureau AKS, mais vous pouvez également utiliser un cluster Standard.

az aks create --resource-group $myResourceGroup --name $myClusterName --sku automatic --attach-acr $registryName

Accorder des autorisations d’administrateur de cluster

  1. Obtenez l’ID de ressource de cluster à l’aide de la commande et définissez-la az aks show sur une variable d’environnement.

    AKS_ID=$(az aks show --resource-group $myResourceGroup --name $myClusterName --query id --output tsv)

  2. Accordez-vous des autorisations d’administrateur au cluster à l’aide de la az role assignment create commande avec le rôle Administrateur du cluster RBAC Azure Kubernetes Service. Veillez à remplacer <your-entra-id> par votre ID d’objet Microsoft Entra ID.

    az role assignment create --role "Azure Kubernetes Service RBAC Cluster Admin" \
   --assignee <your-entra-id> \
   --scope $AKS_ID

Créer une image conteneur à des fins de test

Cet exemple crée une image à partir de l’exemple d’application Contoso Air, mais vous pouvez utiliser n’importe quelle image conteneur pour tester le déploiement d’une application avec le bureau AKS. Si vous souhaitez utiliser une autre image, veillez à remplacer les détails de l’image dans les étapes de déploiement.

  1. Créez un répertoire, accédez-y et clonez l’exemple d’application Contoso Air. Accédez ensuite au répertoire de l’application web. Si vous utilisez une autre application ou structure de répertoires, ajustez ces commandes en conséquence.

    mkdir myapp
cd myapp
git clone https://github.com/Azure-Samples/contoso-air
cd contoso-air/src/web

  2. Générez et expédiez l'image de conteneur à votre registre de conteneurs en utilisant la commande az acr build. Si vous utilisez une autre image, veillez à mettre à jour le nom et le chemin d’accès de l’image en conséquence.

    az acr build --resource-group $myResourceGroup --registry $registryName --image contosoair:v1 .

Inscrire votre cluster auprès d’AKS Desktop

  1. Vérifiez que vous êtes connecté au bureau AKS avec le même compte qui a accès au cluster AKS. Une fois connecté, sélectionnez Ajouter à partir d’un abonnement Azure.

  2. Entrez le nom de votre abonnement Azure si vous en avez plusieurs. (Vous pouvez également sélectionner la flèche pour ouvrir la liste déroulante, puis sélectionner votre abonnement Azure.)

  3. Sélectionnez votre cluster, puis sélectionnez Inscrire le cluster

    Vidéo montrant comment ajouter un cluster à l’application de bureau AKS.

Créer un projet managé dans le bureau AKS

  1. Dans le bureau AKS, accédez à l’onglet Projets , puis sélectionnez Créer un projet géré.

  2. Configurez les paramètres de projet suivants :

    • Principes de base :
      • Nom du projet : par exemple, my-dev-frontend
      • Abonnement : <your-subscription-name>
      • Cluster : <your-cluster-name>

    Note

    Lors de la configuration de l’abonnement Azure et du cluster AKS, l'interface AKS procède à la vérification de la compatibilité des fonctionnalités de cluster et d’abonnement nécessaires à une utilisation optimale de l'interface AKS.

    • Stratégies de mise en réseau : vous pouvez conserver les paramètres par défaut pour ce guide de démarrage rapide ou les mettre à jour si nécessaire.

      • Pour exposer l’application publiquement, remplacez Ingress par Allow all traffic.

    • Quota de calcul : laissez la valeur par défaut pour l’application de test.

    • Accès : ajoutez une personne ou supprimez l’entrée en supprimant l’élément de ligne.

  3. Sous Révision, vérifiez les paramètres de votre projet, puis sélectionnez Créer un projet.

    Capture d’écran de la création d’un projet dans le bureau AKS.

Déployer une application

  1. Fournissez un nom d’application, puis sélectionnez Créer une application.

    Capture d’écran de la création d’une application dans le bureau AKS.

  2. Sélectionnez une source pour votre application. Pour cet exemple, sélectionnez Image de conteneur>Suivant.

    Capture d’écran de la sélection d’une source pour une nouvelle application dans le bureau AKS.

  3. Configurez les paramètres d’application suivants. Vous pouvez accepter les valeurs par défaut ou les mettre à jour si nécessaire.

    • Nom de l’image conteneur :

      • Ajoutez le nom de votre image conteneur. Dans cet exemple, nous utilisons myacr.azurecr.io/contosoair:v1.

      Important

      Vous ne pouvez pas utiliser la latest balise. Spécifiez une balise explicite telle que v1.

    • Mise en réseau :

      • Port cible : pour l’exemple de conteneur, défini sur 3000.
      • Activer l’accès public : définissez si vous souhaitez accéder à l’application à partir d’une URL publique.

    • HPA (autoscaler de pod horizontal) :

      • Activer HPA : Définir pour activer la mise à l’échelle automatique de l’application en fonction de l’utilisation des ressources.

  4. Sélectionnez Déployer pour déployer l’application. Le déploiement de l’application peut prendre quelques minutes. Vous pouvez afficher l’état du déploiement dans la page vue d’ensemble du projet. Attendez que toutes les ressources affichent un état sain avant d’explorer l’application.

    Capture d’écran d’un écran vue d’ensemble du projet dans le bureau AKS.

Explorer l’application

Dans la page vue d’ensemble du projet, vous pouvez explorer votre application à l’aide des onglets suivants :

  • Ressources : affichez toutes les ressources Kubernetes pour l’application.
  • Carte : visualisez la façon dont toutes les ressources Kubernetes interagissent et dépendent les unes des autres.
  • Logs : Affichez les logs des pods.
  • Métriques : afficher la consommation de ressources d’application principale.
  • Mise à l’échelle : affichez les événements de mise à l’échelle et effectuez des mises à jour.
  • Insights : Résoudre les défaillances DNS, le trafic réseau et l’utilisation des ressources (préversion). Pour plus d’informations, consultez Résoudre les problèmes d’une application dans le bureau AKS à l’aide d’Insights.
  • Supprimer : supprimez le projet.
  • Assistant IA : Utilisez le langage naturel pour diagnostiquer et résoudre les problèmes dans votre cluster (préversion). Pour plus d’informations, consultez l’Assistant Résolution des problèmes liés à l’IA dans l’interface AKS.

Nettoyer les ressources

Une fois le démarrage rapide terminé, vous pouvez nettoyer les ressources que vous avez créées pour éviter les coûts inutiles.

Pour supprimer le projet, sélectionnez Supprimer. Si vous souhaitez également supprimer la ressource d’espace de noms managé Azure sous-jacente, sélectionnez Également supprimer les espaces de noms.

Contenu connexe

Pour plus d’informations sur le bureau AKS, consultez les ressources suivantes :

  • Last updated on