Guia de início rápido: criar e implantar um aplicativo Web Python no Azure usando um modelo azd

  • Artigo

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

  • 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 se basear.
  • Use os comandos da CLI para executar um modelo para criar um aplicativo Web e um azd banco de dados de exemplo, crie e configure os recursos necessários do Azure e, em seguida, implante o aplicativo Web de exemplo no Azure.
  • Edite o aplicativo Web no computador local e use um azd comando para reimplantar.
  • Use um azd comando para limpar 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 no 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 se basear.

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

    Modelo Estrutura Web Backup de banco de dados Plataforma de Hospedagem Repositório GitHub
    azure-django-postgres-flexible-aca Django Servidor flexível PostgreSQL Aplicativos de Contêiner do Azure repositório
    azure-django-postgres-flexible-appservice Django Servidor flexível 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 de Aplicativos de Contêiner do Azure Aplicativos de Contêiner do Azure repositório

O repositório do GitHub (última coluna) é fornecido apenas 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 guia de 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 em todas as 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 no computador local onde você normalmente armazena seus repositórios git locais e, em seguida, crie uma nova pasta chamada azdtest. Em seguida, mude 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 quaisquer solicitações:

    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 for solicitado um nome de ambiente, use azdtest ou qualquer outro nome. O nome do ambiente é usado ao nomear grupos de recursos e recursos do Azure. Para obter melhores resultados, use um nome curto, letras minúsculas, 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 é exibida em uma página da Web: "Autenticação concluída. Você pode retornar ao aplicativo. Sinta-se à vontade para fechar esta 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 quaisquer prompts:

    azd up

    Importante

    Depois azd up de 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, uma vez que 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 para usar. Escolha uma região que esteja próxima de você geograficamente.

    A execução azd up pode levar vários minutos, já que é provisionar e implantar vários serviços do Azure. À medida que o progresso é exibido, observe se há 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 desde o início.
    • 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 criados pelo azd up.

  6. Quando azd up concluída com êxito, a seguinte saída é exibida:

    Screenshot of successful output from the azd command line interface with a callout around the endpoint URL to view the working Relecloud application deployed in 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 ao vivo 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, em seguida, reimplantar.

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

  2. Este modelo é configurado para usar opcionalmente Dev Containers. 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 abra o arquivo de .html índice. 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, 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. Quando 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 sejam 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 de Ações do GitHub. 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.

Solução de problemas

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

  • Execute azd down para remover quaisquer 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 no computador local.
  • No portal do Azure, procure Cofres de Chave. Selecione Gerenciar cofres excluídos, escolha sua assinatura, selecione todos os cofres de chaves que contenham o nome azdtest ou qualquer outro nome que você nomeie seu ambiente e selecione Limpar.
  • Repita as etapas neste início rápido novamente. 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