Configurar a sua app com o ficheiro app.yaml

Uma app do App Engine é configurada através de um ficheiro app.yaml que contém recursos de CPU, memória, rede e disco, escalabilidade e outras definições gerais, incluindo variáveis de ambiente.

Acerca de app.yaml ficheiros

Pode especificar a configuração de tempo de execução da sua app Python, incluindo versões e URLs, no ficheiro app.yaml. Este ficheiro funciona como um descritor de implementação de uma versão específica do serviço.

Primeiro, tem de criar o ficheiro app.yaml para o serviço default da sua app antes de poder criar e implementar ficheiros app.yaml para serviços adicionais.

O exemplo seguinte app.yaml demonstra como configurar a sua app para usar a versão mais recente do Python. Para usar qualquer outra versão suportada do Python, tem de atualizar o ficheiro app.yaml. Para mais informações, consulte o artigo Tempo de execução do Python.

# Copyright 2021 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

runtime: python
env: flex
entrypoint: gunicorn -b :$PORT main:app

runtime_config:
  operating_system: ubuntu22

# This sample incurs costs to run on the App Engine flexible environment.
# The settings below are to reduce costs during testing and are not appropriate
# for production use. For more information, see:
# https://cloud.google.com/appengine/docs/flexible/python/configuring-your-app-with-app-yaml
manual_scaling:
  instances: 1
resources:
  cpu: 1
  memory_gb: 0.5
  disk_size_gb: 10

Consoante a complexidade do serviço da sua app, pode apenas ter de definir alguns elementos no ficheiro app.yaml correspondente. O exemplo seguinte demonstra o que uma app Python simples pode exigir no ambiente flexível:

Pode especificar um nome exclusivo para os seus ficheiros app.yaml, mas, em seguida, tem de especificar o nome do ficheiro com o comando de implementação também. Por exemplo, se der o nome app.yaml ao ficheiro service-name-app.yaml ou app.flexible.yaml, tem de implementar a sua app através de:

gcloud app deploy service-name-app.yaml
gcloud app deploy app.flexible.yaml
Para saber como estruturar vários serviços e ficheiros app.yaml na sua app, consulte o artigo Estruturar serviços Web.

Todos os elementos de configuração

Para ver uma lista completa de todos os elementos suportados neste ficheiro de configuração, consulte a referência app.yaml.