REST Resource: projects.locations.bareMetalAdminClusters

Risorsa: BareMetalAdminCluster

Risorsa che rappresenta un cluster di amministrazione bare metal.

Rappresentazione JSON
{
  "name": string,
  "description": string,
  "uid": string,
  "bareMetalVersion": string,
  "state": enum (State),
  "endpoint": string,
  "reconciling": boolean,
  "createTime": string,
  "updateTime": string,
  "deleteTime": string,
  "localName": string,
  "etag": string,
  "annotations": {
    string: string,
    ...
  },
  "networkConfig": {
    object (BareMetalAdminNetworkConfig)
  },
  "controlPlane": {
    object (BareMetalAdminControlPlaneConfig)
  },
  "loadBalancer": {
    object (BareMetalAdminLoadBalancerConfig)
  },
  "storage": {
    object (BareMetalAdminStorageConfig)
  },
  "fleet": {
    object (Fleet)
  },
  "clusterOperations": {
    object (BareMetalAdminClusterOperationsConfig)
  },
  "status": {
    object (ResourceStatus)
  },
  "maintenanceConfig": {
    object (BareMetalAdminMaintenanceConfig)
  },
  "maintenanceStatus": {
    object (BareMetalAdminMaintenanceStatus)
  },
  "validationCheck": {
    object (ValidationCheck)
  },
  "nodeConfig": {
    object (BareMetalAdminWorkloadNodeConfig)
  },
  "proxy": {
    object (BareMetalAdminProxyConfig)
  },
  "securityConfig": {
    object (BareMetalAdminSecurityConfig)
  },
  "nodeAccessConfig": {
    object (BareMetalAdminNodeAccessConfig)
  },
  "osEnvironmentConfig": {
    object (BareMetalAdminOsEnvironmentConfig)
  },
  "binaryAuthorization": {
    object (BinaryAuthorization)
  }
}
Campi
name

string

Immutabile. Il nome della risorsa del cluster di amministrazione bare metal.

description

string

Una descrizione leggibile di questo cluster di amministrazione bare metal.

uid

string

Solo output. L'identificatore univoco del cluster di amministrazione bare metal.

bareMetalVersion

string

La versione di Anthos clusters on bare metal per il cluster di amministrazione bare metal.

state

enum (State)

Solo output. Lo stato attuale del cluster di amministrazione bare metal.

endpoint

string

Solo output. Il nome dell'indirizzo IP del server API del cluster di amministrazione bare metal.

reconciling

boolean

Solo output. Se impostato, sono attualmente in corso modifiche al cluster di amministrazione bare metal.

createTime

string (Timestamp format)

Solo output. L'ora in cui è stato creato questo cluster di amministrazione 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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Solo output. L'ora dell'ultimo aggiornamento di questo cluster di amministrazione 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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

deleteTime

string (Timestamp format)

Solo output. Data e ora di eliminazione di questo cluster di amministrazione 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: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

localName

string

Solo output. Il nome dell'oggetto della risorsa personalizzata del cluster bare metal. 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 dall'ID 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.

Tutti gli utenti devono utilizzare questo nome per accedere al cluster utilizzando gkectl o kubectl e devono aspettarsi di visualizzare il nome locale quando visualizzano i log del controller del cluster di amministrazione.

etag

string

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

map (key: string, value: string)

Annotazioni sul cluster di amministrazione 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 "key": value. Esempio: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

networkConfig

object (BareMetalAdminNetworkConfig)

Configurazione di rete.

controlPlane

object (BareMetalAdminControlPlaneConfig)

Configurazione del control plane.

loadBalancer

object (BareMetalAdminLoadBalancerConfig)

Configurazione del bilanciatore del carico.

storage

object (BareMetalAdminStorageConfig)

Configurazione dello spazio di archiviazione.

fleet

object (Fleet)

Solo output. Configurazione del parco risorse per il cluster.

clusterOperations

object (BareMetalAdminClusterOperationsConfig)

Configurazione delle operazioni del cluster.

status

object (ResourceStatus)

Solo output. ResourceStatus che rappresenta lo stato dettagliato del cluster.

maintenanceConfig

object (BareMetalAdminMaintenanceConfig)

Configurazione della manutenzione.

maintenanceStatus

object (BareMetalAdminMaintenanceStatus)

Solo output. MaintenanceStatus che rappresenta lo stato della manutenzione.

validationCheck

object (ValidationCheck)

Solo output. ValidationCheck che rappresenta il risultato del controllo preliminare.

nodeConfig

object (BareMetalAdminWorkloadNodeConfig)

Configurazione del nodo del workload.

proxy

object (BareMetalAdminProxyConfig)

Configurazione del proxy.

securityConfig

object (BareMetalAdminSecurityConfig)

Configurazione relativa alla sicurezza.

nodeAccessConfig

object (BareMetalAdminNodeAccessConfig)

Configurazioni relative all'accesso ai nodi.

osEnvironmentConfig

object (BareMetalAdminOsEnvironmentConfig)

Configurazioni relative all'ambiente del sistema operativo.

binaryAuthorization

object (BinaryAuthorization)

Configurazioni correlate all'autorizzazione binaria.

Stato

Lo stato del ciclo di vita del cluster di amministrazione 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.

BareMetalAdminNetworkConfig

BareMetalAdminNetworkConfig specifica la configurazione di rete del cluster.

Rappresentazione JSON
{

  // Union field cluster_cidr_configuration can be only one of the following:
  "islandModeCidr": {
    object (BareMetalAdminIslandModeCidrConfig)
  }
  // End of list of possible types for union field cluster_cidr_configuration.
}
Campi
Campo unione cluster_cidr_configuration. La configurazione CIDR da utilizzare nel cluster di amministrazione. cluster_cidr_configuration può essere solo uno dei seguenti:
islandModeCidr

object (BareMetalAdminIslandModeCidrConfig)

Configurazione per il CIDR della modalità Island.

BareMetalAdminIslandModeCidrConfig

BareMetalAdminIslandModeCidrConfig specifica la configurazione CIDR del cluster durante l'esecuzione in modalità isolata.

Rappresentazione JSON
{
  "serviceAddressCidrBlocks": [
    string
  ],
  "podAddressCidrBlocks": [
    string
  ]
}
Campi
serviceAddressCidrBlocks[]

string

Obbligatorio. A tutti i servizi del cluster viene assegnato un indirizzo IPv4 RFC1918 in questi intervalli. Questo campo non può essere modificato dopo la creazione.

podAddressCidrBlocks[]

string

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.

BareMetalAdminControlPlaneConfig

BareMetalAdminControlPlaneConfig specifica la configurazione del control plane.

Rappresentazione JSON
{
  "controlPlaneNodePoolConfig": {
    object (BareMetalAdminControlPlaneNodePoolConfig)
  },
  "apiServerArgs": [
    {
      object (BareMetalAdminApiServerArgument)
    }
  ]
}
Campi
controlPlaneNodePoolConfig

object (BareMetalAdminControlPlaneNodePoolConfig)

Obbligatorio. Configura il pool di nodi che esegue il control plane. Se specificato, il NodePool corrispondente verrà creato per il control plane del cluster. Il node pool avrà lo stesso nome e spazio dei nomi del cluster.

apiServerArgs[]

object (BareMetalAdminApiServerArgument)

Personalizza gli argomenti predefiniti del server API. È supportato solo un sottoinsieme di flag personalizzati. Per conoscere il formato esatto, consulta la documentazione del server API riportata di seguito: https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/

BareMetalAdminControlPlaneNodePoolConfig

BareMetalAdminControlPlaneNodePoolConfig specifica la configurazione del pool di nodi del control plane. Abbiamo una configurazione del pool di nodi specifica del control plane per poter supportare in modo flessibile i campi specifici del control plane in futuro.

Rappresentazione JSON
{
  "nodePoolConfig": {
    object (BareMetalNodePoolConfig)
  }
}
Campi
nodePoolConfig

object (BareMetalNodePoolConfig)

Obbligatorio. La configurazione generica per un pool di nodi che esegue il control plane.

BareMetalAdminApiServerArgument

BareMetalAdminApiServerArgument rappresenta una coppia nome->valore di argomenti. È supportato solo un sottoinsieme di flag personalizzati. Per conoscere il formato esatto, consulta la documentazione del server API riportata di seguito: https://kubernetes.io/docs/reference/command-line-tools-reference/kube-apiserver/

Rappresentazione JSON
{
  "argument": string,
  "value": string
}
Campi
argument

string

Obbligatorio. Il nome dell'argomento così come appare nella riga di comando del server API. Assicurati di rimuovere i trattini iniziali.

value

string

Obbligatorio. Il valore dell'argomento così come verrà passato alla riga di comando del server API.

BareMetalAdminLoadBalancerConfig

BareMetalAdminLoadBalancerConfig specifica la configurazione del bilanciatore del carico.

Rappresentazione JSON
{
  "vipConfig": {
    object (BareMetalAdminVipConfig)
  },
  "portConfig": {
    object (BareMetalAdminPortConfig)
  },

  // Union field load_balancer_configuration can be only one of the following:
  "manualLbConfig": {
    object (BareMetalAdminManualLbConfig)
  }
  // End of list of possible types for union field load_balancer_configuration.
}
Campi
vipConfig

object (BareMetalAdminVipConfig)

Gli IP virtuali utilizzati dal bilanciatore del carico.

portConfig

object (BareMetalAdminPortConfig)

Configura le porte su cui il bilanciatore del carico sarà in ascolto.

Campo unione load_balancer_configuration. La configurazione del bilanciatore del carico da utilizzare nel cluster di amministrazione. load_balancer_configuration può essere solo uno dei seguenti:
manualLbConfig

object (BareMetalAdminManualLbConfig)

Bilanciatori del carico configurati manualmente.

BareMetalAdminVipConfig

BareMetalAdminVipConfig per le configurazioni del bilanciatore del carico Bare Metal.

Rappresentazione JSON
{
  "controlPlaneVip": string
}
Campi
controlPlaneVip

string

Il VIP che hai riservato in precedenza per l'API Kubernetes di questo cluster di amministrazione bare metal.

BareMetalAdminPortConfig

BareMetalAdminPortConfig è la specifica delle porte del bilanciatore del carico.

Rappresentazione JSON
{
  "controlPlaneLoadBalancerPort": integer
}
Campi
controlPlaneLoadBalancerPort

integer

La porta su cui i bilanciatori del carico ospitati del control plane saranno in ascolto.

BareMetalAdminManualLbConfig

BareMetalAdminManualLbConfig rappresenta i parametri di configurazione per un bilanciatore del carico manuale.

Rappresentazione JSON
{
  "enabled": boolean
}
Campi
enabled

boolean

Indica se il bilanciamento del carico manuale è abilitato.

BareMetalAdminStorageConfig

BareMetalAdminStorageConfig specifica la configurazione dello storage del cluster.

Rappresentazione JSON
{
  "lvpShareConfig": {
    object (BareMetalLvpShareConfig)
  },
  "lvpNodeMountsConfig": {
    object (BareMetalLvpConfig)
  }
}
Campi
lvpShareConfig

object (BareMetalLvpShareConfig)

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

object (BareMetalLvpConfig)

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.

BareMetalAdminClusterOperationsConfig

BareMetalAdminClusterOperationsConfig specifica l'infrastruttura di osservabilità del cluster di amministrazione.

Rappresentazione JSON
{
  "enableApplicationLogs": boolean
}
Campi
enableApplicationLogs

boolean

Indica se la raccolta di log/metriche delle applicazioni deve essere abilitata (oltre a log/metriche di sistema).

BareMetalAdminMaintenanceConfig

BareMetalAdminMaintenanceConfig specifica le configurazioni per attivare e disattivare la manutenzione dei nodi CR del cluster di amministrazione Bare Metal.

Rappresentazione JSON
{
  "maintenanceAddressCidrBlocks": [
    string
  ]
}
Campi
maintenanceAddressCidrBlocks[]

string

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.

BareMetalAdminMaintenanceStatus

BareMetalAdminMaintenanceStatus rappresenta lo stato di manutenzione dei nodi del CR del cluster di amministrazione bare metal.

Rappresentazione JSON
{
  "machineDrainStatus": {
    object (BareMetalAdminMachineDrainStatus)
  }
}
Campi
machineDrainStatus

object (BareMetalAdminMachineDrainStatus)

Rappresenta lo stato dei nodi macchina in fase di svuotamento e svuotati. Viene utilizzato per mostrare l'avanzamento dell'upgrade del cluster.

BareMetalAdminMachineDrainStatus

BareMetalAdminMachineDrainStatus rappresenta lo stato delle macchine dei nodi bare metal sottoposte a operazioni di svuotamento.

Rappresentazione JSON
{
  "drainingMachines": [
    {
      object (BareMetalAdminDrainingMachine)
    }
  ],
  "drainedMachines": [
    {
      object (BareMetalAdminDrainedMachine)
    }
  ]
}
Campi
drainingMachines[]

object (BareMetalAdminDrainingMachine)

L'elenco delle macchine di drenaggio.

drainedMachines[]

object (BareMetalAdminDrainedMachine)

L'elenco delle macchine svuotate.

BareMetalAdminDrainingMachine

BareMetalAdminDrainingMachine rappresenta le macchine attualmente in fase di svuotamento.

Rappresentazione JSON
{
  "nodeIp": string,
  "podCount": integer
}
Campi
nodeIp

string

Indirizzo IP della macchina in fase di svuotamento.

podCount

integer

Il conteggio dei pod ancora da svuotare.

BareMetalAdminDrainedMachine

BareMetalAdminDrainedMachine rappresenta le macchine svuotate.

Rappresentazione JSON
{
  "nodeIp": string
}
Campi
nodeIp

string

Indirizzo IP della macchina svuotata.

BareMetalAdminWorkloadNodeConfig

BareMetalAdminWorkloadNodeConfig specifica le configurazioni dei nodi del workload.

Rappresentazione JSON
{
  "maxPodsPerNode": string
}
Campi
maxPodsPerNode

string (int64 format)

Il numero massimo di pod che un nodo può eseguire. Le dimensioni dell'intervallo CIDR assegnato al nodo verranno derivate da questo parametro. Per impostazione predefinita, vengono creati 110 pod per nodo. Il limite superiore è 250 sia per il cluster di amministrazione ad alta disponibilità che per quello non ad alta disponibilità. Il limite inferiore è 64 per il cluster di amministrazione non HA e 32 per il cluster di amministrazione HA.

BareMetalAdminProxyConfig

BareMetalAdminProxyConfig specifica la configurazione del proxy del cluster.

Rappresentazione JSON
{
  "uri": string,
  "noProxy": [
    string
  ]
}
Campi
uri

string

Obbligatorio. Specifica l'indirizzo del server proxy. Esempi: http://domain

AVVISO: non fornire le credenziali nel formato http://(username:password@)domain, in quanto verranno rifiutate dal server.

noProxy[]

string

Un elenco di IP, nomi host e domini che devono ignorare il proxy. Esempi: ["127.0.0.1", "example.com", ".corp", "localhost"].

BareMetalAdminSecurityConfig

Specifica le impostazioni relative alla sicurezza per il cluster di amministrazione bare metal.

Rappresentazione JSON
{
  "authorization": {
    object (Authorization)
  }
}
Campi
authorization

object (Authorization)

Configura l'accesso utente al cluster di amministrazione.

BareMetalAdminNodeAccessConfig

Specifica le impostazioni relative all'accesso ai nodi per il cluster di amministrazione bare metal.

Rappresentazione JSON
{
  "loginUser": string
}
Campi
loginUser

string

Obbligatorio. LoginUser è il nome utente utilizzato per accedere alle macchine dei nodi. Se non è impostato, il valore predefinito è "root".

BareMetalAdminOsEnvironmentConfig

Specifica le impostazioni di funzionamento del sistema operativo per il provisioning del cluster.

Rappresentazione JSON
{
  "packageRepoExcluded": boolean
}
Campi
packageRepoExcluded

boolean

Indica se il repository dei pacchetti deve essere aggiunto durante l'inizializzazione delle macchine bare metal.

Metodi

create

Crea un nuovo cluster di amministrazione bare metal in un progetto e una località specifici.

enroll

Registra un cluster di amministrazione bare metal esistente nell'API Anthos On-Prem all'interno di un progetto e una località specifici.

get

Recupera i dettagli di un singolo cluster di amministrazione bare metal.

list

Elenca i cluster di amministrazione bare metal in un determinato progetto e una determinata località.

patch

Aggiorna i parametri di un singolo cluster di amministrazione bare metal.

queryVersionConfig

Esegue query sulla configurazione della versione del cluster di amministrazione bare metal.