Condividi tramite

Usare l'interfaccia della riga di comando per sviluppatori di Azure con ambienti di distribuzione di Azure

  • Articolo

Questo articolo illustra l'interfaccia della riga di comando per sviluppatori di Azure (azd) e come funziona con Gli ambienti di distribuzione di Azure (ADE) per effettuare il provisioning dell'infrastruttura dell'applicazione e distribuire il codice dell'applicazione nella nuova infrastruttura.

L'interfaccia della riga di comando per sviluppatori di Azure (azd) è uno strumento da riga di comando open source che fornisce comandi descrittivi per gli sviluppatori che eseguono il mapping alle fasi principali del flusso di lavoro. È possibile installare azd localmente nel computer o usarlo in altri ambienti.

Con Ade è possibile creare ambienti da una definizione di ambiente in un catalogo collegato al dev center. azdAggiungendo , è possibile distribuire il codice dell'applicazione nella nuova infrastruttura.

Come funziona azd con Active Directory?

azd funziona con Active Directory per consentire di creare ambienti da cui si lavora.

Con ADE e azd, i singoli sviluppatori che lavorano con un'infrastruttura e un codice univoci che vogliono caricare nel cloud possono creare un ambiente da una cartella locale. Possono usare azd per effettuare il provisioning di un ambiente e distribuirne facilmente il codice.

Su larga scala, l'uso di AdE e azd insieme consente di fornire agli sviluppatori un modo per creare l'infrastruttura e il codice delle app. Il team può creare più ambienti ADE dalla stessa azd definizione di ambiente compatibile e effettuare il provisioning del codice nel cloud in modo coerente.

Informazioni sui azd modelli

I comandi dell'interfaccia della riga di comando per sviluppatori di Azure sono progettati per funzionare con modelli standardizzati. Ogni modello è un repository di codice che aderisce a specifiche convenzioni di file e cartelle. I modelli contengono gli asset azd necessari per effettuare il provisioning di un ambiente di distribuzione di Azure. Quando si esegue un comando come azd up, lo strumento usa gli asset del modello per eseguire vari passaggi del flusso di lavoro, ad esempio il provisioning o la distribuzione di risorse in Azure.

Di seguito è riportata una struttura modello tipica:

├── infra                                        [ Contains infrastructure as code files ]
├── .azdo                                        [ Configures an Azure Pipeline ]
├── .devcontainer                                [ For DevContainer ]
├── .github                                      [ Configures a GitHub workflow ]
├── .vscode                                      [ VS Code workspace configurations ]
├── .azure                                       [ Stores Azure configurations and environment variables ]
├── src                                          [ Contains all of the deployable app source code ]
└── azure.yaml                                   [ Describes the app and type of Azure resources]

Tutti i modelli azd includono gli asset seguenti:

  • cartella infra: la cartella infra non viene usata in azd con ADE. Contiene tutti i file di codice dell'infrastruttura Bicep o Terraform per il modello azd. Active Directory fornisce l'infrastruttura come file di codice per il azd modello. Non è necessario includere questi file nel azd modello.

  • file azure.yaml: file di configurazione che definisce uno o più servizi nel progetto e ne esegue il mapping alle risorse di Azure per la distribuzione. Ad esempio, è possibile definire un servizio API e un servizio front-end Web, ognuno con attributi che li associano a risorse diverse di Azure per la distribuzione.

  • Cartella .azure: contiene le configurazioni e le variabili di ambiente di Azure essenziali, ad esempio il percorso per distribuire le risorse o altre informazioni sulla sottoscrizione.

  • cartella src: contiene tutto il codice sorgente dell'app distribuibile. Alcuni azd modelli forniscono solo asset di infrastruttura e lasciano vuota la directory src per aggiungere il codice dell'applicazione.

La maggior parte dei modelli azd include anche una o più delle cartelle seguenti:

  • Cartella .devcontainer: consente di configurare un ambiente contenitore di sviluppo per l'applicazione. Si tratta di un approccio comune all'ambiente di sviluppo che non è specifico di azd.

  • Cartella .github: contiene i file del flusso di lavoro CI/CD per GitHub Actions, ovvero il provider CI/CD predefinito per azd.

  • Cartella azdo: se si decide di usare Azure Pipelines per CI/CD, definire i file di configurazione del flusso di lavoro in questa cartella.

azd cataloghi compatibili

I cataloghi degli ambienti di distribuzione di Azure sono costituiti da definizioni di ambiente: modelli IaC che definiscono le risorse dell'infrastruttura di cui viene effettuato il provisioning per un ambiente di distribuzione. L'interfaccia della riga di comando per sviluppatori di Azure usa le definizioni di ambiente nel catalogo collegato al dev center per effettuare il provisioning di nuovi ambienti.

Nota

Attualmente, l'interfaccia della riga di comando per sviluppatori di Azure funziona con i modelli di Azure Resource Manager archiviati nel catalogo dev center degli ambienti di distribuzione di Azure.

Per supportare correttamente determinati servizi di calcolo di Azure, l'interfaccia della riga di comando per sviluppatori di Azure richiede più impostazioni di configurazione nel modello IaC. Ad esempio, è necessario contrassegnare gli host del servizio app con informazioni specifiche in modo che azd sappiano come trovare gli host e distribuirli.

È possibile visualizzare un elenco dei servizi di Azure supportati qui: Servizi di calcolo di Azure supportati (host) .

Rendere il catalogo di Ade compatibile con azd

Per consentire ai team di sviluppo di Microsoft azd di usare AdE, è necessario creare una definizione di ambiente nel catalogo compatibile con azd. È possibile creare una nuova azddefinizione di ambiente compatibile oppure usare una definizione di ambiente esistente dal catalogo dev center degli ambienti di distribuzione di Azure. Se si sceglie di usare una definizione di ambiente esistente, è necessario apportare alcune modifiche per renderla compatibile con azd.

Le modifiche includono:

  • Se si modifica un modello esistente azd , rimuovere la infra cartella. AdE usa i file seguenti per creare l'infrastruttura:
    • Modello arm (azuredeploy.json.)
    • File di configurazione che definisce i parametri (environment.yaml o manifest.yaml)
  • Contrassegnare le risorse in azure.yaml con informazioni specifiche in modo che azd sappiano come trovare gli host e distribuirli.
  • Configurare le impostazioni di Dev Center, ad esempio variabili di ambiente, azd configurazione dell'ambiente, azd configurazione del progetto e configurazione utente.

Per altre informazioni su come rendere compatibile la definizione dell'ambiente ADE con azd, vedere Rendere il progetto compatibile con l'interfaccia della riga di comando per sviluppatori di Azure.

Abilitare il azd supporto in ADE

Per abilitare il azd supporto con ADE, è necessario impostare su platform.type devcenter. Questa configurazione consente di azd sfruttare i nuovi componenti di Dev Center per lo stato e il provisioning dell'ambiente remoto e significa che la cartella infra nei modelli verrà effettivamente ignorata. Userà invece azd uno dei modelli di infrastruttura definiti nel catalogo di Dev Center per il provisioning delle risorse.

Per abilitare il azd supporto, eseguire il comando seguente:

 azd config set platform.type devcenter

Esplorare i comandi azd

Quando la funzionalità dev Center è abilitata, il comportamento predefinito di alcuni comandi azd comuni cambia per funzionare con questi ambienti remoti. Per altre informazioni, vedere Usare ambienti di distribuzione di Azure.

Contenuto correlato