为 Cloud Run 服务配置 Cloud Storage 卷装载

控制台

1. 在 Google Cloud 控制台中，前往 Cloud Run：

   转到 Cloud Run

2. 从菜单中选择服务，然后点击部署容器以配置新服务。如果您要配置现有服务，请点击该服务，然后点击修改和部署新的修订版本。

3. 如果您要配置新服务，请填写初始服务设置页面，然后点击容器、卷、网络、安全性以展开服务配置页面。

4. 点击卷标签页。

   

   • 点击添加卷。
   • 在卷类型下拉列表中，选择 Cloud Storage 存储桶作为卷类型。
   • 在卷名称字段中，输入要用于卷的名称。
   • 浏览并选择要用于卷的 Cloud Storage 存储桶，或视需要创建新的存储桶。
   • 如果您要将存储桶设为只读，请选中“只读”复选框。
   • 点击完成。
   • 点击容器标签页：
   • 点击卷装载标签页。
   • 点击装载卷。
   • 从菜单中选择存储卷。
   • 指定您要用于装载卷的路径。
   • 点击完成。

5. 点击创建或部署。

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/worker-pool:latest
   • 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/worker-pool:latest
• 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. 在服务列表中，点击您感兴趣的服务以打开“服务详细信息”页面。

3. 点击卷标签页。

4. 在卷详情页面中找到卷装载设置。

gcloud

1. 使用以下命令：

   gcloud run services describe SERVICE_NAME

2. 在返回的配置中找到卷装载设置。