Use o Flask para gravar e testar localmente um serviço da Web que disponibilize um arquivo HTML estático. Em seguida, crie os arquivos de configuração necessários para implantar o serviço da Web no App Engine.
Nesta etapa, você cria e testa localmente uma versão de um serviço da Web que exibe dados de marcadores. O objetivo aqui é garantir que seu serviço da Web básico esteja funcionando antes de adicionar a autenticação do Datastore e do Firebase.
Antes de começar
Crie um projeto do Google Cloud se ainda não tiver feito isso.
Se ainda não o fez, configure seu ambiente local para o desenvolvimento em Python 3 da seguinte maneira:
Faça o download e instale o Python 3 para desenvolver seu serviço da Web e executar a Google Cloud CLI.
Use suas credenciais de usuário do Google Cloud para fazer a autenticação com a Google Cloud CLI e ativar os testes locais com o Datastore:
gcloud auth application-default login
Como estruturar os arquivos de serviço da Web
O diretório do projeto em que o serviço da Web é criado terá a seguinte estrutura de arquivos:
building-an-app/
app.yaml
main.py
requirements.txt
static/
script.js
style.css
templates/
index.html
As seções a seguir mostram um exemplo de como configurar os arquivos no diretório do projeto.
Como gravar serviços da Web
A iteração inicial do serviço da Web usa o Flask para disponibilizar um modelo HTML baseado em Jinja.
Para configurar o serviço da Web:
Crie seu arquivo
templates/index.html
:Adicione comportamentos e estilos com os arquivos
static/script.js
estatic/style.css
:No arquivo
main.py
, use o Flask para renderizar o modelo HTML com os dados do marcador:Configure todas as dependências necessárias para seu serviço da Web no arquivo
requirements.txt
:
Como testar o serviço da Web
Teste seu serviço da Web executando-o localmente em um ambiente virtual:
Mac OS/Linux
- Crie um
ambiente Python isolado:
python3 -m venv env
source env/bin/activate
- 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
- Execute o aplicativo:
python main.py
- No navegador da Web, digite este endereço:
http://localhost:8080
Windows
Use o PowerShell para executar os pacotes Python.
- Localize a instalação do PowerShell.
- Clique com o botão direito do mouse no atalho do PowerShell e inicie-o como administrador.
- Crie um
ambiente Python isolado.
python -m venv env
.\env\Scripts\activate
- 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
- Execute o aplicativo:
python main.py
- No navegador da Web, digite este endereço:
http://localhost:8080
Como configurar o serviço da Web para o App Engine
Para implantar o serviço da Web no App Engine, você precisa de um arquivo app.yaml
.
Esse arquivo de configuração define as configurações do serviço da Web para o
Google App Engine.
Para configurar o serviço da Web para implantação no App Engine, crie
o arquivo app.yaml
no diretório raiz do projeto, por exemplo,
building-an-app
:
Observe que, para esse serviço da Web simples, seu arquivo app.yaml
precisa definir
apenas a configuração do ambiente de execução e os gerenciadores de arquivos estáticos.
Para serviços da Web mais complexos, é possível definir mais configurações
no app.yaml
, como escalonamento, outros gerenciadores e outros
elementos de aplicativo, como variáveis de ambiente e nomes de serviço.
Para mais informações e uma lista de todos os elementos compatíveis, consulte a
referência de app.yaml
.
Próximas etapas
Agora que o serviço da Web está configurado, criado e testado, é possível implantar no App Engine essa versão do serviço da Web.