使用 app.yaml 配置应用

App Engine 应用是使用 app.yaml 文件进行配置的，该文件包含 CPU、内存、网络和磁盘资源设置、扩缩设置以及环境变量等其他常规设置。

app.yaml 文件简介

您必须先为应用的 default 服务创建 app.yaml 文件，然后才能为其他服务创建和部署 app.yaml 文件。

以下 app.yaml 示例演示了如何将应用配置为使用最新 Java 版本。如需详细了解如何使用受支持的 Java 运行时，请参阅 Java 运行时。

  runtime: java
  env: flex
  runtime_config:
  operating_system: "ubuntu22"
  runtime_version: "21"
  handlers:
  - url: /.*
  script: this field is required, but ignored

  manual_scaling:
  instances: 1

您可能只需在相应的 app.yaml 文件中定义几个元素，具体取决于应用服务的复杂程度。以下示例演示了柔性环境中的简单 Java 应用可能需要定义的元素：

您可以为 app.yaml 文件指定一个独特的名称，但这样一来就必须在使用部署命令时指定该文件名。例如，如果您将 app.yaml 文件命名为 service-name-app.yaml 或 app.flexible.yaml，则必须使用下列任一命令部署您的应用：

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

所有配置元素

如需查看此配置文件中所有受支持的元素的完整列表，请参阅 app.yaml 参考文档。

启用 Java 虚拟机指标收集

您可以配置 Java 版 App Engine 柔性环境以收集 Java 虚拟机 (JVM) 进程的常见指标。这些指标通过 Cloud Monitoring 使用的 JVM 监控插件收集。如需查看 App Engine 的指标的完整列表，请参阅 Google Cloud 指标指南。

如果您想为应用收集以下 JVM 指标，请执行以下操作：

• appengine.googleapis.com/flex/instance/jvm/gc/count
• appengine.googleapis.com/flex/instance/jvm/gc/time

您需要在 app.yaml 的环境变量中设置以下 JMX 系统属性，并部署应用。

JAVA_USER_OPTS: "-Djava.rmi.server.hostname=172.17.0.1 -Dcom.sun.management.jmxremote.port=10403 -
Dcom.sun.management.jmxremote.rmi.port=10403 -Dcom.sun.management.jmxremote.local.only=false -
Dcom.sun.management.jmxremote.authenticate=false -Dcom.sun.management.jmxremote.ssl=false"