Adicionar suporte à Azure Developer CLI ao seu aplicativo usando o código no diretório do seu aplicativo

A CLI do Desenvolvedor do Azure (azd) fornece dois fluxos de trabalho diferentes para inicializar um modelo a ser usado com seu aplicativo, que incluem:

  • Usar código no diretório atual: Esta abordagem analisa seu app e gera automaticamente infraestrutura compatível e recursos de configuração.
  • Selecione um modelo: essa abordagem permite que você integre um modelo existente ao seu aplicativo ou use um modelo existente como ponto de partida para um novo aplicativo.

Ambas as abordagens são exploradas no documento de visão geral de modelos da CLI do Create Azure Developer.

Neste artigo, você aprenderá a adicionar suporte para o Azure Developer CLI (azd) ao seu aplicativo por meio da abordagem Usar código no diretório atual. Consulte o documento Adicionar azd suporte ao seu aplicativo usando um modelo existente para obter mais informações sobre a abordagem alternativa. Você também pode visitar o Treinamento – criar e implantar azd modelos para obter mais informações sobre como criar azd modelos.

Usar código no diretório atual

  1. Você pode seguir as etapas à frente usando seu próprio projeto. No entanto, se você preferir acompanhar usando um aplicativo de exemplo, clone o seguinte repositório inicial em um diretório vazio no computador:

    git clone https://github.com/Azure-Samples/msdocs-python-flask-webapp-quickstart

  2. Abra um terminal para o diretório raiz do projeto.

  3. Execute o azd init comando para inicializar o modelo.

    azd init

  4. Quando solicitado, selecione a opção para Usar código no diretório atual. azd analisa o projeto e fornece um resumo dos serviços detectados e dos recursos recomendados de hospedagem do Azure.

  5. Selecione Confirmar e continue inicializando meu aplicativo. azd gera os seguintes ativos no diretório raiz do projeto:

    • Um azure.yaml arquivo com definições de serviço apropriadas.
    • Uma infra pasta com arquivos de infraestrutura como código para provisionar e implantar o projeto para Azure.
    • Uma .azure pasta com variáveis de ambiente definidas em um .env arquivo.

    Mais detalhes sobre esse processo de detecção e geração são fornecidos posteriormente no artigo.

  6. Os arquivos gerados funcionam como estão para o aplicativo de exemplo fornecido e também podem funcionar para seus próprios aplicativos. Se necessário, os arquivos gerados podem ser modificados para atender às suas necessidades. Por exemplo, talvez seja necessário modificar ainda mais os arquivos de infraestrutura como código na pasta infra se o aplicativo depender de recursos do Azure além daqueles que foram identificados por azd.

  7. Execute o azd up comando para provisionar e implantar seu aplicativo no Azure.

    azd up

  8. Quando solicitado, selecione a assinatura e o local desejados para iniciar o processo de provisionamento e implantação.

  9. Quando o processo for concluído, clique no link na saída azd para abrir o aplicativo no navegador.

Explorar as etapas de inicialização

Quando você seleciona o fluxo de trabalho Usar código no diretório atual, o comando azd init analisa seu projeto e gera código automaticamente com base no que descobre. As seções abaixo explicam os detalhes de como esse processo funciona e quais tecnologias têm suporte no momento.

Detecção

O azd init comando detecta arquivos de projeto para idiomas com suporte localizados em seu diretório de projeto e subdiretórios. azd também verifica as dependências do pacote para coletar informações sobre as estruturas da Web ou os bancos de dados que seu aplicativo usa. Se necessário, você pode adicionar ou editar manualmente os componentes detectados conforme apresentado no prompt de resumo de confirmação.

A lógica de detecção atual é a seguinte:

  • Idiomas com suporte:
    • Python
    • JavaScript/TypeScript
    • .NET
    • Java
  • Bancos de dados com suporte:
    • MongoDB
    • PostgreSQL
  • Para Python e JavaScript/TypeScript, estruturas da Web e bancos de dados são detectados automaticamente.
  • Quando um projeto JavaScript/TypeScript usa uma estrutura Web front-end (ou do lado do cliente), ele é classificado como um serviço front-end. Se o seu serviço usar um framework web de front-end que ainda não foi detectado, você poderá selecionar o jQuery para fornecer classificação e comportamento equivalentes para o serviço de front-end.

Generation

Depois de confirmar os componentes detectados, azd init gera os arquivos de infraestrutura como código necessários para implantar seu aplicativo no Azure.

A lógica de geração é a seguinte:

  • Hosts com suporte:
    • Aplicativos de Contêiner do Azure.
  • Para bancos de dados, o mapeamento com suporte entre a tecnologia de banco de dados e o serviço usado:
    • MongoDB: API do Azure Cosmos DB para MongoDB
    • PostgreSQL: Servidor Flexível do Banco de Dados do Azure para PostgreSQL
    • Redis: complemento Aplicativos de Contêiner do Azure Redis
  • Os serviços que usam bancos de dados terão variáveis de ambiente que fornecem conexão com o banco de dados pré-configurado por padrão.
  • Quando os serviços de front-end e back-end forem detectados, a configuração CORS no host do Azure para os serviços de back-end será atualizada para permitir o domínio padrão de hospedagem dos serviços de front-end. Isso pode ser modificado ou removido conforme necessário nos arquivos de configuração de Infraestrutura como Código.

Adicionar suporte para contêineres de desenvolvimento

Você também pode tornar seu modelo compatível com contêineres de desenvolvimento e codespaces. Um contêiner de desenvolvimento permite que você use um contêiner como um ambiente de desenvolvimento completo. Ele pode ser usado para executar um aplicativo, para separar ferramentas, bibliotecas ou runtimes necessários para trabalhar com uma base de código e ajudar na integração e teste contínuos. Os contêineres de desenvolvimento podem ser executados local ou remotamente, em uma nuvem privada ou pública. (Fonte: https://containers.dev/)

Para adicionar suporte para contêineres de desenvolvimento:

  1. Crie uma pasta .devcontainer na raiz do projeto.

  2. Crie um devcontainer.json arquivo dentro da .devcontainer pasta com as configurações desejadas. O azd modelo inicial fornece um arquivo de exemplo devcontainer.json que você pode copiar para seu projeto e modificar conforme necessário.

Leia mais sobre como trabalhar com contêineres de desenvolvimento na documentação do Visual Studio Code.

Adicionar suporte para um pipeline de CI/CD

Você também pode adicionar suporte para CI/CD em seu modelo usando ações GitHub ou Azure DevOps usando as seguintes etapas:

  1. Adicione uma .github pasta para ações de GitHub ou uma .ado pasta para Azure DevOps à raiz do projeto.

  2. Adicione um arquivo de fluxo de trabalho à nova pasta. O azd modelo inicial fornece um exemplo GitHub Actions arquivo de fluxo de trabalho e um arquivo de exemplo Azure DevOps Pipelines para cada plataforma. Você pode copiar esses arquivos em seu projeto e modificá-los conforme necessário.

  3. Talvez você também precise atualizar o main.parameters.json arquivo em sua infra pasta com as variáveis de ambiente necessárias para que o fluxo de trabalho seja executado.

  • Last updated on