設定工作的記憶體限制

您可以選擇要為 Cloud Run 作業提供多少記憶體。本頁說明如何為工作指定可用記憶體量。

瞭解記憶體用量

超出允許記憶體限制的 Cloud Run 執行個體會遭到終止。

執行個體的可用記憶體必須足以支援:

  • 執行工作可執行檔,因為可執行檔必須載入記憶體
  • 在工作程序中分配記憶體
  • 將檔案寫入檔案系統

部署的容器映像檔大小不會影響執行個體可用的記憶體。

設定及更新記憶體限制

您可以為 Cloud Run 工作設定記憶體限制。 根據預設,分配給每個工作的記憶體為 512 MiB。

CPU 最低需求

您選擇的記憶體分配量,會對應到工作所需的最低 CPU 數量。設定記憶體限制時,必須符合下列最低 CPU 限制:

記憶體 所需 CPU 數量下限
128 MiB 0.083 個 vCPU
256 MiB .167 個 vCPU
512 MiB 0.333 個 vCPU
1 GiB 0.583 個 vCPU
2 GiB 1 個 vCPU
超過 4 GiB 2 個 vCPU
超過 8 GiB 4 個 vCPU
超過 16 GiB 6 個 vCPU
超過 24 GiB 8 個 vCPU

記憶體大小上限

可設定的記憶體最大量為 32 GiB (32 Gi)。

最低記憶體

第二代執行環境中,可設定的記憶體量下限為 512 MiB。

必要的角色

如要取得設定 Cloud Run 作業所需的權限,請要求管理員授予下列 IAM 角色:

如需與 Cloud Run 相關聯的 IAM 角色和權限清單,請參閱 Cloud Run IAM 角色Cloud Run IAM 權限。如果 Cloud Run 作業與Google Cloud API (例如 Cloud 用戶端程式庫) 介接,請參閱服務身分設定指南。 如要進一步瞭解如何授予角色,請參閱部署權限管理存取權

設定記憶體限制

您必須為 Cloud Run 工作指定至少 512 Mi 的記憶體。如要為 Cloud Run 工作指定記憶體,請按照下列步驟操作:

控制台

  1. 前往 Google Cloud 控制台的 Cloud Run 作業頁面:

    前往 Cloud Run

  2. 從選單中選取「工作」,然後按一下「部署容器」,填寫初始工作設定頁面。如要設定現有工作,請選取該工作,然後按一下「編輯」

  3. 按一下「容器、磁碟區、連線與安全性」,展開工作屬性頁面。

  4. 按一下「容器」分頁標籤。

    圖片

    • 從「記憶體」下拉式清單中選取想要的記憶體大小。
  5. 按一下「建立」或「更新」

gcloud

  1. 如要在建立工作時設定記憶體限制,請按照下列步驟操作:

    gcloud run jobs create JOB_NAME --image IMAGE_URL --memory SIZE

    取代:

    • JOB_NAME 改為您的工作名稱。
    • IMAGE_URL,並參照容器映像檔,例如 us-docker.pkg.dev/cloudrun/container/job:latest
    • SIZE 替換為所需的記憶體大小。大小的格式為定點數或浮點數,後面加上單位 GM,分別對應於 GB 或 MB;或者是使用 2 的 n 次冪當量:GiMi,分別對應於 GiB 或 MiB。
  2. 如要在更新工作時設定記憶體限制,請按照下列步驟操作:

    gcloud run jobs update JOB_NAME --memory SIZE

YAML

  1. 如果您要建立新工作,請略過這個步驟。 如要更新現有工作,請下載其 YAML 設定

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

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

    SIZE 替換為所需的記憶體大小,至少須指定 512Mi。格式為定點數或浮點數,後面加上單位 GM,分別對應於 GB 或 MB;或者是使用 2 的 n 次冪當量 GiMi,分別對應於 GiB 或 MiB。

    您也可以指定更多設定,例如環境變數或記憶體限制。

  3. 更新現有工作設定:

    gcloud run jobs replace job.yaml

Terraform

如要瞭解如何套用或移除 Terraform 設定,請參閱「基本 Terraform 指令」。

在 Terraform 設定中,將下列項目新增至 google_cloud_run_v2_job 資源:

resource "google_cloud_run_v2_job" "default" {
  name     = "cloudrun-job"
  location = "REGION"
  deletion_protection = false

  template {
    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job"
        resources {
          limits = {
            cpu    = "2"
            memory = "SIZE"
          }
        }
      }
    }
  }
}

取代:

  • REGION 替換成 Google Cloud 地區。例如:europe-west1
  • SIZE,並指定至少 512Mi 的記憶體大小。格式為定點數或浮點數,後面加上單位 GM,分別對應於 GB 或 MB;或者是使用 2 的 n 次冪當量 GiMi,分別對應於 GiB 或 MiB。

查看記憶體限制設定

如要查看 Cloud Run 工作的目前記憶體限制設定,請按照下列步驟操作:

控制台

  1. 前往 Google Cloud 控制台的 Cloud Run 作業頁面:

    前往 Cloud Run jobs

  2. 按一下所需工作,開啟「工作詳細資料」頁面。

  3. 按一下「查看及編輯工作設定」

  4. 在設定詳細資料中找出記憶體限制設定。

gcloud

  1. 使用下列指令:

    gcloud run jobs describe JOB_NAME
  2. 在傳回的設定中找出記憶體限制設定。