REST Resource: projects.locations.bareMetalClusters

Ressource: BareMetalCluster

Ressource, die einen Bare-Metal-Nutzercluster darstellt.

JSON-Darstellung
{
  "name": string,
  "adminClusterMembership": string,
  "description": string,
  "bareMetalVersion": string,
  "uid": string,
  "state": enum (State),
  "endpoint": string,
  "reconciling": boolean,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "localName": string,
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "networkConfig": {
    object (BareMetalNetworkConfig)
  },
  "controlPlane": {
    object (BareMetalControlPlaneConfig)
  },
  "loadBalancer": {
    object (BareMetalLoadBalancerConfig)
  },
  "storage": {
    object (BareMetalStorageConfig)
  },
  "proxy": {
    object (BareMetalProxyConfig)
  },
  "clusterOperations": {
    object (BareMetalClusterOperationsConfig)
  },
  "maintenanceConfig": {
    object (BareMetalMaintenanceConfig)
  },
  "nodeConfig": {
    object (BareMetalWorkloadNodeConfig)
  },
  "fleet": {
    object (Fleet)
  },
  "status": {
    object (ResourceStatus)
  },
  "validationCheck": {
    object (ValidationCheck)
  },
  "securityConfig": {
    object (BareMetalSecurityConfig)
  },
  "maintenanceStatus": {
    object (BareMetalMaintenanceStatus)
  },
  "adminClusterName": string,
  "nodeAccessConfig": {
    object (BareMetalNodeAccessConfig)
  },
  "osEnvironmentConfig": {
    object (BareMetalOsEnvironmentConfig)
  },
  "binaryAuthorization": {
    object (BinaryAuthorization)
  },
  "upgradePolicy": {
    object (BareMetalClusterUpgradePolicy)
  },
  "localNamespace": string
}
Felder
name

string

Nicht veränderbar. Der Ressourcenname des Bare-Metal-Nutzerclusters.

adminClusterMembership

string

Erforderlich. Der Administratorcluster, zu dem dieser Bare-Metal-Nutzercluster gehört. Dies ist der vollständige Ressourcenname der Flottenmitgliedschaft des Administratorclusters.

description

string

Eine für Menschen lesbare Beschreibung dieses Bare-Metal-Nutzerclusters.

bareMetalVersion

string

Erforderlich. Die Anthos-Cluster auf Bare Metal-Version des Nutzerclusters.

uid

string

Nur Ausgabe. Die eindeutige Kennung des Bare-Metal-Nutzerclusters.

state

enum (State)

Nur Ausgabe. Der aktuelle Status des Bare-Metal-Nutzerclusters.

endpoint

string

Nur Ausgabe. Die IP-Adresse des API-Servers des Bare-Metal-Nutzerclusters.

reconciling

boolean

Nur Ausgabe. Wenn festgelegt, werden aktuell Änderungen am Bare-Metal-Nutzercluster durchgeführt.

createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der Bare-Metal-Nutzercluster 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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der Bare-Metal-Nutzercluster 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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

deleteTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem der Bare-Metal-Nutzercluster gelöscht wurde. Wenn die Ressource nicht gelöscht wird, muss dieses Feld leer sein.

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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".

localName

string

Nur Ausgabe. Der Objektname der benutzerdefinierten Ressource des Bare Metal-Nutzerclusters im zugehörigen Administratorcluster. Dieses Feld wird verwendet, um Konflikte bei Namen zu vermeiden, wenn vorhandene Cluster in der API registriert werden. Wenn dieses Feld im Rahmen der Clusterregistrierung verwendet wird, unterscheidet es sich vom Namen im Ressourcennamen. Bei neuen Clustern entspricht dieses Feld dem vom Nutzer angegebenen Clusternamen und ist in der letzten Komponente des Ressourcennamens sichtbar. Sie kann nicht geändert werden.

Wenn sich der lokale Name und der Clustername unterscheiden, wird der lokale Name in den Controllerlogs des Administratorclusters verwendet. Sie verwenden den Clusternamen, wenn Sie mit bmctl und kubectl auf den Cluster zugreifen.

etag

string

Nur Ausgabe. Diese Prüfsumme wird vom Server anhand des Werts anderer Felder berechnet und kann bei Aktualisierungs- und Löschanfragen gesendet werden, um sicherzustellen, dass der Client vor dem Fortfahren einen aktuellen Wert hat. Ermöglicht Clients durch optimistische Nebenläufigkeitserkennung, konsistente Read-Modify-Write-Vorgänge auszuführen.

annotations

map (key: string, value: string)

Annotationen zum Bare-Metal-Nutzercluster. Für dieses Feld gelten die gleichen Einschränkungen wie für Kubernetes-Annotationen. Die Gesamtgröße aller Schlüssel und Werte ist auf 256 KB begrenzt. Der Schlüssel kann zwei Segmente haben: Präfix (optional) und Name (erforderlich), getrennt durch einen Schrägstrich (/). Das Präfix muss eine DNS-Subdomain sein. Der Name darf maximal 63 Zeichen lang sein und muss mit alphanumerischen Zeichen beginnen und enden. Dazwischen müssen Bindestriche (-), Unterstriche (_), Punkte (.) und alphanumerische Zeichen liegen.

Ein Objekt, das eine Liste von "key": value-Paaren enthält. Beispiel: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

networkConfig

object (BareMetalNetworkConfig)

Erforderlich. Netzwerkkonfiguration.

controlPlane

object (BareMetalControlPlaneConfig)

Erforderlich. Konfiguration der Steuerungsebene.

loadBalancer

object (BareMetalLoadBalancerConfig)

Erforderlich. Load-Balancer-Konfiguration.

storage

object (BareMetalStorageConfig)

Erforderlich. Speicherkonfiguration.

proxy

object (BareMetalProxyConfig)

Proxykonfiguration.

clusterOperations

object (BareMetalClusterOperationsConfig)

Konfiguration von Clustervorgängen.

maintenanceConfig

object (BareMetalMaintenanceConfig)

Wartungskonfiguration.

nodeConfig

object (BareMetalWorkloadNodeConfig)

Konfiguration von Arbeitslastknoten.

fleet

object (Fleet)

Nur Ausgabe. Flottenkonfiguration für den Cluster.

status

object (ResourceStatus)

Nur Ausgabe. Detaillierter Clusterstatus.

validationCheck

object (ValidationCheck)

Nur Ausgabe. Das Ergebnis der Preflight-Prüfung.

securityConfig

object (BareMetalSecurityConfig)

Konfiguration sicherheitsbezogener Einstellungen.

maintenanceStatus

object (BareMetalMaintenanceStatus)

Nur Ausgabe. Status laufender Wartungsaufgaben.

adminClusterName

string

Nur Ausgabe. Der Ressourcenname des Bare-Metal-Administratorclusters, der diesen Nutzercluster verwaltet.

nodeAccessConfig

object (BareMetalNodeAccessConfig)

Konfigurationen für den Knotenzugriff.

osEnvironmentConfig

object (BareMetalOsEnvironmentConfig)

Konfigurationen im Zusammenhang mit der Betriebssystemumgebung.

binaryAuthorization

object (BinaryAuthorization)

Konfigurationen im Zusammenhang mit der Binärautorisierung.

upgradePolicy

object (BareMetalClusterUpgradePolicy)

Die Cluster-Upgraderichtlinie.

localNamespace

string

Nur Ausgabe. Der Namespace des Clusters.

Bundesland

Der Lebenszyklusstatus des Bare-Metal-Nutzerclusters.

Enums
STATE_UNSPECIFIED Nicht definiert.
PROVISIONING Der Status PROVISIONING gibt an, dass der Cluster erstellt wird.
RUNNING Der Status „RUNNING“ gibt an, dass der Cluster erstellt wurde und vollständig nutzbar ist.
RECONCILING Der Status RECONCILING gibt an, dass der Cluster aktualisiert wird. Er ist weiterhin verfügbar, aber die Leistung ist möglicherweise beeinträchtigt.
STOPPING Der Status STOPPING gibt an, dass der Cluster gelöscht wird.
ERROR Der Status „ERROR“ gibt an, dass sich der Cluster in einem fehlerhaften, nicht wiederherstellbaren Zustand befindet.
DEGRADED Der Status „DEGRADED“ gibt an, dass zum Wiederherstellen der vollen Funktionalität des Clusters eine Nutzeraktion erforderlich ist.

BareMetalNetworkConfig

Gibt die Cluster-Netzwerkkonfiguration an.

JSON-Darstellung
{
  "advancedNetworking": boolean,
  "multipleNetworkInterfacesConfig": {
    object (BareMetalMultipleNetworkInterfacesConfig)
  },
  "srIovConfig": {
    object (BareMetalSrIovConfig)
  },

  // Union field cluster_cidr_configuration can be only one of the following:
  "islandModeCidr": {
    object (BareMetalIslandModeCidrConfig)
  }
  // End of list of possible types for union field cluster_cidr_configuration.
}
Felder
advancedNetworking

boolean

Ermöglicht die Verwendung erweiterter Anthos-Netzwerkfunktionen wie gebündeltes Load-Balancing mit BGP oder das NAT-Gateway für ausgehenden Traffic. Wenn Sie die Konfiguration für erweiterte Netzwerkfunktionen festlegen, wird dieses Flag automatisch gesetzt.

multipleNetworkInterfacesConfig

object (BareMetalMultipleNetworkInterfacesConfig)

Konfiguration für mehrere Netzwerkschnittstellen.

srIovConfig

object (BareMetalSrIovConfig)

Konfiguration für SR-IOV.

Union-Feld cluster_cidr_configuration. Die CIDR-Konfiguration, die im Bare-Metal-Nutzercluster verwendet werden soll. Für cluster_cidr_configuration ist nur einer der folgenden Werte zulässig:
islandModeCidr

object (BareMetalIslandModeCidrConfig)

Konfiguration für den CIDR-Block des Inselmodus. In einem Netzwerk im Inselmodus haben Knoten eindeutige IP-Adressen, aber Pods haben keine eindeutigen Adressen über Cluster hinweg. Das verursacht keine Probleme, da Pods in einem Cluster nie direkt mit Pods in einem anderen Cluster kommunizieren. Stattdessen gibt es Gateways, die zwischen einem Pod in einem Cluster und einem Pod in einem anderen Cluster vermitteln.

BareMetalIslandModeCidrConfig

Gibt die CIDR-Konfiguration des Clusters an, wenn der Inselmodus ausgeführt wird.

JSON-Darstellung
{
  "serviceAddressCidrBlocks": [
    string
  ],
  "podAddressCidrBlocks": [
    string
  ]
}
Felder
serviceAddressCidrBlocks[]

string

Erforderlich. Allen Diensten im Cluster wird eine RFC1918-IPv4-Adresse aus diesen Bereichen zugewiesen. Dieses Feld ist ab Version 1.15 nach der Erstellung änderbar.

podAddressCidrBlocks[]

string

Erforderlich. Allen Pods im Cluster wird eine RFC1918-IPv4-Adresse aus diesen Bereichen zugewiesen. Dieses Feld kann nach dem Erstellen nicht mehr geändert werden.

BareMetalMultipleNetworkInterfacesConfig

Gibt die Clusterkonfiguration für mehrere Netzwerkschnittstellen an.

JSON-Darstellung
{
  "enabled": boolean
}
Felder
enabled

boolean

Gibt an, ob mehrere Netzwerkschnittstellen für Ihre Pods aktiviert werden sollen.

Wenn Sie diese Option festlegen, wird „networkConfig.advanced_networking“ automatisch auf „true“ gesetzt.

BareMetalSrIovConfig

Gibt die Konfiguration des SR-IOV-Netzwerkoperators an.

JSON-Darstellung
{
  "enabled": boolean
}
Felder
enabled

boolean

Gibt an, ob der SR-IOV-Operator installiert werden soll.

BareMetalControlPlaneConfig

Gibt die Konfiguration der Steuerungsebene an.

JSON-Darstellung
{
  "controlPlaneNodePoolConfig": {
    object (BareMetalControlPlaneNodePoolConfig)
  },
  "apiServerArgs": [
    {
      object (BareMetalApiServerArgument)
    }
  ]
}
Felder
controlPlaneNodePoolConfig

object (BareMetalControlPlaneNodePoolConfig)

Erforderlich. Konfiguriert den Knotenpool, auf dem die Steuerungsebene ausgeführt wird.

apiServerArgs[]

object (BareMetalApiServerArgument)

Passt die Standardargumente des API-Servers an. Es wird nur eine Teilmenge der benutzerdefinierten Flags unterstützt. Das genaue Format finden Sie in der API-Serverdokumentation.

BareMetalControlPlaneNodePoolConfig

Gibt die Konfiguration des Knotenpools der Steuerungsebene an.

JSON-Darstellung
{
  "nodePoolConfig": {
    object (BareMetalNodePoolConfig)
  }
}
Felder
nodePoolConfig

object (BareMetalNodePoolConfig)

Erforderlich. Die generische Konfiguration für einen Knotenpool, auf dem die Steuerungsebene ausgeführt wird.

BareMetalApiServerArgument

Stellt ein Name->Wert-Paar für ein Argument dar. Es wird nur eine Teilmenge der benutzerdefinierten Flags unterstützt. Das genaue Format finden Sie in der API-Serverdokumentation.

JSON-Darstellung
{
  "argument": string,
  "value": string
}
Felder
argument

string

Erforderlich. Der Argumentname, wie er in der Befehlszeile des API-Servers angezeigt wird. Achten Sie darauf, die führenden Bindestriche zu entfernen.

value

string

Erforderlich. Der Wert des Arguments, wie er an die Befehlszeile des API-Servers übergeben wird.

BareMetalLoadBalancerConfig

Gibt die Load-Balancer-Konfiguration an.

JSON-Darstellung
{
  "vipConfig": {
    object (BareMetalVipConfig)
  },
  "portConfig": {
    object (BareMetalPortConfig)
  },

  // Union field load_balancer_configuration can be only one of the following:
  "metalLbConfig": {
    object (BareMetalMetalLbConfig)
  },
  "manualLbConfig": {
    object (BareMetalManualLbConfig)
  },
  "bgpLbConfig": {
    object (BareMetalBgpLbConfig)
  }
  // End of list of possible types for union field load_balancer_configuration.
}
Felder
vipConfig

object (BareMetalVipConfig)

Die vom Load-Balancer verwendeten VIPs.

portConfig

object (BareMetalPortConfig)

Konfiguriert die Ports, an denen der Load-Balancer auf Anfragen wartet.

Union-Feld load_balancer_configuration. Die Load-Balancer-Konfiguration für den Bare-Metal-Nutzercluster. Für load_balancer_configuration ist nur einer der folgenden Werte zulässig:
metalLbConfig

object (BareMetalMetalLbConfig)

Konfiguration für MetalLB-Load-Balancer.

manualLbConfig

object (BareMetalManualLbConfig)

Manuell konfigurierte Load-Balancer.

bgpLbConfig

object (BareMetalBgpLbConfig)

Konfiguration für BGP-Load-Balancer mit Typ.

Wenn Sie diese Option festlegen, wird „networkConfig.advanced_networking“ automatisch auf „true“ gesetzt.

BareMetalVipConfig

Gibt die VIP-Konfiguration für den Bare Metal-Load-Balancer an.

JSON-Darstellung
{
  "controlPlaneVip": string,
  "ingressVip": string
}
Felder
controlPlaneVip

string

Die VIP, die Sie zuvor für die Kubernetes API dieses Bare-Metal-Nutzerclusters reserviert haben.

ingressVip

string

Die VIP, die Sie zuvor für eingehenden Traffic in diesen Bare-Metal-Nutzercluster reserviert haben.

BareMetalPortConfig

Gibt Load-Balancer-Ports für den Bare-Metal-Nutzercluster an.

JSON-Darstellung
{
  "controlPlaneLoadBalancerPort": integer
}
Felder
controlPlaneLoadBalancerPort

integer

Der Port, den von der Steuerungsebene gehostete Load Balancer überwachen.

BareMetalMetalLbConfig

Stellt Konfigurationsparameter für einen MetalLB-Load-Balancer dar.

JSON-Darstellung
{
  "addressPools": [
    {
      object (BareMetalLoadBalancerAddressPool)
    }
  ],
  "loadBalancerNodePoolConfig": {
    object (BareMetalLoadBalancerNodePoolConfig)
  }
}
Felder
addressPools[]

object (BareMetalLoadBalancerAddressPool)

Erforderlich. „AddressPools“ ist eine Liste nicht überlappender IP-Pools, die von Diensten vom Typ „Load-Balancer“ verwendet werden. Alle Adressen müssen zu Load-Balancer-Knoten weitergeleitet werden können. Die Ingress-VIP muss in den Pools enthalten sein.

loadBalancerNodePoolConfig

object (BareMetalLoadBalancerNodePoolConfig)

Gibt den Knotenpool an, in dem der Load-Balancer ausgeführt wird. Zwischen den Knoten in diesem Pool ist eine L2-Verbindung erforderlich. Wenn er fehlt, wird der Knotenpool der Steuerungsebene als Load-Balancer-Pool verwendet.

BareMetalLoadBalancerAddressPool

Stellt einen IP-Pool dar, der vom Load-Balancer verwendet wird.

JSON-Darstellung
{
  "pool": string,
  "addresses": [
    string
  ],
  "avoidBuggyIps": boolean,
  "manualAssign": boolean
}
Felder
pool

string

Erforderlich. Der Name des Adresspools.

addresses[]

string

Erforderlich. Die Adressen, die zu diesem Pool gehören. Jede Adresse muss entweder im CIDR-Format (1.2.3.0/24) oder im Bereichsformat (1.2.3.1–1.2.3.5) vorliegen.

avoidBuggyIps

boolean

Bei „true“ werden keine IPs verwendet, die auf „.0“ oder „.255“ enden. Dadurch wird verhindert, dass fehlerhafte Geräte versehentlich IPv4-Traffic für diese speziellen IP-Adressen löschen.

manualAssign

boolean

Wenn „true“, wird verhindert, dass IP-Adressen automatisch zugewiesen werden.

BareMetalLoadBalancerNodePoolConfig

Gibt die Knotenpoolkonfiguration des Load-Balancers an.

JSON-Darstellung
{
  "nodePoolConfig": {
    object (BareMetalNodePoolConfig)
  }
}
Felder
nodePoolConfig

object (BareMetalNodePoolConfig)

Die generische Konfiguration für einen Knotenpool, in dem ein Load-Balancer ausgeführt wird.

BareMetalManualLbConfig

Stellt Konfigurationsparameter für einen manuellen Load Balancer dar.

JSON-Darstellung
{
  "enabled": boolean
}
Felder
enabled

boolean

Gibt an, ob das manuelle Load-Balancing aktiviert ist.

BareMetalBgpLbConfig

BareMetalBgpLbConfig stellt Konfigurationsparameter für einen BGP-Load-Balancer (Border Gateway Protocol) dar.

JSON-Darstellung
{
  "asn": string,
  "bgpPeerConfigs": [
    {
      object (BareMetalBgpPeerConfig)
    }
  ],
  "addressPools": [
    {
      object (BareMetalLoadBalancerAddressPool)
    }
  ],
  "loadBalancerNodePoolConfig": {
    object (BareMetalLoadBalancerNodePoolConfig)
  }
}
Felder
asn

string (int64 format)

Erforderlich. Die BGP-Nummer des autonomen Systems (Autonomous System Number, ASN) des Clusters. Dieses Feld kann nach der Clustererstellung aktualisiert werden.

bgpPeerConfigs[]

object (BareMetalBgpPeerConfig)

Erforderlich. Die Liste der BGP-Peers, mit denen der Cluster eine Verbindung herstellt. Für jeden Knoten der Steuerungsebene muss mindestens ein Peer konfiguriert sein.

Knoten der Steuerungsebene stellen eine Verbindung zu diesen Peers her, um die VIP der Steuerungsebene zu bewerben. Der Services-Load-Balancer verwendet diese Peers standardmäßig ebenfalls.

Dieses Feld kann nach der Clustererstellung aktualisiert werden.

addressPools[]

object (BareMetalLoadBalancerAddressPool)

Erforderlich. „AddressPools“ ist eine Liste nicht überlappender IP-Pools, die von Diensten vom Typ „Load-Balancer“ verwendet werden. Alle Adressen müssen zu Load-Balancer-Knoten weitergeleitet werden können. Die Ingress-VIP muss in den Pools enthalten sein.

loadBalancerNodePoolConfig

object (BareMetalLoadBalancerNodePoolConfig)

Gibt den Knotenpool an, in dem das Load-Balancing der Datenebene ausgeführt wird. Zwischen den Knoten in diesem Pool ist eine L2-Verbindung erforderlich. Falls nicht vorhanden, wird der Knotenpool der Steuerungsebene für das Load-Balancing der Datenebene verwendet.

BareMetalBgpPeerConfig

BareMetalBgpPeerConfig stellt Konfigurationsparameter für einen BGP-Peer (Border Gateway Protocol) dar.

JSON-Darstellung
{
  "asn": string,
  "ipAddress": string,
  "controlPlaneNodes": [
    string
  ]
}
Felder
asn

string (int64 format)

Erforderlich. Die BGP-Nummer des autonomen Systems (Autonomous System Number, ASN) für das Netzwerk, das das externe Peer-Gerät enthält.

ipAddress

string

Erforderlich. Die IP-Adresse des externen Peer-Geräts.

controlPlaneNodes[]

string

Die IP-Adresse des Knotens auf der Steuerungsebene, der eine Verbindung zum externen Peer herstellt. Wenn Sie keine Knoten auf Steuerungsebene angeben, können alle Knoten auf Steuerungsebene eine Verbindung zum externen Peer herstellen. Wenn Sie eine oder mehrere IP-Adressen angeben, nehmen nur die angegebenen Knoten an Peering-Sitzungen teil.

BareMetalStorageConfig

BareMetalStorageConfig gibt die Clusterspeicherkonfiguration an.

JSON-Darstellung
{
  "lvpShareConfig": {
    object (BareMetalLvpShareConfig)
  },
  "lvpNodeMountsConfig": {
    object (BareMetalLvpConfig)
  }
}
Felder
lvpShareConfig

object (BareMetalLvpShareConfig)

Erforderlich. Gibt die Konfiguration für lokale PersistentVolumes an, die von Unterverzeichnissen in einem freigegebenen Dateisystem gestützt werden. Diese Unterverzeichnisse werden bei der Clustererstellung automatisch erstellt.

lvpNodeMountsConfig

object (BareMetalLvpConfig)

Erforderlich. Gibt die Konfiguration für lokale PersistentVolumes an, die durch bereitgestellte Knotenlaufwerke gestützt werden. Diese Laufwerke müssen vom Nutzer formatiert und bereitgestellt werden, was vor oder nach der Clustererstellung erfolgen kann.

BareMetalProxyConfig

Gibt die Cluster-Proxykonfiguration an.

JSON-Darstellung
{
  "uri": string,
  "noProxy": [
    string
  ]
}
Felder
uri

string

Erforderlich. Gibt die Adresse Ihres Proxyservers an. Beispiele: http://domain

Geben Sie keine Anmeldedaten im Format http://(username:password@)domain an, da diese vom Server abgelehnt werden.

noProxy[]

string

Eine Liste von IP-Adressen, Hostnamen und Domains, die den Proxy umgehen sollen. Beispiele: ["127.0.0.1", "beispiel.de", ".corp", "localhost"].

BareMetalClusterOperationsConfig

Gibt die Observability-Infrastruktur des Bare-Metal-Nutzerclusters an.

JSON-Darstellung
{
  "enableApplicationLogs": boolean
}
Felder
enableApplicationLogs

boolean

Gibt an, ob die Erfassung von Anwendungslogs/-messwerten (zusätzlich zu Systemlogs/-messwerten) aktiviert werden soll.

BareMetalMaintenanceConfig

Gibt Konfigurationen an, um Bare Metal-Knoten in den Wartungsmodus zu versetzen und aus dem Wartungsmodus zu entfernen.

JSON-Darstellung
{
  "maintenanceAddressCidrBlocks": [
    string
  ]
}
Felder
maintenanceAddressCidrBlocks[]

string

Erforderlich. Alle IPv4-Adressen aus diesen Bereichen werden in den Wartungsmodus versetzt. Knoten im Wartungsmodus werden gesperrt und entleert. Wenn beides zutrifft, wird die Annotation „baremetal.cluster.gke.io/maintenance“ für die Knotenressource festgelegt.

BareMetalWorkloadNodeConfig

Gibt die Konfigurationen für Arbeitslastknoten an.

JSON-Darstellung
{
  "maxPodsPerNode": string,
  "containerRuntime": enum (ContainerRuntime)
}
Felder
maxPodsPerNode

string (int64 format)

Die maximale Anzahl von Pods, die auf einem Knoten ausgeführt werden können. Die Größe des CIDR-Bereichs, der dem Knoten zugewiesen wird, wird aus diesem Parameter abgeleitet.

containerRuntime

enum (ContainerRuntime)

Gibt an, welche Containerlaufzeit verwendet wird.

ContainerRuntime

Die Laufzeit, die zum Ausführen von Containern in diesem Nutzercluster verwendet wird.

Enums
CONTAINER_RUNTIME_UNSPECIFIED Es wurde keine Containerlaufzeit ausgewählt.
CONTAINERD Containerd-Laufzeit.

BareMetalSecurityConfig

Gibt die sicherheitsrelevanten Einstellungen für den Bare-Metal-Nutzercluster an.

JSON-Darstellung
{
  "authorization": {
    object (Authorization)
  }
}
Felder
authorization

object (Authorization)

Konfiguriert den Nutzerzugriff auf den Nutzercluster.

BareMetalMaintenanceStatus

Gibt den Wartungsstatus des Bare-Metal-Nutzerclusters an.

JSON-Darstellung
{
  "machineDrainStatus": {
    object (BareMetalMachineDrainStatus)
  }
}
Felder
machineDrainStatus

object (BareMetalMachineDrainStatus)

Der Wartungsstatus von Knotenmaschinen.

BareMetalMachineDrainStatus

Gibt den Status von Knotencomputern an, die gerade geleert werden.

JSON-Darstellung
{
  "drainingMachines": [
    {
      object (BareMetalDrainingMachine)
    }
  ],
  "drainedMachines": [
    {
      object (BareMetalDrainedMachine)
    }
  ]
}
Felder
drainingMachines[]

object (BareMetalDrainingMachine)

Die Liste der Maschinen, die Strom verbrauchen.

drainedMachines[]

object (BareMetalDrainedMachine)

Die Liste der entleerten Maschinen.

BareMetalDrainingMachine

Stellt einen Computer dar, der gerade per Drain beendet wird.

JSON-Darstellung
{
  "nodeIp": string,
  "podCount": integer
}
Felder
nodeIp

string

IP-Adresse der Maschine, die per Drain beendet wird.

podCount

integer

Die Anzahl der Pods, die noch entleert werden müssen.

BareMetalDrainedMachine

Stellt einen Computer dar, der gerade per Drain beendet wird.

JSON-Darstellung
{
  "nodeIp": string
}
Felder
nodeIp

string

IP-Adresse des geleerten Geräts.

BareMetalNodeAccessConfig

Gibt die Einstellungen für den Knotenzugriff für den Bare-Metal-Nutzercluster an.

JSON-Darstellung
{
  "loginUser": string
}
Felder
loginUser

string

„LoginUser“ ist der Nutzername, der für den Zugriff auf Knotenmaschinen verwendet wird. Wenn nichts festgelegt ist, wird standardmäßig „root“ verwendet.

BareMetalOsEnvironmentConfig

Gibt die Betriebssystemeinstellungen für die Clusterbereitstellung an.

JSON-Darstellung
{
  "packageRepoExcluded": boolean
}
Felder
packageRepoExcluded

boolean

Gibt an, ob das Paket-Repository beim Initialisieren von Bare-Metal-Maschinen nicht berücksichtigt werden soll.

BareMetalClusterUpgradePolicy

BareMetalClusterUpgradePolicy definiert die Cluster-Upgraderichtlinie.

JSON-Darstellung
{
  "policy": enum (NodePoolPolicy),
  "pause": boolean
}
Felder
policy

enum (NodePoolPolicy)

Gibt an, welche Upgraderichtlinie verwendet werden soll.

pause

boolean

Nur Ausgabe. „Pausiert“ wird verwendet, um den Status der Upgrade-Pausierung anzuzeigen. Sie ist derzeit nur im Lesemodus verfügbar.

NodePoolPolicy

Gibt die Upgraderichtlinie für Worker-Knotenpools an.

Enums
NODE_POOL_POLICY_UNSPECIFIED Keine Upgrade-Richtlinie ausgewählt.
SERIAL Führen Sie ein sequenzielles Upgrade der Worker-Knotenpools durch.
CONCURRENT Führen Sie für alle Worker-Knotenpools parallel ein Upgrade durch.

Methoden

create

Erstellt einen neuen Bare-Metal-Cluster in einem angegebenen Projekt und an einem angegebenen Ort.

delete

Löscht einen einzelnen Bare Metal-Cluster.

enroll

Registriert einen vorhandenen Bare Metal-Nutzercluster und seine Knotenpools in der Anthos On-Prem API in einem bestimmten Projekt und an einem bestimmten Standort.

get

Ruft Details zu einem einzelnen Bare-Metal-Cluster ab.

list

Listet Bare-Metal-Cluster in einem angegebenen Projekt und an einem angegebenen Standort auf.

patch

Aktualisiert die Parameter eines einzelnen Bare-Metal-Clusters.

queryVersionConfig

Fragt die Konfiguration der Bare Metal-Nutzerclusterversion ab.