Partager via

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:

  • 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.

Choisissez l’approche qui correspond le mieux à votre projet. Tous ces flux sont décrits plus en détail dans l’Aperçu de la création de modèles et des articles connexes. Les sections suivantes fournissent une vue d’ensemble conceptuelle de chaque flux.

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. Appuyez sur Entrée pour cloner et initialiser le modèle.

  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 appuyez sur 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.
Run azd add to add new Azure components to your project.

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

    • Fichier de base azure.yaml avec uniquement le nom du projet et schemaVersion
    • 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
    • Planifier l’utilisation de la azd add commande pour générer de façon incrémentielle votre architecture
    • Préférer un contrôle total sur la structure de votre projet

  3. Après l’initialisation, vous pouvez :

    • Créer manuellement vos fichiers d’infrastructure dans un infra dossier
    • Utiliser la azd addfonctionnalité de composition pour commencer à ajouter des ressources Azure à votre application
    • Personnaliser votre azure.yaml fichier 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

  • Last updated on