Cloud Run functions 函数在由操作系统版本、插件软件包、语言支持以及支持和调用函数的 Python Functions 框架库组成的环境中运行。此环境由语言版本进行标识,称为运行时 ID。
函数准备
您可以直接在 Google Cloud 控制台中准备函数,也可以在本地机器上编写函数并上传该函数。如需准备本地机器以用于 Python 开发,请参阅设置 Python 开发环境。
支持的 Python 运行时和基础映像
运行时 | 运行时 ID | 堆栈 | 运行时基础映像 |
---|---|---|---|
Python 3.13 | python313 |
|
|
Python 3.12 | python312 |
|
|
Python 3.11 | python311 |
|
|
Python 3.10 | python310 |
|
|
Python 3.9 | python39 | google-18-full | google-18-full/python39 |
Python 3.8 | python38 | google-18-full | google-18-full/python38 |
Python 3.7 | python37 | google-18-full | google-18-full/python37 |
选择运行时
您可以在部署期间为函数选择一个受支持的 Python 运行时。
您可以使用 Google Cloud 控制台或 gcloud CLI 选择运行时版本。点击相应标签页即可获得有关所选工具的使用说明:
gcloud
部署函数时,使用 --base-image
标志为函数指定 Python 基础映像。例如:
gcloud run deploy FUNCTION \
--source . \
--function FUNCTION_ENTRYPOINT \
--base-image python313
您需要进行如下替换:
将 FUNCTION 替换为您要部署的函数的名称。您可以完全省略此参数,但如果省略它,系统将提示您输入名称。
将 FUNCTION_ENTRYPOINT 替换为源代码中函数的入口点。这是 Cloud Run 在您的函数运行时执行的代码。此标志的值必须是源代码中存在的函数名称或完全限定类名称。
如需详细了解如何使用 gcloud CLI 部署函数,请参阅在 Cloud Run 中部署函数。
控制台
您可以在创建或更新 Cloud Run 函数时在 Google Cloud 控制台中选择运行时版本。如需详细了解如何部署函数,请参阅在 Cloud Run 中部署函数。
如需在创建函数时在 Google Cloud 控制台中选择运行时,请按以下步骤操作:
在 Google Cloud 控制台中,前往 Cloud Run 页面:
点击编写函数。
在 Runtime 列表中,选择 Python 运行时版本。
点击创建,然后等待 Cloud Run 使用占位符修订版创建服务。
控制台会将您重定向到来源标签页,您可以在其中查看函数的源代码。点击保存并重新部署。
如需详细了解如何在部署函数后更新运行时版本,请参阅重新部署新的源代码。
源代码结构
为了让 Cloud Run functions 找到函数的定义,源代码必须遵循特定结构。如需了解详情,请参阅编写 Cloud Run functions 函数。
指定依赖项
您可通过两种方式为使用 Python 编写的 Cloud Run functions 函数指定依赖项:使用 pip
软件包管理器的 requirements.txt
文件,或将本地依赖项与您的函数封装在一起。如需了解详情,请参阅指定 Python 依赖项。
Cloud Run 函数不支持使用 Pipfile/Pipfile.lock
指定依赖项,因此您的项目不应包含这些文件。
环境变量
Python 运行时会自动根据需要为函数设置要使用的特定环境变量。如需了解详情,请参阅配置环境变量。