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

控制台

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

   前往 Cloud Run

2. 從選單中選取「Services」(服務)，然後按一下「Deploy container」(部署容器)，即可設定新的服務。如果您要設定現有服務，請按一下該服務，然後點選「編輯並部署新修訂版本」。

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

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

   

   • 按一下「新增音量」。
   • 在「Volume type」下拉式選單中，選取 Cloud Storage bucket 做為音量類型。
   • 在「音量名稱」欄位中，輸入要使用的音量名稱。
   • 瀏覽並選取要用於磁碟區的 Cloud Storage 值區，或視需要建立新的值區。
   • 如要將資料集設為唯讀，請選取「唯讀」核取方塊。
   • 按一下 [完成]。
   • 按一下「Container」分頁標籤：
   • 按一下「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 值區名稱。

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

  --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 值區名稱。

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 值區名稱。

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 值區名稱。
• 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/hello:latest。如果您使用的是 Artifact Registry，則必須先建立存放區 REPO_NAME。網址的形狀為 LOCATION-docker.pkg.dev/PROJECT_ID/REPO_NAME/PATH:TAG
   • MOUNT_PATH 與掛接磁碟區的相對路徑，例如 /cache。
   • VOLUME_NAME 替換為您要為磁碟區取的任何名稱。VOLUME_NAME 值用於將磁碟區對應至磁碟區掛載點。
   • IS_READ_ONLY 搭配 True 可將資料夾設為唯讀，搭配 False 則可允許寫入。
   • BUCKET_NAME 與 Cloud Storage 值區名稱。
   • 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/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 值區名稱。
• 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. 在傳回的設定中找出「磁碟區掛接」設定。