Supporto dell'interfaccia della riga di comando per sviluppatori di Azure per ambienti di distribuzione di Azure

Articolo
12/21/2024

L'interfaccia della riga di comando per sviluppatori di Azure (azd) fornisce supporto per ambienti di distribuzione di Azure. Un ambiente di distribuzione di Azure è una raccolta preconfigurata di risorse di Azure distribuite in sottoscrizioni predefinite. La governance di Azure viene applicata a tali sottoscrizioni in base al tipo di ambiente, ad esempio sandbox, test, gestione temporanea o produzione. Con gli ambienti di distribuzione di Azure, è possibile applicare i criteri di sicurezza aziendali e fornire un set curato di modelli predefiniti di infrastruttura come codice (IaC).

Prerequisiti

Verificare di aver completato i prerequisiti seguenti per lavorare con gli ambienti di distribuzione di Azure usando azd:

azd installati in locale o avere accesso a azd tramite Cloud Shell
Creazione e configurazione di un ambiente di distribuzione di Azure con un dev center, un progetto e un catalogo di modelli
tipi di ambiente configurati a livello di dev center e di progetto
Verificare che lo sviluppatore abbia il ruolo utente Ambienti di distribuzione nel progetto

Mancia

Comprendere i concetti chiave sugli ambienti di distribuzione di Azure è essenziale per usarli tramite azd.

Abilitare il supporto dell'ambiente di distribuzione di Azure

È possibile configurare azd per effettuare il provisioning e distribuire le risorse agli ambienti di distribuzione usando comandi standard, ad esempio azd up o azd provision. Per abilitare il supporto per gli ambienti di distribuzione di Azure, eseguire il comando seguente:

azd config set platform.type devcenter

Quando platform.type è impostato su devcenter, tutti gli azd stato dell'ambiente remoto e il provisioning sfruttano i nuovi componenti di Dev Center. Questa configurazione significa anche che la cartella infra nei modelli locali verrà effettivamente ignorata. Al contrario, azd userà uno dei modelli di infrastruttura definiti nel catalogo di Dev Center per il provisioning delle risorse.

È anche possibile disabilitare il supporto di Dev Center tramite il comando seguente:

azd config unset platform

Usare ambienti di distribuzione di Azure

Quando la funzionalità dev Center è abilitata, il comportamento predefinito di alcuni comandi comuni di azd modifiche per l'uso con questi ambienti remoti. La funzionalità dev center si espande sulle funzionalità fornite dallo standard azdsupporto dell'ambiente remoto.

azd init

L'esperienza di comando azd init in modalità Dev Center mostra tutti i modelli di AZURE compatibili con azd per la selezione dal catalogo configurato. Durante il processo init, dopo azd clona il codice del modello, il file azure.yaml verrà aggiornato automaticamente per includere una sezione platform con la configurazione selezionata in base al modello scelto. La configurazione include il nome, il catalogo e la definizione dell'ambiente di Dev Center.

azd init

azd up

Il comando azd up creerà il pacchetto, il provisioning e la distribuzione dell'applicazione negli ambienti di distribuzione di Azure. Tuttavia, la fase di provisioning del comando azd up userà i modelli di infrastruttura come codice curati nel centro di sviluppo remoto, mentre la fase di distribuzione distribuirà il codice sorgente nel modello di azd. Mentre la modalità Dev Center è abilitata, azd ignorerà la cartella infra nel modello di azd locale ed eseguirà il provisioning solo delle risorse usando i modelli di Dev Center. Il comando richiederà anche i valori necessari, ad esempio il progetto o il tipo di ambiente di distribuzione di Azure.

azd up

azd template list

Il comando azd template list visualizzerà i modelli di infrastruttura disponibili nel catalogo di Dev Center, anziché visualizzare i modelli dalla raccolta AZD Awesome predefinita. Cataloghi fornire un set di modelli di infrastruttura come codice curati e approvati che i team di sviluppo possono usare per creare ambienti.

azd template list

Screenshot che mostra la raccolta di modelli aggiornata.

azd provision

Il comando azd provision creerà nuovi ambienti dev center. Il comando richiederà eventuali valori mancanti, ad esempio il tipo di ambiente o il progetto. Quando il comando viene eseguito, userà il modello di infrastruttura associato per effettuare il provisioning del set corretto di risorse di Azure per tale ambiente. Mentre la modalità Dev Center è abilitata, azd ignorerà la cartella infra nel modello di azd locale ed eseguirà il provisioning solo delle risorse usando i modelli di Dev Center.

azd provision

azd env list

Il comando azd env list visualizzerà lo stesso elenco di ambienti visualizzati nel portale per sviluppatori.

azd env list

Assegnazione di tag alle risorse per gli ambienti di distribuzione di Azure

azd il provisioning per gli ambienti di distribuzione di Azure si basa su modelli curati dal catalogo di Dev Center. I modelli nel catalogo possono o non assegnare tag alle risorse di Azure di cui è stato effettuato il provisioning per associare i servizi app al file di azure.yaml. Se i modelli non assegnano tag, è possibile risolvere questo problema in uno dei due modi seguenti:

Collaborare con l'amministratore del catalogo di Dev Center per assicurarsi che le risorse di Azure sottoposte a provisioning includano tag da associare ai servizi definiti nel file di azure.yaml.

Specificare il resourceName nel file azure.yaml anziché usare i tag:

services:
    api:
        project: ./src/api
        host: containerapp
        language: js
        resourceName: sample-api-containerapp
    web:
        project: ./src/web
        host: containerapp
        language: js
        resourceName: sample-web-containerapp

Configurare le impostazioni di Dev Center

È possibile definire azd impostazioni per i centri di sviluppo in più posizioni. Le impostazioni vengono combinate da queste posizioni per creare il set finale di configurazioni nell'ordine di precedenza seguente:

Variabili di ambiente
Configurazione dell'ambiente Azd
Configurazione del progetto
Configurazione utente

azd richiederà automaticamente i valori di configurazione mancanti da queste origini. Ognuna di queste opzioni di configurazione è descritta in dettaglio nelle sezioni seguenti.

Variabili di ambiente

Le variabili di ambiente seguenti verranno individuate e usate da azd:

AZURE_DEVCENTER_NAME
AZURE_DEVCENTER_PROJECT
AZURE_DEVCENTER_CATALOG
AZURE_DEVCENTER_ENVIRONMENT_DEFINITION
AZURE_DEVCENTER_ENVIRONMENT_TYPE
AZURE_DEVCENTER_ENVIRONMENT_USER

Definire le configurazioni

Definire le configurazioni per i centri di sviluppo nell'ambito dell'ambiente azd nel file .azure/<env>/config.json:

{
    "platform": {
        "config": {
            "catalog": "SampleCatalog",
            "environmentDefinition": "Todo",
            "environmentType": "Dev",
            "name": "sample-devcenter",
            "Project": "SampleProject"
        }
    }
}

Ambito del progetto

Definire le configurazioni per i centri di sviluppo nell'ambito del progetto azd nel nodo platform del file azure.yaml:

name: todo-nodejs-mongo-aca
metadata:
    template: todo-nodejs-mongo-aca@0.0.1-beta
platform:
    type: devcenter
    config:
        catalog: SampleCatalog
        environmentDefinition: Todo
        name: sample-devcenter
        project: SampleProject
services:
    api:
        project: ./src/api
        host: containerapp
        language: js
    web:
        project: ./src/web
        host: containerapp
        language: js

Ambito utente

Definire le configurazioni per i centri di sviluppo nell'ambito utente nel file ~/<user_profile>/.azd/config.json:

{
    "platform": {
        "config": {
            "catalog": "SampleCatalog",
            "environmentDefinition": "Todo",
            "environmentType": "Dev",
            "name": "sample-devcenter",
            "Project": "SampleProject"
        }
    }
}

Condividi tramite