Compartilhar via

Início Rápido: Criar e implantar um aplicativo Web Python para Azure usando um modelo azd

Este guia de início rápido orienta você pela maneira mais fácil e rápida de criar e implantar uma solução Python web e de banco de dados para Azure. Seguindo as instruções neste início rápido, você:

  • Escolha um modelo azd com base na estrutura de desenvolvimento web Python, plataforma de banco de dados Azure e plataforma de hospedagem na Web Azure na qual você deseja criar.
  • Use comandos da CLI para executar um modelo azd para criar um aplicativo Web e um banco de dados de exemplo e criar e configurar os recursos necessários Azure. Em seguida, implante o aplicativo Web de exemplo para Azure.
  • Edite o aplicativo Web em seu computador local e use um azd comando para reimplantar.
  • Use um comando azd para limpar Azure recursos.

Deve levar menos de 15 minutos para concluir este tutorial. Ao concluir, você pode começar a modificar o novo projeto com seu código personalizado.

Para saber mais sobre os modelos de azd desenvolvimento de aplicativos web em Python, consulte:

Pré-requisitos

Uma assinatura Azure – Criar uma gratuitamente

Instale as seguintes ferramentas no computador local:

Escolher um modelo

Escolha um modelo azd com base na estrutura da Web Python, Azure plataforma de hospedagem da Web e Azure plataforma de banco de dados na qual você deseja criar.

  1. Selecione um nome de modelo (primeira coluna) na seguinte lista de modelos nas tabelas a seguir. Utilize o nome do modelo durante a azd init etapa na seção seguinte.

    Modelo Estrutura Web Base de dados Plataforma de hospedagem Repositório GitHub
    azure-django-postgres-flexible-aca Django Servidor Flexível do PostgreSQL Azure Container Apps repo
    azure-django-postgres-flexible-appservice Django Servidor Flexível do PostgreSQL Azure App Service repo
    azure-django-cosmos-postgres-aca Django Cosmos DB (Adaptador PostgreSQL) Azure Container Apps repo
    azure-django-cosmos-postgres-appservice Django Cosmos DB (Adaptador PostgreSQL) Azure App Service repo
    azure-django-postgres-addon-aca Django Complemento para Azure Container Apps PostgreSQL Azure Container Apps repo

Executar o modelo

A execução de um azd modelo é a mesma entre linguagens e estruturas. As mesmas etapas básicas se aplicam a todos os modelos. As etapas são:

  1. Em um terminal, navegue até uma pasta em seu computador local, onde normalmente você armazena seus repositórios git locais. Crie uma nova pasta chamada azdtest. Em seguida, altere para esse diretório usando o cd comando.

    mkdir azdtest
cd azdtest

    Não use o Terminal do Visual Studio Code para este início rápido.

  2. Para configurar o ambiente de desenvolvimento local, insira os seguintes comandos em seu terminal e responda a todos os prompts:

    azd init --template <template name>

    Substitua <template name> por um dos modelos das tabelas selecionadas em uma etapa anterior, como azure-django-postgres-aca , por exemplo.

    Quando solicitado a obter um nome de ambiente, use azdtest ou qualquer outro nome. O nome do ambiente é usado ao nomear recursos do Azure e grupos de recursos. Para obter melhores resultados, use um nome curto, letras minúsculas, sem caracteres especiais.

  3. Para autenticar azd em sua conta Azure, insira os seguintes comandos em seu terminal e siga o prompt:

    azd auth login

    Siga as instruções quando solicitado a "Escolher uma conta" ou entrar em sua conta Azure. Depois de autenticar com êxito, a seguinte mensagem será exibida em uma página da Web: "Autenticação concluída. Você pode retornar ao aplicativo. Feche essa guia do navegador."

    Quando você fecha a guia, o shell exibe a mensagem:

    Logged in to Azure.

  4. Verifique se o Docker Desktop está aberto e em execução em segundo plano antes de tentar a próxima etapa.

  5. Para criar os recursos de Azure necessários, insira os seguintes comandos em seu terminal e responda a todos os prompts:

    azd up

    Importante

    Depois que azd up for concluído com êxito, o aplicativo Web de exemplo estará disponível na Internet pública e sua assinatura Azure começará a acumular encargos para todos os recursos criados. Os criadores dos azd modelos escolheram intencionalmente camadas baratas, mas não necessariamente camadas gratuitas , pois as camadas gratuitas geralmente têm disponibilidade restrita.

    Siga as instruções quando solicitado para escolher a Assinatura do Azure a ser usada para pagamento e selecione um local do Azure a ser usado. Escolha uma região próxima a você geograficamente.

    A execução azd up pode levar vários minutos, pois está provisionando e implantando vários serviços de Azure. À medida que o progresso é exibido, observe os erros. Se você vir erros, tente o seguinte para corrigir o problema:

    • Exclua a pasta azd-quickstart e as instruções de início rápido.
    • Quando solicitado, escolha um nome mais simples para seu ambiente. Use apenas letras minúsculas e traços. Sem números, letras maiúsculas ou caracteres especiais.
    • Escolha um local diferente.

    Se você ainda tiver problemas, consulte a seção Solução de problemas na parte inferior deste documento.

    Importante

    Quando terminar de trabalhar com o aplicativo Web de exemplo, use azd down para remover todos os serviços criados azd up .

  6. Quando azd up conclui com êxito, a seguinte saída será exibida:

    Screenshot da saída bem-sucedida da interface de linha de comando do azd com uma chamada de atenção em torno da URL do endpoint para visualizar o funcionamento do aplicativo Relecloud implantado no Azure.

    Copie a primeira URL após a palavra - Endpoint: e cole-a na barra de localização de um navegador da Web para ver o projeto de aplicativo Web de exemplo em execução em Azure.

  7. Abra uma nova guia no navegador da Web.

    1. Copie a segunda URL da etapa anterior e cole-a na barra de localização.
    2. O portal Azure exibe todos os serviços em seu novo grupo de recursos que são implantados para hospedar o projeto de aplicativo Web de exemplo.

Editar e reimplantar

Em seguida, faça uma pequena alteração no aplicativo Web e, em seguida, reimplante-o.

  1. Abra Visual Studio Code e abra a pasta azdtest.

  2. Esse modelo é configurado para usar opcionalmente Contêineres de Desenvolvimento. Quando você vir a notificação de Dev Container aparecer no Visual Studio Code, selecione o botão Reabrir no Contêiner.

  3. Use o modo de exibição explorer do Visual Studio Code para navegar até src/templates pasta e abrir o arquivo index.html. Localize a seguinte linha de código:

    <h1 id="pagte-title">Welcome to ReleCloud</h1>

    Altere o texto dentro do H1:

    <h1 id="pagte-title">Welcome to ReleCloud - UPDATED</h1>

    Salve suas alterações.

  4. Para reimplantar o aplicativo com sua alteração, execute o seguinte comando em seu terminal:

    azd deploy

    Como você está usando Contêineres de Desenvolvimento e está conectado remotamente ao shell do contêiner, não use o painel Terminal do Visual Studio Code para executar comandos azd.

  5. Quando o comando for concluído, recarregue o navegador para ver a atualização. Dependendo da plataforma de hospedagem da Web que você está usando, pode levar vários minutos até que suas alterações fiquem visíveis.

    Agora você está pronto para editar e excluir arquivos no modelo. Para obter mais informações, consulte o que posso editar ou excluir no modelo?

Limpar os recursos

  1. Limpe os recursos criados pelo modelo executando o azd down comando.

    azd down

    O comando azd down exclui os recursos de Azure e o fluxo de trabalho GitHub Actions. Quando solicitado, concorde em excluir todos os recursos associados ao grupo de recursos.

    Você também pode excluir a pasta azdtest ou usá-la como base para seu próprio aplicativo modificando os arquivos do projeto.

Resolução de problemas

Se você vir erros durante azd up, tente as seguintes etapas:

  • Execute azd down para remover todos os recursos que o comando criou. Como alternativa, você pode excluir o grupo de recursos que criou no portal Azure.
  • Exclua a pasta azdtest em seu computador local.
  • No portal Azure, procure os Key Vaults. Selecione Gerenciar cofres excluídos, selecione sua assinatura, selecione todos os cofres de chaves que contêm o nome azdtest ou com o qual você nomeou seu ambiente e selecione Excluir permanentemente.
  • Tente novamente as etapas neste guia de início rápido. Desta vez, quando solicitado, escolha um nome mais simples para seu ambiente. Experimente um nome curto, letras minúsculas, sem números, sem letras maiúsculas e sem caracteres especiais.
  • Ao tentar novamente as etapas de início rápido, escolha um local diferente.

Para obter uma lista mais abrangente de possíveis problemas e soluções, consulte as perguntas frequentes.

Conteúdo relacionado

  • Last updated on