配置用于服务的 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

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

控制台

1. 在 Google Cloud 控制台中，前往 Cloud Run 服务页面：

   转到 Cloud Run 作业

2. 点击您感兴趣的服务以打开“服务详细信息”页面。

3. 点击卷标签页。

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

gcloud

1. 使用以下命令：

   gcloud run services describe SERVICE_NAME

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