- Risorsa: BareMetalCluster
- Stato
- BareMetalNetworkConfig
- BareMetalIslandModeCidrConfig
- BareMetalMultipleNetworkInterfacesConfig
- BareMetalSrIovConfig
- BareMetalControlPlaneConfig
- BareMetalControlPlaneNodePoolConfig
- BareMetalApiServerArgument
- BareMetalLoadBalancerConfig
- BareMetalVipConfig
- BareMetalPortConfig
- BareMetalMetalLbConfig
- BareMetalLoadBalancerAddressPool
- BareMetalLoadBalancerNodePoolConfig
- BareMetalManualLbConfig
- BareMetalBgpLbConfig
- BareMetalBgpPeerConfig
- BareMetalStorageConfig
- BareMetalProxyConfig
- BareMetalClusterOperationsConfig
- BareMetalMaintenanceConfig
- BareMetalWorkloadNodeConfig
- ContainerRuntime
- BareMetalSecurityConfig
- BareMetalMaintenanceStatus
- BareMetalMachineDrainStatus
- BareMetalDrainingMachine
- BareMetalDrainedMachine
- BareMetalNodeAccessConfig
- BareMetalOsEnvironmentConfig
- BareMetalClusterUpgradePolicy
- NodePoolPolicy
- Metodi
Risorsa: BareMetalCluster
Risorsa che rappresenta un cluster utente bare metal.
Rappresentazione JSON |
---|
{ "name": string, "adminClusterMembership": string, "description": string, "bareMetalVersion": string, "uid": string, "state": enum ( |
Campi | |
---|---|
name |
Immutabile. Il nome della risorsa del cluster utente bare metal. |
admin |
Obbligatorio. Il cluster di amministrazione a cui appartiene questo cluster utente bare metal. Si tratta del nome completo della risorsa dell'appartenenza al parco risorse del cluster di amministrazione. |
description |
Una descrizione leggibile di questo cluster utente bare metal. |
bare |
Obbligatorio. La versione di Anthos clusters on bare metal per il tuo cluster utente. |
uid |
Solo output. L'identificatore univoco del cluster utente bare metal. |
state |
Solo output. Lo stato attuale del cluster utente bare metal. |
endpoint |
Solo output. L'indirizzo IP del server API del cluster utente bare metal. |
reconciling |
Solo output. Se impostato, al momento sono in corso modifiche al cluster utente on bare metal. |
create |
Solo output. La data e l'ora di creazione del cluster utente bare metal. Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: |
update |
Solo output. La data e l'ora dell'ultimo aggiornamento del cluster utente bare metal. Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: |
delete |
Solo output. La data e l'ora in cui è stato eliminato il cluster utente Bare Metal. Se la risorsa non viene eliminata, questo campo deve essere vuoto Utilizza RFC 3339, in cui l'output generato sarà sempre normalizzato in base a Z e utilizza 0, 3, 6 o 9 cifre decimali. Sono accettati anche offset diversi da "Z". Esempi: |
local |
Solo output. Il nome dell'oggetto della risorsa personalizzata del cluster utente bare metal nel cluster di amministrazione associato. Questo campo viene utilizzato per supportare i nomi in conflitto durante la registrazione di cluster esistenti nell'API. Se utilizzato nell'ambito della registrazione del cluster, questo campo sarà diverso dal nome nel nome della risorsa. Per i nuovi cluster, questo campo corrisponderà al nome del cluster fornito dall'utente e sarà visibile nell'ultimo componente del nome della risorsa. Non è modificabile. Quando il nome locale e il nome del cluster sono diversi, il nome locale viene utilizzato nei log del controller del cluster di amministrazione. Utilizza il nome del cluster quando accedi al cluster utilizzando bmctl e kubectl. |
etag |
Solo output. Questo checksum viene calcolato dal server in base al valore di altri campi e può essere inviato per le richieste di aggiornamento ed eliminazione per garantire che il client abbia un valore aggiornato prima di procedere. Consente ai client di eseguire letture, modifiche e scritture coerenti tramite il controllo della concorrenza ottimistico. |
annotations |
Annotazioni sul cluster utente bare metal. Questo campo ha le stesse limitazioni delle annotazioni Kubernetes. La dimensione totale di tutte le chiavi e i valori combinati è limitata a 256 KB. La chiave può avere due segmenti: un prefisso (facoltativo) e un nome (obbligatorio), separati da una barra (/). Il prefisso deve essere un sottodominio DNS. Il nome deve avere una lunghezza massima di 63 caratteri, deve iniziare e terminare con caratteri alfanumerici e può comprendere trattini (-), trattini bassi (_), punti (.) e caratteri alfanumerici. Un oggetto contenente un elenco di coppie |
network |
Obbligatorio. Configurazione di rete. |
control |
Obbligatorio. Configurazione del piano di controllo. |
load |
Obbligatorio. Configurazione del bilanciatore del carico. |
storage |
Obbligatorio. Configurazione dello spazio di archiviazione. |
proxy |
Configurazione del proxy. |
cluster |
Configurazione delle operazioni del cluster. |
maintenance |
Configurazione della manutenzione. |
node |
Configurazione del nodo del workload. |
fleet |
Solo output. Configurazione del parco risorse per il cluster. |
status |
Solo output. Stato dettagliato del cluster. |
validation |
Solo output. Il risultato del controllo preflight. |
security |
Configurazione delle impostazioni relative alla sicurezza. |
maintenance |
Solo output. Stato delle attività di manutenzione in corso. |
admin |
Solo output. Il nome della risorsa del cluster di amministrazione bare metal che gestisce questo cluster utente. |
node |
Configurazioni relative all'accesso ai nodi. |
os |
Configurazioni relative all'ambiente del sistema operativo. |
binary |
Configurazioni relative all'autorizzazione binaria. |
upgrade |
Il criterio di upgrade del cluster. |
Stato
Lo stato del ciclo di vita del cluster utente bare metal.
Enum | |
---|---|
STATE_UNSPECIFIED |
Non impostato. |
PROVISIONING |
Lo stato PROVISIONING indica che il cluster è in fase di creazione. |
RUNNING |
Lo stato RUNNING indica che il cluster è stato creato ed è completamente utilizzabile. |
RECONCILING |
Lo stato RECONCILING indica che il cluster è in fase di aggiornamento. Rimane disponibile, ma con un potenziale calo delle prestazioni. |
STOPPING |
Lo stato STOPPING indica che il cluster è in fase di eliminazione. |
ERROR |
Lo stato ERROR indica che il cluster è in uno stato non recuperabile non funzionante. |
DEGRADED |
Lo stato DEGRADED indica che il cluster richiede un'azione da parte dell'utente per ripristinare la funzionalità completa. |
BareMetalNetworkConfig
Specifica la configurazione di rete del cluster.
Rappresentazione JSON |
---|
{ "advancedNetworking": boolean, "multipleNetworkInterfacesConfig": { object ( |
Campi | |
---|---|
advanced |
Consente l'utilizzo di funzionalità di networking avanzate di Anthos, come il bilanciamento del carico combinato con BGP o il gateway NAT in uscita. L'impostazione della configurazione per le funzionalità di networking avanzate imposterà automaticamente questo flag. |
multiple |
Configurazione per più interfacce di rete. |
sr |
Configurazione per SR-IOV. |
Campo unione cluster_cidr_configuration . La configurazione CIDR da utilizzare nel cluster utente bare metal. cluster_cidr_configuration può essere solo uno dei seguenti: |
|
island |
Configurazione per il CIDR in modalità isola. In una rete in modalità isola, i nodi hanno indirizzi IP univoci, ma i pod non hanno indirizzi univoci nei cluster. Questo non causa problemi perché i pod di un cluster non comunicano mai direttamente con i pod di un altro cluster. Esistono invece gateway che fungono da intermediari tra un pod in un cluster e un pod in un altro cluster. |
BareMetalIslandModeCidrConfig
Specifica la configurazione CIDR del cluster durante l'esecuzione in modalità isola.
Rappresentazione JSON |
---|
{ "serviceAddressCidrBlocks": [ string ], "podAddressCidrBlocks": [ string ] } |
Campi | |
---|---|
service |
Obbligatorio. A tutti i servizi del cluster viene assegnato un indirizzo IPv4 RFC1918 da questi intervalli. Questo campo è modificabile dopo la creazione a partire dalla versione 1.15. |
pod |
Obbligatorio. A tutti i pod del cluster viene assegnato un indirizzo IPv4 RFC1918 da questi intervalli. Questo campo non può essere modificato dopo la creazione. |
BareMetalMultipleNetworkInterfacesConfig
Specifica la configurazione del cluster con più interfacce di rete.
Rappresentazione JSON |
---|
{ "enabled": boolean } |
Campi | |
---|---|
enabled |
Indica se abilitare più interfacce di rete per i pod. Se impostato, networkConfig.advanced_networking viene impostato automaticamente su true. |
BareMetalSrIovConfig
Specifica la configurazione dell'operatore di rete SR-IOV.
Rappresentazione JSON |
---|
{ "enabled": boolean } |
Campi | |
---|---|
enabled |
Se installare l'operatore SR-IOV. |
BareMetalControlPlaneConfig
Specifica la configurazione del piano di controllo.
Rappresentazione JSON |
---|
{ "controlPlaneNodePoolConfig": { object ( |
Campi | |
---|---|
control |
Obbligatorio. Configura il pool di nodi che esegue il piano di controllo. |
api |
Personalizza gli argomenti del server API predefiniti. È supportato solo un sottoinsieme di flag personalizzati. Per il formato esatto, consulta la documentazione del server API. |
BareMetalControlPlaneNodePoolConfig
Specifica la configurazione del pool di nodi del piano di controllo.
Rappresentazione JSON |
---|
{
"nodePoolConfig": {
object ( |
Campi | |
---|---|
node |
Obbligatorio. La configurazione generica per un pool di nodi che esegue il piano di controllo. |
BareMetalApiServerArgument
Rappresenta una coppia nome->valore dell'argomento. È supportato solo un sottoinsieme di flag personalizzati. Per il formato esatto, consulta la documentazione del server API.
Rappresentazione JSON |
---|
{ "argument": string, "value": string } |
Campi | |
---|---|
argument |
Obbligatorio. Il nome dell'argomento come visualizzato nella riga di comando del server API. Assicurati di rimuovere i trattini iniziali. |
value |
Obbligatorio. Il valore dell'argomento che verrà passato alla riga di comando del server API. |
BareMetalLoadBalancerConfig
Specifica la configurazione del bilanciatore del carico.
Rappresentazione JSON |
---|
{ "vipConfig": { object ( |
Campi | |
---|---|
vip |
I VIP utilizzati dal bilanciatore del carico. |
port |
Configura le porte su cui il bilanciatore del carico rimarrà in ascolto. |
Campo unione load_balancer_configuration . La configurazione del bilanciatore del carico per il cluster utente bare metal. load_balancer_configuration può essere solo uno dei seguenti: |
|
metal |
Configurazione per i bilanciatori del carico MetalLB. |
manual |
Bilanciatori del carico configurati manualmente. |
bgp |
Configurazione per i bilanciatori del carico con tipo BGP. Se impostato, networkConfig.advanced_networking viene impostato automaticamente su true. |
BareMetalVipConfig
Specifica la configurazione VIP per il bilanciatore del carico bare metal.
Rappresentazione JSON |
---|
{ "controlPlaneVip": string, "ingressVip": string } |
Campi | |
---|---|
control |
L'IP virtuale che hai riservato in precedenza per l'API Kubernetes di questo cluster utente bare metal. |
ingress |
Il VIP che hai riservato in precedenza per il traffico in entrata in questo cluster utente bare metal. |
BareMetalPortConfig
Specifica le porte del bilanciatore del carico per il cluster utente bare metal.
Rappresentazione JSON |
---|
{ "controlPlaneLoadBalancerPort": integer } |
Campi | |
---|---|
control |
La porta su cui i bilanciatori del carico ospitati dal control plane saranno in ascolto. |
BareMetalMetalLbConfig
Rappresenta i parametri di configurazione per un bilanciatore del carico MetalLB.
Rappresentazione JSON |
---|
{ "addressPools": [ { object ( |
Campi | |
---|---|
address |
Obbligatorio. AddressPools è un elenco di pool di IP che non si sovrappongono utilizzati dai servizi di tipo bilanciatore del carico. Tutti gli indirizzi devono essere instradabili ai nodi del bilanciatore del carico. IngressVIP deve essere incluso nei pool. |
load |
Specifica il pool di nodi su cui è in esecuzione il bilanciatore del carico. È necessaria la connettività L2 tra i nodi di questo pool. Se non è presente, il pool di nodi del control plane viene utilizzato come pool del bilanciatore del carico. |
BareMetalLoadBalancerAddressPool
Rappresenta un pool di IP utilizzato dal bilanciatore del carico.
Rappresentazione JSON |
---|
{ "pool": string, "addresses": [ string ], "avoidBuggyIps": boolean, "manualAssign": boolean } |
Campi | |
---|---|
pool |
Obbligatorio. Il nome del pool di indirizzi. |
addresses[] |
Obbligatorio. Gli indirizzi che fanno parte di questo pool. Ogni indirizzo deve essere nel formato CIDR (1.2.3.0/24) o nell'intervallo (1.2.3.1-1.2.3.5). |
avoid |
Se il valore è true, evita di utilizzare indirizzi IP che terminano con .0 o .255. In questo modo, i dispositivi consumer con bug non interrompono per errore il traffico IPv4 per questi indirizzi IP speciali. |
manual |
Se true, impedisce l'assegnazione automatica degli indirizzi IP. |
BareMetalLoadBalancerNodePoolConfig
Specifica la configurazione del pool di nodi del bilanciatore del carico.
Rappresentazione JSON |
---|
{
"nodePoolConfig": {
object ( |
Campi | |
---|---|
node |
La configurazione generica per un pool di nodi che esegue un bilanciatore del carico. |
BareMetalManualLbConfig
Rappresenta i parametri di configurazione per un bilanciatore del carico manuale.
Rappresentazione JSON |
---|
{ "enabled": boolean } |
Campi | |
---|---|
enabled |
Indica se il bilanciamento del carico manuale è abilitato. |
BareMetalBgpLbConfig
BareMetalBgpLbConfig rappresenta i parametri di configurazione di un bilanciatore del carico BGP (Border Gateway Protocol).
Rappresentazione JSON |
---|
{ "asn": string, "bgpPeerConfigs": [ { object ( |
Campi | |
---|---|
asn |
Obbligatorio. Numero di sistema autonomo (ASN) BGP del cluster. Questo campo può essere aggiornato dopo la creazione del cluster. |
bgp |
Obbligatorio. L'elenco dei peer BGP a cui si connetterà il cluster. Per ogni nodo del piano di controllo deve essere configurato almeno un peer. I nodi del piano di controllo si connettono a questi peer per pubblicizzare il VIP del piano di controllo. Anche il bilanciatore del carico dei servizi utilizza questi peer per impostazione predefinita. Questo campo può essere aggiornato dopo la creazione del cluster. |
address |
Obbligatorio. AddressPools è un elenco di pool di IP che non si sovrappongono utilizzati dai servizi di tipo bilanciatore del carico. Tutti gli indirizzi devono essere instradabili ai nodi del bilanciatore del carico. IngressVIP deve essere incluso nei pool. |
load |
Specifica il pool di nodi che esegue il bilanciamento del carico del piano dati. È necessaria la connettività L2 tra i nodi di questo pool. Se non è presente, il pool di nodi del piano di controllo viene utilizzato per il bilanciamento del carico del piano di dati. |
BareMetalBgpPeerConfig
BareMetalBgpPeerConfig rappresenta i parametri di configurazione per un peer Border Gateway Protocol (BGP).
Rappresentazione JSON |
---|
{ "asn": string, "ipAddress": string, "controlPlaneNodes": [ string ] } |
Campi | |
---|---|
asn |
Obbligatorio. Numero di sistema autonomo (ASN) BGP per la rete che contiene il dispositivo peer esterno. |
ip |
Obbligatorio. L'indirizzo IP del dispositivo peer esterno. |
control |
L'indirizzo IP del nodo del piano di controllo che si connette al peer esterno. Se non specifichi alcun nodo del piano di controllo, tutti i nodi del piano di controllo possono connettersi al peer esterno. Se specifichi uno o più indirizzi IP, solo i nodi specificati partecipano alle sessioni di peering. |
BareMetalStorageConfig
BareMetalStorageConfig specifica la configurazione dello storage del cluster.
Rappresentazione JSON |
---|
{ "lvpShareConfig": { object ( |
Campi | |
---|---|
lvp |
Obbligatorio. Specifica la configurazione per i volumi permanenti locali supportati da sottodirectory in un file system condiviso. Queste sottodirectory vengono create automaticamente durante la creazione del cluster. |
lvp |
Obbligatorio. Specifica la configurazione per i volumi permanenti locali supportati dai dischi dei nodi montati. Questi dischi devono essere formattati e montati dall'utente prima o dopo la creazione del cluster. |
BareMetalProxyConfig
Specifica la configurazione del proxy del cluster.
Rappresentazione JSON |
---|
{ "uri": string, "noProxy": [ string ] } |
Campi | |
---|---|
uri |
Obbligatorio. Specifica l'indirizzo del server proxy. Esempi: Non fornire le credenziali nel formato |
no |
Un elenco di IP, nomi host e domini che devono saltare il proxy. Esempi: ["127.0.0.1", "example.com", ".corp", "localhost"]. |
BareMetalClusterOperationsConfig
Specifica l'infrastruttura di osservabilità del cluster utente bare metal.
Rappresentazione JSON |
---|
{ "enableApplicationLogs": boolean } |
Campi | |
---|---|
enable |
Indica se deve essere abilitata la raccolta di metriche/log delle applicazioni (oltre a quelle di sistema). |
BareMetalMaintenanceConfig
Specifica le configurazioni per mettere in manutenzione e rimuovere dalla manutenzione i nodi bare metal.
Rappresentazione JSON |
---|
{ "maintenanceAddressCidrBlocks": [ string ] } |
Campi | |
---|---|
maintenance |
Obbligatorio. Tutti gli indirizzi IPv4 di questi intervalli verranno inseriti in modalità di manutenzione. I nodi in modalità di manutenzione verranno messi in isolamento e svuotati. Se entrambe le condizioni sono vere, l'annotazione "baremetal.cluster.gke.io/maintenance" verrà impostata sulla risorsa del nodo. |
BareMetalWorkloadNodeConfig
Specifica le configurazioni dei nodi del carico di lavoro.
Rappresentazione JSON |
---|
{
"maxPodsPerNode": string,
"containerRuntime": enum ( |
Campi | |
---|---|
max |
Il numero massimo di pod che un nodo può eseguire. La dimensione dell'intervallo CIDR assegnato al nodo verrà ricavata da questo parametro. |
container |
Specifica il runtime del container da utilizzare. |
ContainerRuntime
Il runtime utilizzato per eseguire i container in questo cluster di utenti.
Enum | |
---|---|
CONTAINER_RUNTIME_UNSPECIFIED |
Nessun runtime del contenitore selezionato. |
CONTAINERD |
Runtime Containerd. |
BareMetalSecurityConfig
Specifica le impostazioni relative alla sicurezza per il cluster utente Bare Metal.
Rappresentazione JSON |
---|
{
"authorization": {
object ( |
Campi | |
---|---|
authorization |
Configura l'accesso utente al cluster utente. |
BareMetalMaintenanceStatus
Rappresenta lo stato di manutenzione del cluster utente bare metal.
Rappresentazione JSON |
---|
{
"machineDrainStatus": {
object ( |
Campi | |
---|---|
machine |
Lo stato della manutenzione delle macchine nodo. |
BareMetalMachineDrainStatus
Rappresenta lo stato delle macchine dei nodi in fase di operazione di svuotamento.
Rappresentazione JSON |
---|
{ "drainingMachines": [ { object ( |
Campi | |
---|---|
draining |
L'elenco delle macchine di pompaggio. |
drained |
L'elenco delle macchine prosciugate. |
BareMetalDrainingMachine
Rappresenta una macchina in fase di svuotamento.
Rappresentazione JSON |
---|
{ "nodeIp": string, "podCount": integer } |
Campi | |
---|---|
node |
Indirizzo IP della macchina di svuotamento. |
pod |
Il conteggio dei pod da svuotare. |
BareMetalDrainedMachine
Rappresenta una macchina attualmente scarica.
Rappresentazione JSON |
---|
{ "nodeIp": string } |
Campi | |
---|---|
node |
Indirizzo IP della macchina svuotata. |
BareMetalNodeAccessConfig
Specifica le impostazioni relative all'accesso ai nodi per il cluster utente Bare Metal.
Rappresentazione JSON |
---|
{ "loginUser": string } |
Campi | |
---|---|
login |
LoginUser è il nome utente utilizzato per accedere alle macchine dei nodi. Se non viene impostato, il valore predefinito è "root". |
BareMetalOsEnvironmentConfig
Specifica le impostazioni del sistema operativo per il provisioning del cluster.
Rappresentazione JSON |
---|
{ "packageRepoExcluded": boolean } |
Campi | |
---|---|
package |
Indica se il repository del pacchetto non deve essere incluso durante l'inizializzazione delle macchine bare metal. |
BareMetalClusterUpgradePolicy
BareMetalClusterUpgradePolicy definisce il criterio di upgrade del cluster.
Rappresentazione JSON |
---|
{
"policy": enum ( |
Campi | |
---|---|
policy |
Specifica quale criterio di upgrade utilizzare. |
pause |
Solo output. La modalità In pausa viene utilizzata per mostrare lo stato di pausa dell'upgrade. Per il momento è solo di visualizzazione. |
NodePoolPolicy
Specifica il criterio di upgrade per i pool di nodi worker.
Enum | |
---|---|
NODE_POOL_POLICY_UNSPECIFIED |
Nessun criterio di upgrade selezionato. |
SERIAL |
Esegui l'upgrade dei pool di nodi worker in sequenza. |
CONCURRENT |
Esegui l'upgrade di tutti i pool di nodi worker in parallelo. |
Metodi |
|
---|---|
|
Crea un nuovo cluster bare metal in un determinato progetto e località. |
|
Consente di eliminare un singolo cluster bare metal. |
|
Registra un cluster utente bare metal esistente e i relativi pool di nodi nell'API Anthos On-Prem in un determinato progetto e località. |
|
Recupera i dettagli di un singolo cluster bare metal. |
|
Elenca i cluster bare metal in un determinato progetto e località. |
|
Aggiorna i parametri di un singolo cluster bare metal. |
|
Esegue query sulla configurazione della versione del cluster utente bare metal. |