Tutoriel : Déployer un projet .NET Aspire à l’aide du Azure Developer CLI

Le Azure Developer CLI (azd) vous permet de déployer des projets .NET Aspire à l’aide de GitHub Actions ou Azure pipelines Devops en configurant automatiquement les paramètres d’authentification et d’environnement requis. Cet article vous guide tout au long du processus de création et de déploiement d’un projet .NET Aspire sur Azure Container Apps à l’aide de azd. Vous découvrez les concepts suivants :

• Découvrez comment l’intégration azd fonctionne avec des projets .NET.NET Aspire
• Créez et configurez un dépôt GitHub ou Azure DevOps pour un projet .NET Aspire à l’aide de azd
• Surveiller et explorer GitHub flux de travail Actions ou Azure exécutions de pipeline DevOps et Azure déploiements

Conditions préalables

Pour utiliser .NET.NET Aspire, vous avez besoin de l’installation locale suivante :

• .NET 8.0 ou .NET 9.0
• Un runtime de conteneur conforme à OCI, tel que :
  • Docker Desktop ou Podman. Pour plus d'informations, consultez la section de l'environnement d'exécution des conteneurs.
• Un environnement de développement intégré (IDE) ou un éditeur de code, par exemple :
  • Visual Studio 2022 version 17.9 ou ultérieure (facultatif)
  • Visual Studio Code (facultatif)
    • C# Dev Kit: Extension (facultatif)
  • JetBrains Rider avec .NET.NET Aspire plug-in (facultatif)

Pour plus d’informations, consultez .NET.NET Aspirede configuration et d’outils et .NET.NET Aspire SDK.

• Créer une organisation Azure DevOps ou choisir une organisation existante
• Créer un jeton d’accès personnel DevOps Azure et l’enregistrer pour une utilisation ultérieure. Configurez le jeton avec les autorisations suivantes :
  • Pools d’agents (lecture, gestion)
  • Construire (lecture et exécution)
  • Code (complet)
  • Projet et équipe (lecture, écriture et gestion)
  • Mise en production (lecture, écriture, exécution et gestion)
  • Connexions de service (lecture, requête et gestion)

Vous devez également avoir le Azure Developer CLIinstallé localement (version 1.5.1 ou ultérieure). Les options d’installation courantes sont les suivantes :

Windows

winget install microsoft.azd

macOS

brew tap azure/azd && brew install azd

Linux

curl -fsSL https://aka.ms/install-azd.sh | bash

Créer une solution .NET.NET Aspire

Comme point de départ, cet article part du principe que vous avez créé une solution .NET.NET Aspire à partir du modèle .NET.NET Aspire Starter Application. Pour plus d’informations, consultez Démarrage rapide : Créer votre première application .NET.NET Aspire.

Initialiser le modèle

1. Ouvrez une nouvelle fenêtre de terminal et cd dans le répertoire de votre solution de .NET.NET Aspire.

2. Exécutez la commande azd init pour initialiser votre projet avec azd, qui inspecte la structure de répertoires local et détermine le type d’application.

   azd init
   

   Pour plus d’informations sur la commande azd init, consultez azd init.

3. Sélectionnez Utiliser du code dans le répertoire actif lorsque azd vous invite à utiliser deux options d’initialisation d’application.

   ? How do you want to initialize your app?  [Use arrows to move, type to filter]
   > Use code in the current directory
     Select a template
   

4. Après avoir analysé le répertoire, azd vous invite à confirmer qu'il a trouvé le projet AppHost approprié .NET.NET Aspire. Sélectionnez l’option Confirmer et continuer à initialiser mon application.

   Detected services:
   
     .NET (Aspire)
     Detected in: D:\source\repos\AspireSample\AspireSample.AppHost\AspireSample.AppHost.csproj
   
   azd will generate the files necessary to host your app on Azure using Azure Container Apps.
   
   ? Select an option  [Use arrows to move, type to filter]
   > Confirm and continue initializing my app
     Cancel and exit
   

5. Entrez un nom d’environnement, utilisé pour nommer les ressources provisionnée dans Azure et gérer différents environnements tels que dev et prod.

   Generating files to run your app on Azure:
   
     (✓) Done: Generating ./azure.yaml
     (✓) Done: Generating ./next-steps.md
   
   SUCCESS: Your app is ready for the cloud!
   You can provision and deploy your app to Azure by running the azd up command in this directory. For more information on configuring your app, see ./next-steps.md
   

azd génère un certain nombre de fichiers et les place dans le répertoire de travail. Ces fichiers sont les suivants :

• azure.yaml: décrit les services de l’application, tels que .NET Aspire projet AppHost, et les mappe aux ressources Azure.
• .azure/config.json: fichier de configuration qui informe azd de quel est l'environnement actif actuel.
• .azure/aspireazddev/.env: contient des remplacements spécifiques à l’environnement.

Créer le référentiel et le pipeline GitHub

Le Azure Developer CLI vous permet de créer automatiquement des pipelines CI/CD avec les configurations et autorisations appropriées pour approvisionner et déployer des ressources sur Azure. azd pouvez également créer un référentiel GitHub pour votre application s’il n’existe pas déjà.

1. Exécutez la commande azd pipeline config pour configurer votre pipeline de déploiement et le connecter en toute sécurité à Azure:

   azd pipeline config
   

2. Sélectionnez l’abonnement dans lequel approvisionner et déployer les ressources de l’application.

3. Sélectionnez l’emplacement Azure à utiliser pour les ressources.

4. Lorsqu'on vous demande si vous souhaitez créer un nouveau référentiel Git dans le répertoire, entrez y et appuyez sur Entrée.

   Note

   La création d’un référentiel GitHub vous oblige à vous connecter à GitHub. Il existe quelques sélections qui varient en fonction de vos préférences. Après vous être connecté, vous serez invité à créer un nouveau dépôt dans le répertoire actuel.

5. Sélectionnez Créer un dépôt de GitHub privé pour configurer git distant.

6. Entrez un nom de votre choix pour le nouveau référentiel GitHub ou appuyez sur Entrée pour utiliser le nom par défaut. azd crée un référentiel dans GitHub et le configure avec les secrets nécessaires pour s’authentifier auprès de Azure.

   

7. Entrez y pour continuer lorsque azd vous invite à valider et à envoyer (push) vos modifications locales pour démarrer le pipeline configuré.

Explorer le flux de travail et le déploiement des actions GitHub

1. Accédez à votre nouveau référentiel GitHub en utilisant le lien généré par azd.

2. Sélectionnez l’onglet Actions pour afficher les flux de travail du référentiel. Vous devez voir le nouveau flux de travail en cours d’exécution ou déjà terminé. Sélectionnez le flux de travail pour afficher les étapes du travail et les détails dans les journaux d’activité de l’exécution. Par exemple, vous pouvez développer des étapes telles que Installer .NET.NET Aspire charge de travail ou Déployer l’application pour afficher les détails de l’action terminée.

   

3. Sélectionnez Déployer l’application pour développer les journaux d’activité de cette étape. Vous devriez voir deux URLs d'endpoint imprimées pour le apiservice et le webfrontend. Sélectionnez l’un de ces liens pour les ouvrir dans un autre onglet de navigateur et explorez l’application déployée.

   

Félicitations! Vous avez déployé avec succès un projet .NET Aspire à l’aide du Azure Developer CLI et des actions de GitHub.

Créer le dépôt DevOps Azure et le pipeline

Important

Comme indiqué dans les conditions préalables, vous devez créer une organisation Azure DevOps ou sélectionner une organisation existante pour effectuer les étapes à suivre. Vous devez également créer un jeton d’accès personnel (PAT) avec les autorisations répertoriées dans les prérequis.

Le Azure Developer CLI vous permet de créer automatiquement des pipelines avec les configurations et autorisations appropriées pour approvisionner et déployer des ressources sur Azure. azd pouvez également créer un référentiel Azure Pipelines pour votre application s’il n’existe pas déjà.

1. Exécutez la commande azd pipeline config pour configurer votre pipeline de déploiement et connectez-le en toute sécurité à Azure. Incluez l’option --provider azdo pour utiliser Azure pipelines au lieu de la configuration des actions par défaut GitHub.

   azd pipeline config --provider azdo
   

2. Sélectionnez l’abonnement dans lequel approvisionner et déployer les ressources de l’application.

3. Sélectionnez l’emplacement Azure à utiliser pour les ressources.

4. Collez le jeton d’accès personnel que vous avez créé précédemment.

5. Entrez le Azure nom de l’organisation DevOps que vous avez créé ou sélectionné.

6. Lorsque vous êtes invité à créer un référentiel dans le répertoire actuel, entrez et et appuyez sur Entrée.

7. Lorsque vous êtes invité à configurer le dépôt git distant, sélectionnez Créer un nouveau projet DevOps Azure.

8. Entrez un nom unique de votre choix pour le nouveau référentiel, tel que aspireazd. azd crée un référentiel dans Azure Repos et le configure avec les secrets nécessaires pour s’authentifier auprès de Azure.

   

9. Entrez y pour continuer lorsque azd vous invite à valider et à envoyer (push) vos modifications locales pour démarrer le pipeline configuré.

Explorer le pipeline et l’appli déployée

1. Accédez à votre nouveau pipeline Azure à l’aide du lien de statut généré par azd.

   

2. Sélectionnez l’exécution du pipeline terminée pour afficher le résumé.

   

3. Sélectionnez le lien de travail en bas de la vue pour accéder aux détails du travail.

   

4. La page détails du travail affiche l’état de toutes les étapes individuelles. Sélectionnez Provisionner l’infrastructure pour afficher les journaux d’activité de cette étape, qui détaillent toutes les étapes d’approvisionnement effectuées par azd. En bas des journaux, notez le message d’état final et le lien vers le groupe de ressources provisionné Azure.

5. Sélectionnez le lien en bas des journaux de sortie d’approvisionnement pour accéder au nouveau groupe de ressources Azure.

   

   Note

   Vous pouvez également accéder directement à votre nouveau groupe de ressources en le recherchant dans le portail Azure. Le nom de votre groupe de ressources est le nom d’environnement que vous avez fourni pour azd précédé de rg-.

6. Sélectionnez l’application conteneur webfrontend, qui héberge la partie publique de votre site.

7. Sur la page de détails du webfrontend , sélectionnez le lien URL de l'application pour ouvrir votre site dans le navigateur.

Important

Si vous rencontrez une erreur 403 Forbidden lors de l’affichage de votre site dans le navigateur, vérifiez que les paramètres d’entrée sont configurés correctement. Sur la page de l'application webfrontend dans le portail Azure, accédez à Ingress dans la navigation à gauche. Assurez-vous que de trafic d’entrée est défini sur Accepter le trafic n’importe où et enregistrez vos modifications.

Félicitations! Vous avez déployé avec succès un projet .NET Aspire à l’aide des pipelines Azure Developer CLI et Azure.

Nettoyer les ressources

Exécutez la commande CLI Azure suivante pour supprimer le groupe de ressources lorsque vous n’avez plus besoin des ressources Azure que vous avez créées. La suppression du groupe de ressources supprime également les ressources contenues à l’intérieur de celui-ci.

az group delete --name <your-resource-group-name>

Pour plus d’informations, consultez Nettoyer les ressources dans Azure.