Compartilhar via

Guia de Início Rápido: Criar e implantar um aplicativo web Python do GitHub Codespaces para o Azure usando um modelo da CLI do Desenvolvedor do Azure

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 Azure Developer CLI (azd) com base na estrutura da Web Python, plataforma de banco de dados do Azure e plataforma de hospedagem da Web do Azure na qual você deseja criar.
  • Crie um novo GitHub Codespace contendo o código gerado do modelo azd 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 azd que cria um aplicativo web e um banco de dados de exemplo, cria e configura os recursos necessários do Azure, e depois implanta o aplicativo web de exemplo no Azure.
  • Edite o aplicativo Web em um GitHub Codespace e use um comando azd para reimplantar.
  • Use um comando azd para limpar Azure recursos.
  • Feche e reabra 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 os modelos de azd desenvolvimento de aplicativos web em Python, consulte:

Pré-requisitos

Importante

Tanto GitHub codespaces quanto Azure são serviços pagos baseados em assinatura. Depois de algumas cotas gratuitas, você pode ser cobrado pelo uso desses serviços. Seguir este guia de início rápido pode afetar essas alocações ou a cobrança. Quando possível, os azd modelos usam a camada de opções mais barata, mas algumas podem não ser gratuitas. Use a calculadora de preços Azure para entender melhor os custos. Para mais informações, consulte preços do GitHub Codespaces.

Escolher um modelo e criar um codespace

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

    Modelo Estrutura Web Base de dados Plataforma de hospedagem Novo espaço de códigos
    azure-django-postgres-flexible-aca Django Servidor Flexível do PostgreSQL Azure Container Apps New Codespace
    azure-django-postgres-flexible-appservice Django Servidor Flexível do PostgreSQL Azure App Service New Codespace
    azure-django-cosmos-postgres-aca Django Cosmos DB (Adaptador PostgreSQL) Azure Container Apps New Codespace
    azure-django-cosmos-postgres-appservice Django Cosmos DB (Adaptador PostgreSQL) Azure App Service New Codespace
    azure-django-postgres-addon-aca Django Complemento para Apps de Container do Azure PostgreSQL Azure Container Apps New Codespace

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

    Durante esse processo, você pode ser solicitado a entrar em sua conta GitHub. Você também é solicitado a confirmar se deseja criar o Codespace. Selecione o botão Criar Codespace para ver a página Configurando seu codespace .

  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 na visão Explorer.

Autenticar para Azure e implantar o modelo azd

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

  1. No Visual Studio Code baseado na Web, o terminal é aberto por padrão. Se não for o caso, use a tecla til ~ para abrir o terminal. Por padrão, o terminal é um terminal bash. Se não estiver, altere para bash na área superior direita da janela do terminal.

  2. No terminal bash, insira o seguinte comando:

    azd auth login

    azd auth login começa a autenticar o Codespace na sua conta 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
    • Selecionar inserir para abrir uma nova guia do navegador e colar o código na caixa de texto
    • Escolhendo sua conta de Azure em uma lista
    • Confirmando que você está tentando entrar no Microsoft Azure CLI

  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 para Azure inserindo o seguinte comando:

    azd up

    Durante esse processo, você será solicitado a:

    • Insira um novo nome do ambiente
    • Selecione uma assinatura Azure para usar [Usar setas para mover, digitar para filtrar]
    • Selecione um Azure local a ser usado: [Usar setas para mover, digitar para filtrar]

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

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

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

  6. Quando azd up é concluído, uma 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 iniciando. Aguarde de 5 a 10 minutos para ver se o problema se resolve antes da solução de problemas.

    1. 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

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

  1. Volte para a aba do navegador que contém o Visual Studio Code. Use o modo de exibição explorer do Visual Studio Code para acessar a pasta src/templates. Abra 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 conforme 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 aba do navegador com o site do ReleCloud 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

Limpe os recursos que o modelo criou executando o comando azd down .

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.

Opcional: localizar seu codespace

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 trabalhando no código, publique o código em um novo repositório.

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

  2. Abra o seu navegador da Web, abra uma nova guia e vá 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 "Propriedade do Azure-Samples".

  4. Selecione os três pontinhos à direita deste Codespace para visualizar um menu de contexto. A partir daqui, você pode renomear o codespace, publicar em um novo repositório, alterar o tipo de computador, parar o codespace e muito mais.

Opcional: publicar um repositório GitHub de codespaces

Neste ponto, você tem um Codespace, que é um contêiner hospedado por GitHub executando seu ambiente de desenvolvimento Visual Studio Code com seu novo código gerado de um modelo azd. No entanto, o código não é armazenado em um repositório GitHub. Se você planeja continuar trabalhando no código, priorize armazená-lo em um repositório.

  1. No menu de contexto do codespace, 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 é criado e o código gerado anteriormente neste Início Rápido é enviado por push para o novo repositório. Selecione o botão Ver repositório para ir para o novo repositório.
  4. Para reabrir e continuar editando o código, selecione o menu suspenso verde "<> Código", mude para a guia Codespaces e selecione o nome do Codespace em que você estava trabalhando anteriormente. Você retorna ao seu codespace Visual Studio Code ambiente de desenvolvimento.
  5. Use o painel Controle de Origem para criar novas ramificações e preparar e confirmar novas alterações no código.

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