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

Articolo
11/16/2023

L'interfaccia della riga di comando per sviluppatori di Azure (azd) fornisce supporto per gli 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:

Installato azd in locale o avere accesso a azd tramite Cloud Shell
Creato e configurato un ambiente di distribuzione di Azure con un centro di sviluppo, 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

Suggerimento

Comprendere i concetti chiave relativi agli 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, azd up ad esempio 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 stati dell'ambiente remoto e il provisioning sfruttano i nuovi componenti di Dev Center. Questa configurazione significa anche che la infra cartella nei modelli locali verrà effettivamente ignorata. Userà invece azd 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 Evironments per la distribuzione di Azure

Quando la funzionalità dev Center è abilitata, il comportamento predefinito di alcuni comandi comuni azd cambia per funzionare con questi ambienti remoti. La funzionalità dev Center si espande sulle funzionalità fornite dai supporto ambientale remoti standard.azd

azd init

L'esperienza azd init di comando in modalità Dev Center mostra tutti i modelli di ADE compatibili con azd per la selezione dal catalogo configurato. Durante il processo init, dopo azd aver clonato il codice del modello, il azure.yaml file verrà aggiornato automaticamente per includere una platform sezione 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 azd up comando consentirà di creare pacchetti, effettuare il provisioning e distribuire l'applicazione in ambienti di distribuzione di Azure. Tuttavia, la fase di provisioning del azd up comando userà i modelli di infrastruttura come codice curati nel dev center remoto, mentre la fase di distribuzione distribuirà il codice sorgente nel azd modello. Mentre la modalità Dev Center è abilitata, azd ignorerà la infra cartella nel modello locale azd e 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 azd template list comando visualizzerà i modelli di infrastruttura disponibili nel catalogo di Dev Center, invece di visualizzare i modelli dalla raccolta AZD Awesome predefinita. I cataloghi offrono un set di modelli di infrastruttura come codice curati e approvati che i team di sviluppo possono usare per creare ambienti.

azd template list

A screenshot showing the updated template gallery.

azd provision

Il azd provision comando 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 infra cartella nel modello locale azd e eseguirà il provisioning solo delle risorse usando i modelli di Dev Center.

azd provision

azd env list

Il azd env list comando 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 azure.yaml provisioning per associare i servizi app a nel file. 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 di cui è stato effettuato il provisioning includano tag da associare ai servizi definiti nel azure.yaml file.

Specificare nel resoureNameazure.yaml file invece di 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 le impostazioni per i centri di sviluppo in più posizioni. Impostazioni vengono combinati 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
Configurazioni degli utenti

azd richiederà automaticamente eventuali 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_Uedizione Standard R

Definire le configurazioni

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

{
    "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 azd del progetto nel platform nodo del azure.yaml file:

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 user

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

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

Condividi tramite