Explorer les flux de travail d’initialisation de l'Azure Developer CLI

Azure Developer CLI (azd) fournit un ensemble de commandes pour simplifier le développement, l’approvisionnement et le déploiement d’applications sur Azure. La azd init commande vous aide à configurer des projets nouveaux ou existants en générant les fichiers et configurations nécessaires pour travailler avec azd. Cet article explique les différents flux de travail d’initialisation disponibles et comment sélectionner la meilleure option pour votre scénario de développement.

Flux de travail d’initialisation

La azd init commande prend en charge plusieurs flux de travail pour préparer votre application à utiliser azd:

• Configurer avec GitHub Copilot (aperçu) : démarre une session de assistant Copilot dédiée qui peut planifier un projet, générer des ressources de modèle et valider le résultat.
• Analyser le répertoire actif : analyse une base de code d’application existante pour générer les fichiers et ressources de configuration appropriés azd .
• Sélectionnez un modèle : clone et initialise un modèle à partir d’une azdgalerie de modèles.
• Créez un projet minimal : initialise un fichier de base azure.yaml comme point de départ pour créer votre propre azd modèle à partir de zéro.

Pour le développement de modèles, utilisez Configurer avec GitHub Copilot (aperçu). Pour obtenir une vue d’ensemble du cycle de vie de création complet, consultez vue d’ensemble du développement de modèles. Les sections suivantes décrivent chaque flux de travail d’initialisation.

Configurer avec GitHub Copilot (aperçu)

Utilisez ce flux de travail pour créer un modèle avec une assistance IA. azddémarre une session gitHub dédiée assistant Copilot qui peut inspecter les fichiers projet existants ou vous aider à planifier un nouveau projet. L’agent génère des ressources standardazd, telles que azure.yaml, Bicep ou des fichiers Terraform et la configuration du conteneur, puis valide le résultat.

La session de l'agent s'exécute dans le terminal et ne poursuit pas une session gitHub Copilot Chat active à partir de Visual Studio Code. Pour obtenir des instructions détaillées et des prérequis, consultez Démarrer avec un nouveau modèle.

Scanner le répertoire courant

Utilisez ce flux de travail lorsque vous disposez d’une base de code d’application existante et que vous souhaitez la préparer pour le déploiement sur Azure à l’aide azdde .

1. Accédez au répertoire racine de votre projet.

2. Exécutez la commande azd init.

   azd init
   

3. Sélectionnez Analyser le répertoire actif. azd va effectuer les actions suivantes :

   • Analysez votre répertoire pour déterminer la langue ou l’infrastructure utilisée par votre application.
   • Sélectionnez une plateforme d’hébergement appropriée, telle qu’Azure Container Apps.
   • Vous inviter à ajouter ou supprimer des services découverts si nécessaire

   ? How do you want to initialize your app? Scan current directory
   
     (✓) Done: Scanning app code in current directory
   
   Detected services:
   
     .NET
     Detected in: src
   
   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
     Remove a detected service
     Add an undetected service
   

4. Sélectionnez Confirmer et continuer à initialiser mon application pour terminer le flux de travail. azd crée les éléments suivants dans le répertoire de votre application :

   • Fichier azure.yaml qui définit vos services d’application et les mappe aux ressources d’hébergement.
   • Dossier .azure contenant les paramètres de configuration tels que le nom de votre environnement.
   • Fichier .gitignore configuré pour la langue de votre application et la plateforme d’hébergement.

5. Si vous le souhaitez, exécutez azd up pour créer les ressources Azure Container Apps et déployer votre application.

Votre application est désormais structurée en tant que azd modèle que vous pouvez continuer à développer et à étendre avec davantage de ressources et de services Azure.

Sélectionner un modèle

Ce flux de travail vous permet de commencer par un modèle prédéfini azd qui inclut généralement le code d’application et les définitions d’infrastructure Azure nécessaires.

1. Exécutez la commande azd init :

   azd init
   

   Remarque

   Vous pouvez également exécuter azd init avec le --template paramètre pour initialiser directement un modèle par nom et ignorer la sélection du flux de travail.

2. Sélectionnez un modèle. azd affiche la liste des modèles disponibles à partir de vos sources de modèles configurées.

   ? How do you want to initialize your app? Select a template
   ? Select a project template:  [Use arrows to move, type to filter]
   > Deploy Phoenix to Azure
     (Arize-ai/phoenix-on-azure)
   
     API Center Reference Sample
     (Azure-Samples/APICenter-Reference)
   
     Event Driven Java Application with Azure Service Bus on Azure Spring Apps
     (Azure-Samples/ASA-Samples-Event-Driven-Application)
   
     Static React Web App with Java API and PostgreSQL
     (Azure-Samples/ASA-Samples-Web-Application)
   

3. Tapez pour filtrer les résultats et rechercher le Hello AZD modèle. Sélectionnez le modèle à cloner et initialiser.

4. Si vous le souhaitez, exécutez azd up pour provisionner et déployer les ressources de modèle sur Azure.

Vous pouvez également utiliser le modèle initialisé comme point de départ pour un développement ultérieur.

Créer un projet minimal

Pour les utilisateurs avancés qui souhaitent commencer avec une configuration minimale et personnaliser tout manuellement, cette option fournit uniquement la configuration essentielle.

1. Exécutez la azd init commande avec l’indicateur --minimal :

   azd init --minimal
   

2. Lorsque vous y êtes invité, entrez un nom pour votre azd modèle, puis sélectionnez Entrée.

   ? How do you want to initialize your app? Create a minimal project
   ? What is the name of your project? (empty) hello-azd
   ? What is the name of your project? hello-azd
   
   SUCCESS: Generated azure.yaml project file.
   

   L’indicateur --minimal crée uniquement les éléments suivants :

   • Fichier de base azure.yaml portant le nom du projet
   • Répertoire .azure pour la configuration de l’environnement
   • Fichier .gitignore avec les entrées appropriées pour Azure Developer CLI

   Cette initialisation simplifiée est idéale lorsque vous procédez comme suit :

   • Vous souhaitez créer votre infrastructure à partir de zéro
   • Besoin d’intégrer azd un projet complexe existant
   • Préférer un contrôle total sur la structure de votre projet

3. Terminez la configuration du projet. Vous pouvez créer manuellement des fichiers d’infrastructure dans un infra dossier, demander à un agent de codage IA de créer l’infrastructure et azure.yaml personnaliser pour définir vos services et ressources.

Nommage des ressources Project et Azure

Lorsque vous initialisez un projet nouveau ou existant, le nom du projet est défini dans azure.yaml. Le nom du projet agit comme préfixe pour les noms de ressources Azure créés pendant le processus d’approvisionnement. En respectant les règles de validation, vous vérifiez que les noms de ressources Azure générés seront également valides.

Dans les modèles Bicep ou Terraform, le nom du projet est souvent utilisé comme base pour construire des noms de ressources, combinés avec le nom de l’environnement et d’autres éléments. Par exemple:

var resourceToken = '${name}-${environmentName}'

Où name fait référence au nom du projet et environmentName est le nom de votre azd environnement.

Règles de validation de nom de projet

Lors de l’initialisation azd init d’un projet ou lors de la création d’un nom de projet dans le azure.yaml fichier, les règles de validation suivantes sont appliquées :

Règle	Descriptif
Caractères autorisés	Les noms de projet peuvent inclure uniquement des lettres minuscules, des chiffres et des traits d’union.
Caractère de départ	Les noms de projet doivent commencer par une lettre.
Caractère de fin	Les noms de projet ne doivent pas se terminer par un trait d’union.
Longueur	Les noms de projet doivent être compris entre 2 et 63 caractères.
Aucun trait d’union consécutif	Les noms de projet ne peuvent pas contenir de traits d’union consécutifs.

Ces règles de validation garantissent que le nom de votre projet est compatible avec les exigences de nommage des ressources Azure et empêche les échecs d’empaquetage de service pendant le déploiement.

Étapes suivantes

Après avoir initialisé votre projet avec azd init, vous pouvez :

• Modifiez les fichiers d’infrastructure générés pour personnaliser vos ressources Azure.
• Permet azd provision de créer les ressources requises dans Azure.
• Permet azd deploy de déployer le code de votre application sur les ressources approvisionnées.
• Découvrez le flux de travail 'up' d'Azure Developer CLI pour combiner l’approvisionnement et le déploiement en une seule commande.

Contenu connexe

• Commandes Azure Developer CLI
• Référence du schéma Azure.yaml
• Modèles Azure Developer CLI
• Galeries de modèles