Utilizzare i volumi dell'agente Filestore con i carichi di lavoro GKE autogestiti

Se esegui benchmark standard degli agenti AI, ambienti di sviluppo o workload di pipeline automatizzati su Google Kubernetes Engine (GKE), puoi utilizzare direttamente le risorse PersistentVolumeClaim (PVC) e Deployment standard di Kubernetes con i volumi dell'agente Filestore.

Questo pattern utilizza definizioni di risorse Kubernetes familiari senza richiedere controller di sandboxing personalizzati o risorse DaemonSet.

Prima di iniziare

Completa la configurazione del cluster e del driver CSI in Configurare l'ambiente GKE per i volumi dell'agente Filestore.

Crea un PersistentVolumeClaim

Crea un manifest denominato agent-pvc.yaml che richieda l'archiviazione da volume-pool-sc StorageClass che hai creato in precedenza:

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

Applica il manifest:

kubectl apply -f agent-pvc.yaml

Verifica che il PVC passi a Bound:

kubectl get pvc agent-workspace-pvc

L'output è simile al seguente:

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

Il driver CSI Filestore esegue il provisioning di un nuovo volume nel pool di volumi in meno di un secondo e associa il PVC.

Esegui il deployment di un carico di lavoro dell'agente

Crea un manifest di deployment denominato agent-deployment.yaml che monta la PVC associata:

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

Applica il manifest:

kubectl apply -f agent-deployment.yaml

Verifica il deployment e l'accesso ai file

  1. Verifica che il pod di deployment sia in esecuzione:

    kubectl get pods -l app=agent-worker

    L'output è simile al seguente:

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

  2. Controlla i log dei container per confermare l'esito positivo delle operazioni sui file:

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

    L'output è simile al seguente:

    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

Poiché i volumi dell'agente Filestore supportano l'accesso ReadWriteMany (RWX), più repliche o pod distinti possono montare contemporaneamente lo stesso PVC per i flussi di lavoro degli agenti collaborativi.

Passaggi successivi