- Ressource: Cluster
- Fleet
- ClusterNetworking
- Autorisierung
- ClusterUser
- MaintenancePolicy
- MaintenanceWindow
- RecurringTimeWindow
- TimeWindow
- MaintenanceExclusionWindow
- ControlPlane
- Remote
- Lokal
- SharedDeploymentPolicy
- SystemAddonsConfig
- Ingress
- VMServiceConfig
- ControlPlaneEncryption
- Status
- MaintenanceEvent
- Typ
- Planen
- Bundesland
- ReleaseChannel
- SurvivabilityConfig
- ConnectionState
- Bundesland
- ExternalLoadBalancerPool
- ZoneStorageEncryption
- Methoden
Ressource: Cluster
Ein Google Distributed Cloud Edge-Kubernetes-Cluster.
| JSON-Darstellung |
|---|
{ "name": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "fleet": { object ( |
| Felder | |
|---|---|
name |
Erforderlich. Der Ressourcenname des Clusters. |
create |
Nur Ausgabe. Der Zeitpunkt, zu dem der Cluster erstellt wurde. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
update |
Nur Ausgabe. Der Zeitpunkt, zu dem der Cluster zuletzt aktualisiert wurde. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
labels |
Mit dieser Ressource verknüpfte Labels. Ein Objekt, das eine Liste von |
fleet |
Erforderlich. Flottenkonfiguration. |
networking |
Erforderlich. Clusterweite Netzwerkkonfiguration. |
authorization |
Erforderlich. Nicht veränderbar. RBAC-Richtlinie, die von GEC angewendet und verwaltet wird. |
default |
Optional. Die standardmäßig maximale Anzahl von Pods pro Knoten, die verwendet wird, wenn für einen Knotenpool in diesem Cluster kein expliziter Höchstwert angegeben ist. Wenn nichts angegeben ist, wird der Kubernetes-Standardwert verwendet. |
endpoint |
Nur Ausgabe. Die IP-Adresse des Kubernetes API-Servers. |
port |
Nur Ausgabe. Die Portnummer des Kubernetes API-Servers. |
cluster |
Nur Ausgabe. Das PEM-codierte öffentliche Zertifikat der Zertifizierungsstelle des Clusters. |
maintenance |
Optional. Konfiguration der clusterweiten Wartungsrichtlinie. |
control |
Nur Ausgabe. Die Release-Version der Steuerungsebene |
node |
Nur Ausgabe. Die niedrigste Release-Version aller Worker-Knoten. Dieses Feld kann leer sein, wenn der Cluster keine Worker-Knoten hat. |
control |
Optional. Die Konfiguration der Cluster-Steuerungsebene. |
system |
Optional. Die Konfiguration der System-Add-ons. |
external |
Optional. IPv4-Adresspools für das externe Load Balancing auf der Cluster-Datenebene. |
control |
Optional. Optionen für die Laufwerksverschlüsselung der Remote-Steuerungsebene. Dieses Feld wird nur verwendet, wenn die CMEK-Unterstützung aktiviert wird. |
status |
Nur Ausgabe. Der aktuelle Status des Clusters. |
maintenance |
Nur Ausgabe. Alle für den Cluster geplanten Wartungsereignisse, einschließlich der laufenden, für die Zukunft geplanten und in der Vergangenheit (bis zu 90 Tage) durchgeführten Ereignisse. |
target |
Optional. Die Zielclusterversion. Beispiel: „1.5.0“. |
release |
Optional. Die Release-Version, die ein Cluster abonniert hat. |
survivability |
Optional. Konfiguration der Cluster-Überlebensfähigkeit, z.B. für den Fall, dass die Netzwerkverbindung unterbrochen wird. Hinweis: Dies gilt nur für Cluster mit lokaler Steuerungsebene. |
external |
Optional. IPv6-Adresspools für das externe Load Balancing der Cluster-Datenebene. |
connection |
Nur Ausgabe. Der aktuelle Verbindungsstatus des Clusters. |
external |
Optional. Externe Load-Balancer-Pools für Cluster. |
zone |
Optional. Die Konfiguration der Verschlüsselung des Zonenspeichers |
Flotte
Flottenbezogene Konfiguration.
Flotten sind ein Google Cloud-Konzept für die logische Organisation von Clustern, mit dem Sie Multi-Cluster-Funktionen nutzen und verwalten sowie einheitliche Richtlinien auf Ihre Systeme anwenden können.
| JSON-Darstellung |
|---|
{ "project": string, "membership": string } |
| Felder | |
|---|---|
project |
Erforderlich. Der Name des Fleet-Hostprojekts, in dem dieser Cluster registriert wird. Projektnamen werden im Format |
membership |
Nur Ausgabe. Der Name der verwalteten Hub-Mitgliedschaftsressource, die diesem Cluster zugeordnet ist. Mitgliedschaftsnamen werden im Format |
ClusterNetworking
Clusterweite Netzwerkkonfiguration.
| JSON-Darstellung |
|---|
{ "clusterIpv4CidrBlocks": [ string ], "servicesIpv4CidrBlocks": [ string ] } |
| Felder | |
|---|---|
cluster |
Erforderlich. Allen Pods im Cluster wird eine RFC1918-IPv4-Adresse aus diesen Blöcken zugewiesen. Es wird nur ein einzelner Block unterstützt. Dieses Feld kann nach dem Erstellen nicht mehr geändert werden. |
services |
Erforderlich. Allen Diensten im Cluster wird eine RFC1918-IPv4-Adresse aus diesen Blöcken zugewiesen. Es wird nur ein einzelner Block unterstützt. Dieses Feld kann nach dem Erstellen nicht mehr geändert werden. |
Autorisierung
RBAC-Richtlinie, die von GEC angewendet und verwaltet wird.
| JSON-Darstellung |
|---|
{
"adminUsers": {
object ( |
| Felder | |
|---|---|
admin |
Erforderlich. Nutzer, dem die Rolle „cluster-admin“ für den Cluster und damit vollständiger Zugriff auf den Cluster gewährt wird. Derzeit ist dies ein einzelnes Feld, es wird jedoch in Zukunft erweitert, um mehrere Administratoren zuzulassen. |
ClusterUser
Ein Nutzerhauptkonto für eine RBAC-Richtlinie.
| JSON-Darstellung |
|---|
{ "username": string } |
| Felder | |
|---|---|
username |
Erforderlich. Einen aktiven Google-Nutzernamen. |
MaintenancePolicy
Konfiguration der Wartungsrichtlinie.
| JSON-Darstellung |
|---|
{ "window": { object ( |
| Felder | |
|---|---|
window |
Gibt das Wartungsfenster an, in dem Wartungsarbeiten durchgeführt werden können. |
maintenance |
Optional. Ausschlüsse von der automatischen Wartung. Nicht dringende Wartungsarbeiten sollten in diesen Zeiträumen nicht durchgeführt werden. Jeder Ausschluss hat einen eindeutigen Namen und kann aktiv oder abgelaufen sein. Die maximale Anzahl von Wartungsausschlüssen, die zu einem bestimmten Zeitpunkt zulässig sind, beträgt 3. |
MaintenanceWindow
Wartungsfenster konfigurieren
| JSON-Darstellung |
|---|
{
"recurringWindow": {
object ( |
| Felder | |
|---|---|
recurring |
Konfiguration eines wiederkehrenden Wartungsfensters. |
RecurringTimeWindow
Stellt ein beliebiges Zeitfenster dar, das sich wiederholt.
| JSON-Darstellung |
|---|
{
"window": {
object ( |
| Felder | |
|---|---|
window |
Das Fenster der ersten Wiederholung. |
recurrence |
Eine RRULE (https://tools.ietf.org/html/rfc5545#section-3.8.5.3) für die Wiederholung dieses Fensters. Sie dauern so lange wie die Zeitspanne zwischen Start- und Endzeit. |
TimeWindow
Stellt ein beliebiges Zeitfenster dar.
| JSON-Darstellung |
|---|
{ "startTime": string, "endTime": string } |
| Felder | |
|---|---|
start |
Der Zeitpunkt, zu dem das Fenster zum ersten Mal beginnt. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
end |
Der Zeitpunkt, zu dem das Fenster endet. Das Ende muss nach dem Beginn liegen. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
MaintenanceExclusionWindow
Stellt ein Wartungsausschlussfenster dar.
| JSON-Darstellung |
|---|
{
"window": {
object ( |
| Felder | |
|---|---|
window |
Optional. Das Zeitfenster. |
id |
Optional. Eine eindeutige ID (pro Cluster) für das Fenster. |
ControlPlane
Konfiguration der Cluster-Steuerungsebene.
| JSON-Darstellung |
|---|
{ // Union field |
| Felder | |
|---|---|
Union-Feld Für |
|
remote |
Konfiguration der Remote-Steuerungsebene. |
local |
Konfiguration der lokalen Steuerungsebene. Warnung: Cluster mit lokaler Steuerungsebene müssen in einem eigenen Projekt erstellt werden. Cluster mit lokaler Steuerungsebene können nicht im selben Projekt mit anderen Clustern koexistieren, einschließlich Nicht-GDCE-Clustern. Wenn Sie GDCE-Cluster mit lokaler Steuerungsebene mit anderen Clustertypen im selben Projekt kombinieren, kann dies zu Datenverlust führen. |
Remote
Dieser Typ hat keine Felder.
Konfiguration speziell für Cluster mit einer remote gehosteten Steuerungsebene.
Lokal
Konfiguration speziell für Cluster mit einer lokal gehosteten Steuerungsebene.
Warnung: Cluster mit lokaler Steuerungsebene müssen in einem eigenen Projekt erstellt werden. Cluster mit lokaler Steuerungsebene können nicht im selben Projekt mit anderen Clustern koexistieren, einschließlich Nicht-GDCE-Clustern. Wenn Sie GDCE-Cluster mit lokaler Steuerungsebene mit anderen Clustertypen im selben Projekt kombinieren, kann dies zu Datenverlust führen.
| JSON-Darstellung |
|---|
{
"nodeLocation": string,
"nodeCount": integer,
"machineFilter": string,
"sharedDeploymentPolicy": enum ( |
| Felder | |
|---|---|
node |
Name der Google Distributed Cloud Edge-Zonen, in denen dieser Knotenpool erstellt wird. Beispiel: |
node |
Die Anzahl der Knoten, die als Replikate der Steuerungsebene dienen sollen. |
machine |
Nur Maschinen, die diesem Filter entsprechen, können Knoten der Steuerungsebene hosten. Die Filtersprache akzeptiert Strings wie „name= |
shared |
Richtlinienkonfiguration für die Bereitstellung von Nutzeranwendungen. |
control |
Optional. Name für das Speicherschema von Knoten der Steuerungsebene. Warnung: Das Feature „Konfigurierbares Schema für lokalen Knotenspeicher“ ist ein experimentelles Feature und wird nicht für die allgemeine Verwendung in Produktionsclustern/-knotenpools empfohlen. |
SystemAddonsConfig
Konfiguration, die Kunden für GDCE-System-Add-ons definieren dürfen.
| JSON-Darstellung |
|---|
{ "ingress": { object ( |
| Felder | |
|---|---|
ingress |
Optional. Konfiguration für Ingress. |
vm |
Optional. Konfiguration für VM-Dienst. |
Eingehender Traffic
Konfiguration für das Ingress-Add-on, mit dem Kunden ein Ingress-Objekt erstellen können, um den externen Zugriff auf die Server in einem Cluster zu verwalten. Das Add-on besteht aus istiod und istio-ingress.
| JSON-Darstellung |
|---|
{ "disabled": boolean, "ipv4Vip": string } |
| Felder | |
|---|---|
disabled |
Optional. Gibt an, ob Ingress deaktiviert ist. |
ipv4 |
Optional. Virtuelle IP-Adresse für eingehenden Traffic. |
VMServiceConfig
VMServiceConfig definiert die Konfiguration für den GDCE-VM-Dienst.
| JSON-Darstellung |
|---|
{ "vmmEnabled": boolean } |
| Felder | |
|---|---|
vmm |
Optional. Gibt an, ob VMM aktiviert ist. |
ControlPlaneEncryption
Konfiguration für die Unterstützung von kundenverwalteten KMS-Schlüsseln für Knoten der Steuerungsebene.
| JSON-Darstellung |
|---|
{ "kmsKey": string, "kmsKeyActiveVersion": string, "kmsKeyState": enum ( |
| Felder | |
|---|---|
kms |
Optional. Der Cloud KMS-CryptoKey, z.B. projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}, der zum Schutz von Laufwerken der Steuerungsebene verwendet werden soll. Wenn keine Angabe erfolgt, wird stattdessen ein von Google verwalteter Schlüssel verwendet. |
kms |
Nur Ausgabe. Die Cloud KMS-CryptoKeyVersion, die derzeit zum Schutz von Laufwerken der Steuerungsebene verwendet wird. Gilt nur, wenn „kmsKey“ festgelegt ist. |
kms |
Nur Ausgabe. Verfügbarkeit des Cloud KMS-CryptoKey. Wenn nicht |
kms |
Nur Ausgabe. Fehlerstatus, der von Cloud KMS zurückgegeben wird, wenn dieser Schlüssel verwendet wird. Dieses Feld darf nur ausgefüllt werden, wenn |
resource |
Nur Ausgabe. Der aktuelle Ressourcenstatus, der mit dem CMEK verknüpft ist. |
Status
Gibt den Status des Clusters an.
| Enums | |
|---|---|
STATUS_UNSPECIFIED |
Status unbekannt. |
PROVISIONING |
Der Cluster wird erstellt. |
RUNNING |
Der Cluster wurde erstellt und ist vollständig nutzbar. |
DELETING |
Der Cluster wird gelöscht. |
ERROR |
Der Status gibt an, dass beim Abgleichen/Löschen des Clusters einige Fehler aufgetreten sind. |
RECONCILING |
Am Cluster werden gerade Arbeiten wie Versionsupgrades usw. durchgeführt. |
MaintenanceEvent
Ein Wartungsereignis ist ein Vorgang, der zu vorübergehenden Unterbrechungen der Clusterarbeitslasten führen kann, einschließlich von Google gesteuerter oder vom Nutzer initiierter Clusterupgrades, vom Nutzer initiierter Änderungen der Clusterkonfiguration, die einen Neustart von Knoten erfordern, usw.
| JSON-Darstellung |
|---|
{ "uuid": string, "targetVersion": string, "operation": string, "type": enum ( |
| Felder | |
|---|---|
uuid |
Nur Ausgabe. UUID des Wartungsereignisses. |
target |
Nur Ausgabe. Die Zielversion des Clusters. |
operation |
Nur Ausgabe. Der Vorgang zum Ausführen des Wartungsereignisses. Wird im Format „projects/*/locations/*/operations/*“ angegeben. Wenn das Wartungsereignis in mehrere Vorgänge aufgeteilt ist (z.B. aufgrund von Wartungsfenstern), wird der letzte Vorgang aufgezeichnet. |
type |
Nur Ausgabe. Der Typ des Wartungsereignisses. |
schedule |
Nur Ausgabe. Der Zeitplan des Wartungsereignisses. |
state |
Nur Ausgabe. Der Status des Wartungsereignisses. |
create |
Nur Ausgabe. Der Zeitpunkt, zu dem die Anfrage für das Wartungsereignis erstellt wurde. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
start |
Nur Ausgabe. Der Zeitpunkt, zu dem das Wartungsereignis gestartet wurde. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
end |
Nur Ausgabe. Der Zeitpunkt, zu dem das Wartungsereignis beendet wurde, entweder erfolgreich oder nicht. Wenn das Wartungsereignis in mehrere Wartungsfenster aufgeteilt ist, wird „endTime“ erst aktualisiert, wenn der gesamte Ablauf beendet ist. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
update |
Nur Ausgabe. Der Zeitpunkt, zu dem die Nachricht zum Wartungsereignis aktualisiert wurde. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
Typ
Gibt den Typ des Wartungsereignisses an.
| Enums | |
|---|---|
TYPE_UNSPECIFIED |
Nicht angegeben. |
USER_INITIATED_UPGRADE |
Upgrade, das von Nutzern initiiert wurde. |
GOOGLE_DRIVEN_UPGRADE |
Upgrade von Google. |
Zeitplan
Gibt an, wann das Wartungsereignis ausgeführt werden soll.
| Enums | |
|---|---|
SCHEDULE_UNSPECIFIED |
Nicht angegeben. |
IMMEDIATELY |
Sofort nach Erhalt der Anfrage. |
Bundesland
Gibt den Status des Wartungsereignisses an.
| Enums | |
|---|---|
STATE_UNSPECIFIED |
Nicht angegeben. |
RECONCILING |
Das Wartungsereignis ist aktiv. Der Cluster ist möglicherweise nicht verwendbar. |
SUCCEEDED |
Das Wartungsereignis war erfolgreich. |
FAILED |
Das Wartungsereignis ist fehlgeschlagen. |
ReleaseChannel
Die Release-Version, die ein Cluster abonniert hat.
| Enums | |
|---|---|
RELEASE_CHANNEL_UNSPECIFIED |
Unbekannte Release-Version. Dies ist standardmäßig der Regular channel. |
NONE |
Keine Release-Version. |
REGULAR |
Reguläre Release-Version. |
SurvivabilityConfig
Konfiguration der Cluster-Überlebensfähigkeit, z.B. für den Fall, dass die Netzwerkverbindung verloren geht.
| JSON-Darstellung |
|---|
{ "offlineRebootTtl": string } |
| Felder | |
|---|---|
offline |
Optional. Zeitraum, in dem die Clusterknoten neu gestartet und ohne Netzwerkverbindung zu Google funktionsfähig werden können. Der Standardwert 0 bedeutet, dass die Option nicht zulässig ist. Die maximale Dauer beträgt 7 Tage. Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „ |
ConnectionState
ConnectionState enthält den aktuellen Verbindungsstatus vom Cluster zu Google.
| JSON-Darstellung |
|---|
{
"state": enum ( |
| Felder | |
|---|---|
state |
Nur Ausgabe. Der aktuelle Verbindungsstatus. |
update |
Nur Ausgabe. Der Zeitpunkt, zu dem der Verbindungsstatus zuletzt geändert wurde. Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: |
Bundesland
Der Verbindungsstatus.
| Enums | |
|---|---|
STATE_UNSPECIFIED |
Unbekannter Verbindungsstatus. |
DISCONNECTED |
Dieser Cluster ist derzeit nicht mit Google verbunden. |
CONNECTED |
Dieser Cluster ist derzeit mit Google verbunden. |
CONNECTED_AND_SYNCING |
Dieser Cluster ist derzeit mit Google verbunden, wurde aber möglicherweise vor Kurzem nach einer Trennung wieder verbunden. Die Synchronisierung läuft noch. |
ExternalLoadBalancerPool
Externer Load-Balancer-Pool mit benutzerdefinierter Konfiguration, z. B. Name, manuelle/automatische Zuweisung, nicht überlappender IPv4- und optionaler IPv6-Adressbereich.
| JSON-Darstellung |
|---|
{ "addressPool": string, "ipv4Range": [ string ], "ipv6Range": [ string ], "avoidBuggyIps": boolean, "manualAssign": boolean } |
| Felder | |
|---|---|
address |
Optional. Name des externen Load-Balancer-Pools. |
ipv4 |
Erforderlich. Nicht überlappender IPv4-Adressbereich des externen Load-Balancer-Pools. |
ipv6 |
Optional. Nicht überlappender IPv6-Adressbereich des externen Load-Balancer-Pools. |
avoid |
Optional. Wenn „true“, werden im Pool IP-Adressen weggelassen, die auf „.0“ und „.255“ enden. Bestimmte Netzwerkhardware führt zu einem Rückgang des Traffics zu diesen speziellen Adressen. Der Standardwert ist „false“. |
manual |
Optional. Wenn „true“, werden Adressen in diesem Pool nicht automatisch Kubernetes-Diensten zugewiesen. Bei „true“ wird eine IP-Adresse in diesem Pool nur verwendet, wenn sie explizit von einem Dienst angegeben wird. Der Standardwert ist „false“. |
ZoneStorageEncryption
Konfiguration für CMEK-Unterstützung für Zonenspeicher
| JSON-Darstellung |
|---|
{
"kmsKey": string,
"kmsKeyActiveVersion": string,
"resourceState": enum ( |
| Felder | |
|---|---|
kms |
Optional. Der Cloud KMS-Schlüssel |
kms |
Nur Ausgabe. Die Cloud KMS-CryptoKeyVersion, die derzeit für die Verschlüsselung/Entschlüsselung verwendet wird |
resource |
Nur Ausgabe. Der aktuelle Ressourcenstatus des CMEK |
Methoden |
|
|---|---|
|
Erstellt einen neuen Cluster in einem bestimmten Projekt und an einem bestimmten Standort. |
|
Löscht einen einzelnen Cluster. |
|
Generiert ein Zugriffstoken für einen Cluster. |
|
Generiert Offline-Anmeldedaten für einen Cluster. |
|
Ruft Details zu einem einzelnen Cluster ab. |
|
Listet Cluster in einem bestimmten Projekt und an einem bestimmten Standort auf. |
|
Aktualisiert die Parameter eines einzelnen Clusters. |
|
Aktualisiert einen einzelnen Cluster. |