Iniziare con un nuovo modello dell'interfaccia della riga di comando per sviluppatori di Azure (azd)

È possibile usare metodi di creazione diversi per compilare i file standard in un nuovo modello Azure Developer CLI (azd):

• Usa l'integrazione GitHub Copilot in azd init. Il flusso di lavoro predefinito analizza i file di progetto esistenti o consente di pianificare un nuovo progetto, creare gli asset del modello ed eseguire la convalida preliminare della distribuzione.
• Usare un altro assistente per la scrittura del codice di intelligenza artificiale. Chiedi all'assistente di creare gli stessi azure.yaml, l'infrastruttura come codice, l'applicazione e i file di supporto senza integrare direttamente con azd init.
• Creare direttamente i file. Crea e modifica tu stesso le risorse del modello se vuoi il controllo completo o non usi un assistente di codifica basato sull'IA.

Questo articolo è incentrato principalmente sul flusso di lavoro GitHub Copilot predefinito, perché offre un'esperienza guidata integrata con azd. Indipendentemente dal metodo di creazione, esaminare e convalidare ogni file prima della distribuzione.

Importante

L'integrazione GitHub Copilot in azd init è disponibile in anteprima. Le funzionalità di anteprima possono cambiare prima della disponibilità generale. Per altre informazioni, consultare la azdstrategia di rilascio e gestione delle versioni delle funzionalità.

Gli asset generati sono file modello standard e modificabili azd . Dopo l'inizializzazione, è possibile aggiornarli direttamente o con qualsiasi assistente per la codifica di intelligenza artificiale.

Prerequisiti per GitHub Copilot

Per usare il flusso di lavoro Copilot predefinito, è necessario:

• Azure Developer CLI 1.23.11 o versione successiva.
• Sottoscrizione attiva GitHub Copilot.
• Git, che azd init usa per controllare l'albero di lavoro prima di modificare i file.
• Una sessione interattiva del terminale.

Se non hai già effettuato l'autenticazione con GitHub Copilot, azd ti chiede di accedere.

Eseguire azd version per controllare la versione installata dell'interfaccia della riga di comando per sviluppatori Azure.

Note

Il flusso di lavoro azd init avvia una sessione dedicata di GitHub agente Copilot nel terminale. Non usa o continua una sessione di GitHub Copilot Chat attiva in Visual Studio Code.

Compilazione con GitHub Copilot

1. Aprire un terminale nella directory in cui si vuole compilare il modello.

   Note

   La directory può contenere un'applicazione esistente, un progetto di infrastruttura o i file iniziali per una nuova soluzione. Se la directory contiene modifiche di cui non è stato eseguito il commit, azd chiede di confermare prima di continuare. Effettua prima il commit o metti da parte le modifiche importanti.

2. Esegui azd init:

   azd init
   

3. Selezionare Configura con GitHub Copilot (anteprima).

   Il prompt di inizializzazione è simile all'esempio seguente:

   ? How do you want to initialize your app?
      Scan current directory
      Select a template
   > Set up with GitHub Copilot (Preview)
   

4. Esaminare l'accesso allo strumento richiesto e concedere l'accesso agli strumenti necessari per il flusso di lavoro. Copilot usa azd e Azure funzionalità di sviluppo per esaminare il progetto, creare file e convalidare il risultato.

5. Selezionare un modello e un livello di ragionamento se azd ti chiede di configurarli.

   Nella prima esecuzione, i prompt usano le etichette seguenti. Il modello e le scelte di ragionamento disponibili dipendono dall'account GitHub Copilot e dal modello selezionato:

   ? Select AI model
   ? Select reasoning effort level
   

6. Descrivi ciò che vuoi creare. Includere requisiti rilevanti, ad esempio:

   • Indipendentemente dal fatto che il modello includa il codice dell'applicazione, solo l'infrastruttura o entrambi.
   • Linguaggi e framework dell'applicazione, se noti.
   • Servizi di Azure e piattaforma di hosting da usare.
   • Se utilizzare Bicep o Terraform.
   • Requisiti di sicurezza, rete, scalabilità e area.

   Per esempio:

   Build an infrastructure-only azd template that provisions an Azure Container Apps
   environment, Azure Container Registry, and Log Analytics workspace with Bicep.
   Use managed identity and least-privilege role assignments. Parameterize the location
   and environment name so the template can be reused.
   

7. Rispondere a qualsiasi domanda di architettura o configurazione da Copilot. L'agente prepara il progetto per Azure, genera gli asset del modello ed esegue la convalida preliminare della distribuzione.

8. Esamina la struttura complessiva dei file che Copilot ha creato o modificato. Verificare che il modello includa la configurazione prevista del progetto, la directory dell'infrastruttura, l'origine dell'applicazione e gli asset di supporto per la soluzione.

   Ad esempio, un modello di sola infrastruttura generato potrebbe contenere i file chiave seguenti:

   azure.yaml
   infra/
   ├── main.bicep
   ├── main.parameters.json
   └── modules/
      ├── container-apps-environment.bicep
      └── container-registry.bicep
   

   Per indicazioni dettagliate sulla revisione del contenuto della configurazione e dell'infrastruttura, vedere Esplorare e modificare i file di modello.

Effettuare il provisioning e distribuire il modello

Dopo aver approvato i file generati, eseguire il comando seguente:

azd up

Il comando crea o seleziona un azd ambiente, effettua il provisioning delle risorse Azure, crea i pacchetti di tutti i servizi dell'applicazione e li distribuisce. Per una suddivisione dettagliata dei comandi, vedere Esplorare il azd up flusso di lavoro.

Usare un altro metodo di creazione

Altri assistenti per la codifica di intelligenza artificiale non sono connessi direttamente al azd init flusso di lavoro, ma possono creare gli stessi asset di modello standard. Puoi anche creare direttamente tutti gli asset.

Creare manualmente questi asset o chiedere a un altro assistente per la scrittura del codice di analizzare i requisiti e crearli:

• File azure.yaml che definisce il progetto e i servizi distribuibili.
• file Bicep o Terraform per effettuare il provisioning delle risorse di Azure necessarie.
• Output delle risorse e variabili di ambiente dell'applicazione.
• Dockerfile, configurazione della distribuzione e script di supporto quando necessario.

Per fornire un punto di partenza minimo prima di usare un altro agente, eseguire:

azd init --minimal

Se utilizzi un altro assistente di codifica, istruiscilo a seguire lo azure.yamlschema, le procedure di sicurezza dell'infrastruttura di Azure e le convenzioni dei modelli descritte in Modelli di Azure Developer CLI. Se si creano direttamente i file, usare gli stessi riferimenti della guida all'implementazione. Esaminare e convalidare tutti i file prima di eseguire azd up.

Contenuti correlati

• Panoramica dello sviluppo di modelli
• Esplorare e modificare i file modello
• Iniziare da un modello esistente
• Estendere un modello
• Esplorare il azd init flusso di lavoro

Richiedere assistenza

Per informazioni su come inviare un bug, richiedere assistenza o proporre una nuova funzionalità per l'interfaccia della riga di comando per sviluppatori di Azure, visitare la pagina troubleshooting e supporto.