Criar a estrutura do modelo

  • 6 minutos

A CLI do Desenvolvedor do Azure (azd) ajuda você a criar novos modelos para seus aplicativos usando os modelos de azd init comando e inicial. Nesta unidade, você criará o andaime básico ou a estrutura de um novo modelo que você desenvolverá para o resto do módulo.

  1. Em um diretório vazio em sua máquina local, execute o azd init comando.

    azd init

  2. A saída do comando exibe uma lista de modelos iniciais e opções de aplicativo de exemplo completo. Os modelos iniciais incluem a estrutura de pastas essencial, a infraestrutura inicial como arquivos de código e outros arquivos de configuração clichê 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 próprio modelo em vez de modificar o código do aplicativo existente, então escolha a opção Starter - Bicep na lista. A CLI do Desenvolvedor do Azure também dá suporte ao uso do Terraform se você preferir essa opção. O suporte a Terraform está atualmente em alfa e deve ser ativado manualmente.

  3. Quando for solicitado um nome de ambiente, digite azdlearn ou um nome de sua escolha. O nome do ambiente influencia a nomeação de recursos provisionados no Azure.

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

    A estrutura do modelo inicial.

Nota

Você deve ter notado que o azd init comando também fornece um modelo de projeto chamado Minimal, que contém a estrutura de modelo mais simples possível. No entanto, o modelo Starter - Bicep que você selecionou inclui código de andaime adicional que é muito útil, mas ainda agnóstico em relação à tecnologia, por isso geralmente é uma ótima opção para começar.

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

  • .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 de ações do GitHub.
  • infra - Uma pasta contendo arquivos Bicep iniciais para a infraestrutura do modelo como código. Se você selecionou o modelo inicial Terraform, esta pasta contém arquivos Terraform em vez disso.
  • azure.yaml - Um arquivo que descreve como as partes do seu aplicativo são mapeadas para serviços no Azure.

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