Regionale Cluster erstellen

Standard

In diesem Dokument wird gezeigt, wie ein regionaler Standardcluster erstellt wird, um die Verfügbarkeit der Steuerungsebene und der Arbeitslasten während Clusterupgrades, automatisierter Wartungsarbeiten oder einer zonalen Unterbrechung zu erhöhen.

Autopilot-Cluster von GKE sind immer regional.

Übersicht

Wenn Sie einen regionalen Cluster statt eines zonalen Clusters erstellen, wird die Steuerungsebene des Clusters in mehreren Zonen einer bestimmten Region repliziert. Für Knotenpools in einem regionalen Cluster können Sie manuell die Zone(n) angeben, in der/denen die Knotenpools ausgeführt werden sollen, oder Sie können die Standardkonfiguration verwenden, bei der jeder Knotenpool über drei Zonen der Region der Steuerungsebene repliziert wird. Alle Zonen müssen sich in derselben Region wie die Steuerungsebene des Clusters befinden.

Regionale Cluster replizieren Ressourcen in mehreren Zonen und verbrauchen zusätzliche Kontingente.

Weitere Informationen zu den verschiedenen Clusterverfügbarkeitstypen finden Sie unter Clusterkonfigurationsoptionen.

In folgenden Abschnitten wird Folgendes beschrieben:

Regionalen Cluster mit einem Einzelzonenknotenpool erstellen
Regionalen Cluster mit einem Mehrzonenknotenpool erstellen.

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 neueste Version mit gcloud components update ab.
Hinweis: Legen Sie für vorhandene Installationen der gcloud CLI die compute/region- und compute/zone-Attribute fest. Durch das Festlegen von Standardspeicherorten können Sie in der gcloud CLI Fehler wie One of [--zone, --region] must be supplied: Please specify location vermeiden.

Prüfen Sie, ob Sie die erforderlichen Berechtigungen zum Erstellen von Clustern haben. Sie sollten mindestens ein Kubernetes Engine-Cluster-Administrator sein.
Wenn Sie Ihren neuen Cluster bei einer Flotte registrieren möchten, benötigen Sie die erforderlichen APIs und Berechtigungen.

Regionalen Cluster mit einem Einzelzonen-Knotenpool erstellen

In der folgenden Anleitung wird beschrieben, wie Sie einen regionalen Cluster mit einem Knotenpool erstellen, der in einer einzelnen Zone innerhalb der Region ausgeführt wird. Die Steuerungsebene des Clusters wird in mehreren Zonen der angegebenen Region repliziert. Die Knoten befinden sich jedoch in einer einzelnen Zone und werden nicht in andere Zonen repliziert.

Sie können den Cluster mit der gcloud CLI, der Google Cloud Console oder Terraform erstellen.

Wenn Sie GKE-Anwendungen mit Cloud Code für VS Code entwickeln, erstellen Sie Cluster mit Cloud Code.

gcloud

Verwenden Sie zum Erstellen eines regionalen Clusters mit der gcloud CLI einen der folgenden Befehle und ersetzen Sie folgende Variablen:

CLUSTER_NAME: Der Name Ihres neuen regionalen Clusters.
COMPUTE_REGION: Die Region für Ihren Cluster, z. B. us-central1.
COMPUTE_ZONE sind die Zonen für Ihren Knotenpool, z. B. us-central1-a Die Zone muss sich in derselben Region wie die Steuerungsebene des Clusters befinden.
CHANNEL: Der Typ der Release-Version, entweder rapid, regular, stable oder None. Standardmäßig wird der Cluster in der Release-Version regular registriert, es sei denn, mindestens eines der folgenden Flags ist angegeben: --cluster-version, --release-channel, --no-enable-autoupgrade und --no-enable-autorepair.
VERSION: Die Version, die Sie für den Cluster angeben möchten.

In den folgenden Befehlen können Sie optional das Flag --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com verwenden, um ein anderes IAM-Dienstkonto anzugeben, das Knoten im ersten Knotenpool Ihres Clusters anstelle des Compute Engine-Standarddienstkontos verwendet. Dieses Flag ist optional. Wir empfehlen jedoch dringend, ein Dienstkonto mit minimalen Berechtigungen zu erstellen und zu verwenden, damit die Knoten nicht mehr Berechtigungen haben, als sie benötigen.

Verwendung einer bestimmten Release-Version:

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

gcloud container clusters create CLUSTER_NAME \
    --region COMPUTE_REGION \
    --node-locations COMPUTE_ZONE \
    --release-channel CHANNEL

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 \
    --region COMPUTE_REGION \
    --node-locations COMPUTE_ZONE \
    --cluster-version VERSION

Standardversion für Cluster verwenden, die nicht in einer Release-Version registriert sind:

Wenn Sie einen neuen Cluster mit der Standardversion für Cluster erstellen möchten, die nicht in einer Release-Version registriert ist, müssen Sie keine Clusterversion angeben. Sie müssen jedoch für die Release-Version None festlegen:

gcloud container clusters create CLUSTER_NAME \
    --region COMPUTE_REGION \
    --node-locations COMPUTE_ZONE \
    --release-channel None

Beispiel

Mit folgendem Befehl wird ein regionaler Cluster erstellt, der für die Release-Version regular (Standard) registriert ist, mit drei Knoten (Standard) in der Zone us-west1-c:

gcloud container clusters create my-regional-cluster \
    --region us-west1 \
    --node-locations us-west1-c

Beispiel

Mit folgendem Befehl wird ein regionaler Cluster erstellt, der für die Release-Version regular (Standard) registriert ist, mit zwei Knoten in der Zone us-west1-c:

gcloud container clusters create my-regional-cluster \
    --region us-west1 \
    --node-locations us-west1-c \
    --num-nodes 2

Console

Rufen Sie in der Google Cloud Console die Seite Google Kubernetes Engine auf.

Zur Seite „Google Kubernetes Engine“
Klicken Sie auf Erstellen.
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 Regional und dann die gewünschte Region für den Cluster aus.
3. Wenn Sie die Standardknoten-Standorte überschreiben möchten, z. B. um sie in einer einzelnen Zone auszuführen, markieren Sie das Kästchen Standardknoten-Standorte angeben und wählen dann die Zonen aus, in der die Knotenpools ausgeführt werden sollen.
4. Release-Version auswählen Sie können optional Kein Kanal aus der Drop-down-Liste auswählen. Wir empfehlen Ihnen jedoch, zu prüfen, wann Ihr Cluster nicht in einer Release-Version registriert werden sollte., bevor Sie diese Option auswählen. GKE aktualisiert Cluster, die sich nicht in einer Release-Version befinden, automatisch mit Versionen aus der Stable Channel.
5. Optional: Geben Sie in der Drop-down-Liste Version eine Version der Steuerungsebene an.
Optional (verfügbar mit GKE Enterprise): Wenn Sie Ihren neuen Cluster bei einer Flotte registrieren möchten, wechseln Sie zum Abschnitt Flottenregistrierung und folgen Sie der Google Cloud Console-Anleitung für Neuen Cluster erstellen und registrieren, um die Clusterregistrierung abzuschließen.
Klicken Sie im Navigationsbereich unter Knotenpools auf default-pool.
Geben Sie im Bereich Knotenpooldetails Folgendes ein:
1. Geben Sie einen Namen für den standardmäßigen Knotenpool ein.
2. Optional: Wählen Sie die Knotenversion aus.
3. Geben Sie die Anzahl der Knoten ein, die im Cluster erstellt werden sollen. Sie müssen verfügbare Ressourcenkontingente für die Knoten und ihre Ressourcen (z. B. Firewallrouten) haben.
4. Optional: Sie können automatische Knotenupgrades deaktivieren. Wir empfehlen Ihnen jedoch, die Überlegungen vor dem Deaktivieren von automatischen Knotenupgrades zu lesen, bevor Sie diese Option auswählen.
Klicken Sie im Navigationsbereich unter Knotenpools auf Knoten.
Wählen Sie in der Drop-down-Liste Image-Typ das gewünschte Knoten-Image aus.
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.
Wählen Sie in der Drop-down-Liste Bootlaufwerktyp den gewünschten Laufwerktyp aus.
Geben Sie die Größe des Bootlaufwerks ein.
Klicken Sie im Navigationsbereich unter Knotenpools auf Sicherheit.
Optional: Wählen Sie in der Drop-down-Liste Dienstkonto ein IAM-Dienstkonto (Identity and Access Management) aus, das Ihre Anwendungen beim Aufrufen von Google Cloud APIs verwenden sollen. Wir empfehlen, dass Sie ein Dienstkonto mit minimalen Berechtigungen anstelle des Standarddienstkontos verwenden, damit Ihre Knoten nicht mehr Berechtigungen haben, als sie benötigen.
Klicken Sie auf Erstellen.

Terraform

Informationen zum Erstellen eines regionalen Clusters mit einem Einzelzonenknotenpool mithilfe von Terraform finden Sie im folgenden Beispiel:

resource "google_container_cluster" "default" {
  name               = "gke-standard-regional-single-zone"
  location           = "us-west1"
  node_locations     = ["us-west1-c"]
  initial_node_count = 2

  # Set `deletion_protection` to `true` will ensure that one cannot
  # accidentally delete this instance by use of Terraform.
  deletion_protection = false
}

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.

Regionalen Cluster mit einem Mehrzonenknotenpool erstellen.

In der folgenden Anleitung erfahren Sie, wie Sie einen regionalen Cluster mit einem Knotenpool mit mehreren Zonen erstellen. Dies ist die Standardeinrichtung. Die Steuerungsebene und die Knoten des Clusters werden in mehreren Zonen der angegebenen Region repliziert.

Sie können den Cluster mit der gcloud CLI, der Google Cloud Console oder Terraform erstellen.

Wenn Sie GKE-Anwendungen mit Visual Studio Code entwickeln, erstellen Sie Cluster mit Cloud Code.

gcloud

Verwenden Sie zum Erstellen eines regionalen Clusters mit der gcloud CLI einen der folgenden Befehle und ersetzen Sie folgende Variablen:

CLUSTER_NAME: Der Name Ihres neuen regionalen Clusters.
COMPUTE_REGION: Die Region für Ihren Cluster, z. B. us-central1.
CHANNEL: Der Typ der Release-Version, entweder rapid, regular, stable oder None. Standardmäßig wird der Cluster in der Release-Version regular registriert, wenn die folgenden Flags nicht angegeben sind: --cluster-version, --release-channel, --no-enable-autoupgrade und --no-enable-autorepair.
VERSION: Die Version, die Sie für den Cluster angeben möchten.
Wenn Sie Regionen mit mehr als drei Zonen haben oder weniger Zonen wünschen, können Sie mit dem optionalen Flag --node-locations die Standardzonen überschreiben, in denen die Knoten repliziert werden.

Verwendung einer bestimmten Release-Version:

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

gcloud container clusters create CLUSTER_NAME \
    --region COMPUTE_REGION \
    --release-channel CHANNEL

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 \
    --region COMPUTE_REGION \
    --cluster-version VERSION

Standardversion für Cluster verwenden, die nicht in einer Release-Version registriert sind:

gcloud container clusters create CLUSTER_NAME \
    --region COMPUTE_REGION \
    --release-channel None

Beispiel

Mit dem folgenden Befehl erstellen Sie einen regionalen Cluster in der Release-Version regular mit neun Knoten in us-west1 (drei Zonen mit jeweils drei Knoten, Standardeinstellung):

gcloud container clusters create my-regional-cluster --region us-west1

Beispiel

Mit dem folgenden Befehl erstellen Sie einen regionalen Cluster mit der Release-Version regular mit sechs Knoten (drei Zonen mit jeweils zwei Knoten, angegeben durch --num-nodes):

gcloud container clusters create my-regional-cluster \
    --region us-west1 \
    --num-nodes 2

Beispiel

Mit dem folgenden Befehl wird ein regionaler Cluster erstellt, der für die Release-Version regular registriert ist, mit sechs Knoten in zwei Zonen (zwei Zonen, angegeben durch --node-locations, mit jeweils drei Knoten):

gcloud container clusters create my-regional-cluster \
    --region us-central1 \
    --node-locations us-central1-b,us-central1-c

Console

Rufen Sie in der Google Cloud Console die Seite Google Kubernetes Engine auf.

Zur Seite „Google Kubernetes Engine“
Klicken Sie auf Erstellen.
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 Regional und dann die gewünschte Region für den Cluster aus.
3. Wenn Sie die Standardknoten-Standorte überschreiben möchten, z. B. um sie in einer einzelnen Zone auszuführen, markieren Sie das Kästchen Standardknoten-Standorte angeben und wählen dann die Zonen aus, in der die Knotenpools ausgeführt werden sollen.
4. Release-Version auswählen Sie können optional Kein Kanal aus der Drop-down-Liste auswählen. Wir empfehlen Ihnen jedoch, zu prüfen, wann Ihr Cluster nicht in einer Release-Version registriert werden sollte., bevor Sie diese Option auswählen. GKE aktualisiert Cluster, die sich nicht in einer Release-Version befinden, automatisch mit Versionen aus der Stable Channel.
5. Optional: Geben Sie in der Drop-down-Liste Version eine Version der Steuerungsebene an.
Optional (verfügbar mit GKE Enterprise): Wenn Sie Ihren neuen Cluster bei einer Flotte registrieren möchten, wechseln Sie zum Abschnitt Flottenregistrierung und folgen Sie der Google Cloud Console-Anleitung für Neuen Cluster erstellen und registrieren, um die Clusterregistrierung abzuschließen.
Klicken Sie im Navigationsbereich unter Knotenpools auf default-pool.
Geben Sie im Bereich Knotenpooldetails Folgendes ein:
1. Geben Sie einen Namen für den standardmäßigen Knotenpool ein.
2. Optional: Wählen Sie die Knotenversion aus.
3. Geben Sie die Anzahl der Knoten ein, die im Cluster erstellt werden sollen. Sie müssen verfügbare Ressourcenkontingente für die Knoten und ihre Ressourcen (z. B. Firewallrouten) haben.
4. Optional: Sie können automatische Knotenupgrades deaktivieren. Wir empfehlen Ihnen jedoch, die Überlegungen vor dem Deaktivieren von automatischen Knotenupgrades zu lesen, bevor Sie diese Option auswählen.
Klicken Sie im Navigationsbereich unter Knotenpools auf Knoten.
Wählen Sie in der Drop-down-Liste Image-Typ das gewünschte Knoten-Image aus.
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.
Wählen Sie in der Drop-down-Liste Bootlaufwerktyp den gewünschten Laufwerktyp aus.
Geben Sie die Größe des Bootlaufwerks ein.
Klicken Sie im Navigationsbereich unter Knotenpools auf Sicherheit.
Optional: Wählen Sie in der Drop-down-Liste Dienstkonto ein IAM-Dienstkonto (Identity and Access Management) aus, das Ihre Anwendungen beim Aufrufen von Google Cloud APIs verwenden sollen. Wir empfehlen, dass Sie ein Dienstkonto mit minimalen Berechtigungen anstelle des Standarddienstkontos verwenden, damit Ihre Knoten nicht mehr Berechtigungen haben, als sie benötigen.
Klicken Sie auf Erstellen.

Terraform

Informationen zum Erstellen eines regionalen Clusters mit einem Mehrzonenknotenpool mithilfe von Terraform finden Sie im folgenden Beispiel:

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

  # Set `deletion_protection` to `true` will ensure that one cannot
  # accidentally delete this instance by use of Terraform.
  deletion_protection = false
}

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.

Regionale Cluster erstellen

Übersicht

Hinweis

Regionalen Cluster mit einem Einzelzonen-Knotenpool erstellen

gcloud

Console

Terraform

Mit kubectl mit einem Cluster interagieren

Regionalen Cluster mit einem Mehrzonenknotenpool erstellen.

gcloud

Console

Terraform

Mit kubectl mit einem Cluster interagieren

Nächste Schritte