Partilhar via

Início Rápido: Crie e implemente uma aplicação web em Python a partir do GitHub Codespaces para o Azure usando um modelo de CLI do Azure Developer

Este início rápido orienta-o pela forma mais fácil e rápida de criar e implementar uma solução web e de base de dados em Python para o Azure. Ao seguir as instruções deste início rápido, você:

  • Escolha um modelo Azure Developer CLI (azd) baseado no framework web Python, Azure plataforma de base de dados e Azure plataforma de alojamento web onde pretende construir.
  • Crie um novo GitHub Codespace contendo código gerado a partir do modelo azd que selecionou.
  • Use o GitHub Codespaces e o terminal bash do Visual Studio Code online. O terminal permite-lhe usar Azure comandos Developer CLI para executar um modelo azd para criar uma aplicação web de exemplo e base de dados, criar e configurar os recursos de Azure necessários, e depois implementar a aplicação web de exemplo para Azure.
  • Edita a aplicação web num Codespace GitHub e usa um comando azd para redistribuir.
  • Usa um comando azd para limpar Azure recursos.
  • Fecha e reabre o teu Codespace do GitHub.
  • Publique o seu novo código num 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 estes modelos azd para desenvolvimento de aplicações web Python, veja:

Pré-requisitos

Importante

Tanto o GitHub Codespaces como o Azure são serviços pagos por subscrição. Após alguns lotes gratuitos, pode ser cobrado por utilizar estes serviços. Seguir esse início rápido pode afetar essas alocações ou faturamento. Quando possível, os azd modelos usam as opções mais baratas, mas algumas podem não ser gratuitas. Use a calculadora de preços Azure para compreender melhor os custos. Para mais informações, consulte GitHub Codespaces pricing para mais detalhes.

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

Escolha um modelo azd baseado na framework web em Python, na plataforma de alojamento na web Azure e na plataforma de base de dados Azure na qual pretende basear-se.

  1. Da lista seguinte de modelos, escolha um que utilize as tecnologias que pretende utilizar na sua nova aplicação web.

    Modelo Estrutura Web Base de dados Plataforma de Alojamento Novo Codespace
    azure-django-postgres-flexible-aca Django Servidor Flexível PostgreSQL Azure Container Apps Novo Codespace
    azure-django-postgres-flexible-appservice Django Servidor Flexível PostgreSQL Azure App Service Novo Codespace
    azure-django-cosmos-postgres-aca Django Cosmos DB (Adaptador PostgreSQL) Azure Container Apps Novo Codespace
    azure-django-cosmos-postgres-appservice Django Cosmos DB (Adaptador PostgreSQL) Azure App Service Novo Codespace
    azure-django-postgres-addon-aca Django Azure Container Apps PostgreSQL Add-on Azure Container Apps 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 modelo azd na sua conta GitHub. Clique com o botão direito no link Novo Codespace ao lado do nome do modelo que selecionou e selecione Abrir num novo separador para iniciar o processo de configuração.

    Durante este processo, pode ser solicitado a iniciar sessão na sua conta GitHub. Também te pedem para confirmares que queres criar o Codespace. Selecione o botão Criar espaço de código para ver a página Configurar o seu espaço de código .

  2. Após alguns minutos, uma versão baseada na web do Visual Studio Code carrega num novo separador do navegador, com o modelo de aplicação web em Python carregado como um espaço de trabalho na visualização do Explorador.

Autenticar no Azure e implementar o modelo azd

Agora que tens um Codespace GitHub contendo o código recém-gerado, usa a utilidade azd dentro do Codespace para publicar o código no Azure.

  1. No Visual Studio Code baseado na web, o terminal está aberto por padrão. Se não estiver, use a tecla til ~ para abrir o terminal. Por defeito, o terminal é 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 começa a autenticar o teu Codespace na tua 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:

    • Copiar um código gerado
    • Selecionar enter para abrir um novo separador do navegador e colar o código na caixa de texto
    • Escolher a sua conta Azure a partir de uma lista
    • Confirmando que está a tentar iniciar sessão na Microsoft Azure CLI

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

    Device code authentication completed.
Logged in to Azure.

  5. Implemente a sua nova aplicação no Azure introduzindo o seguinte comando:

    azd up

    Durante este processo, é-lhe pedido:

    • Insira um novo nome de ambiente
    • Selecione uma subscrição do Azure para usar [Use setas para mover, digite para filtrar]
    • Selecione um local Azure para usar: [Use 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 o azd up estiver concluído com sucesso, a aplicação web de exemplo está disponível na internet pública e a sua subscrição de Azure começa a acumular encargos por 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. Quando terminar de trabalhar com a aplicação web de exemplo, use azd down para remover todos os serviços que azd up criou.

    Siga as instruções quando solicitado a escolher a Subscrição do Azure que pretende utilizar para o pagamento e depois selecione uma localização do Azure a usar. Escolha uma região que esteja perto de si geograficamente.

    Executar azd up pode demorar vários minutos, pois está a provisionar e implementar múltiplos serviços 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 vires um ecrã padrão ou um ecrã de erro, a aplicação pode estar a arrancar. Espere 5-10 minutos para ver se o problema se resolve antes de fazer a resolução de problemas.

    1. Ctrl + clique no primeiro URL após a palavra - Endpoint: para ver o projeto de aplicação web de exemplo a correr em Azure.

  7. Ctrl + clique na segunda URL do passo anterior para visualizar os recursos provisionados no portal Azure.

Editar e reimplantar

De seguida, faz uma pequena alteração na aplicação web e depois volta a implementá-la.

  1. Volte ao separador do navegador que contém o Visual Studio Code. Usa a vista do Explorador da Visual Studio Code para ir à pasta src/templates. Abra o ficheiro index.html. Encontre a seguinte linha de código:

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

    Alterar 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 terminar, recarregue o separador do navegador com o site do ReleCloud para visualizar a atualização. Dependendo da plataforma de alojamento web que está a usar, pode demorar vários minutos até que as 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

Limpa os recursos que o modelo criou ao executar o comando azd down .

azd down

O comando azd down elimina 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: Encontre seu espaço de código

Esta seção demonstra como o seu código está a correr temporariamente e é preservado a curto prazo num Codespace. Se planeia continuar a trabalhar no código, publique o código num 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 seu browser; abra um novo separador e aceda a https://github.com/codespaces.

  3. Perto da parte inferior, vê uma lista de Codespaces recentes. Procure o que criou numa secção intitulada "Pertencente a 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 dos Codespaces

Neste ponto, tens um Codespace, que é um container hospedado pelo GitHub a executar o teu ambiente de desenvolvimento Visual Studio Code com o teu novo código gerado a partir de um modelo azd. No entanto, o código não está armazenado num repositório do GitHub. Se planeias continuar a trabalhar no código, prioriza guardá-lo num repositório.

  1. No menu de contexto do espaço de código, selecione Publicar num novo repositório.
  2. No diálogo Publicar num novo repositório , renomeie o seu novo repositório e escolha se quer que seja um repositório público ou privado. Selecione Criar repositório.
  3. Após alguns momentos, o repositório é criado e o código que gerou anteriormente neste Quickstart é enviado para o novo repositório. Selecione o botão Ver repositório para ir ao novo repositório.
  4. Para reabrir e continuar a editar código, selecione o menu suspenso verde "<> Code", mude para o separador Codespaces e selecione o nome do Codespace em que estava a trabalhar anteriormente. Regressa ao seu ambiente de desenvolvimento Codespaces no 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 vir erros durante azd up, experimente os seguintes passos:

  • Execute azd down para remover quaisquer recursos que o comando tenha criado. Alternativamente, pode eliminar o grupo de recursos que criou no portal do Azure.
  • Dirija-se à página de Codespaces da sua conta GitHub, encontre o Codespace criado durante este Quickstart, selecione os três pontos à direita e escolha Eliminar no menu contextual.
  • No portal do Azure, pesquise por Cofres de Chaves. Seleciona Gerir cofres apagados, escolhe a tua subscrição, seleciona todos os cofres-chave que contenham o nome azdtest ou o nome que chamaste ao teu ambiente, e seleciona Purgar.
  • Repita os passos deste início rápido. Desta vez, quando solicitado, escolha um nome mais simples para o seu ambiente. Experimenta 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 uma lista mais abrangente de possíveis problemas e soluções, consulte as Perguntas Frequentes.

Conteúdo relacionado

  • Last updated on