Compartilhar via

Início Rápido: Criar e implantar um aplicativo Web Python no 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 web e de banco de dados python no Azure. Ao seguir as instruções neste guia de início rápido, você:

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

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

Para saber mais sobre esses azd modelos para o desenvolvimento de aplicativos Web Python:

Pré-requisitos

Uma assinatura do Azure – crie uma gratuitamente

Você deve ter o seguinte instalado em seu computador local:

Escolher um modelo

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

  1. Selecione um nome de modelo (primeira coluna) na seguinte lista de modelos nas tabelas a seguir. Você usará o nome do template na etapa azd init na próxima seção.

    Modelo Estrutura Web Base de dados Plataforma de hospedagem Repositório GitHub
    azure-django-postgres-flexible-aca Django Servidor Flexível do PostgreSQL Aplicativos de Contêiner do Azure repositório
    azure-django-postgres-flexible-appservice Django Servidor Flexível do PostgreSQL Serviço de aplicativo do Azure repositório
    azure-django-cosmos-postgres-aca Django Cosmos DB (Adaptador PostgreSQL) Aplicativos de Contêiner do Azure repositório
    azure-django-cosmos-postgres-appservice Django Cosmos DB (Adaptador PostgreSQL) Serviço de aplicativo do Azure repositório
    azure-django-postgres-addon-aca Django Complemento PostgreSQL dos Aplicativos de Contêiner do Azure Aplicativos de Contêiner do Azure repositório

O repositório GitHub (última coluna) só é fornecido para fins de referência. Você só deve clonar o repositório diretamente se quiser contribuir com alterações no modelo. Caso contrário, siga as instruções neste início rápido para usar a azd CLI para interagir com o modelo em um fluxo de trabalho normal.

Executar o modelo

A execução de um azd modelo é a mesma entre linguagens e estruturas. E 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 e 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 e grupos de recursos do Azure. Para obter melhores resultados, use um nome curto, letras minúsculas e sem caracteres especiais.

  3. Para autenticar azd em sua conta do 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 faça logon em sua conta do 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 necessários do Azure, insira os seguintes comandos em seu terminal e responda a todos os prompts:

    azd up

    Importante

    Depois de azd up concluído com êxito, o aplicativo Web de exemplo estará disponível na Internet pública e sua Assinatura do 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 a 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 do 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

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

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

    Captura de tela da saída bem-sucedida da interface de linha de comando do azd com uma legenda em torno do URL do ponto de extremidade para exibir o aplicativo Relecloud em funcionamento 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 no Azure.

  7. Abra uma nova guia no navegador da Web, copie a segunda URL da etapa anterior e cole-a na barra de localização. O portal do Azure exibe todos os serviços em seu novo grupo de recursos que foram implantados para hospedar o projeto de aplicativo Web de exemplo.

Editar e reimplantar

A próxima etapa é fazer uma pequena alteração no aplicativo Web e reimplantar.

  1. Abra o Visual Studio Code e abra a pasta azdtest criada anteriormente.

  2. Esse modelo é configurado para usar opcionalmente Contêineres de Desenvolvimento. Quando você vir a notificação de Contêiner de Desenvolvimento 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é a pasta src/templates 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 a alteração, no terminal, execute o seguinte comando:

    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 azd comandos.

  5. Depois que o comando for concluído, atualize o navegador da Web para ver a atualização. Dependendo da plataforma de hospedagem da Web que está sendo usada, 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 azd down comando exclui os recursos do Azure e o fluxo de trabalho do 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 possam ter sido criados. Como alternativa, você pode excluir o grupo de recursos que foi criado no portal do Azure.
  • Exclua a pasta azdtest em seu computador local.
  • No portal do Azure, pesquise Cofres de Chaves. Selecione a opção Gerenciar cofres excluídos, escolha sua assinatura, selecione todos os cofres de chaves que contêm o nome azdtest ou o nome que você deu ao seu ambiente, e selecione Purgar.
  • Tente novamente as etapas neste guia de início rápido. Desta vez, quando solicitado, escolha um nome mais simples para seu ambiente. Tente um nome curto, letras minúsculas, sem números, sem letras maiúsculas, sem caracteres especiais.
  • Ao tentar novamente as etapas de início rápido, escolha um local diferente.

Consulte as perguntas frequentes para obter uma lista mais abrangente de possíveis problemas e soluções.

Conteúdo relacionado