Compartilhar via

Guia de início rápido: criar e implantar um aplicativo Web Python do GitHub Codespaces para o Azure usando um modelo de CLI do desenvolvedor do Azure

  • 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 modelo de CLI (azd) do Desenvolvedor do Azure com base na estrutura da 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.
  • Crie um novo espaço de código do GitHub contendo o código gerado a partir do azd modelo selecionado.
  • Use o GitHub Codespaces e o terminal bash do Visual Studio Code online. O terminal permite que você use os comandos da CLI do Desenvolvedor do Azure para executar um modelo para criar um aplicativo Web e um azd banco de dados de exemplo, 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 um Codespace do GitHub e use um azd comando para reimplantar.
  • Use um azd comando para limpar recursos do Azure.
  • Feche e reabra o espaço de código do GitHub.
  • Publique seu novo código em um repositório do GitHub.

Deve levar menos de 25 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

Importante

O GitHub Codespaces e o Azure são serviços baseados em assinatura paga. Após algumas alocações gratuitas, você pode ser cobrado pelo uso desses serviços. Seguir esse início rápido pode afetar essas alocações ou cobrança. Quando possível, os azd modelos foram criados usando a camada mais barata de opções, mas algumas podem não ser gratuitas. Use a calculadora de preços do Azure para entender melhor os custos. Para obter mais informações, consulte Preços do GitHub Codespaces para obter mais detalhes.

Escolha um modelo e crie um espaço de código

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. Na lista de modelos a seguir, escolha um que use as tecnologias que você deseja usar em seu novo aplicativo Web.

    Modelo Estrutura Web Backup de banco de dados Plataforma de Hospedagem Novo espaço de código
    azure-django-postgres-flexible-aca Django Servidor flexível PostgreSQL Aplicativos de Contêiner do Azure Novo espaço de código
    azure-django-postgres-flexible-appservice Django Servidor flexível PostgreSQL Serviço de Aplicativo do Azure Novo espaço de código
    azure-django-cosmos-postgres-aca Django Cosmos DB (Adaptador PostgreSQL) Aplicativos de Contêiner do Azure Novo espaço de código
    azure-django-cosmos-postgres-appservice Django Cosmos DB (Adaptador PostgreSQL) Serviço de Aplicativo do Azure Novo espaço de código
    azure-django-postgres-addon-aca Django Complemento PostgreSQL de Aplicativos de Contêiner do Azure Aplicativos de Contêiner do Azure Novo espaço de código

  1. Para sua conveniência, a última coluna de cada tabela contém um link que cria um novo Codespace e inicializa o modelo em sua conta do azd GitHub. Clique com o botão direito do mouse e selecione "Abrir em nova guia" no link "Novo Codespace" ao lado do nome do modelo selecionado para iniciar o processo de configuração.

    Durante esse processo, você pode ser solicitado a fazer login em sua conta do GitHub e você será solicitado a confirmar que deseja criar o Codespace. Selecione o botão "Criar Codespace" para ver a página "Configurando seu espaço de código".

  2. Após alguns minutos, uma versão baseada na Web do Visual Studio Code é carregada em uma nova guia do navegador com o modelo da Web Python carregado como um espaço de trabalho no modo de exibição Explorer.

Autenticar no Azure e implantar o modelo azd

Agora que você tem um GitHub Codespace contendo o código recém-gerado, use o utilitário de dentro do Codespace para publicar o azd código no Azure.

  1. No Visual Studio Code baseado na Web, o terminal deve ser aberto por padrão. Se não estiver, use a tecla til ~ para abrir o terminal. Além disso, por padrão, o terminal deve ser um terminal bash. Se não estiver, mude para bash na área superior direita da janela do terminal.

  2. No terminal bash, digite o seguinte comando:

    azd auth login

    azd auth login inicia o processo de autenticação do Codespace na sua conta do Azure.

    Start by copying the next code: XXXXXXXXX
Then press enter and continue to log in from your browser...

Waiting for you to complete authentication in the browser...

  3. Siga as instruções, que incluem:

    • Copiando um código gerado
    • Selecionando enter para abrir uma nova guia do navegador e colando o código na caixa de texto
    • Escolhendo sua conta do Azure em uma lista
    • Confirmando que você está tentando entrar na CLI do Microsoft Azure

  4. Quando bem-sucedida, a seguinte mensagem é exibida de volta na guia Codespaces no terminal:

    Device code authentication completed.
Logged in to Azure.

  5. Implante seu novo aplicativo no Azure inserindo o seguinte comando:

    azd up

    Durante esse processo, você será solicitado a:

    • Insira um novo nome do ambiente
    • Selecione uma Assinatura do Azure para usar [Usar setas para mover, digite para filtrar]
    • Selecione um local do Azure para usar: [Usar setas para mover, digite para filtrar]

    Depois de responder a essas perguntas, a saída de azd indica que a implantação está progredindo.

    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. Depois de terminar de trabalhar com o aplicativo Web de exemplo, use azd down para remover todos os serviços criados pelo azd up.

    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, consulte a seção Solução de problemas na parte inferior deste documento.

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

    (✓) Done: Deploying service web
- Endpoint: https://xxxxx-xxxxxxxxxxxxx-ca.example-xxxxxxxx.westus.azurecontainerapps.io/

SUCCESS: Your application was provisioned and deployed to Azure in 11 minutes 44 seconds.
You can view the resources created under the resource group xxxxx-rg in Azure Portal:
https://portal.azure.com/#@/resource/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/xxxxx-rg/overview

    Se você vir uma tela padrão ou uma tela de erro, o aplicativo pode estar sendo iniciado. Aguarde de 5 a 10 minutos para ver se o problema se resolve antes de solucioná-lo.

    Ctrl + clique na primeira URL após a palavra - Endpoint: para ver o projeto de aplicativo Web de exemplo em execução ao vivo no Azure.

  7. Ctrl + clique na segunda URL da etapa anterior para exibir os recursos provisionados no portal do Azure.

Editar e reimplantar

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

  1. Retorne à guia do navegador que contém o Visual Studio Code e use o modo de exibição Explorer do Visual Studio Code para navegar até a pasta src/templates e abrir o arquivo de .html índice. Localize a seguinte linha de código:

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

    Altere o texto dentro do H1:

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

    Seu código é salvo enquanto você digita.

  2. Para reimplantar o aplicativo com sua alteração, execute o seguinte comando no terminal:

    azd deploy

  3. Quando o comando for concluído, atualize a guia do navegador com o site do ReleCloud 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

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

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.

Opcional: Encontre seu espaço de código

Esta seção demonstra como seu código está (temporariamente) em execução e persistiu a curto prazo em um Codespace. Se você planeja continuar a trabalhar no código, você deve publicar o código em um novo repositório.

  1. Feche todas as guias relacionadas a este artigo de início rápido ou desligue totalmente o navegador da Web.

  2. Abra o navegador da Web e uma nova guia e navegue para: https://github.com/codespaces

  3. Perto da parte inferior, você verá uma lista de Codespaces recentes. Procure o que você criou em uma seção intitulada "Owned by Azure-Samples".

  4. Selecione as reticências à direita deste Codespace para exibir um menu de contexto. A partir daqui, você pode renomear o espaço de código, publicar em um novo repositório, alterar o tipo de máquina, parar o espaço de código e muito mais.

Opcional: Publicar um repositório GitHub a partir de Codespaces

Neste ponto, você tem um Codespace, que é um contêiner hospedado pelo GitHub executando seu ambiente de desenvolvimento do Visual Studio Code com seu novo código gerado a partir de um azd modelo. No entanto, o código não é armazenado em um repositório do GitHub. Se você planeja continuar a trabalhar no código, você deve fazer disso uma prioridade.

  1. No menu de contexto do espaço de código, selecione "Publicar em um novo repositório".
  2. Na caixa de diálogo "Publicar em um novo repositório", renomeie seu novo repositório e escolha se deseja que ele seja um repositório público ou privado. Selecione "Criar repositório".
  3. Após alguns instantes, o repositório será criado e o código gerado anteriormente neste Guia de início rápido será enviado por push para o novo repositório. Selecione o botão "Ver repositório" para navegar até o novo repositório.
  4. Para reabrir e continuar editando o código, selecione o menu suspenso verde "<> Código", alterne para a guia Codespaces e selecione o nome do Codespace no qual você estava trabalhando anteriormente. Agora você deve ser retornado ao seu ambiente de desenvolvimento Codespace Visual Studio Code.
  5. Use o painel Controle do código-fonte para criar novas ramificações e preparar e confirmar novas alterações em seu código.

Solução de problemas

Se você vir erros durante azd upo , tente o seguinte:

  • 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.
  • Vá para a página Codespaces da sua conta do GitHub, localize o Codespace criado durante este Guia de início rápido, selecione as reticências à direita e escolha "Excluir" no menu de contexto.
  • 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