Zonale Cluster erstellen

Auf dieser Seite wird beschrieben, wie Sie einen zonalen Standardcluster mit den aktivierten Standardfunktionen in Google Kubernetes Engine (GKE) erstellen. Zonale Cluster haben eine einzige Steuerungsebeneninstanz in einer einzelnen Zone. Je nach Verfügbarkeitsanforderungen können Sie die Knoten für den zonalen Cluster in einer einzigen Zone oder in mehreren Zonen verteilen.

Best Practice: Führen Sie Produktionsarbeitslasten mit regionalen Clustern aus, da sie eine höhere Verfügbarkeit als zonale Cluster bieten. In einem regionalen Cluster wird die Steuerungsebene über mehrere Zonen in einer Region repliziert.

Diese Seite richtet sich an Operatoren, Cloud-Architekten und Entwickler, die Cluster erstellen und konfigurieren und Arbeitslasten in GKE bereitstellen müssen. Weitere Informationen zu gängigen Rollen und Beispielaufgaben, auf die wir in Google Cloud-Inhalten verweisen, finden Sie unter Häufig verwendete GKE-Nutzerrollen und -Aufgaben.

Machen Sie sich vor dem Lesen dieser Seite mit den Cluster-Konfigurationsoptionen vertraut.

Hinweis

Führen Sie die folgenden Aufgaben aus, bevor Sie beginnen:

  • Aktivieren Sie die Google Kubernetes Engine API.
  • Google Kubernetes Engine API aktivieren
  • Wenn Sie die Google Cloud CLI für diese Aufgabe verwenden möchten, müssen Sie die gcloud CLI installieren und dann initialisieren. Wenn Sie die gcloud CLI bereits installiert haben, rufen Sie die aktuelle Version mit dem Befehl gcloud components update ab. Ältere gcloud CLI-Versionen unterstützen möglicherweise nicht die Ausführung der Befehle in diesem Dokument.

IAM-Dienstkonten für GKE einrichten

Die GKE verwendet IAM-Dienstkonten, die an Ihre Knoten angehängt sind, um Systemaufgaben wie Logging und Monitoring auszuführen. Diese Knotendienstkonten müssen mindestens die Rolle Kubernetes Engine Default Node Service Account (roles/container.defaultNodeServiceAccount) für Ihr Projekt haben. Standardmäßig verwendet die GKE das Compute Engine-Standarddienstkonto, das automatisch in Ihrem Projekt erstellt wird, als Knotendienstkonto.

So weisen Sie dem Compute Engine-Standarddienstkonto die Rolle roles/container.defaultNodeServiceAccount zu:

Console

  1. Rufen Sie die Seite Willkommen auf:

    Zur Begrüßungsseite

  2. Klicken Sie im Feld Projektnummer auf In die Zwischenablage kopieren.
  3. Rufen Sie die IAM-Seite auf.

    IAM aufrufen

  4. Klicken Sie auf Zugriffsrechte erteilen.
  5. Geben Sie im Feld Neue Hauptkonten den folgenden Wert ein:
    PROJECT_NUMBER-compute@
    Ersetzen Sie PROJECT_NUMBER durch die kopierte Projektnummer.
  6. Wählen Sie im Menü Rolle auswählen die Rolle Kubernetes Engine Default Node Service Account aus.
  7. Klicken Sie auf Speichern.

gcloud

  1. So finden Sie Ihre Google Cloud Projektnummer:
    gcloud projects describe PROJECT_ID \
        --format="value(projectNumber)"

    Ersetzen Sie PROJECT_ID durch Ihre Projekt-ID.

    Die Ausgabe sieht etwa so aus:

    12345678901
    
  2. Weisen Sie dem Compute Engine-Standarddienstkonto die Rolle roles/container.defaultNodeServiceAccount zu:
    gcloud projects add-iam-policy-binding PROJECT_ID \
        --member="serviceAccount:PROJECT_NUMBER-compute@" \
        --role="roles/container.defaultNodeServiceAccount"

    Ersetzen Sie PROJECT_NUMBER durch die Projektnummer aus dem vorherigen Schritt.

Zonalen Cluster erstellen

Wenn Sie einen neuen zonalen Cluster erstellen, müssen Sie mindestens einen Namen, ein Projekt (normalerweise das aktuelle Projekt) und eine Zone (normalerweise den Standardstandort für Befehlszeilentools) angeben. Für alle anderen Werte werden die Standardeinstellungen verwendet. Es gibt jedoch weitere mögliche Konfigurationseinstellungen, von denen nur einige in diesem Abschnitt beschrieben werden und von denen einige nach dem Erstellen des Clusters nicht mehr geändert werden können. Sie sollten wissen, welche Einstellungen nach dem Erstellen des Clusters nicht mehr geändert werden können, und die richtige Einstellung beim Erstellen eines Clusters auswählen, wenn Sie ihn nicht noch einmal erstellen möchten.

Eine Übersicht über die Clusterkonfigurationsoptionen finden Sie unter Clusterkonfigurationsoptionen. Eine vollständige Liste der möglichen Optionen finden Sie in den Referenzhandbüchern zu gcloud container clusters create und Terraform google_container_cluster.

Sie können einen zonalen Cluster mit der gcloud CLI, derGoogle Cloud Console oder Terraform erstellen.

Wenn Sie GKE-Anwendungen mit Cloud Code for VS Code entwickeln, können Sie Cluster mit Cloud Code erstellen.

gcloud

Verwenden Sie einen der folgenden Befehle, um einen zonalen Cluster mit der gcloud CLI zu erstellen.

Dabei gilt:

  • CLUSTER_NAME: Der Name des neuen Clusters.
  • CHANNEL: Der Typ der Release-Version, entweder rapid, regular, stable oder None (eingestellt). Standardmäßig ist der Cluster für die Release-Version regular registriert.
  • CONTROL_PLANE_LOCATION: die Compute Engine-Zone der Steuerungsebene Ihres Clusters.
  • VERSION: Die Version, die Sie für den Cluster angeben möchten.
  • COMPUTE_ZONE,COMPUTE_ZONE1,[...]: Zonen, in denen Knoten erstellt werden. Sie können beliebig viele Zonen für Ihren Cluster angeben. Alle Zonen müssen sich in derselben Region befinden wie die Steuerungsebene des Clusters, die durch das Flag --location angegeben wird. Bei zonalen Clustern muss --node-locations die primäre Zone des Clusters enthalten.

Wir empfehlen dringend, ein IAM-Dienstkonto mit minimalen Berechtigungen anzugeben, das Ihre Knoten anstelle des Compute Engine-Standarddienstkontos verwenden können. Informationen zum Erstellen eines Dienstkontos mit minimalen Berechtigungen finden Sie unter Dienstkonto mit geringsten Berechtigungen verwenden.

Wenn Sie ein benutzerdefiniertes Dienstkonto in der gcloud CLI angeben möchten, fügen Sie Ihrem Befehl das folgende Flag hinzu:

--service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.

Ersetzen Sie SERVICE_ACCOUNT_NAME durch den Namen Ihres Dienstkontos mit minimalen Berechtigungen.

Verwendung einer bestimmten Release-Version:

Führen Sie den folgenden Befehl aus, um einen neuen Cluster mit einer bestimmten Release-Version zu erstellen:

gcloud container clusters create CLUSTER_NAME \
    --release-channel CHANNEL \
    --location CONTROL_PLANE_LOCATION \
    --node-locations COMPUTE_ZONE,COMPUTE_ZONE1

Bestimmte Version verwenden:

Führen Sie den folgenden Befehl aus, um einen neuen Cluster mit einer bestimmten Clusterversion zu erstellen:

gcloud container clusters create CLUSTER_NAME \
    --cluster-version VERSION \
    --location CONTROL_PLANE_LOCATION \
    --node-locations COMPUTE_ZONE,COMPUTE_ZONE1

Beispiel

Mit dem folgenden Befehl wird ein multizonaler Cluster mit dem Namen example-cluster erstellt, wobei sich die Cluster-Steuerungsebene in der Zone us-east4-a befindet und es drei Knotenstandorte gibt. Der Cluster ist in der Release-Version regular registriert.

Wird das Flag --num-nodes weggelassen, werden vom Cluster standardmäßig drei Knoten pro Zone erstellt. Da drei Zonen angegeben wurden, erstellt dieser Befehl einen neun Knoten umfassenden Cluster mit jeweils drei Knoten in us-east4-a, us-east4-b und us-east4-c. In GKE-Version 1.37.1-gke.1153000 und höher können Sie das Flag --num-nodes auf den Wert 0 setzen, um einen Cluster ohne Knoten zu erstellen.

gcloud container clusters create example-cluster \
    --location us-east4-a \
    --node-locations us-east4-a,us-east4-b,us-east4-c

Console

Führen Sie die folgenden Aufgaben aus, um einen zonalen Cluster mit der Google Cloud Console zu erstellen:

  1. Rufen Sie in der Google Cloud Console die Seite Kubernetes-Cluster erstellen auf.

    Zur Seite „Kubernetes-Cluster erstellen“

  2. Geben Sie im Bereich Clustergrundlagen Folgendes ein:

    1. Geben Sie den Namen für den Cluster ein.
    2. Wählen Sie als Standorttyp die Option Zonal und dann die gewünschte Zone für den Cluster aus.
    3. Wenn Sie einen multizonalen Cluster erstellen, klicken Sie das Kästchen Standardknotenstandorte angeben an und wählen Sie weitere Zonen aus, in denen die Knotenpools ausgeführt werden sollen.

    4. Release-Version auswählen Sie können optional Kein Versions-Kanal auswählen. Diese Konfigurationsoption wurde jedoch verworfen und wird entfernt. Weitere Informationen finden Sie unter Cluster, die nicht für eine Release-Version registriert sind.

    5. Optional: Geben Sie in der Drop-down-Liste Version eine Version der Steuerungsebene an.

  3. Optional: Konfigurieren Sie weitere Einstellungen für den neuen Cluster.

  4. Optional: Wenn Sie Ihren neuen Cluster bei einer Flotte registrieren möchten, rufen Sie den Abschnitt Erweiterte Einstellungen auf und folgen Sie der Anleitung in der Google Cloud Console für Neuen Cluster erstellen und registrieren, um die Clusterregistrierung abzuschließen.

  5. So erstellen und konfigurieren Sie eigene Knotenpools:

    1. Klicken Sie auf Knotenpool hinzufügen .
    2. Klicken Sie im Dialogfeld Änderungen erforderlich auf Änderungen vornehmen.

    Im Navigationsmenü wird ein Knotenpool mit dem Namen default-pool angezeigt.

  6. Optional: So erstellen Sie einen Cluster ohne Knotenpools:

    1. Klicken Sie im Navigationsmenü auf default-pool.
    2. Klicken Sie auf Knotenpool entfernen.
    3. Konfigurieren Sie die verbleibenden Einstellungen für den Cluster und klicken Sie dann auf Erstellen.
  7. Optional: Wenn Sie dem Cluster Knotenpools hinzufügen möchten, klicken Sie auf Knotenpool hinzufügen. Im Navigationsmenü wird ein neuer Knotenpool angezeigt.

  8. Konfigurieren Sie die grundlegenden Einstellungen für einen Knotenpool:

    1. Klicken Sie im Navigationsmenü im Abschnitt Knotenpools auf den Namen des Knotenpools. Die Seite Details zum nutzerverwalteten Knotenpool wird geöffnet.
    2. Geben Sie im Feld Name einen Namen für den Knotenpool ein.
    3. Geben Sie im Abschnitt Größe im Feld Anzahl der Knoten die Anzahl der zu erstellenden Knoten an. Sie müssen verfügbare Ressourcenkontingente für die Knoten und ihre Ressourcen (z. B. Firewallrouten) haben. In GKE-Version 1.37.1-gke.1153000 und höher können Sie einen leeren Knotenpool erstellen, indem Sie den Wert 0 angeben.
  9. Konfigurieren Sie die Einstellungen für die VM-Instanzen, auf denen die Knoten ausgeführt werden:

    1. Klicken Sie im Navigationsmenü im maximierten Bereich für den ausgewählten Knotenpool auf Knoten.
    2. Wählen Sie in der Drop-down-Liste Image-Typ das gewünschte Knoten-Image aus.
    3. Wählen Sie die Maschinenkonfiguration aus, die standardmäßig für die Instanzen verwendet werden soll. Jeder Maschinentyp wird unterschiedlich abgerechnet. Der Standardmaschinentyp ist e2-medium. Informationen zu Preisen von Maschinentypen finden Sie in der Preisübersicht für Maschinentypen.
    4. Wählen Sie in der Drop-down-Liste Bootlaufwerktyp den gewünschten Laufwerktyp aus.
    5. Geben Sie im Feld Größe des Bootlaufwerks eine Größe in GB für das Bootlaufwerk an.
  10. Konfigurieren Sie die Sicherheitseinstellungen für den Knotenpool:

    1. Klicken Sie im Navigationsmenü im maximierten Bereich für den ausgewählten Knotenpool auf Sicherheit.
    2. Optional können Sie ein benutzerdefiniertes IAM-Dienstkonto für Ihre Knoten angeben:
      1. Maximieren Sie auf der Seite Erweiterte Einstellungen den Abschnitt Sicherheit.
      2. Wählen Sie im Menü Dienstkonto das gewünschte Dienstkonto aus.

      Wir empfehlen dringend, ein IAM-Dienstkonto mit minimalen Berechtigungen anzugeben, das Ihre Knoten anstelle des Compute Engine-Standarddienstkontos verwenden können. Informationen zum Erstellen eines Dienstkontos mit minimalen Berechtigungen finden Sie unter Dienstkonto mit geringsten Berechtigungen verwenden.

  11. Klicken Sie auf Erstellen.

Terraform

Informationen zum Erstellen eines zonalen Clusters mit einem Einzelzonen-Knotenpool mit Terraform finden Sie im folgenden Beispiel:

resource "google_container_cluster" "default" {
  name               = "gke-standard-zonal-single-zone"
  location           = "us-central1-a"
  initial_node_count = 1
}

Informationen zum Erstellen eines zonalen Clusters mit einem Knotenpool mit mehreren Zonen mit Terraform finden Sie im folgenden Beispiel:

resource "google_container_cluster" "default" {
  name               = "gke-standard-zonal-multi-zone"
  location           = "us-central1-a"
  node_locations     = ["us-central1-b", "us-central1-c"]
  initial_node_count = 2
}

Weitere Informationen zur Verwendung von Terraform finden Sie unter Terraform-Unterstützung für GKE.

Mit kubectl mit einem Cluster interagieren

Nachdem Sie einen Cluster erstellt haben, müssen Sie kubectl konfigurieren, bevor Sie über die Befehlszeile mit dem Cluster interagieren können.

Zonalen Cluster ohne Knoten erstellen

In GKE-Version 1.37.1-gke.1153000 und höher können Sie einen zonalen Cluster ohne Knoten auf eine der folgenden Arten erstellen:

  • Erstellung des Standardknotenpools überspringen: GKE fügt dem Cluster keine Knotenpools hinzu. Wenn Sie Arbeitslasten mit Autopilot-ComputeClasses, automatischer Knotenpoolerstellung oder benutzerdefinierten Knotenpools ausführen möchten, die Sie später erstellen, verwenden Sie diese Option.
  • Leeren Knotenpool erstellen: GKE erstellt einen Knotenpool ohne Knoten. Verwenden Sie diese Option, wenn Sie die Einstellungen des Knotenpools während der Clustererstellung anpassen möchten, ohne die eigentlichen Knoten zu erstellen.

Wenn Sie einen Cluster ohne Knoten erstellen, bleiben System-Pods in einem nicht planbaren Zustand, bis mindestens ein Knoten im Cluster vorhanden ist. Wählen Sie eine der folgenden Optionen aus, um einen zonalen Cluster ohne Knoten zu erstellen:

gcloud

  • Wenn Sie das Erstellen des Standardknotenpools überspringen möchten, verwenden Sie im Befehl gcloud container clusters create nur das Flag --num-nodes=0:

    gcloud container clusters create CLUSTER_NAME \
        --location=CONTROL_PLANE_LOCATION \
        --num-nodes=0
    

    Ersetzen Sie Folgendes:

    • CLUSTER_NAME: Der Name Ihres neuen zonalen Clusters.
    • CONTROL_PLANE_LOCATION: die Compute Engine-Zone der Steuerungsebene des Clusters, z. B. us-central1-a.

    Wenn Sie andere Flags für die Knotenpoolkonfiguration angeben, z. B. die Flags --machine-type, --disk-type oder --disk-size, schlägt der Befehl fehl, da kein Knotenpool für die GKE-Konfiguration vorhanden ist.

  • Verwenden Sie zum Erstellen eines Clusters mit einem leeren Knotenpool das Flag --num-nodes=0 und das Flag --node-pool-name im Befehl gcloud container clusters create:

    gcloud container clusters create CLUSTER_NAME \
        --location=CONTROL_PLANE_LOCATION \
        --num-nodes=0 \
        --node-pool-name=NODEPOOL_NAME
    

    Ersetzen Sie NODEPOOL_NAME durch einen Namen für den leeren Knotenpool. Sie können andere Flags für die Knotenkonfiguration angeben, um die Knoten im leeren Knotenpool anzupassen.

Console

  1. Rufen Sie in der Google Cloud Console die Seite Kubernetes-Cluster erstellen auf.

    Zur Seite „Kubernetes-Cluster erstellen“

  2. Geben Sie einen Namen für den Cluster an.

  3. Wählen Sie im Abschnitt Standorttyp die Option Zonal aus.

  4. Wählen Sie in der Drop-down-Liste Zone eine Zone für die Steuerungsebene des Clusters aus.

  5. Überspringen Sie das Erstellen des Standardknotenpools oder erstellen Sie einen leeren Knotenpool:

    • Wenn Sie die Erstellung des Standardknotenpools überspringen möchten, prüfen Sie im Abschnitt Standardmodus, ob die Option Autopilot ausgewählt ist. Alternativ können Sie die Erstellung des Standardknotenpools auslösen und ihn dann entfernen:

      1. Klicken Sie auf Knotenpool hinzufügen.
      2. Klicken Sie im Dialogfeld Änderungen erforderlich auf Änderungen vornehmen. Ein Knotenpool mit dem Namen default-pool wird angezeigt.
      3. Klicken Sie im Navigationsmenü auf default-pool.
      4. Klicken Sie auf Knotenpool entfernen.

      Mit diesen Schritten wird ein Cluster ohne Knotenpools erstellt, der den Autopilot-Modus verwendet, um Arbeitslasten auszuführen, die keine ComputeClass auswählen. Sie können die Verwendung des Autopilot-Modus auch verhindern, indem Sie im Abschnitt Standardmodus die Option Nutzerverwalteter Knotenpool auswählen.

    • So erstellen Sie einen leeren Knotenpool:

      1. Klicken Sie auf Knotenpool hinzufügen.
      2. Klicken Sie im Dialogfeld Änderungen erforderlich auf Änderungen vornehmen. Ein Knotenpool mit dem Namen default-pool wird angezeigt.
      3. Klicken Sie im Navigationsmenü auf default-pool.
      4. Geben Sie im Feld Anzahl der Knoten den Wert 0 an.
  6. Konfigurieren Sie die verbleibenden Einstellungen für den Cluster und klicken Sie dann auf Erstellen.

Terraform

  • Wenn Sie das Erstellen des Standardknotenpools überspringen möchten, setzen Sie in Ihrer google_container_cluster-Ressource das Feld initial_node_count auf den Wert 0.
  • So erstellen Sie einen leeren anfänglichen Knotenpool:

    1. Legen Sie in der Ressource google_container_cluster für das Feld initial_node_count den Wert 0 fest.
    2. Fügen Sie eine google_container_node_pool-Ressource hinzu und legen Sie für das Feld node_count den Wert 0 fest.

Nachdem Sie einen Cluster ohne Knoten erstellt haben, können Sie Knoten auf folgende Weise bereitstellen:

Clustervorlagen

GKE unterstützte zuvor Vorlagen für Cluster. Diese Vorlagen wurden aus der Google Cloud Console entfernt, sind aber weiterhin über die folgenden Links zugänglich:

Nächste Schritte