Criar a estrutura do modelo

  • 6 minutos

O Azure Developer CLI (azd) ajuda você a criar modelos para seus aplicativos usando o comando azd init e os modelos iniciais. Nesta unidade, você criará o scaffolding básico ou a estrutura de um novo modelo que você usará para criar no restante do módulo.

  1. Em um diretório vazio no computador local, execute o comando azd init.

    azd init

  2. A saída do comando exibe uma lista de modelos iniciais e opções completas de aplicativo de exemplo. Os modelos iniciais incluem a estrutura de pastas essenciais, a infraestrutura inicial como arquivos de código e outros arquivos de configuração clichês para começar a criar modelos. Os modelos de exemplo completos também incluem o código do aplicativo de espaço reservado e os arquivos necessários para implantá-los. Para este módulo, você aprenderá a criar seu modelo em vez de modificar o código do aplicativo existente, portanto, escolha a opção Starter – Bicep na lista. O Azure Developer CLI também dá suporte ao uso do Terraform se você preferir essa opção. O suporte ao Terraform está atualmente em alfa e precisa ser habilitado manualmente.

  3. Quando solicitado a fornecer um nome de ambiente, insira azdlearn ou um nome de sua escolha. O nome do ambiente influencia a nomenclatura de recursos provisionados no Azure.

  4. Um conjunto de pastas é criado dentro do diretório atual:

    The starter template structure.

Observação

Talvez você tenha notado que o comando azd init também fornece um modelo de projeto chamado Mínimo, que contém a estrutura de modelo mais simples possível. No entanto, o modelo Starter – Bicep selecionado inclui código de scaffolding adicional que é muito útil, mas ainda independente de tecnologia, portanto, geralmente é uma ótima opção para começar.

As pastas geradas fornecem todos os blocos de construção essenciais de um modelo azd:

  • .azdo – uma pasta que contém os arquivos de configuração inicial .yml para CI/CD com o Azure Pipelines.
  • .azure – uma pasta que contém configurações essenciais para o ambiente do Azure do modelo, como o nome do ambiente.
  • .devcontainer – uma pasta que contém arquivos de configuração usados para executar o modelo em um ambiente de contêiner de desenvolvimento.
  • .github – uma pasta que contém um modelo de configuração inicial .yml para configurar um pipeline de CI/CD por meio do GitHub Actions.
  • infra – uma pasta que contém arquivos Bicep iniciais para a infraestrutura do modelo como código. Se você selecionou o modelo inicial do Terraform, essa pasta conterá, em vez disso, arquivos Terraform.
  • azure.yaml – um arquivo que descreve como as partes do aplicativo são mapeadas para serviços no Azure.

Este modelo inicial contém a maior parte do que você precisa para criar seu modelo azd. Nas próximas unidades, você aprenderá a atualizar esses arquivos existentes e adicionar novos ativos para criar um modelo completo.