Panoramica dei modelli dell'interfaccia della riga di comando per sviluppatori di Azure

L'interfaccia della riga di comando per sviluppatori di Azure (azd) usa i modelli 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

Nota

Questo articolo presuppone una conoscenza generale dei azd modelli. Per altre informazioni sui modelli, vedere la documentazione sulla panoramica del modello.

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:

• infra Cartella che contiene l'infrastruttura come file di codice (Bicep o Terraform).
• File azure.yaml di configurazione che esegue il mapping dei servizi dell'applicazione alle risorse dell'infrastruttura di cui è stato effettuato il provisioning.

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 questa app di esempio in un azd modello, lo stesso repository di app contiene quanto segue:

Le risorse dell'app originali sono invariate, ma sono stati aggiunti nuovi asset che azd dipendono da per i comandi, azd upad esempio :

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

Flussi di lavoro di creazione di modelli

Il azd init comando viene usato per inizializzare un azd modello 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 usare i servizi comuni di Azure supportati dalle azd funzionalità di scaffolding.

Vedere l'esercitazione Iniziare con il codice dell'app per creare un modello per informazioni dettagliate su come implementare questo approccio e altre informazioni sulle risorse di Azure che supportano il rilevamento automatico e lo scaffolding.

Selezionare un modello

Selezionare questa opzione per usare un modello esistente che definisce molte delle risorse di Azure e gli obiettivi dell'architettura 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 il codice dell'app di esempio che è possibile sostituire con i propri, mentre alcuni (denominati "modelli di avvio") sono solo l'infrastruttura.

Usare il comando per eseguire il azd init pull di 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 eseguire la compilazione di 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.

Vedi 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 relativa alla risoluzione dei problemi e al supporto tecnico.

Passaggi successivi

Domande frequenti su Azure Developer CLI