為服務設定 NFS 磁碟區掛載

控制台

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

   前往 Cloud Run

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

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

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

   

   • 在「磁碟區」下方：
     • 按一下「新增磁碟區」。
     • 在「Volume type」(磁碟區類型) 下拉式選單中，選取「NFS」做為磁碟區類型。
     • 在「磁碟區名稱」欄位中，輸入要使用的磁碟區名稱。
     • 在「NFS server」(NFS 伺服器) 欄位中，輸入 NFS 檔案共用區的網域名稱或位置 (格式為 IP_ADDRESS)。
     • 在「路徑」欄位中，輸入要掛接的 NFS 伺服器目錄路徑。
     • 按一下 [完成]。
   • 按一下「容器」分頁，然後展開要掛接磁碟區的容器，即可編輯容器。
   • 按一下「Volume Mounts」分頁標籤。
   • 按一下「掛接磁碟區」。
   • 從選單中選取 NFS 磁碟區。
   • 指定要掛接磁碟區的路徑。
   • 按一下「掛接磁碟區」。

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

gcloud

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

  gcloud run services update SERVICE \
  --add-volume=name=VOLUME_NAME,type=nfs,location=IP_ADDRESS:NFS_PATH \
  --add-volume-mount=volume=VOLUME_NAME,mount-path=MOUNT_PATH

  取代：

  • SERVICE 改為您的服務名稱。
  • VOLUME_NAME 改成您要為磁碟區取的名稱。
  • IP_ADDRESS，並提供 NFS 檔案共用位置。
  • NFS_PATH，並以正斜線開頭，例如 /example-directory。
  • MOUNT_PATH，例如 /mnt/my-volume。
  • VOLUME_NAME 改成您要的磁碟區名稱。VOLUME_NAME 值用於將磁碟區對應至磁碟區掛接點。

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

  --add-volume=name=VOLUME_NAME,type=nfs,location=IP_ADDRESS:NFS_PATH,readonly=true

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

  gcloud run services update SERVICE \
  --add-volume=name VOLUME_NAME,type=nfs,location=IP_ADDRESS:NFS_PATH \
  --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. 視需要更新 MOUNT_PATH、VOLUME_NAME、IP_ADDRESS 和 NFS_PATH。如果您有多個磁碟區掛接點，就會有多個這類屬性。

   apiVersion: run.googleapis.com/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
           nfs:
             server: IP_ADDRESS
             path: NFS_PATH
             readOnly: IS_READ_ONLY

   取代

   • SERVICE 改為 Cloud Run 服務名稱
   • MOUNT_PATH，例如 /mnt/my-volume。
   • VOLUME_NAME 改成您要的磁碟區名稱。VOLUME_NAME 值用於將磁碟區對應至磁碟區掛接點。
   • IP_ADDRESS，並提供 NFS 檔案共用區的地址。
   • 將 NFS_PATH 替換為 NFS 檔案共用路徑，並以正斜線開頭，例如 /example-directory。
   • IS_READ_ONLY，並使用 True 將磁碟區設為唯讀，或使用 False 允許寫入。

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

   gcloud run services replace service.yaml

Terraform

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

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

  template {
    execution_environment = "EXECUTION_ENVIRONMENT_GEN2"
    containers {
      image = "us-docker.pkg.dev/cloudrun/container/hello"
      volume_mounts {
        name       = "VOLUME_NAME"
        mount_path = "MOUNT_PATH"
      }
    }
    vpc_access {
      network_interfaces {
        network    = "default"
        subnetwork = "default"
      }
    }
    volumes {
      name = "VOLUME_NAME"
      nfs {
        server    = google_filestore_instance.default.networks[0].ip_addresses[0]
        path      = "NFS_PATH"
        read_only = IS_READ_ONLY
      }
    }
  }
}

resource "google_filestore_instance" "default" {
  name     = "cloudrun-service-ro"
  location = "REGION"
  tier     = "BASIC_HDD"

  file_shares {
    capacity_gb = 1024
    name        = "share1"
  }

  networks {
    network = "default"
    modes   = ["MODE_IPV4"]
  }
}

取代：

• SERVICE 改為您的 Cloud Run 服務名稱。
• REGION 替換成 Google Cloud 地區。例如：europe-west1。
• MOUNT_PATH 替換為要掛接磁碟區的相對路徑，例如 /mnt/nfs/filestore。
• VOLUME_NAME 改成您要的磁碟區名稱。VOLUME_NAME 值用於將磁碟區對應至磁碟區掛接點。
• NFS_PATH，並以正斜線開頭，例如 /share1。
• IS_READ_ONLY，使用 True 將磁碟區設為唯讀，或使用 False 允許寫入。

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");