在 Cloud Run 中构建并创建 Go 作业
须知事项
- 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手,请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金,用于运行、测试和部署工作负载。
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
编写示例作业
如需在 Go 中编写作业,请执行以下操作:
创建名为
jobs
的新目录,并转到此目录中:mkdir jobs cd jobs
在同一目录中,为实际作业代码创建一个
main.go
文件。将以下示例行复制到其中:Cloud Run 作业允许用户指定作业要执行的任务数量。此示例代码演示了如何使用内置
CLOUD_RUN_TASK_INDEX
环境变量。每个任务代表容器的一个正在运行的副本。 请注意,任务通常并行执行。如果每个任务都可以独立处理一部分数据,则使用多个任务非常有用。每个任务都知道其存储在
CLOUD_RUN_TASK_INDEX
环境变量中的索引。内置CLOUD_RUN_TASK_COUNT
环境变量包含在执行作业时通过--tasks
参数提供的任务数量。此处所示的代码还展示了如何使用内置
CLOUD_RUN_TASK_ATTEMPT
环境变量重试任务,该变量包含此任务重试的次数,从 0 开始(表示第一次尝试),然后每次连续重试时递增 1,上限为--max-retries
。此外,通过代码,您还可以生成失败来测试重试并生成错误日志,从而查看失败情况。
创建一个包含以下内容的
go.mod
文件:
您的代码已完成,可以封装在容器中。
构建作业容器,将其发送到 Artifact Registry 并部署到 Cloud Run
重要提示:本快速入门假定您在快速入门中使用的项目中拥有所有者或编辑者角色。否则,请参阅 Cloud Run Source Developer 角色,了解从源代码部署 Cloud Run 资源所需的权限。
本快速入门使用“从源代码部署”,以构建容器,将其上传到 Artifact Registry,然后将作业部署到 Cloud Run:
gcloud run jobs deploy job-quickstart \ --source . \ --tasks 50 \ --set-env-vars SLEEP_MS=10000 \ --set-env-vars FAIL_RATE=0.1 \ --max-retries 5 \ --region REGION \ --project=PROJECT_ID
其中,PROJECT_ID 是您的项目 ID,REGION 是您的区域,例如 us-central1
。请注意,您可以将各种参数更改为要用于测试的任何值。SLEEP_MS
模拟工作,FAIL_RATE
导致 X
% 的任务失败,因此您可以试验并行情况并重试失败任务。
在 Cloud Run 中执行作业
如需执行刚刚创建的作业,请运行以下命令:
gcloud run jobs execute job-quickstart --region REGION
将 REGION 替换为您在创建和部署作业时使用的区域,例如 us-central1
。
后续步骤
如需详细了解如何使用代码源构建容器并推送到仓库,请参阅: