并行(作业)

您可以使用 parallelism 指定作业执行中可并行运行的任务的数量上限。默认情况下,任务将尽快启动,最多不超过因所使用的 CPU 数量而异的上限

降低并行性会限制可并行运行的任务数量。如果您的某个支持性资源(如数据库)的扩缩能力有限且无法处理大量并行请求,则降低并行性会非常有用。

所需的角色

如需获得配置 Cloud Run 作业所需的权限,请让管理员向您授予以下 IAM 角色:

如需查看与 Cloud Run 关联的 IAM 角色和权限的列表,请参阅 Cloud Run IAM 角色Cloud Run IAM 权限。如果您的 Cloud Run 作业与 Google Cloud API(例如 Cloud 客户端库)进行交互,请参阅服务身份配置指南。如需详细了解如何授予角色,请参阅部署权限管理访问权限

配置并行设置

如需为 Cloud Run 作业指定并行设置,请执行以下操作:

控制台

  1. 在 Google Cloud 控制台中,进入 Cloud Run 作业页面:

    转到 Cloud Run

  2. 如果要配置新作业,请点击作业标签页,然后根据需要填写初始作业设置页面。如果要配置现有作业,请点击作业,然后点击修改

  3. 点击容器、变量和 Secret、连接、安全性以展开作业属性页面。

  4. 点击常规标签页。

    映像

    • 选择尽可能多地运行并发任务以获得最佳性能。如果需要减少并发任务的数量(例如,在您的支持性资源有限的情况下),请选择限制并发任务的数量,然后在文本框中指定一个介于 0 到 100 之间的整数。
  5. 点击创建更新

命令行

  1. 对于要创建的作业:

    gcloud run jobs create JOB_NAME --image IMAGE_URL --parallelism PARALLELISM

    替换

    • JOB_NAME 替换为作业的名称。
    • IMAGE_URL 替换为对容器映像的引用,例如 us-docker.pkg.dev/cloudrun/container/job:latest
    • PARALLELISM 指定 0 到 100 之间的整数,且该数值不能超过任务的数量。
  2. 对于要更新的作业:

    gcloud run jobs update JOB_NAME --parallelism PARALLELISM

YAML

使用 gcloud run jobs describe --format export 命令下载并查看现有作业配置,该命令会生成清理后的 YAML 格式的结果。然后,修改下述字段,并使用 gcloud run jobs replace 命令上传修改后的 YAML。请务必严格按照说明修改字段。

  1. 要查看和下载配置,请运行以下命令:

    gcloud run jobs describe JOB_NAME --format export > job.yaml
  2. 更新 parallelism: 特性:

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

    替换 PARALLELISM。指定 0 到 100 之间的整数,且该数值不能超过任务的数量。

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

  3. 更新现有作业配置:

    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-parallelism"
  location     = "us-central1"
  launch_stage = "BETA"

  template {
    task_count  = 3
    parallelism = 3

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

查看并行设置

如需查看 Cloud Run 作业的当前并行设置,请按照以下所述操作:

控制台

  1. 在 Google Cloud 控制台中,进入 Cloud Run 作业页面:

    转到 Cloud Run 作业

  2. 点击相关作业以打开作业详情页面。

  3. 点击配置标签页。

  4. 在配置详细信息中找到并行设置。

命令行

  1. 使用以下命令:

    gcloud run jobs describe JOB_NAME
  2. 在返回的配置中找到并行设置。