Como configurar o aplicativo com app.yaml

Observação: alguns ambientes de execução do Node.js estão chegando ao fim do suporte. Não é possível reimplantar versões que usam ambientes de execução após o término da data de suporte. Recomendamos que você faça upgrade do seu aplicativo para usar a versão mais recente do Node.js.

Um aplicativo do App Engine é configurado usando um arquivo app.yaml, que contém recursos de CPU, memória, rede e disco, escalonamento e outras configurações gerais, incluindo variáveis de ambiente.

Sobre arquivos app.yaml

É possível especificar a configuração do ambiente de execução para o aplicativo Node.js, incluindo versões e URLs, no arquivo app.yaml. Esse arquivo atua como um descritor de implantação de uma versão de serviço específica.

Primeiro, é necessário criar o arquivo app.yaml para o serviço default do app antes de criar e implementar arquivos app.yaml para outros serviços.

O app.yaml a seguir demonstra como configurar seu aplicativo para usar a versão mais recente do Node.js. Para usar qualquer outra versão compatível do Node.js, atualize o arquivo app.yaml. Para mais informações, consulte Ambiente de execução do Node.js.

runtime: nodejs
env: flex
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/nodejs/configuring-your-app-with-app-yaml
manual_scaling:
  instances: 1
resources:
  cpu: 1
  memory_gb: 0.5
  disk_size_gb: 10

Dependendo da complexidade do serviço do aplicativo, talvez seja necessário definir apenas alguns elementos no arquivo app.yaml correspondente. No exemplo a seguir, veja o que um simples aplicativo Node.js pode exigir no ambiente flexível:

É possível especificar um nome único para os arquivos app.yaml, mas será necessário especificar o nome do arquivo com o comando de implantação também. Por exemplo, ao nomear seu arquivo app.yaml, service-name-app.yaml ou app.flexible.yaml, será preciso implantar o aplicativo usando:

gcloud app deploy service-name-app.yaml
gcloud app deploy app.flexible.yaml

Para saber mais sobre como estruturar vários serviços e arquivos app.yaml no app, consulte Como estruturar serviços da Web.

Todos os elementos de configuração

Para uma lista completa de todos os elementos compatíveis com esse arquivo de configuração, consulte a referência do app.yaml.