Supporto dell'interfaccia della riga di comando per sviluppatori di Azure per ambienti di distribuzione di Azure
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 aazd
tramite Cloud ShellCreato 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
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
resoureName
azure.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"
}
}
}
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per