创建作业

控制台

如需创建新作业，请执行以下操作：

1. 在 Google Cloud 控制台中，前往 Cloud Run 页面：

   转到 Cloud Run

2. 点击部署容器，然后选择作业以显示创建作业表单。

   1. 在该表单中，指定包含作业代码的容器映像，或从之前部署的容器列表中选择容器映像。
   2. 作业名称是系统根据容器映像自动生成的。您可以根据需要修改或更改作业名称。 创建作业后，便无法再更改作业名称。
   3. 选择作业所在的区域。区域选择器会突出显示碳影响最低的区域。
   4. 指定要在作业中运行的任务的数量。所有任务都必须成功完成，这样作业才能成功完成。默认情况下，这些任务是并行执行的。

3. 点击容器、卷、网络、安全性以设置其他作业属性。

   • 在“任务容量”下，执行以下操作：
   1. 在内存菜单中，指定所需的内存量。默认值为所需的最小值，即 512 MiB。
   2. 在 CPU 菜单中，指定所需的 CPU 数量。默认值为所需的最小值，即 1 个 CPU。

   3. 在“任务超时”下，指定任务可运行的时长上限（以秒为单位），最长为 168 小时（7 天）。对超过 24 小时的超时时间的支持目前处于预览版阶段。每个任务都必须在此时间段内完成。默认值为 10 分钟（600 秒）。

   4. 在每个失败任务的重试次数下，指定任务失败时的重试次数。默认值为 3 次重试。

   • 在“并行”下：

     1. 在大多数情况下，您可以选择尽可能多地运行并发任务。
     2. 如果您因作业访问的资源存在扩缩限制而需要设置更小的限值，请选择限制并发任务数上限，然后在自定义并行限制字段中指定并发任务的数量。

4. （可选）在相应的标签页中配置其他设置：

   • 容器配置
   • CPU 上限
   • 内存限制
   • 密文
   • 环境变量
   • 标签
   • 服务账号
   • Cloud SQL 连接
   • VPC 连接

5. 配置完作业后，点击创建以在 Cloud Run 中创建作业。

6. 如需执行作业，请参阅执行作业或按计划执行作业。

gcloud

如需使用命令行，您需要先设置 gcloud CLI。

如需创建新作业，请执行以下操作：

1. 运行以下命令：

   gcloud run jobs create JOB_NAME --image IMAGE_URL OPTIONS

   或者，使用部署命令：

   gcloud run jobs deploy JOB_NAME --image IMAGE_URL OPTIONS

   • 将 JOB_NAME 替换为您要创建的作业的名称。您可以省略此参数，但如果省略它，系统将提示您输入作业名称。
   • 将 IMAGE_URL 替换为对容器映像的引用，例如 us-docker.pkg.dev/cloudrun/container/job:latest。

   • （可选）将 OPTIONS 替换为以下任意选项：

     选项	说明
     --tasks	接受大于或等于 1 的整数。默认为 1；最大值为 10000。每个任务都提供环境变量 CLOUD_RUN_TASK_INDEX（其值介于 0 到任务数减去 1 之间）和 CLOUD_RUN_TASK_COUNT（即任务数）
     --max-retries	失败任务的重试次数。如果有任何任务的失败次数超过此限制，则整个作业会被标记为失败。例如，如果设置为 1，系统将重试失败的任务一次，即总共尝试两次。默认值为 3。接受 0 到 10 的整数。
     --task-timeout	接受类似于“2s”的时长。默认值为 10 分钟；最长为 168 小时（7 天）。对超过 24 小时的超时时间的支持目前处于预览版阶段。
     --parallelism	可以并行执行的任务的数量上限。默认情况下，任务会尽快并行启动。如需了解值范围，请参阅并行性。
     --execute-now	如果设置了此标志，则在创建作业后立即启动作业执行。等同于依次调用 gcloud run jobs create 和 gcloud run jobs execute。

     除了上述选项之外，您还可以指定更多配置，例如环境变量或内存限制。

     如需查看创建作业时可用的选项的完整列表，请参阅 gcloud run jobs create 命令行文档。

2. 等待创建作业的操作完成。成功完成后，您会看到一条成功消息。

3. 如需执行作业，请参阅执行作业或按计划执行作业。

YAML

您可以将作业规范存储在 YAML 文件中，然后使用 gcloud CLI 进行部署。

1. 使用以下内容创建新的 job.yaml 文件：

   apiVersion: run.googleapis.com/v1
   kind: Job
   metadata:
     name: JOB
   spec:
     template:
       spec:
         template:
           spec:
             containers:
             - image: IMAGE

   您需要进行如下替换

   • 将 JOB 替换为 Cloud Run 作业的名称。 作业名称不得超过 49 个字符，并且在每个区域和项目中必须是唯一的。
   • 将 IMAGE 替换为作业容器映像的网址。

   您还可以指定更多配置，例如环境变量或内存限制。

2. 使用以下命令部署新作业：

   gcloud run jobs replace job.yaml

Terraform

如需了解如何应用或移除 Terraform 配置，请参阅基本 Terraform 命令。

如需创建新的 Cloud Run 作业，请使用 google_cloud_run_v2_job 资源并修改 main.tf 文件，如以下代码段所示。

resource "google_cloud_run_v2_job" "default" {
  name     = "cloud-run-job"
  location = "us-central1"

  deletion_protection = false # set to "true" in production

  template {
    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job:latest"
      }
    }
  }
}

客户端库

通过以下代码创建作业：

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

REST API

如需创建作业，请向 Cloud Run Admin API jobs 端点发送 POST HTTP 请求。

例如，使用 curl：

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X POST \
  -d '{template: {template: {containers: [{image: "IMAGE_URL"}]}}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs?jobId=JOB_NAME

您需要进行如下替换：

• 将 ACCESS_TOKEN 替换为具有创建作业的 IAM 权限的账号的有效访问令牌。例如，如果您已登录 gcloud，则可以使用 gcloud auth print-access-token 检索访问令牌。在 Cloud Run 容器实例中，您可以使用容器实例元数据服务器检索访问令牌。
• 将 JOB_NAME 替换为您要创建的作业的名称。
• 将 IMAGE_URL 替换为作业容器映像的网址，例如 us-docker.pkg.dev/cloudrun/container/job:latest。
• 将 REGION 替换为作业的 Google Cloud 区域。
• 将 PROJECT_ID 替换为 Google Cloud 项目 ID。

控制台

如需更新现有作业，请执行以下操作：

1. 在 Google Cloud 控制台中，前往 Cloud Run 页面：

   转到 Cloud Run

2. 点击作业标签页以显示作业列表。

3. 点击该作业以显示作业详情页面。

4. 点击修改。

5. 如果更改了作业代码，请指定新的容器映像摘要。

6. （可选）根据需要更改作业中的任务数量。

7. 酌情点击容器、卷、网络、安全性以更新任何其他作业属性：

   • 在“任务容量”下，执行以下操作：
   1. 在内存菜单中，指定所需的内存量。默认值为所需的最小值，即 512 MiB。
   2. 在 CPU 菜单中，指定所需的 CPU 数量。默认值为所需的最小值，即 1 个 CPU。
   3. 在“任务超时”下，指定任务可运行的时长上限（以秒为单位），最长为 168 小时（7 天）。对超过 24 小时的超时时间的支持目前处于预览版阶段。每个任务都必须在此时间段内完成。默认值为 10 分钟（600 秒）。
   4. 在每个失败任务的重试次数下，指定任务失败时的重试次数。默认值为 3 次重试。

   • 在“并行”下：

     1. 在大多数情况下，您可以选择尽可能多地运行并发任务。
     2. 如果您因作业访问的资源存在扩缩限制而需要设置更小的限值，请选择限制并发任务的数量，然后在自定义并行限制字段中指定并发任务数上限。

8. （可选）在相应的标签页中配置其他设置：

   • 容器配置
   • CPU 上限
   • 内存限制
   • 密文
   • 环境变量
   • 标签
   • 服务账号
   • Cloud SQL 连接
   • VPC 连接

9. 配置完作业后，点击保存以在 Cloud Run 中创建作业，然后等待作业创建完成。

10. 如需执行作业，请参阅执行作业或按计划执行作业。

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. 运行以下命令：

   gcloud run jobs update JOB_NAME

   您需要进行如下替换：

   • 将 JOB_NAME 替换为您要更新的作业的名称。

   • （可选）将 OPTIONS 替换为以下选项：

     选项	说明
     --tasks	接受不小于 1 的整数。默认为 1；最大值为 10000。每个任务都提供环境变量 CLOUD_RUN_TASK_INDEX（其值介于 0 到任务数减去 1 之间）和 CLOUD_RUN_TASK_COUNT（即任务数）
     --max-retries	失败任务的重试次数。如果有任何任务的失败次数超过此限制，则整个作业会被标记为失败。例如，如果设置为 1，系统将重试失败的任务一次，即总共尝试两次。默认值为 3。 接受 0 到 10 的整数。
     --task-timeout	接受类似于“2s”的时长。默认值为 10 分钟；最长为 168 小时（7 天）。对超过 24 小时的超时时间的支持目前处于预览版阶段。
     --parallelism	可以并行执行的任务的数量上限。默认情况下，任务会尽快并行启动。如需了解值范围，请参阅并行性。

   除了上述选项之外，您还可以设置其他可选的配置设置：

   • 容器配置
   • CPU 上限
   • 内存限制
   • 密文
   • 环境变量
   • 标签
   • 服务账号
   • Cloud SQL 连接
   • VPC 连接

   如需查看创建作业时可用的选项的完整列表，请参阅 gcloud run jobs create 命令行文档。

3. 等待更新作业的操作完成。成功完成后，系统会显示一条成功消息，如下所示：

   Job [JOB_NAME] has been successfully updated.
   View details about this job by running `gcloud run jobs describe JOB_NAME`.
   See logs for this execution at: https://console.cloud.google.com/logs/viewer?project=PROJECT_ID&resource=cloud_run_revision/service_name/JOB_NAME

4. 如需执行作业，请参阅执行作业或按计划执行作业。

YAML

如果您需要下载或查看现有作业的配置，请使用以下命令将结果保存到 YAML 文件：

gcloud run jobs describe JOB --format export > job.yaml

在作业配置 YAML 文件中，根据需要修改任何 spec.template 子属性以更新配置设置，然后重新部署：

1. 更新现有作业配置：

   gcloud run jobs replace job.yaml

2. 如需执行作业，请参阅执行作业或按计划执行作业。

Terraform

可以使用 terraform apply 命令在 main.tf 文件中更改作业配置。详细的 Terraform 说明适用于：

• 最大并行数量
• 尝试次数上限
• 超时

如需了解详情，请参阅 terraform apply 命令行选项。

客户端库

如需通过代码更新现有作业，请使用以下客户端库：

• Go
• Java
• Node.js
• Python
• Ruby
• PHP
• .NET

REST API

如需更新作业，请向 Cloud Run Admin API jobs 端点发送 PATCH HTTP 请求。

例如，使用 curl：

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -X PATCH \
  -d '{template: {template: {containers: [{image: "IMAGE_URL"}]}}}' \
  https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB_NAME

您需要进行如下替换：

• 将 ACCESS_TOKEN 替换为具有更新作业的 IAM 权限的账号的有效访问令牌。例如，如果您已登录 gcloud，则可以使用 gcloud auth print-access-token 检索访问令牌。在 Cloud Run 容器实例中，您可以使用容器实例元数据服务器检索访问令牌。
• 将 JOB_NAME 替换为您要更新的作业的名称。
• 将 IMAGE_URL 替换为作业容器映像的网址，例如 us-docker.pkg.dev/cloudrun/container/job:latest。
• 将 REGION 替换为作业的 Google Cloud 区域。
• 将 PROJECT_ID 替换为 Google Cloud 项目 ID。