Partilhar 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 Azure Developer

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 Web e banco de dados Python no Azure. Seguindo as instruções neste guia de início rápido, você irá:

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

Pré-requisitos

Importante

Tanto o GitHub Codespaces quanto o Azure são serviços pagos baseados em assinatura. Depois de algumas atribuições gratuitas, você pode ser cobrado pelo uso desses serviços. Seguir esse início rápido pode afetar essas alocações ou faturamento. Quando possível, os azd modelos foram criados usando o nível mais barato de opções, mas alguns podem não ser gratuitos. 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 baseado na estrutura Web Python, na plataforma de hospedagem 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 Base de dados Plataforma de Alojamento Novo Codespace
    azure-django-postgres-flexible-aca Django Servidor Flexível PostgreSQL Aplicações de Contentores do Azure Novo Codespace
    azure-django-postgres-flexible-appservice Django Servidor Flexível PostgreSQL Serviço de Aplicações do Azure Novo Codespace
    azure-django-cosmos-postgres-aca Django Cosmos DB (Adaptador PostgreSQL) Aplicações de Contentores do Azure Novo Codespace
    azure-django-cosmos-postgres-appservice Django Cosmos DB (Adaptador PostgreSQL) Serviço de Aplicações do Azure Novo Codespace
    azure-django-postgres-addon-aca Django Azure Container Apps PostgreSQL Add-on Aplicações de Contentores do Azure Novo Codespace

  1. Para sua conveniência, a última coluna de cada tabela contém um link que cria um novo Codespace e inicializa o azd modelo em sua conta do 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 que você selecionou 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 espaço de código" para ver a página "Configurando seu espaço de código".

  2. Após alguns minutos, uma versão web do Visual Studio Code é carregada numa nova aba do navegador com o modelo web Python carregado como um espaço de trabalho na vista do Explorador.

Autenticar no Azure e implantar o modelo azd

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

  1. No Visual Studio Code baseado na Web, o terminal deve estar 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, altere 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:

    • Copiar um código gerado
    • Selecionar enter para abrir uma nova guia do navegador e colar o código na caixa de texto
    • Escolher a sua conta do Azure a partir de uma lista
    • Confirmando que você está tentando entrar na CLI do Microsoft Azure

  4. Quando bem-sucedida, a seguinte mensagem é exibida novamente 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 este processo, é-lhe pedido:

    • Insira um novo nome de 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

    Assim que azd up for concluído com êxito, a aplicação Web de exemplo estará disponível na Internet pública e a sua subscrição Azure começará a acumular encargos para todos os recursos criados. Os criadores dos azd modelos escolheram intencionalmente níveis baratos, mas não necessariamente gratuitos, uma vez que os níveis gratuitos 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 ao ser solicitado a escolher a assinatura do Azure para processar pagamentos e, em seguida, selecione uma localização do Azure a utilizar. Escolha uma região que esteja perto de si geograficamente.

    A execução azd up pode levar vários minutos, já que está provisionando e implantando vários serviços do Azure. À medida que o progresso é exibido, observe se há erros. Se vir erros, consulte a secção Resolução de problemas na parte inferior deste documento.

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

    (✓) 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 vir um ecrã predefinido ou um ecrã de erro, a aplicação poderá estar a ser iniciada. Aguarde de 5 a 10 minutos para ver se o problema se resolve antes de solucionar o problema.

    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 index.html . 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 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?

Limpeza de recursos

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

azd down

O comando azd down 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 secção demonstra como o seu código está (temporariamente) a ser executado e armazenado a curto prazo num 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, abra uma nova guia e navegue para: https://github.com/codespaces

  3. Na parte inferior, você verá uma lista de Codespaces recentes. Procure o que você criou em uma seção intitulada "De propriedade do Azure-Samples".

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

Opcional: publicar um repositório GitHub a partir do 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 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 momentos, 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 a lista suspensa 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 de código do Codespace Visual Studio.
  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 vir erros durante azd up, 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, encontre o Codespace criado durante este início rápido, selecione as reticências à direita e escolha "Apagar" no menu de contexto.
  • No portal do Azure, procure por Cofres de Chaves. Selecione Gerir cofres eliminados, escolha a sua subscrição, selecione todos os cofres de chaves que contenham o nome azdtest ou o nome que deu ao seu ambiente e selecione Limpar.
  • Repita as etapas no guia de início rápido novamente. Desta vez, quando solicitado, escolha um nome mais simples para o 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