Condividi tramite

Configurare e utilizzare le origini modello

L'interfaccia della riga di comando per sviluppatori di Azure è progettata in base a un potente sistema di modelli che semplifica la distribuzione e il provisioning delle risorse di Azure. Durante lo sviluppo con azd, è possibile creare un modello personalizzato o scegliere da un elenco configurabile di modelli esistenti. Questo articolo illustra come usare gli elenchi di modelli e configurare l'installazione locale azd per supportare origini di elenco modelli diverse.

Informazioni sulle origini dei modelli

Un'origine di un modello azd punta a un file di configurazione JSON che descrive un elenco di modelli disponibili e i relativi metadati essenziali, quali il nome, la descrizione e la posizione del codice sorgente del modello (di solito un repository su GitHub). Quando si abilita un'origine modello, i modelli definiti vengono resi disponibili tramite azd altri comandi. Ad esempio, il frammento JSON di origine del modello seguente definisce due modelli:

[
  {
    "name": "Starter - Bicep",
    "description": "A starter template with Bicep as infrastructure provider",
    "repositoryPath": "azd-starter-bicep",
    "tags": ["bicep"]
  },
  {
    "name": "Starter - Terraform",
    "description": "A starter template with Terraform as infrastructure provider",
    "repositoryPath": "azd-starter-terraform",
    "tags": ["terraform"]
  }
]

Ogni voce di modello nel file di configurazione JSON include le proprietà seguenti:

  • nome: Il nome visualizzato del modello.
  • descrizione: breve riepilogo delle funzioni del modello.
  • repositoryPath: percorso del codice sorgente del modello, che può essere:
    • URI completo in un repository Git, ad esempio "https://dev.azure.com/org/project/_git/repo".
    • "{owner}/{repo} dei repository di GitHub."
    • "{repo}" per i repository di GitHub nell'organizzazione Azure-Samples.
  • tag : parole chiave che consentono agli utenti di filtrare i modelli con azd init --filter <tag> e azd template list --filter <tag>.

Per un esempio completo, vedere questo file JSONin , che funge da sorgente modello predefinita inclusa in .

azd consente di abilitare più origini modello contemporaneamente. Le opzioni di origine del modello seguenti sono attualmente disponibili per scegliere tra:

  • awesome-azd : elenco dei modelli della raccolta Awesome AZD abilitata per impostazione predefinita.
  • default : un piccolo set di modelli curati per illustrare diversi stack tecnologici.
  • file : percorso locale/di rete che punta a un file di configurazione JSON di origine modello.
  • url : percorso indirizzabile HTTP(S) che punta a un file di configurazione JSON di origine modello.
  • gh : punta a un repository GitHub.
  • ade : punta a un elenco di modelli dell'ambiente di distribuzione di Azure. Altre informazioni sul supporto dell'interfaccia della riga di comando per sviluppatori di Azure per ambienti di distribuzione di Azure.

Usare le origini modello

azd fornisce diversi comandi per configurare le origini modello.

Usare il azd template source list comando per elencare tutte le origini modello attualmente configurate:

azd template source list

Output di esempio con due origini modello configurate:

Key          Name         Type         Location

awesome-azd  Awesome AZD  awesome-azd  https://aka.ms/awesome-azd/templates.json
default      Default      resource

Usare il azd template source add comando per aggiungere una nuova origine modello. Questo comando accetta i parametri seguenti:

  • key: nome tecnico dell'origine del modello.
  • --type, -t: il tipo di origine del modello: i valori validi sono file, URL e gh per GitHub.
  • --location, -l: percorso di origine del modello, che deve essere una rete locale o un URI Web HTTP(S).
  • --name, -n: il nome visualizzato dell'origine del modello (facoltativo, se omesso, usa la chiave ).
azd template source add <key> --type <file-or-url-or-gh> --location <your-uri> --name <your-display-name>

Usare il comando per rimuovere un'origine azd template source remove modello:

azd template source remove <key>

Usare il azd config reset comando per ripristinare le impostazioni predefinite della configurazione del modello:

azd config reset

Usare gli elenchi di modelli

Dopo aver configurato le origini del modello, usare il azd template list comando per elencare i modelli disponibili da tali origini:

azd template list

Ad esempio, un'installazione predefinita di azd elenca i modelli seguenti dall'origine modello awesome-azd :

Name                                                         Source       Repository Path

Event Driven Java Application with Azure Service Bus         Awesome AZD  Azure-Samples/ASA-Samples-Event-Driven-Application
Static React Web App with Java API and PostgreSQL            Awesome AZD  Azure-Samples/ASA-Samples-Web-Application
SAP CAP on Azure App Service Quickstart                      Awesome AZD  Azure-Samples/app-service-javascript-sap-cap-quickstart
SAP Cloud SDK on Azure App Service Quickstart (TypeScript)   Awesome AZD  Azure-Samples/app-service-javascript-sap-cloud-sdk-quickstart
Java Spring Apps with Azure OpenAI                           Awesome AZD  Azure-Samples/app-templates-java-openai-springapps
WordPress with Azure Container Apps                          Awesome AZD  Azure-Samples/apptemplate-wordpress-on-ACA
Bicep template to bootstrap Azure Deployment Environments    Awesome AZD  Azure-Samples/azd-deployment-environments
Starter - Bicep                                              Awesome AZD  Azure-Samples/azd-starter-bicep
Starter - Terraform                                          Awesome AZD  Azure-Samples/azd-starter-terraform
...
# Additional templates omitted

Includere il --source flag per elencare solo i modelli da un'origine specifica:

azd template list --source <source-name>

Per inizializzare un modello dall'elenco visualizzato, eseguire il comando azd init e specificare il percorso del repository del modello:

azd init --template <path-value>

Usare ambienti di distribuzione di Azure

L'interfaccia della riga di comando per sviluppatori di Azure (azd) fornisce anche il 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).

L'integrazione di Active Directory esula dall'ambito di questo articolo. Altre informazioni sulla configurazione del ade supporto nell'interfaccia della riga di comando per sviluppatori di Azure per gli ambienti di distribuzione di Azure.

Passaggi successivi

Supporto dell'interfaccia della riga di comando per sviluppatori di Azure per l'elenco dei modelli per ambientidi distribuzione di Azure- Informazioni di riferimento sul comando

  • Last updated on