- 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. |
adminClusterMembership |
Obbligatorio. Il cluster di amministrazione a cui appartiene questo cluster utente Bare Metal. Questo è il nome completo della risorsa dell'appartenenza al parco risorse del cluster di amministrazione. |
description |
Una descrizione leggibile di questo cluster utente bare metal. |
bareMetalVersion |
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, sono attualmente in corso modifiche al cluster utente bare metal. |
createTime |
Solo output. L'ora in cui è stato creato il cluster utente bare metal. Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
updateTime |
Solo output. La data e l'ora dell'ultimo aggiornamento del cluster utente bare metal. Utilizza RFC 3339, in cui l'output generato è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
deleteTime |
Solo output. 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 è sempre normalizzato in base al fuso orario UTC e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: |
localName |
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 nomi in conflitto durante la registrazione di cluster esistenti all'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. Utilizzi 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 nelle richieste di aggiornamento ed eliminazione per garantire che il client disponga di un valore aggiornato prima di procedere. Consente ai client di eseguire operazioni di lettura-modifica-scrittura coerenti tramite controllo della contemporaneità 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: prefisso (facoltativo) e 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 |
networkConfig |
Obbligatorio. Configurazione di rete. |
controlPlane |
Obbligatorio. Configurazione del control plane. |
loadBalancer |
Obbligatorio. Configurazione del bilanciatore del carico. |
storage |
Obbligatorio. Configurazione dello spazio di archiviazione. |
proxy |
Configurazione del proxy. |
clusterOperations |
Configurazione delle operazioni del cluster. |
maintenanceConfig |
Configurazione della manutenzione. |
nodeConfig |
Configurazione del nodo del workload. |
fleet |
Solo output. Configurazione del parco risorse per il cluster. |
status |
Solo output. Stato dettagliato del cluster. |
validationCheck |
Solo output. Il risultato del controllo preflight. |
securityConfig |
Configurazione delle impostazioni relative alla sicurezza. |
maintenanceStatus |
Solo output. Stato delle attività di manutenzione in corso. |
adminClusterName |
Solo output. Il nome risorsa del cluster di amministrazione Bare Metal che gestisce questo cluster utente. |
nodeAccessConfig |
Configurazioni relative all'accesso ai nodi. |
osEnvironmentConfig |
Configurazioni relative all'ambiente del sistema operativo. |
binaryAuthorization |
Configurazioni correlate all'autorizzazione binaria. |
upgradePolicy |
Policy di upgrade del cluster. |
localNamespace |
Solo output. Lo spazio dei nomi 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 potenzialmente con prestazioni ridotte. |
STOPPING |
Lo stato STOPPING indica che il cluster è in fase di eliminazione. |
ERROR |
Lo stato ERROR indica che il cluster è in uno stato non funzionante e non recuperabile. |
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 | |
---|---|
advancedNetworking |
Consente l'utilizzo di funzionalità di networking avanzate di Anthos, come il bilanciamento del carico in bundle con BGP o il gateway NAT in uscita. La configurazione delle impostazioni per le funzionalità di networking avanzate imposterà automaticamente questo flag. |
multipleNetworkInterfacesConfig |
Configurazione per più interfacce di rete. |
srIovConfig |
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: |
|
islandModeCidr |
Configurazione per il CIDR della modalità isolata. In una rete in modalità isolata, i nodi hanno indirizzi IP univoci, ma i pod non hanno indirizzi univoci nei cluster. Ciò non causa problemi perché i pod di un cluster non comunicano mai direttamente con i pod di un altro cluster. Esistono invece gateway che fanno 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à isolata.
Rappresentazione JSON |
---|
{ "serviceAddressCidrBlocks": [ string ], "podAddressCidrBlocks": [ string ] } |
Campi | |
---|---|
serviceAddressCidrBlocks[] |
Obbligatorio. A tutti i servizi del cluster viene assegnato un indirizzo IPv4 RFC1918 in questi intervalli. Questo campo è modificabile dopo la creazione a partire dalla versione 1.15. |
podAddressCidrBlocks[] |
Obbligatorio. A tutti i pod del cluster viene assegnato un indirizzo IPv4 RFC1918 in 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. Quando viene impostato networkConfig.advanced_networking, questo valore 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 control plane.
Rappresentazione JSON |
---|
{ "controlPlaneNodePoolConfig": { object ( |
Campi | |
---|---|
controlPlaneNodePoolConfig |
Obbligatorio. Configura il pool di nodi che esegue il control plane. |
apiServerArgs[] |
Personalizza gli argomenti predefiniti del server API. È 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 control plane.
Rappresentazione JSON |
---|
{
"nodePoolConfig": {
object ( |
Campi | |
---|---|
nodePoolConfig |
Obbligatorio. La configurazione generica per un pool di nodi che esegue il control plane. |
BareMetalApiServerArgument
Rappresenta una coppia nome-valore di argomenti. È 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 appare nella riga di comando del server API. Assicurati di rimuovere i trattini iniziali. |
value |
Obbligatorio. Il valore dell'argomento così come verrà passato alla riga di comando del server API. |
BareMetalLoadBalancerConfig
Specifica la configurazione del bilanciatore del carico.
Rappresentazione JSON |
---|
{ "vipConfig": { object ( |
Campi | |
---|---|
vipConfig |
Gli IP virtuali utilizzati dal bilanciatore del carico. |
portConfig |
Configura le porte su cui il bilanciatore del carico sarà 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: |
|
metalLbConfig |
Configurazione per i bilanciatori del carico MetalLB. |
manualLbConfig |
Bilanciatori del carico configurati manualmente. |
bgpLbConfig |
Configurazione per i bilanciatori del carico con tipo BGP. Quando viene impostato networkConfig.advanced_networking, questo valore viene impostato automaticamente su true. |
BareMetalVipConfig
Specifica la configurazione VIP per il bilanciatore del carico bare metal.
Rappresentazione JSON |
---|
{ "controlPlaneVip": string, "ingressVip": string } |
Campi | |
---|---|
controlPlaneVip |
Il VIP che hai riservato in precedenza per l'API Kubernetes di questo cluster utente bare metal. |
ingressVip |
Il VIP che hai precedentemente riservato 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 | |
---|---|
controlPlaneLoadBalancerPort |
La porta su cui i bilanciatori del carico ospitati del control plane saranno in ascolto. |
BareMetalMetalLbConfig
Rappresenta i parametri di configurazione per un bilanciatore del carico MetalLB.
Rappresentazione JSON |
---|
{ "addressPools": [ { object ( |
Campi | |
---|---|
addressPools[] |
Obbligatorio. AddressPools è un elenco di pool IP che non si sovrappongono utilizzati dai servizi con tipo di bilanciatore del carico. Tutti gli indirizzi devono essere instradabili ai nodi del bilanciatore del carico. IngressVIP deve essere incluso nei pool. |
loadBalancerNodePoolConfig |
Specifica il pool di nodi che esegue il bilanciatore del carico. È necessaria la connettività L2 tra i nodi di questo pool. Se manca, 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 in formato CIDR (1.2.3.0/24) o intervallo (1.2.3.1-1.2.3.5). |
avoidBuggyIps |
Se il valore è true, evita di utilizzare IP che terminano con .0 o .255. In questo modo si evita che i dispositivi di consumo con bug abbandonino erroneamente il traffico IPv4 per questi indirizzi IP speciali. |
manualAssign |
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 | |
---|---|
nodePoolConfig |
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 per 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. |
bgpPeerConfigs[] |
Obbligatorio. L'elenco dei peer BGP a cui si connetterà il cluster. È necessario configurare almeno un peer per ogni nodo del control plane. I nodi del control plane si connetteranno a questi peer per annunciare il VIP del control plane. Per impostazione predefinita, anche il bilanciatore del carico dei servizi utilizza questi peer. Questo campo può essere aggiornato dopo la creazione del cluster. |
addressPools[] |
Obbligatorio. AddressPools è un elenco di pool IP che non si sovrappongono utilizzati dai servizi con tipo di bilanciatore del carico. Tutti gli indirizzi devono essere instradabili ai nodi del bilanciatore del carico. IngressVIP deve essere incluso nei pool. |
loadBalancerNodePoolConfig |
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 control plane viene utilizzato per il bilanciamento del carico del piano dati. |
BareMetalBgpPeerConfig
BareMetalBgpPeerConfig rappresenta i parametri di configurazione per un peer BGP (Border Gateway Protocol).
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. |
ipAddress |
Obbligatorio. L'indirizzo IP del dispositivo peer esterno. |
controlPlaneNodes[] |
L'indirizzo IP del nodo del control plane che si connette al peer esterno. Se non specifichi nodi del control plane, tutti i nodi del control plane 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 | |
---|---|
lvpShareConfig |
Obbligatorio. Specifica la configurazione per i volumi permanenti locali supportati da sottodirectory in un file system condiviso. Queste sottodirectory vengono generate automaticamente durante la creazione del cluster. |
lvpNodeMountsConfig |
Obbligatorio. Specifica la configurazione per i volumi permanenti locali supportati da 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 credenziali nel formato |
noProxy[] |
Un elenco di IP, nomi host e domini che devono ignorare 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 | |
---|---|
enableApplicationLogs |
Indica se la raccolta di log/metriche delle applicazioni deve essere abilitata (oltre a log/metriche di sistema). |
BareMetalMaintenanceConfig
Specifica le configurazioni per attivare e disattivare la manutenzione dei nodi bare metal.
Rappresentazione JSON |
---|
{ "maintenanceAddressCidrBlocks": [ string ] } |
Campi | |
---|---|
maintenanceAddressCidrBlocks[] |
Obbligatorio. Tutti gli indirizzi IPv4 di questi intervalli verranno inseriti in modalità di manutenzione. I nodi in modalità di manutenzione verranno isolati e svuotati. Quando entrambe le condizioni sono vere, l'annotazione "baremetal.cluster.gke.io/maintenance" viene impostata sulla risorsa nodo. |
BareMetalWorkloadNodeConfig
Specifica le configurazioni dei nodi del workload.
Rappresentazione JSON |
---|
{
"maxPodsPerNode": string,
"containerRuntime": enum ( |
Campi | |
---|---|
maxPodsPerNode |
Il numero massimo di pod che un nodo può eseguire. Le dimensioni dell'intervallo CIDR assegnato al nodo verranno derivate da questo parametro. |
containerRuntime |
Specifica il runtime del container da utilizzare. |
ContainerRuntime
Il runtime utilizzato per eseguire i container in questo cluster utente.
Enum | |
---|---|
CONTAINER_RUNTIME_UNSPECIFIED |
Nessun runtime del container 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 | |
---|---|
machineDrainStatus |
Lo stato di manutenzione delle macchine nodo. |
BareMetalMachineDrainStatus
Rappresenta lo stato delle macchine dei nodi sottoposte a operazioni di svuotamento.
Rappresentazione JSON |
---|
{ "drainingMachines": [ { object ( |
Campi | |
---|---|
drainingMachines[] |
L'elenco delle macchine di drenaggio. |
drainedMachines[] |
L'elenco delle macchine svuotate. |
BareMetalDrainingMachine
Rappresenta una macchina attualmente in fase di svuotamento.
Rappresentazione JSON |
---|
{ "nodeIp": string, "podCount": integer } |
Campi | |
---|---|
nodeIp |
Indirizzo IP della macchina in fase di svuotamento. |
podCount |
Il conteggio dei pod ancora da svuotare. |
BareMetalDrainedMachine
Rappresenta una macchina attualmente scarica.
Rappresentazione JSON |
---|
{ "nodeIp": string } |
Campi | |
---|---|
nodeIp |
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 | |
---|---|
loginUser |
LoginUser è il nome utente utilizzato per accedere alle macchine dei nodi. Se non è impostato, il valore predefinito è "root". |
BareMetalOsEnvironmentConfig
Specifica le impostazioni del sistema operativo per il provisioning del cluster.
Rappresentazione JSON |
---|
{ "packageRepoExcluded": boolean } |
Campi | |
---|---|
packageRepoExcluded |
Indica se il repository del pacchetto non deve essere incluso durante l'inizializzazione delle macchine bare metal. |
BareMetalClusterUpgradePolicy
BareMetalClusterUpgradePolicy definisce le norme di upgrade del cluster.
Rappresentazione JSON |
---|
{
"policy": enum ( |
Campi | |
---|---|
policy |
Specifica quali norme sugli upgrade utilizzare. |
pause |
Solo output. Pausa viene utilizzato per mostrare lo stato di pausa dell'upgrade. Per il momento è di sola visualizzazione. |
NodePoolPolicy
Specifica il criterio di upgrade per i pool di nodi worker.
Enum | |
---|---|
NODE_POOL_POLICY_UNSPECIFIED |
Nessuna policy di upgrade selezionata. |
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 progetto e una località specifici. |
|
Elimina un singolo cluster bare metal. |
|
Registra un cluster utente bare metal esistente e i relativi pool di nodi nell'API Anthos On-Prem all'interno di un determinato progetto e una determinata località. |
|
Recupera i dettagli di un singolo cluster bare metal. |
|
Elenca i cluster bare metal in un determinato progetto e una determinata località. |
|
Aggiorna i parametri di un singolo cluster bare metal. |
|
Esegue query sulla configurazione della versione del cluster utente Bare Metal. |