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

Artigo
09/13/2024

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

Usar código no diretório atual: essa abordagem analisa seu aplicativo e gera automaticamente a infraestrutura suportada e os recursos de configuração.
Selecione um modelo: essa abordagem permite integrar um modelo existente ao seu aplicativo ou usar um modelo existente como ponto de partida para um novo aplicativo.

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

Neste artigo, você aprenderá a adicionar suporte para a CLI do Desenvolvedor do Azure (azd) ao seu aplicativo por meio da abordagem Usar código na abordagem de diretório atual. Visite Adicionar azd suporte ao seu aplicativo usando um documento de 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 a criação azd de modelos.

Usar código no diretório atual

Você pode seguir as etapas à frente usando seu próprio projeto. No entanto, se você preferir acompanhar usando um aplicativo de exemplo, clone o repositório inicial a seguir para um diretório vazio no seu computador:
```
git clone https://github.com/Azure-Samples/msdocs-python-flask-webapp-quickstart
```
Abra um terminal para o diretório raiz do projeto.
Execute o azd init comando para inicializar o modelo.
```
azd init
```
Quando solicitado, selecione a opção Usar código no diretório atual. azd analisa o projeto e fornece um resumo dos serviços detetados e dos recursos de hospedagem recomendados do Azure.
Selecione Confirmar e continuar 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 no Azure.
- Uma .azure pasta com variáveis de ambiente definidas em um .env arquivo.
Mais detalhes sobre esse processo de deteção e geração são fornecidos mais adiante no artigo.
Os arquivos gerados funcionam como estão para o aplicativo de exemplo fornecido e podem para seus próprios aplicativos também. 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 infra pasta se seu aplicativo depender de recursos do Azure além daqueles que foram identificados pelo azd.
Execute o azd up comando para provisionar e implantar seu aplicativo no Azure.
```
azd up
```
Quando solicitado, selecione a assinatura e o local desejados para iniciar o processo de provisionamento e implantação.
Quando o processo for concluído, clique no link na azd saída para abrir o aplicativo no navegador.

Explore as etapas de inicialização

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

Detection

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

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

Idiomas suportados:
- Python
- JavaScript/TypeScript
- .NET
- Java
Bases de dados suportadas:
- MongoDB
- PostgreSQL
Para Python e JavaScript/TypeScript, frameworks da web e bancos de dados são detetados automaticamente.
Quando um projeto JavaScript/TypeScript usa uma estrutura da Web front-end (ou do lado do cliente), ele é classificado como um serviço front-end. Se o seu serviço usa uma estrutura da Web front-end que não é detetada no momento, você pode selecionar JQuery para fornecer classificação e comportamento de serviço front-end equivalente.

Geração

Depois de confirmar os componentes detetados, 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:

Anfitriões suportados:
- Aplicativos de contêiner do Azure.
Para bancos de dados, o mapeamento suportado entre a tecnologia de banco de dados e o serviço usado:
- MongoDB: API do Azure CosmosDB para MongoDB
- PostgreSQL: Banco de Dados do Azure para servidor flexível PostgreSQL
- Redis: Complemento Redis do Azure Container Apps
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 front-end e back-end forem detetados, a configuração CORS no host do Azure para serviços back-end será atualizada para permitir o domínio de hospedagem padrão dos serviços front-end. Isso pode ser modificado ou removido conforme necessário nos arquivos de configuração 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 tempos de execução necessários para trabalhar com uma base de código e para 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:

Crie uma pasta .devcontainer na raiz do seu projeto.
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 do GitHub ou Azure DevOps usando as seguintes etapas:

Adicione uma .github pasta para ações do GitHub ou uma .ado pasta para o Azure DevOps à raiz do seu projeto.
Adicione um arquivo de fluxo de trabalho à nova pasta. O azd modelo inicial fornece um arquivo de fluxo de trabalho de Ações de Exemplo do GitHub e arquivos de Pipelines de DevOps do Azure de Exemplo para cada plataforma que você pode copiar para seu projeto e modificar conforme necessário.
Também pode ser necessário atualizar o main.parameters.json arquivo em sua infra pasta com as variáveis de ambiente necessárias para que seu fluxo de trabalho seja executado.

Partilhar via