Guia de início rápido para o ambiente padrão do Python 2

Neste guia de início rápido, você aprenderá a criar um pequeno aplicativo do App Engine que exibe uma mensagem curta.

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

Antes de executar e implantar este guia de início rápido, instale o SDK do Cloud e, em seguida, configure um projeto do GCP para o App Engine:

  1. Faça o download e instale o SDK do Cloud:

    Fazer o download do SDK

    Observação: se o SDK do Cloud já estiver instalado, atualize-o executando o comando a seguir:

    gcloud components update
    
  2. Crie um novo projeto:

    gcloud projects create [YOUR_PROJECT_ID] --set-as-default
    

    Verifique se o projeto foi criado:

    gcloud projects describe [YOUR_PROJECT_ID]
    

    Você verá detalhes do projeto parecidos com o seguinte:

    createTime: year-month-hour
    lifecycleState: ACTIVE
    name: project-name
    parent:
    id: '433637338589'
    type: organization
    projectId: project-name-id
    projectNumber: 499227785679
    
  3. 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 o aplicativo do App Engine estará localizado.

  4. Instale os seguintes pré-requisitos:

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

      gcloud components install app-engine-python
      
  5. Prepare o ambiente para o desenvolvimento do Python. É recomendável ter a versão mais recente do Python, pip, virtualenv e outras ferramentas instaladas no 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, e isso significa que a infraestrutura que executa os aplicativos está localizada em uma região específica e é gerenciada pelo Google para ficar 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 seus aplicativos. Em geral, você escolhe a região mais próxima dos usuários do aplicativo. No entanto, pense também no local dos outros produtos e serviços do GCP utilizados pelo aplicativo. O uso de serviços em vários locais pode afetar a latência e o preço do seu aplicativo.

O App Engine está disponível nas regiões a seguir:

  • northamerica-northeast1 (Montreal)
  • us-central (Iowa)
  • us-west2 (Los Angeles)
  • us-east1 (Carolina do Sul)
  • us-east4 (Norte da Virgínia)
  • southamerica-east1 (São Paulo)
  • europe-west (Bélgica)
  • europe-west2 (Londres)
  • europe-west3 (Frankfurt)
  • europe-west6 (Zurique)
  • asia-northeast1 (Tóquio)
  • asia-northeast2 (Osaka)
  • asia-east2 (Hong Kong)
  • asia-south1 (Mumbai)
  • australia-southeast1 (Sydney)

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

Se você já tiver criado um aplicativo do App Engine, poderá visualizar a região executando o comando gcloud app describe ou abrindo o Painel do App Engine no Console do GCP. A região do aplicativo do App Engine está listada em http://[YOUR_PROJECT_ID].appspot.com.

Neste guia de início rápido, você verá a demonstração de um aplicativo 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 frameworks são Django, Pyramid, Bottle e web.py (todos em inglês).

Fazer o download do app Hello World

Criamos um aplicativo simples Hello World para Python. Dessa maneira, você pode ter rapidamente uma ideia de como implantar um aplicativo no Google Cloud Platform. Siga estas etapas para fazer o download do Hello World na máquina local.

  1. Clone o repositório do aplicativo de amostra Hello World para a máquina local:

    git clone https://github.com/GoogleCloudPlatform/python-docs-samples
    
  2. Acesse o diretório que contém o código de amostra:

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

Também é possível fazer o download da amostra como um arquivo zip e extraí-lo.

Testar o aplicativo

Teste o aplicativo com o servidor de desenvolvimento local dev_appserver.py, incluído no SDK.

  1. No diretório hello_world em que está o arquivo de configuração app.yaml do aplicativo, inicie o servidor de desenvolvimento local executando o seguinte comando:

    dev_appserver.py app.yaml
    

    O servidor de desenvolvimento local agora está sendo executado e recebendo as solicitações na porta 8080. Ocorreu algum erro?

    1. Visite http://localhost:8080/ no navegador da Web para visualizar o aplicativo.

Executar o servidor de desenvolvimento local (dev_appserver.py)

Para executar o servidor de desenvolvimento local, execute dev_appserver.py especificando o caminho completo do diretório ou adicione dev_appserver.py à variável de ambiente PATH:

  • Se você instalou o SDK original do App Engine, a ferramenta está localizada em:

    [PATH_TO_APP_ENGINE_SDK]/dev_appserver.py
    
  • Se você instalou o SDK do Google Cloud, a ferramenta está localizada em:

    [PATH_TO_CLOUD_SDK]/google-cloud-sdk/bin/dev_appserver.py
    

    Dica: para adicionar as ferramentas do SDK do Google Cloud à variável de ambiente PATH e ativar a conclusão do comando no shell, execute:

    [PATH_TO_CLOUD_SDK]/google-cloud-sdk/install.sh
    

Para mais informações sobre como executar o servidor de desenvolvimento local, incluindo como alterar o número da porta, consulte a referência Servidor de desenvolvimento local.

Fazer uma alteração

É possível deixar o servidor de desenvolvimento em execução enquanto você desenvolve o aplicativo. Esse servidor observa as alterações nos arquivos de origem e os atualiza, se necessário.

  1. Faça o teste agora: deixe o servidor de desenvolvimento em execução e edite main.py para mudar Hello, World! para alguma outra coisa.
  2. Atualize http://localhost:8080/ para ver os resultados.

Implantar o aplicativo

Para implantar o aplicativo no App Engine, execute o seguinte comando no diretório raiz do aplicativo em que o arquivo app.yaml está localizado:

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 app. 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 do projeto do GCP como alternativa ao ID definido como padrão na ferramenta gcloud. Exemplo: --project [YOUR_PROJECT_ID]

Por exemplo:

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

Para saber mais sobre como implantar o aplicativo na linha de comando, consulte Como implantar um aplicativo em Python 2. Para uma lista de todas as sinalizações de comando, acesse a referência de gcloud app deploy.

Ver o aplicativo

Para iniciar o navegador e visualizar o app em http://[YOUR_PROJECT_ID].appspot.com, execute o seguinte comando:

gcloud app browse

Parabéns!

Você completou este guia de início rápido.

Consulte as seções a seguir para informações sobre limpeza após este início rápido, bem como links para as próximas etapas possíveis que você pode seguir com os aplicativos implantados.

Para saber mais sobre este aplicativo Hello World, consulte a seção de análise de código do Hello World.

Limpar

Se tiver ativado o faturamento, você poderá excluir o projeto do GCP para evitar cobranças. Isso para o faturamento de todos os recursos usados nesse projeto.

  1. No Console do GCP, acesse a página Projetos.

    Acessar a página Projetos

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

Próximas etapas

Desenvolva um aplicativo Flask básico

Saiba como desenvolver e implantar aplicativos básicos do Python 2.7 executados no ambiente padrão do Google App Engine. Caso você não tenha muita experiência com o Google App Engine, com os serviços relacionados dele e, em especial, com o uso do App Engine com a linguagem Python, o guia do Flask apresenta explicações mais aprofundadas para cada tarefa do que as encontradas no guia de início rápido. Para mais informações, consulte Primeiros passos no Flask no ambiente padrão do App Engine.

Usar um domínio personalizado

Você pode veicular o aplicativo do App Engine usando o próprio domínio personalizado em vez de appspot.com. Para mais informações, consulte Como usar domínios personalizados e SSL.

Revisão do código do Hello World

Hello World é o aplicativo mais simples possível do App Engine. Nele, há apenas um serviço e uma versão. Além disso, todo o código é armazenado no diretório raiz. Nesta seção, cada arquivo do aplicativo é descrito em detalhes.

main.py

Este script do Python responde à solicitação com um cabeçalho HTTP e a mensagem Hello, World!.

import webapp2

class MainPage(webapp2.RequestHandler):
    def get(self):
        self.response.headers['Content-Type'] = 'text/plain'
        self.response.write('Hello, World!')

app = webapp2.WSGIApplication([
    ('/', MainPage),
], debug=True)

app.yaml

O arquivo de configuração app.yaml define várias opções para o app e descreve quais scripts de gerenciador precisam ser usados em quais URLs.

runtime: python27
api_version: 1
threadsafe: true

handlers:
- url: /.*
  script: main.app

De cima para baixo, estas são as informações do aplicativo que estão no arquivo de configuração:

  • Este código é executado no ambiente de execução python27, versão da API 1.
  • Este aplicativo é threadsafe. Dessa maneira, a mesma instância pode processar várias solicitações simultâneas. O recurso Threadsafe é avançado e poderá apresentar um comportamento instável se o aplicativo não for especificamente projetado para ser seguro para linhas de execução.
  • Toda solicitação a um URL com um caminho correspondente à expressão regular /.* (todos os URLs) precisa ser processada pelo objeto app no módulo main do Python.

A sintaxe desse arquivo é YAML (em inglês). Para ver uma lista completa de opções de configuração, consulte a referência de app.yaml.

Saiba mais

Conheça a plataforma inteira

Agora que você já sabe como é desenvolver e implantar aplicativos no App Engine, é possível expandir os horizontes e conhecer o restante do Google Cloud Platform. Para instruções orientadas que ensinam como criar um aplicativo que usa toda a plataforma, em vez de somente o App Engine, confira o início rápido Como criar um livro de visitas em que você expande esse aplicativo simples para se tornar um aplicativo do Google completo que permite a Contas do Google autenticadas postar mensagens em uma página pública.

Saiba mais sobre o ambiente padrão do App Engine

Aqui estão alguns tópicos para ajudar você a continuar sabendo mais sobre o App Engine:

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Ambiente padrão do App Engine para Python 2