GKE-Umgebung für Filestore-Agent-Volumes einrichten

Filestore-Agent-Volumes lassen sich in die Google Kubernetes Engine (GKE) einbinden und bieten nichtflüchtigen Dateispeicher mit hoher Dichte und niedriger Latenz für zustandsorientierte KI-Agent-Sandboxes, Entwicklungsumgebungen und Multi-Agent-Workflows.

In dieser Anleitung werden die Voraussetzungen beschrieben, die für die Verwendung von Filestore-Agent-Volumes in GKE erforderlich sind.

Hinweis

  1. Führen Sie die Ersteinrichtung unter Filestore-Agent-Volumes einrichten aus.

  2. Aktivieren Sie die GKE API:

    gcloud services enable container.googleapis.com \
    --project=PROJECT_ID

  3. Installieren Sie die erforderlichen Komponenten für gcloud:

    gcloud components install kubectl gke-gcloud-auth-plugin

GKE-Cluster erstellen

Erstellen Sie einen GKE-Cluster, der mit Ihrem Private Service Connect verbunden ist.

gcloud container clusters create CLUSTER_NAME \
    --region=REGION \
    --project=PROJECT_ID \
    --network=projects/PROJECT_ID/global/networks/VPC_NETWORK \
    --subnetwork=SUBNET_NAME \
    --num-nodes=3 \
    --workload-pool=PROJECT_ID.s3ns.svc.id.goog \
    --scopes=cloud-platform \
    --enable-agent-sandbox \
    --addons=GcpFilestoreCsiDriver=DISABLED \
    --cluster-version=1.36.0-gke.3302001

Ersetzen Sie Folgendes:

  • CLUSTER_NAME: der Name des neuen Clusters.
  • REGION: die Region, in der sich Ihr Volume-Pool befindet, z. B. us-central1.
  • PROJECT_ID: Ihre Cloud de Confiance by S3NS Projekt-ID.
  • VPC_NETWORK: der Name Ihres VPC-Netzwerk mit aktivierter PSC.
  • SUBNET_NAME: der Name des Subnetzes.

Workload Identity Federation for GKE und IAM einrichten

Erteilen Sie dem Kubernetes-Dienstkonto, das vom CSI-Treiber verwendet wird, und dem Compute Engine-Standarddienstkonto Berechtigungen zum Bereitstellen von Filestore-Volumes:

  1. Rufen Sie Ihre Projektnummer ab:

    gcloud projects describe PROJECT_ID \
    --format="value(projectNumber)"

    Ersetzen Sie PROJECT_ID durch Ihre Projekt-ID.

  2. Weisen Sie dem Kubernetes-Dienstkonto (gcp-filestore-csi-controller-sa) im Namespace gcp-filestore-csi-driver die Rolle „Cloud Filestore-Bearbeiter“ (roles/file.editor) für das Projekt zu:

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/PROJECT_ID.s3ns.svc.id.goog/subject/ns/gcp-filestore-csi-driver/sa/gcp-filestore-csi-controller-sa" \
    --role="roles/file.editor" \
    --condition=None

    Ersetzen Sie Folgendes:

    • PROJECT_ID: Ihre Cloud de Confiance by S3NS Projekt-ID.
    • PROJECT_NUMBER: Ihre Cloud de Confiance by S3NS Projektnummer.

  3. Weisen Sie dem Compute Engine-Standarddienstkonto die Rolle „Cloud Filestore-Bearbeiter“ (roles/file.editor) für das Projekt zu:

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member="serviceAccount:PROJECT_NUMBER-compute@developer.s3ns-system.iam.gserviceaccount.com" \
    --role="roles/file.editor" \
    --condition=None

Filestore-CSI-Treiber bereitstellen

  1. Rufen Sie die Clusteranmeldedaten ab:

    gcloud container clusters get-credentials CLUSTER_NAME \
    --region=REGION \
    --project=PROJECT_ID

  2. Klonen Sie das Treiber-Repository und wenden Sie das volumepool-Overlay an:

    git clone https://github.com/kubernetes-sigs/gcp-filestore-csi-driver.git
cd gcp-filestore-csi-driver
kubectl apply -k deploy/kubernetes/overlays/volumepool

  3. Prüfen Sie, ob die CSI-Treiber-Pods ausgeführt werden:

    kubectl get pods -n gcp-filestore-csi-driver

    Die Ausgabe sieht etwa so aus:

    NAME                             READY   STATUS    RESTARTS   AGE
gcp-filestore-csi-controller-0   5/5     Running   0          2m
gcp-filestore-csi-node-abcde     3/3     Running   0          2m

StorageClass für Ihren Volume-Pool anwenden

Damit Ihre GKE-Arbeitslasten Volumes dynamisch aus Ihrem Volume-Pool bereitstellen können, wenden Sie eine Kubernetes-StorageClass auf Ihren Cluster an.

Wenn Sie das Manifest volume-pool-sc.yaml bereits unter Filestore-Agent-Volumes einrichten, erstellt haben, fahren Sie mit Schritt 2 fort.

  1. Erstellen Sie eine Datei mit dem Namen volume-pool-sc.yaml und der folgenden Konfiguration:

    apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: volume-pool-sc
provisioner: filestore.csi.storage.gke.io
parameters:
  volume-pool: "projects/<var>PROJECT_ID</var>/locations/<var>LOCATION</var>/volumePools/<var>VOLUME_POOL_ID</var>"
mountOptions:
  - vers=3
  - proto=tcp
  - mountproto=tcp
  - port=2049
  - mountport=2050
volumeBindingMode: Immediate
reclaimPolicy: Delete

    Ersetzen Sie Folgendes:

    • PROJECT_ID: die ID Ihres Cloud de Confiance Projekts.
    • LOCATION: die Region, in der Ihr Volume-Pool bereitgestellt wird, z. B. us-central1.
    • VOLUME_POOL_ID: die ID Ihres Volume-Pools.

  2. Wenden Sie das Manifest an:

    kubectl apply -f volume-pool-sc.yaml

  3. Prüfen Sie, ob die StorageClass verfügbar ist:

    kubectl get storageclass volume-pool-sc

    Die Ausgabe sieht etwa so aus:

    NAME             PROVISIONER                    RECLAIMPOLICY   VOLUMEBINDINGMODE   ALLOWVOLUMEEXPANSION   AGE
volume-pool-sc   filestore.csi.storage.gke.io   Delete          Immediate           true                   1m

Nach Abschluss dieser Anleitung ist Ihre GKE-Umgebung bereit für die Unterstützung von Filestore-Agent-Volumes.

Nächste Schritte

Nachdem Sie Ihren GKE-Cluster und die StorageClass konfiguriert haben, können Sie zustandsorientierte KI-Agent-Arbeitslasten mit einem der folgenden Orchestrierungsmuster bereitstellen: