Esplora la configurazione della CLI per sviluppatori di Azure

L'interfaccia della riga di comando per sviluppatori Azure (azd) consente di gestire azd le configurazioni usando un set di azd config comandi. Queste impostazioni di configurazione includono impostazioni predefinite utili, ad esempio la sottoscrizione e il percorso Azure, nonché le impostazioni usate da altri azd comandi o funzionalità. È anche possibile ottenere e impostare valori personalizzati e usarli in script o funzionalità personalizzate.

In questo articolo, imparerai a:

  • Concetti chiave sulla configurazione dell'interfaccia della riga di comando per sviluppatori di Azure
  • Come usare azd config i comandi
  • Come azd config si integra con altre azd funzionalità

Esplorare il file di configurazione dell'interfaccia della riga di comando per sviluppatori Azure

Quando si installa per la prima volta l'interfaccia della riga di comando di Azure Developer, viene aggiunto un file denominato config.json nel percorso seguente:

  • $HOME/.azd su Linux e macOS
  • %USERPROFILE%\.azd in Windows

Tip

È possibile eseguire l'override della directory di configurazione specificando un percorso nella AZD_CONFIG_DIR variabile di ambiente.

Le impostazioni in questo file gestiscono le funzionalità, ad esempio:

  • Sottoscrizione o località predefinita Azure da usare durante il provisioning o la distribuzione delle risorse
  • Quali funzionalità alfa sono abilitate
  • Quali percorsi di origine del modello sono configurati
  • Valori personalizzati impostati dall'utente per script o altri scopi

Per impostazione predefinita, il config.json file contiene solo alcune configurazioni per i percorsi di origine del modello predefiniti azd . Quando usi diverse funzionalità di Azure Developer CLI, alcuni valori vengono compilati automaticamente in config.json. Ad esempio, la prima volta che si esegue il azd up comando, la sottoscrizione e il percorso selezionati per il provisioning e la distribuzione vengono archiviati nella defaults sezione del file.

Un file semplice config.json potrebbe essere simile al seguente:

{
  "defaults": {
    "location": "eastus2",
    "subscription": "your-subscription-id"
  },
  "template": {
    "sources": {
      "awesome-azd": {
        "key": "awesome-azd",
        "location": "https://aka.ms/awesome-azd/templates.json",
        "name": "Awesome AZD",
        "type": "awesome-azd"
      },
      "default": {
        "key": "default",
        "name": "default"
      }
    }
  }
}

Usare i comandi di configurazione

L'interfaccia della riga di comando per sviluppatori di Azure fornisce un set di comandi per gestire manualmente le impostazioni nel config.json file:

  • azd config get: Ottenere un valore di configurazione.
  • azd config list-alpha: visualizza l'elenco delle funzionalità disponibili nella fase alfa.
  • azd config reset: ripristina la configurazione predefinita.
  • azd config set: impostare una configurazione.
  • azd config show: mostra tutti i valori di configurazione.
  • azd config unset: Annulla una configurazione.

Questi comandi vengono esaminati di più nelle sezioni seguenti. È anche possibile visitare la pagina di riferimento dei comandi dell'interfaccia della riga di comando per sviluppatori Azure per altre informazioni sui azd comandi.

Configurazioni dello schermo

Visualizzare il contenuto corrente dell'intero config.json file in qualsiasi momento eseguendo il azd config show comando :

azd config show

Output di esempio:

{
  "defaults": {
    "location": "eastus2",
    "subscription": "your-subscription-id"
  },
  "template": {
    "sources": {
      "awesome-azd": {
        "key": "awesome-azd",
        "location": "https://aka.ms/awesome-azd/templates.json",
        "name": "Awesome AZD",
        "type": "awesome-azd"
      },
      "default": {
        "key": "default",
        "name": "default"
      }
    }
  }
}

Visualizzare un valore di configurazione specifico usando il azd config get <key> comando :

azd config get defaults

Output di esempio:

"defaults": {
    "location": "eastus2",
    "subscription": "your-subscription-id"
}

L'abilitazione o la disabilitazione delle funzionalità alfa è un'attività di configurazione comune, quindi azd include anche un comando pratico per visualizzare lo stato corrente delle funzionalità alfa:

azd config list-alpha

Output di esempio:

Name: aca.persistDomains
Description: Do not change custom domains when deploying Azure Container Apps.
Status: Off

Name: aca.persistIngressSessionAffinity
Description: Do not change Ingress Session Affinity when deploying Azure Container Apps.
Status: Off

Name: aks.helm
Description: Enable Helm support for AKS deployments.
Status: On

Name: aks.kustomize
Description: Enable Kustomize support for AKS deployments.
Status: Off

Name: azd.operations
Description: Extends provisioning providers with azd operations.
Status: Off

Name: deployment.stacks
Description: Enables Azure deployment stacks for ARM/Bicep based deployments.
Status: Off

Name: llm
Description: Enables the use of LLMs in the CLI.
Status: Off

Ottenere e impostare configurazioni

È possibile recuperare, impostare o rimuovere i valori nel file config.json tramite i comandi azd config. Alcune configurazioni specifiche vengono usate da altre azd funzionalità e comandi, ad esempio quando si abilitano le caratteristiche alfa o si impostano origini modello, ma è anche possibile impostare valori personalizzati.

Gestire le configurazioni usate da azd

Usare il azd config set <key> <value> comando per aggiungere un'impostazione di configurazione al config.json file.

Ad esempio, per abilitare le funzionalità LLM usate dall'integrazione GitHub Copilot:

azd config set alpha.llm on

Note

Selezionando Configura con GitHub Copilot (anteprima) durante azd init questa impostazione viene abilitata automaticamente. Usare la sintassi . per esplorare le strutture degli oggetti JSON quando si ottengono e si impostano i valori di configurazione.

Verificare che l'impostazione sia stata abilitata usando il azd config get <key> comando , ad esempio:

azd config get alpha.llm

Output di esempio:

"on"

In questo scenario è anche possibile eseguire azd config get alpha per visualizzare l'intero oggetto JSON nel config.json file:

azd config get alpha

Output di esempio:

{
  "llm": "on"
}

Gestire configurazioni personalizzate

È anche possibile impostare valori di configurazione personalizzati da usare negli azd hook e negli script dei clienti. Questi valori di configurazione offrono un'alternativa all'uso delle variabili di ambiente.

Per impostare un valore di configurazione personalizzato:

azd config get customVal hello-world

Ottenere il valore di configurazione personalizzato:

azd config get customVal

Output di esempio:

hello-world

Reimpostare le configurazioni

È possibile ripristinare le impostazioni predefinite del file dell'interfaccia della riga di comando di Azure developer config.json usando il azd config reset comando , che elimina il contenuto del file:

azd config reset

Quando si esegue azd config show dopo una reimpostazione, verrà visualizzato semplicemente un oggetto vuoto:

{}

Passaggi successivi

Panoramica dello sviluppo di modelli

  • Last updated on