Versionsinformationen finden Sie in den Versionshinweisen zu Distributed Cloud Connected.

Cluster erstellen und verwalten

Auf dieser Seite wird beschrieben, wie Sie Google Distributed Cloud-Clusterressourcen erstellen und verwalten.

Weitere Informationen zu Distributed Cloud-Clustern finden Sie unter Funktionsweise von Distributed Cloud.

Distributed Cloud Servers unterstützen nur lokale Steuerungsebenencluster. Sie können keine Cluster für die Cloud-Steuerungsebene auf Distributed Cloud-Servern erstellen.

Lokale Steuerungsebenencluster in Distributed Cloud 1.5.x

Nachdem Google Ihre Distributed Cloud-Bereitstellung auf Version 1.5.0 oder höher aktualisiert hat, müssen Sie alle lokalen Steuerungsebenencluster, die Sie mit Distributed Cloud-Version 1.4.0 erstellt haben, manuell löschen und neu erstellen. Andernfalls kann es zu unerwartetem Verhalten und Datenverlust kommen. Cluster, die für die Verwendung einer Cloud-Steuerungsebene konfiguriert sind, werden nach dem Update der Distributed Cloud-Bereitstellung durch Google auf Version 1.5.0 oder höher weiterhin normal ausgeführt.

Cluster erstellen

Führen Sie die Schritte in diesem Abschnitt aus, um einen Distributed Cloud-Cluster zu erstellen. Das Erstellen eines Clusters ist einer von mehreren Schritten, die zum Bereitstellen einer Arbeitslast in Distributed Cloud erforderlich sind.

Wenn Sie einen Cluster mit einer lokalen Steuerungsebene erstellen möchten, auf der Arbeitslasten ausgeführt werden können, während die Verbindung zu Google Cloudvorübergehend unterbrochen ist, lesen Sie zuerst den Abschnitt Notfallbetrieb.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle Edge Container Admin (roles/edgecontainer.admin) in Ihrem Google Cloud -Projekt.

Sie müssen Ihr Google Cloud SDK auf Version 450.0.0 oder höher aktualisieren, um lokale Steuerungsebenencluster mit der Distributed Cloud-Softwareversion 1.5.0 zu erstellen. Andernfalls schlägt das Erstellen solcher Cluster fehl.

Console

Rufen Sie in der Google Cloud Console die Seite Cluster auf.

Zu den Clustern
Klicken Sie auf Cluster erstellen.
Klicken Sie auf der Seite Cluster erstellen auf den Tab Lokal.
Klicken Sie neben der Option Distributed Cloud Edge auf Konfigurieren.
Geben Sie auf der Seite Clustergrundlagen die folgenden Informationen an:
- Name: Ein eindeutiger Name, der diesen Cluster identifiziert. Dieser Name muss RFC 1213-konform sein und darf nur alphanumerische Zeichen in Kleinbuchstaben und Bindestriche (-) enthalten. Er muss mit einem alphanumerischen Zeichen beginnen und enden.
- Standort: die Google Cloud Region, in der Sie diesen Cluster erstellen möchten.
- Standardmäßig maximale Anzahl von Pods pro Knoten: Die gewünschte maximale Anzahl von Kubernetes-Pods, die auf jedem Knoten in diesem Cluster ausgeführt werden sollen.
- Labels: Hier können Sie diesem Cluster ein oder mehrere Labels hinzufügen, indem Sie auf Label hinzufügen klicken.
Klicken Sie im linken Navigationsbereich auf Netzwerk.
Geben Sie auf der Seite Netzwerk die folgenden Informationen an:
- Standardadressbereich für Cluster-Pods: Der gewünschte IPv4-CIDR-Block für Kubernetes-Pods, die in diesem Cluster ausgeführt werden.
- Dienstadressbereich: Der gewünschte IPv4-CIDR-Block für Kubernetes-Dienste, die in diesem Cluster ausgeführt werden.
Weitere Informationen finden Sie unter Zuweisung von Adressen für Distributed Cloud-Pod- und Dienstnetzwerke.
Klicken Sie links im Navigationsmenü auf Autorisierung.
Geben Sie auf der Seite Autorisierung den Namen des Nutzerkontos im Zielprojekt Google Cloud an, das zum Ändern von Clusterressourcen autorisiert ist.
Klicken Sie links im Navigationsmenü auf Wartungsrichtlinie.

Warnung :Für einen Distributed Cloud-Cluster ist kein Standardwartungsfenster festgelegt. Das bedeutet, dass ein Softwareupdate möglicherweise eine kritische Arbeitslast beeinträchtigen kann. Um eine hohe Verfügbarkeit zu gewährleisten, müssen Sie gestaffelte Wartungsfenster für Ihre Distributed Cloud-Cluster konfigurieren, damit Softwareupdates zu unterschiedlichen Zeiten erfolgen und Ihre Arbeitslasten verfügbar bleiben.
Geben Sie auf der Seite Wartungsrichtlinie die folgenden Informationen an:
- Wartungsfenster aktivieren: Wählen Sie dieses Kästchen aus, um ein Wartungsfenster für den Cluster zu konfigurieren. Um unerwartete Ausfallzeiten aufgrund von Distributed Cloud-Softwareupdates zu vermeiden, empfehlen wir dringend, für jeden erstellten Distributed Cloud-Cluster ein Wartungsfenster zu konfigurieren. Weitere Informationen finden Sie unter Softwareupdates und Wartungsfenster.
- Startzeit: Das gewünschte Datum und die gewünschte Uhrzeit, zu der das Wartungsfenster für diesen Cluster beginnt.
- Ende: Das gewünschte Datum und die gewünschte Uhrzeit, zu der das Wartungsfenster für diesen Cluster endet.
- RRule: Die Häufigkeit des Wartungsfensters im Format FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU:
  - FREQ kann DAILY oder WEEKLY sein.
  - BYDAY: eine durch Kommas getrennte Liste der Tage, an denen die Wartung erfolgen kann, wenn FREQ auf WEEKLY festgelegt ist. Wenn Sie den Parameter BYDAY weglassen, wählt Google den Wochentag für Sie aus.
  - Wenn Sie FREQ auf DAILY festlegen, finden Wartungsfenster jeden Tag während der angegebenen Stunden statt.
Weisen Sie dem Cluster einen Knotenpool zu, indem Sie eine der folgenden Aktionen ausführen:
- Wenn Sie diesem Cluster einen vorhandenen Knotenpool zuweisen möchten, wählen Sie im Abschnitt Knotenpools in der linken Navigationsleiste den vorhandenen Knotenpool aus und prüfen Sie, ob die Knotenpoolkonfiguration auf der Seite Knotenpooldetails korrekt ist.
- Wenn Sie einen neuen Knotenpool erstellen möchten, der diesem Cluster zugewiesen werden soll, klicken Sie auf add_boxKnotenpool hinzufügen und geben Sie auf der Seite Details zum Knotenpool die folgenden Informationen an:
  - Knotenpoolname: Ein eindeutiger Name, der diesen Knotenpool identifiziert.
  - Knotenpool-Labels: Klicken Sie auf Label hinzufügen, um diesem Knotenpool ein oder mehrere Labels hinzuzufügen.
  - Worker-Knoten-Einstellungen: Wählen Sie die Distributed Cloud-Knoten aus, die diesem Knotenpool zugewiesen werden sollen.
Klicken Sie auf Erstellen, um den Distributed Cloud-Cluster zu erstellen.

gcloud

Führen Sie den Befehl gcloud edge-cloud container clusters create aus:

gcloud edge-cloud container clusters create CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION \
    --fleet-project=FLEET_PROJECT_ID \
    --cluster-ipv4-cidr=CLUSTER_IPV4_CIDR_BLOCK \
    --services-ipv4-cidr=SERVICE_IPV4_CIDR_BLOCK \
    --default-max-pods-per-node=MAX_PODS_PER_NODE \
    --release-channel RELEASE_CHANNEL \
    --control-plane-kms-key=CONTROL_PLANE_KMS_KEY \
    --control-plane-node-location=CONTROL_PLANE_LOCATION \
    --control-plane-node-count=CONTROL_PLANE_NODE_COUNT \
    --control-plane-machine-filter=CONTROL_PLANE_NODE_FILTER \
    --control-plane-shared-deployment-policy=CONTROL_PLANE_NODE_SHARING \
    --external-lb-ipv4-address-pools=IPV4_DATA_PLANE_ADDRESSES \
    --version SOFTWARE_VERSION \
    --offline-reboot-ttl REBOOT_TIMEOUT

Ersetzen Sie Folgendes:

CLUSTER_ID: Ein eindeutiger Name, der diesen Cluster identifiziert. Dieser Name muss RFC 1213-konform sein und darf nur alphanumerische Zeichen in Kleinbuchstaben und Bindestriche (-) enthalten. Er muss mit einem alphanumerischen Zeichen beginnen und enden.
PROJECT_ID: die ID des Zielprojekts Google Cloud .
REGION: die Google Cloud Region, in der der Cluster erstellt und die Kubernetes-Steuerungsebene für den Cluster bereitgestellt wird.
FLEET_PROJECT_ID: die ID des Flotten-Hostprojekts, in dem der Cluster registriert ist. Wenn dieses Flag nicht angegeben ist, wird das Distributed Cloud-Clusterprojekt als Hostprojekt der Flotte verwendet.
CLUSTER_IPV4_CIDR_BLOCK: Der gewünschte IPv4-CIDR-Block für Kubernetes-Pods, die in diesem Cluster ausgeführt werden.
SERVICE_IPV4_CIDR_BLOCK: Der gewünschte IPv4-CIDR-Block für Kubernetes-Dienste, die in diesem Cluster ausgeführt werden.
MAX_PODS_PER_NODE (optional): die gewünschte maximale Anzahl von Kubernetes-Pods, die auf jedem Knoten in diesem Cluster ausgeführt werden sollen.
RELEASE_CHANNEL (optional): Gibt den Release-Channel für die Version der Distributed Cloud-Software an, die auf diesem Cluster ausgeführt werden soll. Gültige Werte sind REGULAR (automatische Cluster-Upgrades aktivieren) und NONE (automatische Cluster-Upgrades deaktivieren). Wenn keine Angabe gemacht wird, lautet der Standardwert REGULAR.
CONTROL_PLANE_KMS_KEY (optional): Der vollständige Pfad zum Cloud KMS-Schlüssel, den Sie mit dem Steuerungsebenenknoten dieses Clusters verwenden möchten. Beispiel:
```
/projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
```
Dieses Flag gilt nur, wenn Sie Distributed Cloud in Cloud Key Management Service eingebunden haben, wie unter Unterstützung für kundenverwaltete Verschlüsselungsschlüssel (CMEK) für lokalen Speicher aktivieren beschrieben.

Wenn Sie einen Cluster mit einer lokalen Steuerungsebene erstellen, müssen Sie zusätzlich zu den vorherigen Variablen auch die folgenden ersetzen:

CONTROL_PLANE_LOCATION: weist Distributed Cloud an, die Workloads der Steuerungsebene für diesen Cluster lokal bereitzustellen. Der Wert ist der Name der Zielzone von Distributed Cloud.
CONTROL_PLANE_NODE_COUNT (optional): Gibt die Anzahl der Knoten an, auf denen die Arbeitslasten der lokalen Steuerungsebene ausgeführt werden sollen. Gültige Werte sind 3 für Hochverfügbarkeit und 1 für den Standardbetrieb. Wenn keine Angabe gemacht wird, lautet der Standardwert 3.
CONTROL_PLANE_NODE_FILTER (optional): Gibt eine Liste von Knoten im regulären Ausdrucksformat an, auf denen die Arbeitslasten der lokalen Steuerungsebene ausgeführt werden. Wenn Sie diese Option weglassen, wählt Distributed Cloud die Knoten automatisch nach dem Zufallsprinzip aus.
CONTROL_PLANE_NODE_SHARING: (optional) Gibt an, ob Anwendungsarbeitslasten auf den Knoten ausgeführt werden können, auf denen die Arbeitslasten der lokalen Steuerungsebene ausgeführt werden. Gültige Werte sind DISALLOWED und ALLOWED. Wenn keine Angabe gemacht wird, lautet der Standardwert DISALLOWED.
IPV4_DATA_PLANE_ADDRESSES: Gibt eine durch Kommas getrennte Liste von IPv4-Adressen, Adressbereichen oder Subnetzen für eingehenden Traffic für Dienste an, die hinter dem Distributed Cloud-Load-Balancer ausgeführt werden, wenn der Cluster im Survivability-Modus ausgeführt wird.
SOFTWARE_VERSION: Gibt die Distributed Cloud-Softwareversion an, die auf diesem Cluster ausgeführt werden soll, im Format 1.X.Y, wobei X die Nebenversion und Y die Patchversion ist, z. B. 1.5.0. Wenn Sie diese Option nicht festlegen, wird die Standardsoftwareversion des Servers verwendet. Das ist in der Regel die neueste verfügbare Version von Distributed Cloud. Informationen zu den Softwareversionen, die für die Clustererstellung verfügbar sind, einschließlich der Standardversion des Servers, finden Sie unter Verfügbare Softwareversionen für einen Cluster abrufen.
REBOOT_TIMEOUT: (erfordert gcloud alpha) gibt ein Zeitfenster in Sekunden an, in dem ein Clusterknoten nach dem Neustart wieder einem Cluster beitreten kann, während der Cluster im Survivability-Modus ausgeführt wird. Wenn nichts angegeben ist, wird standardmäßig 0 verwendet. In diesem Fall können neu gestartete Knoten erst wieder dem Cluster beitreten, wenn die Verbindung zu Google Cloud wiederhergestellt wurde. Dies ist eine Funktion auf Vorschau-Ebene.

ACHTUNG: Wenn Sie ein Zeitüberschreitungsfenster für den Neustart angeben, können Knoten, die offline gegangen sind, neu starten und dem Cluster wieder beitreten, auch wenn Sie den Speicherschlüssel für die angegebene Zeit deaktivieren oder löschen.

API

Stellen Sie eine POST-Anfrage an die Methode projects.locations.clusters:

POST /v1/projects/PROJECT_ID/locations/REGION/clusters?clusterId=CLUSTER_ID&requestId=REQUEST_ID&fleetId=FLEET_PROJECT_ID

{
  "labels": { LABELS,
  },
  "authorization": {
    "adminUsers": {
      "username": "USERNAME"
    }
  },
  "fleet": {
    "project": "FLEET_PROJECT_ID"
  },
  "networking": {
    "clusterIpv4CidrBlocks": CLUSTER_IPV4_CIDR_BLOCK,
    "servicesIpv4CidrBlocks": SERVICE_IPV4_CIDR_BLOCK,
      },
  "defaultMaxPodsPerNode": MAX_PODS_PER_NODE,
  "releaseChannel": "RELEASE_CHANNEL",
  "controlPlaneEncryption": {
   "kmsKey": CONTROL_PLANE_KMS_KEY,
  },      
  "controlPlane": {
    "local": {
      "nodeLocation": "CONTROL_PLANE_LOCATION",
      "nodeCount": CONTROL_PLANE_NODE_COUNT,
      "machineFilter": "CONTROL_PLANE_NODE_FILTER",
      "sharedDeploymentPolicy": "CONTROL_PLANE_NODE_SHARING"
    }
  },
  "externalLoadBalancerIpv4AddressPools": [
    "IPV4_DATA_PLANE_ADDRESSES"
  ],
  "targetVersion": "SOFTWARE_VERSION",
  "offlineRebootTtl": "REBOOT_TIMEOUT",
}

Ersetzen Sie Folgendes:

PROJECT_ID: die ID des Zielprojekts Google Cloud .
REGION: die Google Cloud Region, in der der Ziel-Distributed Cloud-Cluster erstellt wird.
CLUSTER_ID: Ein eindeutiger Name, der diesen Cluster identifiziert. Dieser Name muss RFC 1213-konform sein und darf nur alphanumerische Zeichen in Kleinbuchstaben und Bindestriche (-) enthalten. Er muss mit einem alphanumerischen Zeichen beginnen und enden.
REQUEST_ID: Eine eindeutige programmatische ID zur Identifizierung dieser Anfrage.
FLEET_PROJECT_ID: die ID des Flotten-Hostprojekts, in dem der Cluster registriert ist. Dies kann entweder ein separates Projekt oder das Distributed Cloud-Projekt sein, zu dem dieser Cluster gehört (PROJECT_ID). Die Flottenregistrierung ist obligatorisch.
LABELS: Eine Liste der Labels, die auf diese Clusterressource angewendet werden sollen.
USERNAME: Der Name des Nutzerkontos im Zielprojekt Google Cloud , das zum Ändern von Clusterressourcen autorisiert ist.
CLUSTER_IPV4_CIDR_BLOCK: Der gewünschte IPv4-CIDR-Block für Kubernetes-Pods, die in diesem Cluster ausgeführt werden.
SERVICE_IPV4_CIDR_BLOCK: Der gewünschte IPv4-CIDR-Block für Kubernetes-Dienste, die in diesem Cluster ausgeführt werden.
MAX_PODS_PER_NODE: Die gewünschte maximale Anzahl von Kubernetes-Pods, die auf jedem Knoten in diesem Cluster ausgeführt werden sollen.
RELEASE_CHANNEL: Gibt den Release-Channel für die Version der Distributed Cloud-Software an, die auf diesem Cluster ausgeführt werden soll. Gültige Werte sind REGULAR und NONE. Wenn keine Angabe gemacht wird, lautet der Standardwert REGULAR.
CONTROL_PLANE_KMS_KEY (optional): Der vollständige Pfad zum Cloud KMS-Schlüssel, den Sie mit dem Steuerungsebenenknoten dieses Clusters verwenden möchten. Beispiel:
```
/projects/myProject/locations/us-west1-a/keyRings/myKeyRing/cryptoKeys/myGDCE-Key
```
Dieser Parameter gilt nur, wenn Sie Distributed Cloud wie unter Unterstützung für vom Kunden verwaltete Verschlüsselungsschlüssel (CMEK) für lokalen Speicher aktivieren beschrieben in Cloud Key Management Service eingebunden haben.

Wenn Sie einen Cluster mit einer lokalen Steuerungsebene erstellen, müssen Sie zusätzlich zu den vorherigen Variablen auch die folgenden ersetzen:

CONTROL_PLANE_LOCATION: weist Distributed Cloud an, die Workloads der Steuerungsebene für diesen Cluster lokal bereitzustellen. Der Wert ist der Name der Zielzone von Distributed Cloud.
CONTROL_PLANE_NODE_COUNT: Gibt die Anzahl der Knoten an, auf denen die Arbeitslasten der lokalen Steuerungsebene ausgeführt werden sollen. Gültige Werte sind 3 für Hochverfügbarkeit und 1 für den Standardbetrieb.
CONTROL_PLANE_NODE_FILTER (optional): Gibt eine Liste von Knoten im regulären Ausdrucksformat an, auf denen die Arbeitslasten der lokalen Steuerungsebene ausgeführt werden. Wenn Sie diese Option weglassen, wählt Distributed Cloud die Knoten automatisch nach dem Zufallsprinzip aus.
CONTROL_PLANE_NODE_SHARING: Gibt an, ob Anwendungsarbeitslasten auf den Knoten ausgeführt werden können, auf denen die lokalen Arbeitslasten der Steuerungsebene ausgeführt werden. Gültige Werte sind DISALLOWED und ALLOWED. Wenn keine Angabe gemacht wird, lautet der Standardwert DISALLOWED.
IPV4_DATA_PLANE_ADDRESSES: Gibt eine durch Kommas getrennte Liste von IPv4-Adressen, Adressbereichen oder Subnetzen für eingehenden Traffic für Dienste an, die in einem lokalen Cluster der Steuerungsebene hinter dem Distributed Cloud-Load-Balancer ausgeführt werden. Gilt nicht für Cloud-Steuerungsebenen-Cluster.
SOFTWARE_VERSION: Gibt die Distributed Cloud-Softwareversion an, die auf diesem Cluster ausgeführt werden soll, im Format 1.X.Y, wobei X die Nebenversion und Y die Patchversion ist, z. B. 1.5.0. Wenn Sie diese Option nicht festlegen, wird die Standardsoftwareversion des Servers verwendet. Das ist in der Regel die neueste verfügbare Version von Distributed Cloud. Informationen zu den Softwareversionen, die für die Clustererstellung verfügbar sind, einschließlich der Standardversion des Servers, finden Sie unter Verfügbare Softwareversionen für einen Cluster abrufen.
REBOOT_TIMEOUT: (erfordert v1alpha1) gibt ein Zeitfenster in Sekunden an, in dem ein Clusterknoten nach dem Neustart wieder einem Cluster beitreten kann, während der Cluster im Survivability-Modus ausgeführt wird. Wenn nichts angegeben ist, wird standardmäßig 0 verwendet. In diesem Fall können neu gestartete Knoten erst wieder dem Cluster beitreten, wenn die Verbindung zu Google Cloud wiederhergestellt wurde. Dies ist eine Funktion auf Vorschau-Ebene.

ACHTUNG: Wenn Sie ein Zeitüberschreitungsfenster für den Neustart angeben, können Knoten, die offline gegangen sind, neu starten und dem Cluster wieder beitreten, auch wenn Sie den Speicherschlüssel für die angegebene Zeit deaktivieren oder löschen.

Cluster in einer Region auflisten

Führen Sie die Schritte in diesem Abschnitt aus, um die in einerGoogle Cloud -Region bereitgestellten Distributed Cloud-Cluster aufzulisten.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge Container Viewer“ (roles/edgecontainer.viewer) in Ihrem Google Cloud -Projekt.

Console

Rufen Sie in der Google Cloud Console die Seite Cluster auf.

Zu den Clustern
Sehen Sie sich die Liste der Cluster an.

gcloud

Führen Sie den Befehl gcloud edge-cloud container clusters list aus:

gcloud edge-cloud container clusters list \
    --project=PROJECT_ID \
    --location=REGION

Ersetzen Sie Folgendes:

PROJECT_ID: die ID des Zielprojekts Google Cloud .
REGION: die Google Cloud Region, in der Sie Ihren Distributed Cloud-Cluster erstellt haben.

API

Stellen Sie eine GET-Anfrage an die Methode projects.locations.clusters.list:

GET /v1/projects/PROJECT_ID/locations/REGION/clusters?clusterId=CLUSTER_ID&filter=FILTER&pageSize=PAGE_SIZE&orderBy=SORT_BY&pageToken=PAGE_TOKEN

Ersetzen Sie Folgendes:

PROJECT_ID: die ID des Zielprojekts Google Cloud .
REGION: die Google Cloud Region, in der der Zielcluster für Distributed Cloud erstellt wird.
CLUSTER_ID gibt den Namen des Zielclusters an.
FILTER: Ein Ausdruck, der die zurückgegebenen Ergebnisse auf bestimmte Werte beschränkt.
PAGE_SIZE: Die Anzahl der Ergebnisse, die pro Seite zurückgegeben werden sollen.
SORT_BY: Eine durch Kommas getrennte Liste von Feldnamen, nach denen die zurückgegebenen Ergebnisse sortiert werden. Die Standardsortierreihenfolge ist aufsteigend. Wenn Sie eine absteigende Sortierreihenfolge verwenden möchten, stellen Sie dem gewünschten Feld ~ voran.
PAGE_TOKEN: Ein Token, das in der Antwort auf die letzte Listenanfrage im Feld nextPageToken in der Antwort empfangen wurde. Senden Sie dieses Token, um eine Seite mit Ergebnissen zu erhalten.

Informationen zu einem Cluster abrufen

Wenn Sie Informationen zu einem Distributed Cloud-Cluster abrufen möchten, führen Sie die Schritte in diesem Abschnitt aus.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge Container Viewer“ (roles/edgecontainer.viewer) in Ihrem Google Cloud -Projekt.

Console

Rufen Sie in der Google Cloud Console die Seite Cluster auf.

Zu den Clustern
Wählen Sie den gewünschten Cluster aus.

Im rechten Bereich wird ein Aufklappfeld mit detaillierten Informationen zum Cluster angezeigt.

gcloud

Führen Sie den Befehl gcloud edge-cloud container clusters describe aus:

gcloud edge-cloud container clusters describe CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION

Ersetzen Sie Folgendes:

CLUSTER_ID gibt den Namen des Zielclusters an.
PROJECT_ID: die ID des Zielprojekts Google Cloud .
REGION: Die Google Cloud Region, in der Sie Ihre Distributed Cloud-Zone erstellt haben.

API

Stellen Sie eine GET-Anfrage an die Methode projects.locations.clusters.get:

GET /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID

Ersetzen Sie Folgendes:

PROJECT_ID: die ID des Zielprojekts Google Cloud .
REGION: die Google Cloud Region, in der der Zielcluster für Distributed Cloud erstellt wird.
CLUSTER_ID gibt den Namen des Zielclusters an.

Verfügbare Softwareversionen für einen Cluster abrufen

Führen Sie die Schritte in diesem Abschnitt aus, um herauszufinden, welche Distributed Cloud-Softwareversionen in Ihrer Distributed Cloud-Zone zum Erstellen von Clustern verfügbar sind.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge Container Viewer“ (roles/edgecontainer.viewer) in Ihrem Google Cloud -Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud container get-server-config aus:

gcloud edge-cloud container get-server-config --location=REGION

Ersetzen Sie REGION durch die Google Cloud Region, in der Sie Ihre Distributed Cloud-Zone erstellt haben.

API

Stellen Sie eine GET-Anfrage an die Methode projects.locations.serverConfig:

GET /v1/projects/PROJECT_ID/locations/REGION/serverConfig

Ersetzen Sie Folgendes:

PROJECT_ID: die ID des Zielprojekts Google Cloud .
REGION: die Google Cloud Region, in der der Zielcluster für Distributed Cloud erstellt wird.

Softwareversion eines lokalen Steuerungsebenenclusters aktualisieren

Wenn Sie die Softwareversion eines lokalen Steuerungsebenenclusters von Distributed Cloud aktualisieren möchten, führen Sie die Schritte in diesem Abschnitt aus. Diese Funktion ist für Cloud-Steuerungsebene-Cluster nicht verfügbar.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle Edge Container Admin (roles/edgecontainer.admin) in Ihrem Google Cloud -Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud container clusters upgrade aus:

gcloud edge-cloud container clusters upgrade CLUSTER_ID \
   --location=REGION \
   --project=PROJECT_ID \
   --schedule=UPGRADE_SCHEDULE \
   --version=SOFTWARE_VERSION

Ersetzen Sie Folgendes:

CLUSTER_ID gibt den Namen des Zielclusters an.
REGION: die Google Cloud Region, in der der Zielcluster für Distributed Cloud erstellt wurde.
PROJECT_ID: die ID des Zielprojekts Google Cloud .
UPGRADE_SCHEDULE: Gibt an, wann das Software-Upgrade ausgelöst werden soll. Der einzige gültige Wert ist IMMEDIATELY.
SOFTWARE_VERSION: Gibt die Distributed Cloud-Softwareversion an, die auf diesem Cluster ausgeführt werden soll, im Format 1.X.Y, wobei X die Nebenversion und Y die Patchversion ist, z. B. 1.5.1. Informationen zum Abrufen der für die Clustererstellung verfügbaren Softwareversionen, einschließlich der Standardversion des Servers, finden Sie unter Verfügbare Softwareversionen für einen Cluster abrufen.

API

Stellen Sie eine POST-Anfrage an die Methode projects.locations.clusters.upgrade:

POST /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID:upgrade?requestId=REQUEST_ID
{
  "name": "projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID",
  "targetVersion": "SOFTWARE_VERSION",
    "schedule": "UPGRADE_SCHEDULE",
}

Ersetzen Sie Folgendes:

PROJECT_ID: die ID des Zielprojekts Google Cloud .
REGION: die Google Cloud Region, in der der Zielcluster für Distributed Cloud erstellt wird.
CLUSTER_ID gibt den Namen des Zielclusters an.
REQUEST_ID: Eine eindeutige programmatische ID zur Identifizierung dieser Anfrage.
UPGRADE_SCHEDULE: Gibt an, wann das Software-Upgrade ausgelöst werden soll. Der einzige gültige Wert ist IMMEDIATELY.
SOFTWARE_VERSION: Gibt die Distributed Cloud-Softwareversion an, die auf diesem Cluster ausgeführt werden soll, im Format 1.X.Y, wobei X die Nebenversion und Y die Patchversion ist, z. B. 1.5.1. Informationen zum Abrufen der für die Clustererstellung verfügbaren Softwareversionen, einschließlich der Standardversion des Servers, finden Sie unter Verfügbare Softwareversionen für einen Cluster abrufen.

Ein Software-Upgrade dauert in der Regel etwa zwei Stunden pro Knoten, der zum Knotenpool des Clusters gehört. Der Befehl gibt einen Vorgang zurück, mit dem Sie den Fortschritt des Softwareupgrades verfolgen können. Während des Softwareupgrades wird der Status des Clusters auf Reconciling gesetzt und kehrt nach Abschluss des Upgrades zu Running zurück. Ein Clusterstatus von Error gibt an, dass das Software-Upgrade fehlgeschlagen ist. Führen Sie in solchen Fällen den Upgradevorgang noch einmal aus. Informationen zum Prüfen des Clusterstatus finden Sie unter Informationen zu einem Cluster abrufen.

Anmeldedaten für einen Cluster abrufen

Führen Sie die Schritte in diesem Abschnitt aus, um Anmeldedaten für einen Distributed Cloud-Cluster zu erhalten.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle „Edge Container Viewer“ (roles/edgecontainer.viewer) in Ihrem Google Cloud -Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud container clusters get-credentials aus:

gcloud edge-cloud container clusters get-credentials CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION

Ersetzen Sie Folgendes:

CLUSTER_ID gibt den Namen des Zielclusters an.
PROJECT_ID: die ID des Zielprojekts Google Cloud .
REGION: die Google Cloud Region, in der der Zielcluster für Distributed Cloud erstellt wird.

API

Stellen Sie eine GET-Anfrage an die Methode projects.locations.clusters:

GET /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID

Ersetzen Sie Folgendes:

PROJECT_ID: die ID des Zielprojekts Google Cloud .
REGION: die Google Cloud Region, in der die Distributed Cloud-Zielzone erstellt wird.
CLUSTER_ID gibt den Namen des Zielclusters an.

Wartungsfenster für einen Cluster konfigurieren

In diesem Abschnitt wird beschrieben, wie Sie ein Wartungsfenster für einen Distributed Cloud-Cluster angeben und löschen.

Wartungsfenster für einen Cluster angeben

Wenn Sie ein Wartungsfenster für einen Distributed Cloud-Cluster angeben möchten, führen Sie die Schritte in diesem Abschnitt aus. Weitere Informationen zur Clusterwartung finden Sie unter Softwareupdates und Wartungsfenster.

Verwenden Sie für Datums- und Uhrzeitformate RFC 5545.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle Edge Container Admin (roles/edgecontainer.admin) in Ihrem Google Cloud -Projekt.

Console

Wenn Sie die Google Cloud Konsole verwenden, können Sie nur beim Erstellen eines Clusters ein Wartungsfenster angeben. Wenn Sie ein Wartungsfenster für einen vorhandenen Cluster angeben möchten, müssen Sie die Google Cloud CLI oder die Distributed Cloud Edge Container API verwenden.

gcloud

Führen Sie den Befehl gcloud edge-cloud container clusters update aus:

gcloud edge-cloud container clusters update CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION \
    --maintenance-window-start=MAINTENANCE_START \
    --maintenance-window-end=MAINTENANCE_END \
    --maintenance-window-recurrence=MAINTENANCE_FREQUENCY

Ersetzen Sie Folgendes:

CLUSTER_ID gibt den Namen des Zielclusters an.
PROJECT_ID: die ID des Zielprojekts Google Cloud .
REGION: die Google Cloud Region, in der der Ziel-Distributed Cloud-Cluster erstellt wird.
MAINTENANCE_START: die Startzeit des Wartungsfensters im Format YYYY-MM-DDTHH:MM:SSZ.
MAINTENANCE_END: die Endzeit des Wartungsfensters im Format YYYY-MM-DDTHH:MM:SSZ.
MAINTENANCE_FREQUENCY: die Häufigkeit des Wartungsfensters im Format FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU:
- BYDAY: eine durch Kommas getrennte Liste von Tagen, an denen die Wartung erfolgen kann, wenn FREQ auf WEEKLY festgelegt ist. Wenn Sie den Parameter BYDAY weglassen, wählt Google den Wochentag für Sie aus.
- Wenn Sie FREQ auf „täglich“ festlegen, finden Wartungsfenster jeden Tag während der angegebenen Stunden statt.

API

Stellen Sie eine PATCH-Anfrage an die Methode projects.locations.clusters.update:

PATCH /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?updateMask=maintenancePolicy&requestId=REQUEST_ID
{
 "maintenance_policy": {
   "window": {
     "recurring_window": {
       "window": {
         "start_time": "MAINTENANCE_START",
         "end_time": "MAINTENANCE_END"
         },
       "recurrence": "MAINTENANCE_FREQUENCY"
     }
   }
 }
}

Ersetzen Sie Folgendes:

PROJECT_ID: die ID des Zielprojekts Google Cloud .
REGION: die Google Cloud Region, in der der Ziel-Distributed Cloud-Cluster erstellt wird.
CLUSTER_ID gibt den Namen des Zielclusters an.
UPDATE_MASK: Eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen, die in dieser Anfrage im FieldMask-Format aktualisiert werden sollen.
REQUEST_ID: Eine eindeutige programmatische ID zur Identifizierung dieser Anfrage.
CLUSTER_ID gibt den Namen des Zielclusters an.
USERNAME: Der Name des Nutzerkontos im Zielprojekt Google Cloud , das zum Ändern von Clusterressourcen autorisiert ist.
MAINTENANCE_START: die Startzeit des Wartungsfensters im Format YYYY-MM-DDTHH:MM:SSZ.
MAINTENANCE_END: die Endzeit des Wartungsfensters im Format YYYY-MM-DDTHH:MM:SSZ.
MAINTENANCE_FREQUENCY: die Häufigkeit des Wartungsfensters im Format FREQ=WEEKLY|DAILY;BYDAY=MO,TU,WE,TH,FR,SA,SU:
- FREQ kann DAILY oder WEEKLY sein.
- BYDAY: eine durch Kommas getrennte Liste von Tagen, an denen die Wartung erfolgen kann, wenn FREQ auf WEEKLY festgelegt ist. Wenn Sie den Parameter BYDAY weglassen, wählt Google den Wochentag für Sie aus.
- Wenn Sie FREQ auf „täglich“ festlegen, finden Wartungsfenster jeden Tag während der angegebenen Stunden statt.

Weitere Informationen finden Sie unter Ressource: Cluster.

Wartungsfenster für einen Cluster löschen

Führen Sie die Schritte in diesem Abschnitt aus, um das Wartungsfenster für einen Distributed Cloud-Cluster zu löschen. Weitere Informationen zur Clusterwartung finden Sie unter Softwareupdates und Wartungsfenster.

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle Edge Container Admin (roles/edgecontainer.admin) in Ihrem Google Cloud -Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud container clusters update aus:

gcloud edge-cloud container clusters update CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION \
    --clear-maintenance-window

Ersetzen Sie Folgendes:

CLUSTER_ID gibt den Namen des Zielclusters an.
PROJECT_ID: die ID des Zielprojekts Google Cloud .
REGION: die Google Cloud Region, in der der Ziel-Distributed Cloud-Cluster erstellt wird.

API

Stellen Sie eine PATCH-Anfrage an die Methode projects.locations.clusters.update:

PATCH /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?updateMask=maintenancePolicy&requestId=REQUEST_ID
{
 "maintenance_policy": null
}

Ersetzen Sie Folgendes:

PROJECT_ID: die ID des Zielprojekts Google Cloud .
REGION: die Google Cloud Region, in der der Ziel-Distributed Cloud-Cluster erstellt wird.
CLUSTER_ID gibt den Namen des Zielclusters an.
UPDATE_MASK: Eine durch Kommas getrennte Liste vollständig qualifizierter Feldnamen, die in dieser Anfrage im FieldMask-Format aktualisiert werden sollen.
REQUEST_ID: Eine eindeutige programmatische ID zur Identifizierung dieser Anfrage.
USERNAME: Der Name des Nutzerkontos im Zielprojekt Google Cloud , das zum Ändern von Clusterressourcen autorisiert ist.

Weitere Informationen finden Sie unter Ressource: Cluster.

Cluster löschen

Führen Sie die Schritte in diesem Abschnitt aus, um einen Distributed Cloud-Cluster zu löschen. Bevor Sie einen Cluster löschen können, müssen Sie zuerst Folgendes tun:

Zum Ausführen dieser Aufgabe benötigen Sie die Rolle Edge Container Admin (roles/edgecontainer.admin) in Ihrem Google Cloud -Projekt.

gcloud

Führen Sie den Befehl gcloud edge-cloud container clusters delete aus:

gcloud edge-cloud container clusters delete CLUSTER_ID \
    --project=PROJECT_ID \
    --location=REGION

Ersetzen Sie Folgendes:

CLUSTER_ID gibt den Namen des Zielclusters an.
PROJECT_ID: die ID des Zielprojekts Google Cloud .
REGION: die Google Cloud Region, in der der Zielcluster für Distributed Cloud erstellt wird.

API

Stellen Sie eine DELETE-Anfrage an die Methode projects.locations.clusters.delete:

DELETE /v1/projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_ID?requestId=REQUEST_ID

Ersetzen Sie Folgendes:

PROJECT_ID: die ID des Zielprojekts Google Cloud .
REGION: die Google Cloud Region, in der der Zielcluster für Distributed Cloud erstellt wird.
CLUSTER_ID gibt den Namen des Zielclusters an.
REQUEST_ID: Eine eindeutige programmatische ID zur Identifizierung dieser Anfrage.

Cluster erstellen und verwalten Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Lokale Steuerungsebenencluster in Distributed Cloud 1.5.x

Cluster erstellen

Console

gcloud

API

Cluster in einer Region auflisten

Console

gcloud

API

Informationen zu einem Cluster abrufen

Console

gcloud

API

Verfügbare Softwareversionen für einen Cluster abrufen

gcloud

API

Softwareversion eines lokalen Steuerungsebenenclusters aktualisieren

gcloud

API

Anmeldedaten für einen Cluster abrufen

gcloud

API

Wartungsfenster für einen Cluster konfigurieren

Wartungsfenster für einen Cluster angeben

Console

gcloud

API

Wartungsfenster für einen Cluster löschen

gcloud

API

Cluster löschen

gcloud

API

Nächste Schritte

Cluster erstellen und verwalten