Partilhar via

Configurar e consumir fontes de modelo

A CLI do Desenvolvedor do Azure foi projetada em torno de um poderoso sistema de modelo que simplifica a implantação e o provisionamento de recursos do Azure. Ao desenvolver com azdo , você tem a opção de criar seu próprio modelo ou escolher a partir de uma lista configurável de modelos existentes. Neste artigo, você aprenderá a trabalhar com listas de modelos e configurar sua instalação local azd para oferecer suporte a diferentes fontes de listas de modelos.

Compreender as fontes de modelos

Uma fonte de modelo azd aponta para um arquivo de configuração JSON que descreve uma lista de modelos disponíveis e seus metadados essenciais, como o nome, a descrição e o local do código-fonte do modelo (geralmente um repositório GitHub). Quando você habilita uma fonte de modelo, os modelos que ela define são disponibilizados por azd meio de outros comandos. Por exemplo, o trecho JSON de origem do modelo abaixo define dois modelos:

[
  {
    "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"]
  }
]

Cada entrada de modelo no arquivo de configuração JSON inclui as seguintes propriedades:

  • nome: O nome para exibição do modelo.
  • descrição: Um breve resumo do que o modelo faz.
  • repositoryPath: O caminho para o código-fonte do modelo, que pode ser:
    • Um URI totalmente qualificado para um repositório Git, como "https://dev.azure.com/org/project/_git/repo".
    • "{owner}/{repo}" para repositórios do GitHub.
    • "{repo}" para repositórios do GitHub da organização Azure-Samples.
  • tags: Palavras-chave que ajudam os usuários a filtrar modelos com azd init --filter <tag> e azd template list --filter <tag>.

Para obter um exemplo completo, consulte este arquivo JSON, que é a fonte de modelo padrão incluída no azd.

azd permite habilitar várias fontes de modelo ao mesmo tempo. As seguintes opções de origem de modelo estão atualmente disponíveis para escolha:

  • awesome-azd - Uma lista dos modelos da galeria Awesome AZD que está ativada por padrão.
  • default - Um pequeno conjunto de modelos selecionados para demonstrar diferentes pilhas de tecnologia.
  • file - Um caminho local/de rede que aponta para um arquivo de configuração JSON de origem do modelo.
  • url - Um caminho endereçável HTTP(S) que aponta para um arquivo de configuração JSON de origem do modelo.
  • gh - Aponta para um repositório GitHub.
  • ade - Aponta para uma lista de modelos do Ambiente de Implantação do Azure. Saiba mais sobre o suporte da CLI do Desenvolvedor do Azure para Ambientes de Implantação do Azure.

Trabalhar com fontes de modelo

azd Fornece vários comandos para configurar fontes de modelo.

Use o azd template source list comando para listar todas as fontes de modelo configuradas no momento:

azd template source list

Exemplo de saída com duas fontes de modelo configuradas:

Key          Name         Type         Location

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

Use o azd template source add comando para adicionar uma nova fonte de modelo. Este comando aceita os seguintes parâmetros:

  • key: O nome técnico da origem do modelo.
  • --type, -t: O tipo de fonte do modelo - os valores válidos são file, url e gh para o GitHub.
  • --location, -l: O local de origem do modelo, que deve ser uma rede local ou um URI da Web HTTP(S).
  • --name, -n: O nome de apresentação da fonte do modelo (opcional, usa a chave se não for especificado).
azd template source add <key> --type <file-or-url-or-gh> --location <your-uri> --name <your-display-name>

Use o comando para remover uma fonte de azd template source remove modelo:

azd template source remove <key>

Use o azd config reset comando para redefinir a configuração do modelo de volta às configurações padrão:

azd config reset

Trabalhar com listas de modelos

Depois de configurar as fontes de modelo, use o azd template list comando para listar os modelos disponíveis dessas fontes:

azd template list

Por exemplo, uma instalação padrão de azd lista os seguintes modelos da fonte de modelo 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

Inclua o sinalizador --source para listar apenas modelos de uma fonte específica:

azd template list --source <source-name>

Para inicializar um modelo da lista exibida, execute o comando azd init e forneça o caminho do repositório do modelo:

azd init --template <path-value>

Trabalhar com ambientes de implantação do Azure

A CLI do Desenvolvedor do Azure (azd) também fornece suporte para Ambientes de Implantação do Azure. Um Ambiente de Implantação do Azure (ADE) é uma coleção pré-configurada de recursos do Azure implantados em assinaturas predefinidas. A governança do Azure é aplicada a essas assinaturas com base no tipo de ambiente, como área restrita, teste, preparo ou produção. Com os Ambientes de Implantação do Azure, você pode aplicar políticas de segurança corporativa e fornecer um conjunto selecionado de modelos predefinidos de infraestrutura como código (IaC).

A integração do ADE está além do escopo deste artigo. Saiba mais sobre como configurar ade o suporte na documentação da CLI do Desenvolvedor do Azure para Ambientes de Implantação do Azure.

Próximos passos

Suporte da CLI do Desenvolvedor do Azure para Ambientes de Implantaçãodo Azure Referência de comando da lista de modelos