Compartilhar via

Visão geral dos modelos azd da Web do Python

Modelos da CLI do Desenvolvedor para Python na Web do Azure (azd) são a maneira mais rápida e fácil de criar, configurar e implantar aplicativos Web Python no Azure. Este artigo fornece informações contextuais em segundo plano para ajudá-lo a entender os componentes envolvidos e como os modelos simplificam a implantação.

A melhor maneira de começar é seguir o início rápido para criar seu primeiro aplicativo Web Python e implantá-lo no Azure em minutos com azd modelos. Se você preferir não configurar um ambiente de desenvolvimento local, poderá seguir o início rápido usando os Codespaces do GitHub para uma experiência totalmente baseada em nuvem com todas as ferramentas pré-configuradas.

O que são os modelos web azd do Python?

Os azd modelos são projetados para desenvolvedores web python experientes que desejam implantar aplicativos escalonáveis e prontos para nuvem no Azure com tempo mínimo de instalação.

Esses modelos oferecem o ponto de partida mais fácil possível para criar e implantar aplicativos Web Python:

  • Configurando rapidamente um ambiente de hospedagem e desenvolvimento local completo.
  • Automatizando a criação de um ambiente de implantação do Azure correspondente.
  • Usando um fluxo de trabalho simples e memorável com interface de linha de comando (CLI).

Depois que seus ambientes são configurados, os modelos fornecem a maneira mais rápida de começar a criar seu aplicativo Web Python. É possível:

  • Modifique os arquivos de código fornecidos para corresponder aos requisitos do aplicativo.
  • Implante atualizações com esforço mínimo usando comandos azd.
  • Estenda o modelo para se ajustar à sua arquitetura.

Esses modelos refletem padrões de design comprovados e práticas recomendadas, permitindo que você:

  • Construa com confiança em uma base arquitetônica sólida.
  • Siga as diretrizes desenvolvidas por especialistas do setor com experiência profunda no Python e no Azure.
  • Verifique a manutenção, a escalabilidade e a segurança desde o início.

Quais tarefas posso fazer com os modelos?

Ao executar um modelo web azd do Python, você conclui rapidamente várias tarefas:

  • Crie um aplicativo inicial. Você cria um site para uma empresa fictícia chamada Relecloud. Este projeto inicial inclui:

    • Código bem organizado e pronto para produção
    • Práticas recomendadas para estruturas web do Python (como Flask, Django).
    • Uso adequado de dependências, configuração e estrutura.

    O modelo foi projetado para ser um ponto de partida– você pode personalizar livremente a lógica e expandir ou remover recursos do Azure para se ajustar ao seu projeto.

  • Provisionar recursos do Azure. Usando o Bicep, uma linguagem moderna de IaC (infraestrutura como código), o template provisiona todos os recursos necessários do Azure para:

    • Hospedando seu aplicativo Web (como Serviço de Aplicativo, Aplicativos de Contêiner)
    • Conectando-se a bancos de dados (como PostgreSQL, Cosmos DB)

    Os arquivos Bicep são totalmente editáveis, você pode adicionar ou personalizar os serviços do Azure à medida que seu aplicativo evolui. Semelhante à tarefa anterior, você pode modificar os modelos do Bicep para adicionar mais serviços do Azure, conforme necessário.

  • Implantar o aplicativo inicial em recursos provisionados do Azure. Depois que os recursos são provisionados, seu aplicativo é implantado automaticamente no ambiente do Azure. Agora você pode:

    • Veja seu aplicativo em execução na nuvem em poucos minutos.
    • Teste seu comportamento.
    • Decida qual funcionalidade ou configuração será atualizada a seguir.

  • (Opcional) Configure o repositório GitHub e o pipeline de CI/CD. Opcionalmente, você pode inicializar um repositório do GitHub com um pipeline de GitHub Actions para integração contínua e entrega contínua (CI/CD), para:

    • Automatizar implantações nas alterações de código.
    • Colabore com os membros da equipe.
    • Envie atualizações para o Azure ao mesclar com o branch principal.

    Essa integração ajuda você a adotar as práticas recomendadas do DevOps desde o início.

Onde posso acessar os modelos?

Muitos modelos azd estão disponíveis na Galeria de Modelos Incrível da CLI do Desenvolvedor do Azure. Esses modelos fornecem projetos de aplicativo Web Python prontos para uso com paridade de recursos entre combinações populares de serviços do Azure e estruturas Web do Python.

Cada modelo inclui:

  • Um aplicativo de exemplo com código limpo e mantenedível.
  • Infraestrutura como código pré-configurada usando o Bicep.
  • Fluxos de trabalho de implantação contínuos usando a CLI do Desenvolvedor do Azure.
  • Integração opcional de CI/CD por meio do GitHub Actions

As tabelas a seguir listam os monikers de modelo web azd do Python que estão disponíveis para uso com o azd init comando. As tabelas identificam as tecnologias implementadas em cada modelo e fornecem um link para o repositório GitHub correspondente, no qual você pode contribuir com alterações.

azd Os modelos a seguir estão disponíveis para a estrutura web do Django.

Modelo Base de dados Plataforma de hospedagem Repositório GitHub
azure-django-postgres-flexible-aca Azure Banco de Dados para PostgreSQL - Servidor Flexível Aplicativos de Contêiner do Azure https://github.com/Azure-Samples/azure-django-postgres-flexible-aca
azure-django-postgres-flexible-appservice Servidor Flexível do Banco de Dados do Azure para PostgreSQL Serviço de Aplicativo do Azure https://github.com/Azure-Samples/azure-django-postgres-flexible-appservice
azure-django-cosmos-postgres-aca Azure Cosmos DB para Banco de Dados do Azure para PostgreSQL Aplicativos de Contêiner do Azure https://github.com/Azure-Samples/azure-django-cosmos-postgres-aca
azure-django-cosmos-postgres-appservice Azure Cosmos DB para Banco de Dados do Azure para PostgreSQL Serviço de aplicativo do Azure https://github.com/Azure-Samples/azure-django-cosmos-postgres-appservice
azure-django-postgres-addon-aca Aplicativos de Contêiner do Azure com o Banco de Dados do Azure para PostgreSQL Aplicativos de Contêiner do Azure https://github.com/Azure-Samples/azure-django-postgres-addon-aca

Como devo usar os modelos?

Cada azd modelo é composto por um repositório GitHub que contém o código do aplicativo (código Python que utiliza uma estrutura web popular) e os arquivos de infraestrutura como código (ou seja, Bicep) para criar os recursos do Azure. O modelo também contém a configuração necessária para configurar um repositório GitHub com um pipeline de CI/CD.

Os principais componentes de cada modelo incluem:

  • Código do aplicativo: escrito em Python e criado usando uma estrutura web popular (como Flask, Django, FastAPI). O aplicativo de exemplo demonstra as melhores práticas de roteamento, acesso a dados e configuração.

  • IaC (infraestrutura como código):: fornecido por meio de arquivos Bicep para definir e provisionar os recursos necessários do Azure, como:

    • Serviços de Aplicativos ou Aplicativos de Contêiner
    • Bancos de Dados do Azure (como PostgreSQL, Cosmos DB)
    • Serviços de IA do Azure, Armazenamento e muito mais

  • Configuração de CI/CD (opcional): inclui arquivos para configurar um repositório GitHub com um pipeline de CI/CD do GitHub Actions, habilitando:

    • Implantação automática no Azure em cada solicitação push ou pull para o branch principal.
    • Integração perfeita ao fluxo de trabalho do DevOps

    Esses modelos são totalmente personalizáveis, fornecendo uma base forte para criar e adaptar-se às necessidades específicas do projeto.

Para executar as tarefas definidas por um azd modelo da Web, use vários comandos do Python azd . Para obter descrições detalhadas desses comandos, consulte Início Rápido: Implantar um modelo da CLI do Desenvolvedor do Azure. O guia de início rápido orienta você pelas etapas para usar um modelo específico azd. Você só precisa executar cinco instruções de linha de comando essenciais para o ambiente de hospedagem de produção e o ambiente de desenvolvimento local.

A tabela a seguir resume os cinco comandos essenciais:

Comando Descrição da tarefa
azd init --template <template name> Crie um novo projeto a partir de um modelo e crie uma cópia do código do aplicativo em seu computador local. O comando solicita que você forneça um nome de ambiente (como "myapp") usado como prefixo na nomenclatura dos recursos implantados.
azd auth login Inicie sessão no Azure. O comando abre uma janela do navegador na qual você pode entrar no Azure. Depois de entrar, a janela do navegador é fechada e o comando é concluído. O azd auth login comando é necessário apenas na primeira vez que você usa a CLI do Desenvolvedor do Azure (azd) por sessão.
azd up Provisione os recursos de nuvem e implante o aplicativo nesses recursos.
azd deploy Implante alterações no código-fonte do aplicativo em recursos já provisionados pelo azd up comando.
azd down Exclua os recursos do Azure e o pipeline de CI/CD, se ele tiver sido usado.

Dica

Quando você trabalha com os azd comandos, preste atenção às solicitações para inserir mais informações. Depois de executar o azd up comando, você poderá ser solicitado a selecionar uma assinatura, se tiver mais de uma. Você também pode ser solicitado a especificar sua região. Você pode alterar as respostas para prompts editando as variáveis de ambiente armazenadas na pasta /.azure/ do modelo.

Depois de concluir as tarefas essenciais fornecidas pelo azd modelo, você tem uma cópia pessoal do modelo original em que pode modificar qualquer arquivo, conforme necessário.

  • Código do aplicativo: personalize o código do projeto Python para implementar seu próprio design, rotas e lógica de negócios.
  • Infraestrutura como Código (Bicep): atualize os arquivos Bicep para provisionar serviços adicionais do Azure, alterar configurações ou remover recursos desnecessários.

Esse ponto de partida flexível permite que você crie uma base bem estruturada enquanto adapta o aplicativo ao seu caso de uso do mundo real.

Você também pode modificar a configuração de infraestrutura como código se precisar alterar os recursos do Azure. Para obter mais informações, consulte a seção O que posso editar ou excluir mais adiante neste artigo.

Tarefas de modelo opcionais

Além dos cinco comandos essenciais, há tarefas opcionais que você pode concluir com os azd modelos.

Reprovisionar e modificar recursos do Azure

Depois de provisionar recursos do Azure com um azd modelo, você pode modificar e reprovisionar um recurso.

Configurar pipeline de CI/CD

A CLI do Desenvolvedor do Azure (azd) fornece uma maneira fácil de configurar um pipeline de CI/CD para seu novo aplicativo Web Python. Quando você mescla confirmações ou solicitações de pull em seu branch principal, o pipeline cria e publica automaticamente as alterações em seus recursos do Azure.

  • Para configurar o pipeline de CI/CD, você designa o repositório do GitHub e as configurações desejadas para habilitar o pipeline.
  • Para criar o pipeline, use o azd pipeline config comando.

Depois de configurar o pipeline, sempre que as alterações de código forem mescladas ao branch principal do repositório, o pipeline implantará as alterações nos serviços provisionados do Azure.

Alternativas aos modelos

Se você preferir não usar os modelos Web azd do Python, haverá métodos alternativos para implantar aplicativos Web Python no Azure e provisionar recursos do Azure.

Você pode criar muitos recursos e concluir as etapas de implantação usando várias ferramentas:

Você também pode seguir um tutorial de ponta a ponta que apresenta as estruturas de desenvolvimento da Web do Python:

Perguntas frequentes

As seções a seguir resumem respostas a perguntas frequentes sobre como trabalhar com os modelos web azd do Python.

Preciso usar Contêineres de Desenvolvimento?

Não. Os modelos web azd do Python usam contêineres de desenvolvimento do Visual Studio Code por padrão. Os Contêineres de Desenvolvimento oferecem muitos benefícios, mas exigem algum conhecimento e software de pré-requisito. Se você preferir não usar Contêineres de Desenvolvimento e, em vez disso, usar seu ambiente de desenvolvimento local, consulte o arquivo README.md no diretório raiz do aplicativo de exemplo para obter instruções de configuração do ambiente.

O que posso editar ou excluir?

O conteúdo de cada modelo web azd do Python pode variar dependendo do tipo de projeto e da pilha de tecnologia subjacente empregada. Os modelos identificados neste artigo seguem uma convenção de arquivo e pasta comum, conforme descrito na tabela a seguir.

Pasta/arquivo(s) Propósito Descrição
/ Diretório raiz A pasta raiz para cada modelo contém muitos tipos diferentes de arquivos e pastas para fins diferentes.
/.azul azd arquivos de configuração A pasta .azure é criada depois que você executa o azd init comando. A pasta armazena arquivos de configuração para as variáveis de ambiente usadas pelos azd comandos. Você pode alterar os valores das variáveis de ambiente para personalizar o aplicativo e os recursos do Azure. Para obter mais informações, consulte o arquivo .env específico do ambiente.
/.devcontainer Arquivos de configuração do Contêiner de Desenvolvimento Os Contêineres de Desenvolvimento permitem que você crie um ambiente de desenvolvimento baseado em contêiner completo com todos os recursos necessários para o desenvolvimento de software dentro do Visual Studio Code. A pasta .devcontainer é criada depois que o Visual Studio Code gera um arquivo de configuração de Contêiner de Desenvolvimento em resposta a um comando de modelo.
/.github Arquivos de configuração do GitHub Actions Esta pasta contém configurações para o pipeline de CI/CD opcional do GitHub Actions, além de linting e testes. Se você não quiser configurar o pipeline do GitHub Actions usando azd pipeline config o comando, poderá modificar ou excluir o arquivo azure-dev.yaml .
/infra Arquivos Bicep A pasta infra contém os arquivos de configuração do Bicep. O Bicep permite declarar os recursos do Azure que você deseja implantar em seu ambiente. Você só deve modificar os arquivos main.bicep e web.bicep . Para obter mais informações, consulte Início Rápido: Dimensionamento de serviços implantados com os modelos web do Python azd usando o Bicep.
/Src Arquivos de código do projeto inicial A pasta src contém vários arquivos de código necessários para preparar o projeto inicial. Exemplos dos arquivos incluem modelos exigidos pela estrutura da Web, arquivos estáticos, arquivos Python (.py) para a lógica de código e modelos de dados, um arquivo requirements.txt e muito mais. Os arquivos específicos dependem da estrutura da Web, da estrutura de acesso a dados e assim por diante. Você pode modificar esses arquivos para atender aos requisitos do projeto.
/.cruft.json Arquivo de geração de modelo O arquivo JSON .cruft é usado internamente para gerar os modelos web azd do Python. Você pode excluir esse arquivo com segurança, conforme necessário.
/.gitattributes Arquivo com configurações de atributo para git Esse arquivo fornece ao Git configurações importantes para lidar com arquivos e pastas. Você pode modificar esse arquivo, conforme necessário.
/.gitignore Arquivo com itens ignorados para git O arquivo .gitignore informa ao Git sobre os arquivos e pastas a serem excluídos (ignorar) ao gravar no repositório GitHub para o modelo. Você pode modificar esse arquivo, conforme necessário.
/azure.yaml azd up arquivo de configuração Esse arquivo de configuração contém as configurações do azd up comando. Ele especifica os serviços e as pastas de projeto a serem implantados. Importante: este arquivo não deve ser excluído.
/*.md Arquivos de formato markdown Um modelo pode incluir vários arquivos de formato Markdown (.md) para diferentes finalidades. Você pode excluir arquivos Markdown com segurança.
/docker-compose.yml Configurações de composição do Docker Esse arquivo YML cria o pacote de contêiner para o aplicativo Web Python antes que o aplicativo seja implantado no Azure.
/pyproject.toml Arquivo de configurações de build do Python O arquivo TOML contém os requisitos do sistema de build de projetos do Python. Você pode modificar esse arquivo para identificar suas preferências de ferramenta, como um linter específico ou estrutura de teste de unidade.
/requirements-dev.in arquivo de requisitos de pip Esse arquivo é usado para criar uma versão do ambiente de desenvolvimento dos requisitos usando o pip install -r comando. Você pode modificar esse arquivo para incluir outros pacotes, conforme necessário.

Dica

Ao modificar arquivos de modelo para seu programa, não se esqueça de praticar um bom controle de versão. Essa abordagem pode ajudá-lo a restaurar seu repositório para uma versão de trabalho anterior, se novas alterações causarem problemas de programa.

Como posso lidar com erros de modelo?

Se você receber um erro ao usar um modelo azd, examine as opções descritas no artigo CLI do Desenvolvedor do Azure. Você também pode relatar problemas no repositório GitHub associado ao azd modelo.

Conteúdo relacionado