将 Filestore 代理卷与自管理的 GKE 工作负载搭配使用

如果您在 Google Kubernetes Engine (GKE) 上运行标准 AI 智能体基准测试、开发环境或自动化流水线工作负载，则可以直接将标准 Kubernetes PersistentVolumeClaim (PVC) 和 Deployment 资源与 Filestore 智能体存储卷搭配使用。

此模式使用熟悉的 Kubernetes 资源定义，无需自定义沙盒控制器或 DaemonSet 资源。

准备工作

完成为 Filestore 代理卷设置 GKE 环境中的集群和 CSI 驱动程序设置。

创建一个 PersistentVolumeClaim

创建一个名为 agent-pvc.yaml 的清单，请求从您之前创建的 volume-pool-sc StorageClass 中获取存储空间：

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: agent-workspace-pvc
  namespace: default
spec:
  accessModes:
    - ReadWriteMany
  storageClassName: volume-pool-sc
  resources:
    requests:
      storage: 1Gi

应用清单：

kubectl apply -f agent-pvc.yaml

验证 PVC 是否转换为 Bound：

kubectl get pvc agent-workspace-pvc

输出类似于以下内容：

NAME                  STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS     AGE
agent-workspace-pvc   Bound    pvc-12345678-abcd-ef01-2345-6789abcdef01   1Gi        RWX            volume-pool-sc   5s

Filestore CSI 驱动程序会在不到一秒的时间内预配卷池中的新卷并绑定 PVC。

部署代理工作负载

创建名为 agent-deployment.yaml 的 Deployment 清单，该清单会挂载已绑定的 PVC：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: agent-worker
  namespace: default
  labels:
    app: agent-worker
spec:
  replicas: 1
  selector:
    matchLabels:
      app: agent-worker
  template:
    metadata:
      labels:
        app: agent-worker
    spec:
      containers:
        - name: worker
          image: busybox:latest
          command: ["/bin/sh", "-c"]
          args:
            - |
              echo "Agent worker started. Workspace mounted at /workspace:"
              ls -la /workspace
              echo "Writing benchmark results..."
              date > /workspace/run-status.txt
              cat /workspace/run-status.txt
              sleep infinity
          resources:
            requests:
              cpu: "250m"
              memory: "256Mi"
            limits:
              cpu: "500m"
              memory: "512Mi"
          volumeMounts:
            - name: workspace-storage
              mountPath: /workspace
      volumes:
        - name: workspace-storage
          persistentVolumeClaim:
            claimName: agent-workspace-pvc

应用清单：

kubectl apply -f agent-deployment.yaml

验证部署和文件访问权限

  1. 检查部署 pod 是否正在运行：

    kubectl get pods -l app=agent-worker

    输出类似于以下内容：

    NAME                            READY   STATUS    RESTARTS   AGE
agent-worker-6789bcdef-ghijk    1/1     Running   0          30s

  2. 检查容器日志，确认文件操作成功：

    kubectl logs -l app=agent-worker -c worker

    输出类似于以下内容：

    Agent worker started. Workspace mounted at /workspace:
total 8
drwxr-xr-x    2 root     root          4096 Sep 14 12:00 .
drwxr-xr-x    1 root     root          4096 Sep 14 12:00 ..
Writing benchmark results...
Mon Sep 14 12:00:05 UTC 2026

由于 Filestore 代理卷支持 ReadWriteMany (RWX) 访问，因此多个副本或不同的 Pod 可以同时装载同一 PVC，以实现协作式代理工作流。

后续步骤