Generare Bicep usando la funzionalità di composizione

La funzionalità di composizione dell'interfaccia della riga di comando per sviluppatori di Azure (azd) semplifica il processo di compilazione, distribuzione e gestione delle applicazioni cloud. Usando azd compose, è possibile definire e gestire l'infrastruttura e il codice dell'applicazione per il progetto in modo unificato. Questa guida illustra come generare codice Bicep dal azd compose feature, consentendo di adattare l'infrastruttura cloud in modo da soddisfare i requisiti specifici.

Come azd compose gestisce lo stato dell'infrastruttura

La azd compose funzionalità tiene traccia dello stato dell'infrastruttura in memoria durante il processo di composizione. Questo approccio consente di definire e perfezionare in modo iterativo l'applicazione e l'infrastruttura senza generare immediatamente file o modificare la directory del progetto.

Quando si esegue il azd infra synth comando, lo stato in memoria viene convertito in file Bicep nella infra cartella . A questo punto, lo stato dell'infrastruttura passa dall'essere gestito in memoria a essere rappresentato come codice, consentendo un'ulteriore personalizzazione.

Suggerimento

Usare azd compose per creare rapidamente un prototipo dell'infrastruttura prima di eseguire il commit delle modifiche basate su file con azd infra synth.

Generare il codice Bicep

Per esplorare o personalizzare il codice Bicep usato internamente da azd per effettuare il provisioning delle risorse create da azd add, eseguire il comando seguente:

azd infra gen

Annotazioni

Il azd infra synth comando delle versioni precedenti di azd è ora un alias di azd infra generatee continuerà a funzionare. Tuttavia, verrà visualizzato un messaggio di avviso e il comando potrebbe essere rimosso in una versione futura azd .

Questo comando genera i file Bicep corrispondenti nella infra cartella dell'app.

Gestione degli aggiornamenti con la generazione Bicep

Quando si esegue il azd infra gen comando, si esce dal azd compose flusso di lavoro e dal processo init semplificato. Da questo punto in poi, le modifiche apportate ai file Bicep generati non vengono più rilevate da azd compose. Se si modificano i file Bicep e successivamente si esegue azd infra gen nuovamente, le modifiche manuali verranno sovrascritte dal codice appena generato.

Ecco come può essere visualizzato un flusso di lavoro tipico:

1. Tu usi azd add per aggiungere nuove risorse di Azure al tuo progetto. Queste risorse vengono gestite internamente da azd.
2. Al termine dell'aggiunta di risorse, eseguire azd infra gen per generare file Bicep per tali risorse nella cartella del infra progetto. In questa fase, le risorse non vengono più gestite dal azd compose flusso di lavoro.
3. È ora possibile aggiornare manualmente i file Bicep man mano che si continua a sviluppare l'app.
4. Se si aggiungono altre risorse o si esegue azd infra gen di nuovo, il contenuto della infra cartella verrà rigenerato e le eventuali modifiche manuali andranno perse.

Per questo motivo, la funzionalità compose è più adatta per gli scenari seguenti:

• Creazione di un set iniziale di risorse di Azure per il progetto, quindi gestione di ulteriori aggiornamenti modificando i file Bicep.
• Gestione completa delle risorse di Azure tramite la funzionalità compose senza eseguire azd infra gen.

Passaggi successivi

Panoramica dei modelli della CLI per sviluppatori di Azure