GKE-Cluster mit Pathways erstellen

Mit dem Cluster Toolkit können Sie vorkonfigurierte Google Kubernetes Engine-Cluster (GKE) für auf Pathways basierende Arbeitslasten erstellen. Sie können auch gcloud verwenden, um GKE-Cluster für Pathways-basierte Arbeitslasten manuell zu erstellen.

Hinweis

Sie benötigen Folgendes:

Lokale Umgebung einrichten

Melden Sie sich mit Ihren Google Cloud Anmeldedaten an.

gcloud auth application-default login

Definieren Sie die folgenden Umgebungsvariablen mit Werten, die für Ihren Arbeitslast geeignet sind.

GKE-Cluster erstellen

Im folgenden Beispiel erstellen Sie einen Cluster mit TPU v6e 2x4-Knotenpools. Sie können einen Cluster mit dem Cluster Toolkit oder der gcloud-Befehlszeile erstellen.

Cluster Toolkit

  1. Cluster Toolkit einrichten
  2. Stellen Sie einen GKE-TPU-Cluster bereit. Folgen Sie dazu der Anleitung unter GKE-TPU-v6e-Cluster bereitstellen. Eine Übersicht über alle TPU-Bereitstellungsoptionen finden Sie unter Cloud TPU-Bereitstellungen – Übersicht.

    Gehen Sie bei der Konfiguration Ihres Bereitstellungs-Blueprints so vor:

    • Achten Sie darauf, dass enable_pathways_for_tpus auf true festgelegt ist (in Cluster Toolkit-TPU-Blueprints standardmäßig aktiviert). Dadurch wird automatisch der erforderliche cpu-np-CPU-Knotenpool (n4-standard-64) und die Kueue-Konfigurationen für den Pathways-Controller bereitgestellt.
    • Legen Sie num_slices auf die Anzahl der TPU-Slice-Knotenpools fest, die für Ihre Arbeitslast erforderlich sind.
    • Legen Sie tpu_topology auf die ausgewählte TPU-Slice-Topologie fest (z. B. 2x4 oder 4x4).
    • Wenn Sie reservierte Kapazität verwenden, legen Sie reservation auf den Namen Ihrer TPU-Reservierung fest.

    Nachdem der Cluster erstellt wurde, können Sie Pathways-Arbeitslasten mit dem Befehl gcluster job submit und dem Flag --pathways einreichen.

gcloud

  1. Umgebungsvariablen festlegen

    CLUSTER=GKE_CLUSTER_NAME
    PROJECT=PROJECT_ID
    ZONE=ZONE
    REGION=REGION
    CLUSTER_VERSION=GKE_CLUSTER_VERSION
    PW_CPU_MACHINE_TYPE="n2-standard-64"
    NETWORK=NETWORK
    SUBNETWORK=SUB_NETWORK
    CLUSTER_NODEPOOL_COUNT=3
    TPU_MACHINE_TYPE="ct6e-standard-4t"
    WORKERS_PER_SLICE=2
    TOPOLOGY="2x4"
    NUM_CPU_NODES=1

    Ersetzen Sie Folgendes:

    • CLUSTER: der Name des GKE-Cluster
    • PROJECT_ID: Ihr Google Cloud Projektname
    • ZONE: die Zone, in der Sie Ressourcen erstellen
    • REGION: die Region, in der Sie Ressourcen erstellen
    • CLUSTER_VERSION: [Optional] die GKE-Clusterversion. Verwenden Sie 1.32.2-gke.1475000 oder höher.
    • NETWORK: [Optional] Legen Sie einen Namen für die Virtual Private Cloud fest. Diese muss vor dem Erstellen des Clusters erstellt werden.
    • SUBNETWORK: [Optional] Legen Sie einen Subnetzwerknamen fest. Das Subnetzwerk muss vor dem Erstellen des Clusters erstellt werden.

In den folgenden Schritten wird erläutert, wie Sie einen GKE-Cluster erstellen und für die Ausführung von Pathways-Arbeitslasten einrichten.

  1. Erstellen Sie einen GKE-Cluster.

    gcloud beta container clusters create ${CLUSTER} \
    --project=${PROJECT} \
    --zone=${ZONE} \
    --cluster-version=${CLUSTER_VERSION} \
    --scopes=storage-full,gke-default,cloud-platform \
    --machine-type ${PW_CPU_MACHINE_TYPE} \
    --network=${NETWORK} \
    --subnetwork=${SUBNETWORK}
    
  2. TPU-Knotenpools erstellen:

    for i in $(seq 1 ${CLUSTER_NODEPOOL_COUNT}); do
    gcloud container node-pools create "tpu-np-${i}" \
    --project=${PROJECT} \
    --zone=${ZONE} \
    --cluster=${CLUSTER} \
    --machine-type=${TPU_MACHINE_TYPE} \
    --num-nodes=${WORKERS_PER_SLICE} \
    --placement-type=COMPACT \
    --tpu-topology=${TOPOLOGY} \
    --scopes=storage-full,gke-default,cloud-platform \
    --workload-metadata=GCE_METADATA
    done
    
  3. CPU-Knotenpool erstellen:

    gcloud container node-pools create "cpu-pathways-np" \
    --project ${PROJECT} \
    --zone ${ZONE} \
    --cluster ${CLUSTER} \
    --machine-type ${PW_CPU_MACHINE_TYPE} \
    --num-nodes ${NUM_CPU_NODES} \
    --scopes=storage-full,gke-default,cloud-platform \
    --workload-metadata=GCE_METADATA
    
  4. JobSet API installieren

    Rufen Sie Anmeldedaten für den Cluster ab und fügen Sie sie Ihrem lokalen kubectl-Kontext hinzu.

    gcloud container clusters get-credentials ${CLUSTER} \
        [--zone=${ZONE} | --region=${REGION}] \
        --project=${PROJECT} \
        && kubectl config set-context --current --namespace=default
    

    Wenn Sie die Pathways-Architektur in Ihrem GKE-Cluster verwenden möchten, müssen Sie die JobSet API installieren.

    kubectl apply --server-side -f https://github.com/kubernetes-sigs/jobset/releases/download/v0.8.0/manifests.yaml
    

Nächste Schritte