為 Cloud Run 服務設定 Cloud Storage 磁碟區掛載

控制台

1. 前往 Google Cloud 控制台的 Cloud Run：

   前往 Cloud Run

2. 從選單中選取「服務」，然後按一下「部署容器」，設定新服務。如要設定現有服務，請按一下該服務，然後點選「編輯並部署新修訂版本」。

3. 如要設定新服務，請填寫初始服務設定頁面，然後按一下「容器、磁碟區、網路與安全性」，展開服務設定頁面。

4. 按一下「Volumes」(磁碟區) 分頁標籤。

   

   • 按一下「新增音量」。
   • 在「Volume type」(磁碟區類型) 下拉式選單中，選取 Cloud Storage bucket 做為磁碟區類型。
   • 在「磁碟區名稱」欄位中，輸入要使用的磁碟區名稱。
   • 瀏覽並選取要用於磁碟區的 Cloud Storage bucket，或視需要建立新的 bucket。
   • 如要將 bucket 設為唯讀，請選取「唯讀」核取方塊。
   • 按一下 [完成]。
   • 按一下「容器」分頁標籤：
   • 按一下「Volume Mounts」分頁標籤。
   • 按一下「掛接磁碟區」。
   • 從選單中選取儲存空間磁碟區。
   • 指定要掛接磁碟區的路徑。
   • 然後按一下 [完成]。

5. 按一下 [Create] (建立) 或 [Deploy] (部署)。

gcloud

• 如要新增磁碟區並掛接，請按照下列步驟操作：

  gcloud run services update SERVICE \
  --add-volume name=VOLUME_NAME,type=cloud-storage,bucket=BUCKET_NAME \
  --add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH

  取代：

  • SERVICE 改為您的服務名稱。
  • MOUNT_PATH，例如 /mnt/my-volume。
  • VOLUME_NAME 改成您要的磁碟區名稱。VOLUME_NAME 值用於將磁碟區對應至磁碟區掛接點。
  • BUCKET_NAME 改成您的 Cloud Storage bucket 名稱。

• 如要將磁碟區掛接為唯讀磁碟區，請按照下列步驟操作：

  --add-volume=name=VOLUME_NAME,type=cloud-storage,bucket=BUCKET_NAME,readonly=true

• 如果您使用多個容器，請先指定磁碟區，然後為每個容器指定磁碟區掛接：

  gcloud run services update SERVICE \
  --add-volume name=VOLUME_NAME,type=cloud-storage,bucket=BUCKET_NAME \
  --container CONTAINER_1 \
  --add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH \
  --container CONTAINER_2 \
  --add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH2

YAML

1. 如要建立新服務，請略過這個步驟。 如要更新現有服務，請下載其 YAML 設定：

   gcloud run services describe SERVICE --format export > service.yaml

2. 視需要更新。

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
   spec:
     template:
       metadata:
         annotations:
           run.googleapis.com/execution-environment: gen2
       spec:
         containers:
         - image: IMAGE_URL
           volumeMounts:
           - name: VOLUME_NAME
             mountPath: MOUNT_PATH
         volumes:
         - name: VOLUME_NAME
           csi:
             driver: gcsfuse.run.googleapis.com
             readOnly: IS_READ_ONLY
             volumeAttributes:
               bucketName: BUCKET_NAME

   取代

   • IMAGE_URL，並參照容器映像檔，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。如果您使用 Artifact Registry，則必須先建立存放區 REPO_NAME。網址的格式為 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
   • MOUNT_PATH，例如 /mnt/my-volume。
   • VOLUME_NAME 改成您要的磁碟區名稱。VOLUME_NAME 值用於將磁碟區對應至磁碟區掛接點。
   • IS_READ_ONLY，並使用 True 將磁碟區設為唯讀，或使用 False 允許寫入。
   • BUCKET_NAME 改成 Cloud Storage bucket 的名稱。

3. 使用下列指令建立或更新服務：

   gcloud run services replace service.yaml

Terraform

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

  resource "google_cloud_run_v2_service" "default" {
    name     = "SERVICE"
    location = "REGION"

    template {
      containers {
        image = "IMAGE_URL"
        volume_mounts {
          name = "VOLUME_NAME"
          mount_path = "MOUNT_PATH"
        }
      }

      volumes {
        name = "VOLUME_NAME"
        gcs {
          bucket = google_storage_bucket.default.name
          read_only = IS_READ_ONLY
        }
      }
    }
  }

  resource "google_storage_bucket" "default" {
    name     = "BUCKET_NAME"
    location = "REGION"
  }

取代：

• SERVICE 改為您的 Cloud Run 服務名稱。
• REGION 替換成 Google Cloud 地區。
• IMAGE_URL，並參照容器映像檔，例如 us-docker.pkg.dev/cloudrun/container/hello:latest。如果您使用 Artifact Registry，則必須先建立存放區 REPO_NAME。網址的格式為 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
• VOLUME_NAME 改成您要的磁碟區名稱。VOLUME_NAME 值用於將磁碟區對應至磁碟區掛接點。
• MOUNT_PATH 替換為要掛接磁碟區的相對路徑，例如 /mnt/my-volume。
• IS_READ_ONLY，使用 True 將磁碟區設為唯讀，或使用 False 允許寫入。
• BUCKET_NAME 改成 Cloud Storage bucket 的名稱。

NodeJS

使用檔案系統模組，在磁碟區中建立新檔案或附加至現有檔案，/mnt/my-volume：

var fs = require('fs');
fs.appendFileSync('/mnt/my-volume/sample-logfile.txt', 'Hello logs!', { flag: 'a+' });

Python

寫入磁碟區中保留的檔案 /mnt/my-volume：

f = open("/mnt/my-volume/sample-logfile.txt", "a")

Go

使用 os 套件建立新檔案，並保留在磁碟區中：/mnt/my-volume

f, err := os.Create("/mnt/my-volume/sample-logfile.txt")

Java

使用 Java.io.File 類別在磁碟區中建立記錄檔 /mnt/my-volume：

import java.io.File;
File f = new File("/mnt/my-volume/sample-logfile.txt");

gcloud

如要新增磁碟區並使用掛接選項掛接，請按照下列步驟操作：

gcloud beta run services update SERVICE \
    --execution-environment gen2 \
    --add-volume name=VOLUME_NAME,type=cloud-storage,bucket=BUCKET_NAME,mount-options="OPTION_1=VALUE_1;OPTION_N=VALUE_N" \
    --add-volume-mount volume=VOLUME_NAME,mount-path=MOUNT_PATH

取代：

• SERVICE 改為您的服務名稱。
• VOLUME_NAME 改成您要的磁碟區名稱。VOLUME_NAME 值用於將磁碟區對應至磁碟區掛接點。
• BUCKET_NAME 改成您的 Cloud Storage bucket 名稱。
• OPTION_1，並選擇第一個掛接選項。請注意，您可以指定任意數量的掛接選項，但每個掛接選項和值配對之間必須以半形分號分隔。
• VALUE_1，並將第一個掛接選項設為所需設定。
• OPTION_N 下一個掛接選項。
• VALUE_N，並設定下一個掛接選項。
• MOUNT_PATH，例如 /cache。

YAML

1. 如要建立新服務，請略過這個步驟。 如要更新現有服務，請下載其 YAML 設定：

   gcloud run services describe SERVICE --format export > service.yaml

2. 視需要更新。

   apiVersion: serving.knative.dev/v1
   kind: Service
   metadata:
     name: SERVICE
     annotations:
       run.googleapis.com/launch-stage: BETA
   spec:
     template:
       metadata:
         annotations:
           run.googleapis.com/execution-environment: gen2
       spec:
         containers:
         - image: IMAGE_URL
           volumeMounts:
           - name: VOLUME_NAME
             mountPath: MOUNT_PATH
         volumes:
         - name: VOLUME_NAME
           csi:
             driver: gcsfuse.run.googleapis.com
             readOnly: IS_READ_ONLY
             volumeAttributes:
               bucketName: BUCKET_NAME
               mountOptions: OPTION_1=VALUE_1,OPTION_N=VALUE_N

   取代

   • IMAGE_URL，並參照內含工作站集區的容器映像檔，例如 us-docker.pkg.dev/cloudrun/container/worker-pool:latest
   • MOUNT_PATH，例如 /cache。
   • VOLUME_NAME 改成您要的磁碟區名稱。VOLUME_NAME 值用於將磁碟區對應至磁碟區掛接點。
   • IS_READ_ONLY，並使用 True 將磁碟區設為唯讀，或使用 False 允許寫入。
   • BUCKET_NAME 改成 Cloud Storage bucket 的名稱。
   • OPTION_1，並選擇第一個掛接選項。請注意，您可以指定任意數量的掛接選項，並以半形逗號分隔每個掛接選項和值配對。
   • VALUE_1，並將第一個掛接選項設為所需設定。
   • OPTION_N 下一個掛接選項。
   • VALUE_N，並設定下一個掛接選項。

3. 使用下列指令建立或更新服務：

   gcloud run services replace service.yaml

Terraform

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

  resource "google_cloud_run_v2_service" "default" {
    provider = google-beta
    name     = "SERVICE"
    location = "REGION"

    template {
      containers {
        image = "IMAGE_URL"
        volume_mounts {
          name = "VOLUME_NAME"
          mount_path = "MOUNT_PATH"
        }
      }

      volumes {
        name = "VOLUME_NAME"
        gcs {
            bucket = google_storage_bucket.default.name
            read_only = IS_READ_ONLY
            mount_options = ["OPTION_1=VALUE_1", "OPTION_N=VALUE_N", "OPTION_O"]
        }
      }
    }
  }

取代：

• SERVICE 改為您的 Cloud Run 服務名稱。
• REGION 替換成 Google Cloud 地區。
• IMAGE_URL，並參照內含工作站集區的容器映像檔，例如 us-docker.pkg.dev/cloudrun/container/worker-pool:latest
• VOLUME_NAME 改成您要的磁碟區名稱。VOLUME_NAME 值用於將磁碟區對應至磁碟區掛接點。
• MOUNT_PATH 替換為要掛接磁碟區的相對路徑，例如 /mnt/my-volume。
• IS_READ_ONLY，使用 True 將磁碟區設為唯讀，或使用 False 允許寫入。
• BUCKET_NAME 改成 Cloud Storage bucket 的名稱。
• OPTION_1，並選擇第一個掛接選項。請注意，您可以指定任意數量的掛接選項，並以半形逗號分隔每個掛接選項和值配對。
• VALUE_1，並將第一個掛接選項設為所需設定。
• OPTION_N (如適用)。
• VALUE_N，並設定第二個掛接選項。
• OPTION_O (如適用)。部分掛接選項沒有值。

控制台

1. 前往 Google Cloud 控制台的 Cloud Run 服務頁面：

   前往 Cloud Run

2. 在服務清單中，按一下您感興趣的服務，開啟「Service details」(服務詳細資料) 頁面。

3. 按一下「Volumes」(磁碟區) 分頁標籤。

4. 在磁碟區詳細資料頁面中找到「磁碟區掛接」設定。

gcloud

1. 使用下列指令：

   gcloud run services describe SERVICE_NAME

2. 在傳回的設定中找到「磁碟區掛接」設定。