Esplorare i flussi di lavoro di inizializzazione dell'interfaccia della riga di comando per sviluppatori di Azure

L'interfaccia della riga di comando per sviluppatori di Azure (azd) offre un set di comandi per semplificare lo sviluppo, il provisioning e la distribuzione di app in Azure. Il azd init comando consente di configurare progetti nuovi o esistenti generando i file e le configurazioni necessari per lavorare con azd. Questo articolo illustra i diversi flussi di lavoro di inizializzazione disponibili e come selezionare l'opzione migliore per lo scenario di sviluppo.

Flussi di lavoro di inizializzazione

Il azd init comando supporta diversi flussi di lavoro per preparare l'app per l'uso con azd:

• Analizza la directory corrente: analizza una codebase di app esistente per generare i file e le risorse di configurazione appropriati azd.
• Selezionare un modello: clona e inizializza un modello da una azdraccolta di modelli.
• Creare un progetto minimo: inizializza un file di base azure.yaml come punto di partenza per la creazione di un modello personalizzato azd da zero.

Scegliere l'approccio più adatto al progetto. Tutti questi flussi sono descritti in modo più dettagliato nella panoramica di Creare modelli e negli articoli correlati. Le sezioni seguenti forniscono una panoramica concettuale di ogni flusso.

Analizzare la directory corrente

Usare questo flusso di lavoro quando si ha una codebase di app esistente e si vuole prepararla per la distribuzione in Azure usando azd.

1. Passare alla directory radice del progetto.

2. Eseguire il comando azd init:

   azd init
   

3. Selezionare Analizza directory corrente. azd sarà:

   • Analizzare la directory per determinare il linguaggio o il framework usato dall'app.
   • Selezionare una piattaforma di hosting appropriata, ad esempio App Azure Container.
   • Richiedere di aggiungere o rimuovere i servizi individuati, se necessario.

   ? 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. Selezionare Conferma e continuare a inizializzare l'app per completare il flusso di lavoro. azd crea quanto segue nella directory dell'app:

   • File azure.yaml che definisce i servizi dell'app e li mappa alle risorse di hosting.
   • Una .azure cartella per contenere impostazioni di configurazione, come ad esempio il nome dell'ambiente.
   • Un .gitignore file configurato per la lingua dell'app e la piattaforma di hosting.

5. Facoltativamente, eseguire azd up per creare le risorse di App Azure Container e distribuire l'app.

L'app è ora strutturata come modello azd che è possibile continuare a sviluppare ed espandere con più risorse e servizi di Azure.

Selezionare un modello

Questo flusso di lavoro consente di iniziare con un modello predefinito azd che in genere include sia il codice dell'applicazione che le definizioni dell'infrastruttura di Azure necessarie.

1. Eseguire il comando azd init:

   azd init
   

   Annotazioni

   È anche possibile eseguire azd init con il --template parametro per inizializzare direttamente un modello in base al nome e ignorare la selezione del flusso di lavoro.

2. Scegliere Seleziona un modello. azd visualizza un elenco di modelli disponibili dalle fonti dei modelli configurate.

   ? 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. Digitare per filtrare i risultati e cercare il Hello AZD modello. Premere INVIO per clonare e inizializzare il modello.

4. Facoltativamente, eseguire azd up per effettuare il provisioning e distribuire le risorse del modello in Azure.

È anche possibile usare il modello inizializzato come punto di partenza per un ulteriore sviluppo.

Creare un progetto minimo

Per gli utenti avanzati che vogliono iniziare con una configurazione minima e personalizzare tutto manualmente, questa opzione fornisce solo la configurazione essenziale.

1. Eseguire il azd init comando con il --minimal flag :

   azd init --minimal
   

2. Quando richiesto, immettere un nome per il azd modello e premere INVIO.

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

   Il --minimal flag crea solo quanto segue:

   • Un file di base azure.yaml con solo il nome del progetto e schemaVersion
   • Directory .azure per la configurazione dell'ambiente
   • Un .gitignore file con voci appropriate per la CLI dello sviluppatore Azure

   Questa inizializzazione semplificata è ideale quando:

   • Si vuole creare l'infrastruttura da zero
   • È necessario eseguire l'integrazione azd con un progetto complesso esistente
   • Pianificare l'uso del azd add comando per compilare in modo incrementale l'architettura
   • Preferire il controllo completo sulla struttura del progetto

3. Dopo l'inizializzazione, è possibile:

   • Creare manualmente i file di infrastruttura in una infra cartella
   • Usare la azd addfunzionalità compose per iniziare ad aggiungere risorse di Azure all'app
   • Personalizzare il azure.yaml file per definire i servizi e le risorse

Denominazione delle risorse di Project e Azure

Quando si inizializza un progetto nuovo o esistente, il nome del progetto viene impostato in azure.yaml. Il nome del progetto funge da prefisso per i nomi delle risorse di Azure creati durante il processo di provisioning. Rispettando le regole di convalida, assicurarsi che anche i nomi delle risorse di Azure generati siano validi.

Nei modelli Bicep o Terraform il nome del progetto viene spesso usato come base per costruire nomi di risorse, combinati con il nome dell'ambiente e altri elementi. Per esempio:

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

Dove name fa riferimento al nome del progetto e environmentName è il nome dell'ambiente azd .

Regole di convalida del nome del progetto

Quando si usa azd init per inizializzare un progetto o quando si crea un nuovo nome di azure.yaml progetto nel file, vengono applicate le regole di convalida seguenti:

Queste regole di convalida assicurano che il nome del progetto sia compatibile con i requisiti di denominazione delle risorse di Azure e impedire errori di creazione di pacchetti di servizi durante la distribuzione.

Passaggi successivi

Dopo aver inizializzato il progetto con azd init, è possibile:

• Modificare i file di infrastruttura generati per personalizzare le risorse di Azure.
• Usare azd provision per creare le risorse necessarie in Azure.
• Usare azd deploy per distribuire il codice dell'applicazione nelle risorse approvvigionate.
• Scopri il flusso di lavoro di Azure Developer CLI per combinare il provisioning e la distribuzione in un singolo comando.

Contenuti correlati

• Comandi dell'interfaccia della riga di comando per sviluppatori di Azure
• Informazioni di riferimento sullo schema Azure.yaml
• modelli dell'interfaccia della riga di comando per sviluppatori di Azure
• Raccolte di modelli