Criar um aplicativo Python 3 no ambiente padrão do App Engine

Guia de início rápido: criar um aplicativo Python 3 no ambiente padrão do App Engine

Criar um aplicativo Python 3 no ambiente padrão do App Engine

ID da região

O REGION_ID é um código abreviado que o Google atribui com base na região que você selecionou ao criar o aplicativo. O código não corresponde a um país ou estado, ainda que alguns IDs de região sejam semelhantes aos códigos de país e estado geralmente usados. Para apps criados após fevereiro de 2020, o REGION_ID.r está incluído nos URLs do App Engine. Para apps existentes criados antes dessa data, o ID da região é opcional no URL.

Saiba mais sobre IDs de região.

OK

Python 2.7/3 |Java 8/11/17 |PHP 5/7+ |Ruby |Go 1.11 / 1.12+ |Node.js

Neste guia de início rápido, você aprende como implantar um aplicativo de amostra no App Engine. Se você quiser saber mais sobre como codificar um aplicativo para o App Engine, consulte Como criar um app.

O App Engine é a opção de computação certa para você? Veja outras opções para hospedar seu aplicativo no Google Cloud.

Custos

Não há custos associados à execução deste guia. A execução deste aplicativo de amostra não excede sua cota gratuita.

Antes de começar

1. Faça login na sua conta do Google Cloud. Se você começou a usar o Google Cloud agora, crie uma conta para avaliar o desempenho de nossos produtos em situações reais. Clientes novos também recebem US$ 300 em créditos para executar, testar e implantar cargas de trabalho.

2. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

3. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

4. Ative a Cloud Build API.

   Ative a API

5. Instale a CLI do Google Cloud.

6. Para inicializar a CLI gcloud, execute o seguinte comando:

   gcloud init

7. No console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.

   Observação: se você não pretende manter os recursos criados neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover todos os recursos associados a ele.

   Acessar o seletor de projetos

8. Verifique se a cobrança está ativada para o seu projeto do Google Cloud.

9. Ative a Cloud Build API.

   Ative a API

10. Instale a CLI do Google Cloud.

11. Para inicializar a CLI gcloud, execute o seguinte comando:

    gcloud init

Pré-requisitos adicionais

1. Inicialize seu aplicativo do App Engine com o projeto e escolha a região:

   gcloud app create --project=[YOUR_PROJECT_ID]
   

   Quando solicitado, selecione a região em que você quer localizar o aplicativo do App Engine.

   Cuidado: não é possível alterar a região de um aplicativo depois de defini-la.

2. Instale os pré-requisitos a seguir:

   • Fazer o download e instalar o Git.

• Execute o seguinte comando para instalar o componente do gcloud que inclui a extensão do App Engine para Python 3:

  gcloud components install app-engine-python
  

3. Prepare o ambiente para o desenvolvimento do Python. É recomendável ter a versão mais recente do Python, pip e outras ferramentas relacionadas instaladas em seu sistema. Para mais instruções, consulte o Guia de configuração do ambiente de desenvolvimento do Python.

Locais do App Engine

O App Engine é regional. Isso significa que a infraestrutura que executa os aplicativos está em uma determinada região que é gerenciada pelo Google para estar disponível de modo redundante em todas as zonas dessa região.

Atender aos requisitos de latência, disponibilidade ou durabilidade são os principais fatores para selecionar a região de execução dos aplicativos. Geralmente, é possível selecionar a região mais próxima dos usuários do aplicativo, mas considere os locais em que o App Engine está disponível, bem como os locais dos outros produtos e serviços do Google Cloud usados pelo app. O uso de serviços em vários locais pode afetar a latência e o preço do aplicativo.

Não é possível alterar a região de um aplicativo depois de defini-la.

Observação: dois locais, chamados europe-west e us-central nos comandos do App Engine e no console do Google Cloud, são chamados europe-west1 e us-central1, respectivamente, em todos os outros lugares da documentação do Google.

Se você já criou um aplicativo do App Engine, será possível ver a região dele com um dos seguintes procedimentos:

• Execute o comando gcloud app describe.‏

• Abra o Painel do App Engine no console do Google Cloud. A região aparece perto do topo da página.

OK

Neste guia de início rápido, você verá a demonstração de um app simples em Python, gravado com o framework da Web Flask que pode ser implantado no App Engine. O Flask é usado nesta amostra, mas é possível usar qualquer framework da Web que atenda aos requisitos mencionados acima. Outros exemplos de framework são Django, Pyramid, Bottle e web.py (links em inglês).

Download do app Hello World

Criamos um app Hello World simples para Python 3. Assim, é possível ter uma ideia de como implantar um app no Google Cloud.

1. Clone o repositório do app de amostra Hello World na máquina local.

   git clone https://github.com/GoogleCloudPlatform/python-docs-samples
   

   Outra opção é fazer o download da amostra (em inglês) como um arquivo ZIP e extraí-lo.

2. Acesse o diretório que contém o código de amostra.

   cd python-docs-samples/appengine/standard_python3/hello_world
   

Como executar o Hello World na máquina local

Para executar o app Hello World no seu computador:

Mac OS/Linux

1. Crie um ambiente Python isolado:

   python3 -m venv env
   source env/bin/activate

2. Se você não estiver no diretório que contém o código de amostra, navegue até o diretório que contém o código de amostra hello_world. Em seguida, instale as dependências:

   cd YOUR_SAMPLE_CODE_DIR
   pip install -r requirements.txt

3. Execute o aplicativo:

   python main.py

4. No navegador da Web, digite este endereço:

   http://localhost:8080

   Observação: se estiver usando o Cloud Shell, na barra de ferramentas, clique em Visualização da Web e selecione Visualização na porta 8080 em vez disso.

Windows

Use o PowerShell para executar os pacotes Python.

1. Localize a instalação do PowerShell.
2. Clique com o botão direito do mouse no atalho do PowerShell e inicie-o como administrador.
3. Crie um ambiente Python isolado.

   python -m venv env
   .\env\Scripts\activate

4. Acesse o diretório do projeto e instale as dependências: Se você não estiver no diretório que contém o código de amostra, navegue até o diretório que contém o código de amostra hello_world. Em seguida, instale as dependências:

   cd YOUR_SAMPLE_CODE_DIR
   pip install -r requirements.txt

5. Execute o aplicativo:

   python main.py

6. No navegador da Web, digite este endereço:

   http://localhost:8080

A mensagem Hello World do app de amostra é exibida na página. Na janela do terminal, pressione Ctrl+C para sair do servidor da Web.

Implantar e executar o Hello World no App Engine

Para implantar o aplicativo no ambiente padrão do App Engine, siga estas etapas:

1. Implemente o aplicativo Hello World executando o comando a seguir no diretório standard_python3/hello_world:

   gcloud app deploy

   Saiba mais sobre sinalizações opcionais.

   Sinalizações comuns do comando gcloud

   • Inclua a sinalização --version para especificar um ID exclusivo da versão do seu aplicativo. Quando a sinalização não é incluída, o ID é gerado automaticamente. Exemplo: --version [YOUR_VERSION_ID]
   • Inclua a sinalização --project para especificar um ID de projeto alternativo do Cloud para o que você inicializou como padrão na ferramenta gcloud. Exemplo: --project [YOUR_PROJECT_ID]

   Exemplo:

   gcloud app deploy --version pre-prod-5 --project my-sample-app

   Para aprender a implantar o app pela linha de comando, consulte Como testar e implantar o app. Para uma lista de todas as sinalizações de comando, consulte a referência do gcloud app deploy.

   OK

2. Inicie o navegador para visualizar o aplicativo em https://PROJECT_ID.REGION_ID.r.appspot.com

   gcloud app browse

   em que PROJECT_ID representa o ID do projeto do Google Cloud.

Nesse momento, a página que exibe a mensagem "Hello World" é enviada por um servidor da Web executado em uma instância do App Engine.

Parabéns! Você implantou seu primeiro app do Python 3 no ambiente padrão do App Engine.

Veja as seções a seguir para informações sobre limpeza e links das próximas etapas.

Limpar

Exclua o projeto do Google Cloud para não ser cobrado pelos recursos usados nele.

Cuidado: excluir um projeto tem os seguintes efeitos:
• Tudo no projeto é excluído. Se você tiver usado um projeto existente para as tarefas neste documento, a exclusão dele incluirá a exclusão de quaisquer outros trabalhos feitos no projeto.
• Os IDs do projeto personalizados são perdidos. Ao criar o projeto, você pode ter criado um código do projeto personalizado para ser usado no futuro. Para preservar os URLs que usam o ID do projeto, como um URL appspot.com, exclua recursos específicos do projeto, em vez de excluir o projeto inteiro.
1. No Console do Google Cloud, acesse a página Gerenciar recursos.

   Acessar "Gerenciar recursos"

2. Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir .
3. Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluí-lo.

A seguir

Conheça a plataforma inteira

Agora que você sabe como é desenvolver e implantar aplicativos do App Engine, explore o restante do Google Cloud. Você já tem a Google Cloud CLI instalada, o que oferece as ferramentas para interagir com produtos como Cloud SQL, Cloud Storage, Firestore e muitos outros.

Saiba mais sobre o ambiente padrão do App Engine

Listamos alguns tópicos para você continuar aprendendo sobre o App Engine:

• Uma visão geral do App Engine
• Roteamento de solicitações
• Processamento de solicitações
• Como gerenciar instâncias