为 Python 3 运行时准备配置文件

在 App Engine 标准环境的 Python 3 运行时中运行应用之前，可能需要更改该 App Engine 使用的一些配置文件：

• app.yaml。此文件包含应用代码的相关信息，例如运行时和应用处理程序。

• appengine_config.py。Python 2 运行时使用此文件访问第三方库，并为常量和“钩子函数”提供值。Python 3 运行时不使用此文件。

正在更新“app.yaml”

您的 app.yaml 配置文件中某些字段的行为已修改。移除所有不再受支持的字段并更新其他字段，如下表所述。

字段	更改类型	说明
app_engine_apis	仅适用于 Python 3	如果要访问 Python 3 版旧版捆绑服务，则必须设置为 true。
api_version application_readable builtins	不再支持	不适用于 Python 3 运行时。
threadsafe	不再支持	假定所有应用的线程安全。如果您的应用不具备线程安全性，请指定一个 entrypoint，为每个工作器配置 1 个线程。 例如，使用 F4 实例类时： entrypoint: gunicorn -b :$PORT -w 8 --threads 1 main:app 请参阅入口点最佳做法，了解每个实例类的推荐工作器数量。
库	不再支持	使用 requirements.txt 文件声明依赖项并安装客户端库。
处理程序：登录	在 app_engine_apis 为 true 时支持	如果未使用 Python 3 版旧版捆绑服务，请使用 Identity and Access Management (IAM) 执行用户管理。
处理程序：脚本	已修改	在 Python 2 运行时中，您使用 script 字段将传入请求路由到应用的脚本。 在 Python 3 运行时中，您需要使用具有应用内路由的 Web 框架（例如 Flask 或 Django），而不是使用 script 字段。 如需将 app.yaml 文件迁移到 Python 3 运行时，请执行以下操作之一，具体取决于该文件是否包含静态处理程序以及脚本处理程序： 如果您的 app.yaml 文件包含静态处理程序，请执行以下操作之一，以确保将动态内容请求路由到应用的脚本： 移除所有 script 字段。然后添加 entrypoint 字段以启动运行应用的 Web 服务器。与任何静态调度程序均不匹配的请求将定向到您在 entrypoint 字段中指定的 Web 服务器。Web 服务器和应用的 Web 框架负责将请求路由到正确的脚本。 将所有 script 字段的值替换为 auto。App Engine 将在 Web 服务器中自动运行应用（假设应用符合一些要求），与脚本处理程序匹配的所有请求都将定向到该 Web 服务器。Web 服务器和应用的 Web 框架负责将请求路由到正确的脚本。 如果您的 app.yaml 文件不包含静态处理程序，请移除所有 script 字段。发送到应用的所有请求都将定向到应用的 Web 服务器，并且应用的框架会将请求路由到正确的脚本。您可以选择添加 entrypoint 字段来自定义默认启动行为。 如果您的 app.yaml 同时具有这两种类型的处理程序，您仍然可以移除标记为 auto 的所有脚本处理程序，并留下静态处理程序以及需要使用其他指令的 auto 处理程序，例如以下示例中的管理员专用处理程序。 静态文件处理保持不变。

如果使用任何已弃用的字段，App Engine 会在您部署应用时返回错误。

您可以使用以下示例比较 app.yaml 文件之间的差异：

Python 2

runtime: python27
api_version: 1
threadsafe: true

handlers:
- url: /
  script: home.app

- url: /index\.html
  script: home.app

- url: /stylesheets
  static_dir: stylesheets

- url: /(.*\.(gif|png|jpg))$
  static_files: static/\1
  upload: static/.*\.(gif|png|jpg)$

- url: /admin/.*
  script: admin.app
  login: admin

- url: /.*
  script: not_found.app

Python 3

runtime: python312
app_engine_apis: true

handlers:
- url: /stylesheets
  static_dir: stylesheets

- url: /(.*\.(gif|png|jpg))$
  static_files: static/\1
  upload: static/.*\.(gif|png|jpg)$

- url: /admin/.*
  script: auto
  login: admin

注意：对于 Python 3，首选的 WSGI 兼容网络服务器为 gunicorn。在 app.yaml 配置文件中使用可选的 entrypoint 字段时，gunicorn 的默认超时时间为 30 秒。如需设置自定义超时，请更新 entrypoint 字段：例如 entrypoint: gunicorn -b :$PORT --timeout=600。在这种情况下，请确保您已将 gunicorn 添加到 requirements.txt 文件中。

移除 appengine_config.py

App Engine 标准环境中的 Python 2 运行时使用 appengine_config.py 文件。

此文件在 Python 3 运行时中会被忽略。相反，Python 3 运行时会使用标准 requirements.txt 文件来 安装依赖项，包括使用原生代码的依赖项。