Introduzione alla funzionalità di composizione dell'interfaccia della riga di comando per sviluppatori Azure

La funzionalità di componibilità (compose) Azure Developer CLI (azd) consente di comporre progressivamente le risorse Azure necessarie per l'app senza scrivere manualmente codice Bicep. Compose usa anche Azure Moduli verificati (AVM) quando possibile, fornendo procedure consigliate usando blocchi predefiniti per Azure.

Che cos'è la funzionalità di composizione?

La azd funzionalità compose offre un nuovo modo per iniziare a usare azd. Prima della funzionalità di composizione, gli sviluppatori avevano due opzioni principali per configurare le risorse Azure per il provisioning e la distribuzione di un'applicazione:

• Iniziare con un modello predefinito , che definisce le risorse e i servizi di cui eseguire il provisioning e la distribuzione in Azure e quindi personalizzare. Esplora i modelli nella raccolta di modelli di intelligenza artificiale o nella raccolta della community.
• Iniziare da una codebase esistente seguendo le istruzioni nel flusso init semplificato.

Qualsiasi ulteriore personalizzazione richiede all'utente di modificare manualmente i file Bicep, fino all'introduzione della funzionalità di composizione.

Compatibilità del progetto con compose

La funzionalità di composizione azd è progettata per i progetti che non usano già l'infrastruttura come codice per gestire le risorse Azure. Di conseguenza, compose non supporta gli scenari seguenti:

• Progetti che dispongono già di una cartella infra per la creazione di risorse Azure (ad esempio modelli esistenti).
• progetti .NET Aspire, che usano il file host dell'app Aspire per gestire le risorse.

Semplificare la creazione di risorse con compose

La funzionalità di composizione azd introduce una terza opzione per aggiungere risorse Azure alle app. Gli sviluppatori usano il comando azd add per indicare a azd di comporre nuove risorse Azure e aggiornare le configurazioni dei modelli usando flussi di lavoro minimi del prompt. Questa funzionalità è utile per gli sviluppatori che vogliono evitare di scrivere Bicep o usare un modello esistente.

Eseguire il azd add comando per avviare il flusso di lavoro di composizione e aggiungere una nuova risorsa:

azd add

Questo comando avvia un flusso di lavoro basato su prompt che consente di selezionare una nuova risorsa da creare per l'app:

? What would you like to add?  [Use arrows to move, type to filter]
> AI
  Database
  Host service
  Key Vault
  Messaging
  Storage account
  ~Existing resource

Al termine dell'aggiunta di risorse con azd add, eseguire azd up o azd provision per creare le risorse in Azure. azd gestisce internamente la creazione delle risorse fino a quando non si generano i file di Bicep per le risorse per ulteriori personalizzazioni.

Per una procedura dettagliata completa di questa funzionalità, visitare l'articolo Creare un modello minimo usando la funzionalità compose .

Servizi supportati dalla funzionalità compose

La funzionalità azd compose supporta l'aggiunta di risorse per i servizi di Azure seguenti:

• Intelligenza artificiale
  • Modelli di strumenti Foundry e Microsoft Foundry
  • Azure OpenAI con autenticazione Microsoft Entra ID
  • Azure AI Search
• Banca dati
  • Azure Cosmos DB
  • Azure Cosmos DB per MongoDB
  • Azure Cosmos DB per PostgreSQL
  • Azure Cache for Redis
  • Azure Database for MySQL
• Servizio host
  • Azure Container Apps
  • Azure App Service
• Key Vault
  • Azure Key Vault
• Messaggistica
  • Azure Service Bus
  • Azure Event Hubs
• Account di archiviazione
  • Azure Blob Storage

Supporto per i linguaggi

• Servizio app:
  • Python
  • TypeScript
  • JavaScript

Passaggi successivi

Guida introduttiva a Compose