指定依赖项

Python 应用的依赖项在标准 requirements.txt 文件中声明。例如:

Flask==MAJOR.MINOR.PATCH
google-cloud-storage

MAJORMINORPATCH 替换为所需的 Flask 版本号

您可以在 App Engine 柔性环境中使用任何与 Linux 兼容的 Python 包,包括需要原生 (C) 扩展程序的包。

部署期间,Python 运行时将自动安装 requirements.txt 中声明的所有依赖项。

在本地安装依赖项

在本地开发和测试应用时,我们建议您使用 venv 将应用的依赖项与系统软件包隔离开来。这样做还可确保本地机器上的依赖项的版本与已部署应用的依赖项版本保持一致。

如需使用 venv 安装依赖项,请完成以下步骤:

Mac OS/Linux

  1. 创建一个独立的 Python 环境
    python3 -m venv env
    source env/bin/activate
  2. 如果您当前不在包含示例代码的目录中,则导航到包含 hello_world 示例代码的目录。然后安装依赖项:
    cd YOUR_SAMPLE_CODE_DIR
    pip install -r requirements.txt

Windows

使用 Powershell 运行 Python 包。

  1. 找到已安装的 Powershell
  2. 右键点击 Powershell 的快捷方式,并以管理员身份启动。
  3. 创建一个独立的 Python 环境
    python -m venv env
    .\env\Scripts\activate
  4. 导航到项目目录并安装依赖项。如果您当前不在包含示例代码的目录中,则导航到包含 hello_world 示例代码的目录。然后安装依赖项:
    cd YOUR_SAMPLE_CODE_DIR
    pip install -r requirements.txt

这样可确保当您在本地运行应用时,只有 requirements.txt 文件中声明的依赖项可用。App Engine 在部署期间安装的依赖项基于 requirements.txt 文件的内容,而不是 env/ 目录的内容。

安装 Web 框架

您需要使用 Web 框架来启用您的应用以处理 Web 请求。 您可以使用任何 Python Web 框架,包括以下各项:

如需使用特定的 Web 框架,只需将其添加到 requirements.txt

Flask==MAJOR.MINOR.PATCH

安装 WSGI 服务器

一些网络框架具有内置 WSGI 服务器,但是,这些框架基本都不适合传送生产流量。大多数 Web 应用都使用独立的 WSGI 服务器,如 GunicornuWSGIWaitress。如需详细了解如何安装、配置和使用 WSGI 服务器,请参阅应用启动

安装 Cloud 客户端库

Python 版 Cloud 客户端库可用于访问 Google Cloud 服务,能显著减少您必须编写的样板代码量。该库提供高级 API 抽象,因此更容易理解。该库还包含 Python 的习语,适用于标准 Python 库,并且可与您的代码库更好地集成。

例如,您可以为 DatastoreCloud Storage 安装相应的 Python 客户端库,从而将这些服务与您的应用集成。

要为 Cloud Datastore 安装 Python 客户端库,请执行以下操作:

  1. 使用 pip 在本地安装客户端库:

    pip install google-cloud-datastore

  2. 设置身份验证。您可以将 Python 版 Cloud 客户端库配置为自动处理身份验证。该客户端库也可使用 Google Cloud CLI 为您在本地自动处理身份验证。

    gcloud auth login
    
  3. 借助 Datastore 客户端库参考文档,在您的应用中实现对 Cloud Datastore 服务的支持。

如需查看支持的 Google Cloud 服务的所有 Python 版 Cloud 客户端库的完整列表,请参阅 API 和 Python 库