Panoramica sulla creazione di modelli per l'interfaccia a riga di comando di Azure Developer

L'interfaccia della riga di comando Azure Developer (azd) usa template per effettuare il provisioning e distribuire le risorse dell'app nel cloud. Gli sviluppatori possono aggiungere supporto per azd comandi e funzionalità convertendo le applicazioni in modelli. Questo articolo offre una panoramica contestuale delle diverse opzioni per la creazione azd di modelli. Dopo aver compreso i concetti di questo articolo, visitare le risorse seguenti per guide più dettagliate all'implementazione:

• Usare un modello esistente per l'app.
• Creare un modello dal codice dell'app
• Training - Compilare e distribuire azd modelli

Concetti relativi alla creazione di modelli

La creazione di un azd modello richiede l'aggiunta di asset di configurazione e infrastruttura specifici alla codebase esistente o l'avvio di una nuova app da un modello esistente con gli stessi asset. Entrambi i flussi di lavoro sono illustrati nelle sezioni successive. Tutti i azd modelli condividono una struttura di file simile basata sulle azd convenzioni. Il diagramma seguente offre una rapida panoramica del processo per creare un azd modello:

Ogni azd modello richiede le risorse minime seguenti:

• Cartella infra che contiene l'infrastruttura come file di codice (Bicep o Terraform).
• File di configurazione azure.yaml che mappa i servizi dell'applicazione alle risorse infrastrutturali provisionate.

Altre directory facoltative sono spesso incluse, ad esempio una .github cartella con asset per creare una pipeline CI/CD. Per altre informazioni sui modelli, vedere la documentazione sulla panoramica del modello .

Si consideri il repository di app di esempio seguente:

Dopo aver convertito quest'app di esempio in un azd template, lo stesso repository di app contiene quanto segue:

Le risorse originali dell'app sono invariate, ma sono stati aggiunti nuovi asset da cui azd dipende per i comandi, come azd up ad esempio:

• È stata aggiunta una cartella infra che include file Bicep per creare risorse Azure.
• È stato aggiunto un file di configurazione azure.yaml per mappare il codice dell'app nella directory src al provisioning delle risorse di Azure.
• È stata creata una .azure cartella per contenere azd le variabili di ambiente.
• È stata aggiunta una cartella .github (facoltativa) per supportare le pipeline CI/CD tramite azioni di GitHub.

Flussi di lavoro di creazione di modelli

Il comando azd init viene usato per inizializzare un modello /azd per il provisioning e la distribuzione delle risorse dell'app in Azure. Il comando richiede di scegliere tra due flussi di lavoro diversi per inizializzare un modello descritto nelle sezioni seguenti: Usare il codice nella directory corrente e Usare un modello esistente.

Eseguire il azd init comando nella radice della directory da convertire in azd template:

azd init

Usare il codice nella directory corrente

Questa opzione indica di azd analizzare il codice nella directory per identificare le tecnologie usate, ad esempio il linguaggio di programmazione, il framework e il sistema di database. azd genera automaticamente gli asset modello, ad esempio il file di definizione del azure.yaml servizio e la infra cartella con file di infrastruttura come codice. Gli asset generati sono un punto di partenza per ulteriori modifiche. Usare questo approccio se si prevede di utilizzare comuni servizi di Azure supportati dalle funzionalità di scaffolding di azd.

Consulta l'esercitazione Inizia con il codice dell'app per creare un template per informazioni dettagliate su come implementare questo approccio e ulteriori informazioni su quali risorse Azure supportano il rilevamento automatico e scaffolding.

Selezionare un modello

Selezionare questa opzione per usare un modello esistente che definisce molte delle risorse Azure e gli obiettivi architetturali come punto di partenza. azd chiederà di selezionare un modello di avvio o un altro modello dalla raccolta awesome-azd . Quando si seleziona un modello, gli asset di tale modello vengono aggiunti alla directory del progetto esistente da usare come punto di partenza. Alcuni modelli includono codice applicazione di esempio che puoi sostituire con il tuo, mentre altri (denominati "modelli di avvio") forniscono solo l'infrastruttura.

Usa il comando azd init per scaricare un modello esistente in una directory vuota e usarlo come punto di partenza per la propria app. Se il modello include il codice sorgente dell'app, è possibile compilare tale codice o sostituire la directory del codice sorgente con la propria.

Per informazioni dettagliate su come implementare questo approccio, vedere l'esercitazione Iniziare con un modello esistente .

Vedere anche

• Usare un modello esistente per l'app.
• Creare un modello dal codice dell'app

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.

Passaggi successivi