Panoramica dello sviluppo di modelli per Azure Developer CLI (azd)

I modelli di Azure Developer CLI (azd) raggruppano la configurazione, l'infrastruttura e il codice applicativo facoltativo necessari per eseguire il provisioning e distribuire una soluzione su Azure. È possibile usare un modello per un'applicazione, un progetto solo infrastruttura o un punto di partenza riutilizzabile per i progetti futuri.

Note

Prima di iniziare, consulta i modelli di Azure Developer CLI per una descrizione completa della struttura dei modelli, delle risorse obbligatorie e facoltative, delle associazioni tra servizi e risorse e del modo in cui i comandi azd usano ogni file.

Flusso di lavoro di sviluppo di modelli

Il flusso di lavoro seguente si applica se si crea un modello o si inizializza uno già esistente:

Diagramma del flusso di lavoro di sviluppo del modello dell'interfaccia della riga di comando per sviluppatori Azure. A sinistra, una casella con l'etichetta "Scegli un punto iniziale" contiene due opzioni: "Inizia con un nuovo modello" e "Inizia da un modello esistente". Entrambe le opzioni portano a "Esplorare e modificare i file modello". Da qui, un percorso facoltativo conduce a "Estendi il modello" e il percorso principale continua a "Esegui azd up". Il passaggio "Estendi il modello" porta anche a "Esegui azd up". Infine, "Run azd up" porta a "mantenere o condividere il modello".

• Scegliere un punto di partenza:Iniziare con un nuovo modello con l'integrazione GitHub Copilot, un altro assistente per la codifica di intelligenza artificiale o la creazione diretta. In alternativa, iniziare da un modello esistente da Microsoft, dall'organizzazione o dalla community degli sviluppatori.
• Esplora e modifica i file: Analizza come azure.yaml, i file Bicep o Terraform, il codice dell'app e la configurazione di supporto funzionano insieme. Vedi Esplora e modifica i file di modello.
• Estendere ed evolvere in base alle esigenze: Aggiungere, sostituire, rimuovere o riprogettare i componenti dell'app e dell'infrastruttura. Segui Estendere un modello per un esempio end-to-end che aggiunge una risorsa di Azure e la collega a un'app.
• Eseguire il provisioning e distribuire: Eseguire azd up per effettuare il provisioning dell'infrastruttura e distribuire eventuali servizi applicativi. Per altre informazioni, vedere Esplorare il azd up flusso di lavoro.
• Gestire o condividere: Continuare a modificare il modello man mano che il progetto evolve. Se prevedi di condividerlo, provalo prima in una directory pulita e in un ambiente nuovo azd.

Note

In questo flusso di lavoro è possibile creare, modificare o sostituire i file di modello manualmente o con l'aiuto di un assistente per la codifica di intelligenza artificiale. Il risultato è lo stesso set di asset standard modificabili azd .

Blocchi predefiniti del modello

Ogni azd modello supporta una soluzione diversa, ma la maggior parte dei modelli combina gli stessi tipi di asset:

• Configurazione del progetto: Il file azure.yaml identifica il progetto, i servizi distribuibili, le directory di origine, le destinazioni di hosting e gli hook o i flussi di lavoro facoltativi.
• Infrastruttura come codice: Bicep o i file Terraform definiscono le risorse Azure, le assegnazioni di ruolo, la rete e le impostazioni dell'app richieste dalla soluzione.
• Origine applicazione: Un modello può includere una o più app distribuibili oppure può contenere solo l'infrastruttura.
• Configurazione dell'ambiente: I parametri passano valori specifici dell'ambiente nelle distribuzioni e gli output dell'infrastruttura diventano valori nell'ambiente attivo azd .

Un modello per un'app potrebbe usare la struttura di cartelle seguente:

.
├── azure.yaml                # Project configuration
├── infra/                    # Infrastructure as code
│   ├── main.bicep
│   ├── main.parameters.json
│   └── modules/
├── src/                      # Application source
│   ├── api/
│   └── web/
├── .github/                  # Pipeline workflows
│   └── workflows/
└── README.md

La struttura esatta varia in base al progetto. Il codice sorgente dell'app, i moduli dell'infrastruttura e i file della pipeline sono facoltativi e azure.yaml identifica i percorsi usati da azd. Questi asset interagiscono per tutto il ciclo di vita dello sviluppo di modelli.

Passaggi successivi

Iniziare con un nuovo modello

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.