Informazioni sui controlli preliminari

In GKE su Bare Metal puoi eseguire controlli preflight per diverse situazioni:

GKE su Bare Metal esegue controlli preflight quando crei o aggiorni le risorse di amministratore, ibrido, autonomo o utente e del pool di nodi con bmctl. Se i controlli non vanno a buon fine, non vengono apportate modifiche. Puoi anche bypassare questi controlli.
Inoltre, GKE su Bare Metal esegue controlli preflight interni quando applichi risorse Kubernetes a cluster utente da un cluster di amministrazione o ibrido. I controlli vengono eseguiti prima che le modifiche vengano effettivamente applicate ai cluster utente interessati. Se i controlli non vanno a buon fine, non vengono apportate modifiche. Puoi anche bypassare questi controlli o eseguirli esplicitamente.

Controlli preflight per la creazione del cluster con `bmctl`

Quando crei cluster admin, ibridi, autonomati o utente con il comando bmctl, GKE su Bare Metal esegue automaticamente i controlli preflight prima che vengano apportate modifiche.

Una volta superati i controlli, GKE su Bare Metal creerà i cluster.

Ignorare i risultati dei controlli preflight automatici

Se vuoi bypassare questi controlli preflight automatici, puoi utilizzare il flag facoltativo --force nel comando.

Esegui i controlli preflight in modo indipendente

Puoi anche eseguire i controlli preflight autonomamente prima di creare un cluster. Questo può aiutarti a risparmiare tempo garantendo che le risorse della macchina e dei nodi superino i controlli.

Il seguente comando convalida il file di configurazione del cluster specificato, ma non prova a creare il cluster stesso:
```
bmctl check config --cluster CLUSTER_NAME
```
Sostituisci CLUSTER_NAME con il nome del cluster di cui stai controllando il file di configurazione.
Questo comando controlla se le macchine e la rete sono pronte per la creazione del cluster:
```
bmctl check preflight --cluster CLUSTER_NAME
```
Sostituisci CLUSTER_NAME con il nome del cluster che stai controllando.

Esegui i controlli preflight e i controlli di integrità più recenti

Puoi eseguire controlli preflight sul tuo sistema. I controlli preflight assicurano che le macchine e la rete siano pronte per la creazione del cluster. Il seguente comando controlla le tue macchine e la tua rete per verificare che siano pronte per la creazione del cluster utilizzando l'elenco più recente di controlli:

bmctl check preflight --cluster CLUSTER_NAME --check-image-version latest

Sostituisci CLUSTER_NAME con il nome del cluster che stai controllando.

Puoi anche eseguire controlli di integrità di un cluster in tempo reale per determinare se il cluster è integro. Per eseguire i controlli di integrità più aggiornati su un cluster in tempo reale, esegui questo comando:

bmctl check cluster --cluster CLUSTER_NAME --check-image-version latest

Sostituisci CLUSTER_NAME con il nome del cluster che stai controllando.

Controlli preflight per gli upgrade

Il comando bmctl check preflight consente di eseguire un controllo preflight prima di eseguire l'upgrade del cluster. Puoi verificare se i cluster sono pronti per un upgrade eseguendo il seguente comando di controllo preflight prima di iniziare l'upgrade:

Aggiorna la versione del cluster (anthosBareMetalVersion) nel file di configurazione del cluster.
Il seguente comando ti consente di verificare se i cluster sono pronti per un upgrade ed eseguire un controllo preflight:
```
bmctl check preflight --kubeconfig ADMIN_CLUSTER_KUBECONFIG_PATH
 -c CLUSTER_NAME
```
Sostituisci quanto segue:
- CLUSTER_NAME: il nome del cluster di cui eseguire l'upgrade.
- ADMIN_CLUSTER_KUBECONFIG_PATH: il percorso del file kubeconfig del cluster di amministrazione.
Tieni presente che bmctl check preflight per l'upgrade funziona quando il cluster originale è la versione 1.13.1 o successive.

Quando crei il controllo preflight con questo comando per testare un upgrade di un cluster di amministrazione o di un cluster utente, nel cluster di amministrazione viene creata una risorsa personalizzata PreflightCheck.

Controlli preflight per la creazione del cluster utente

I cluster utente vengono creati da un cluster di amministrazione o ibrido esistente. GKE su Bare Metal esegue automaticamente i controlli preflight prima di apportare modifiche. Puoi anche eseguire controlli preflight con bmctl prima di creare un cluster.

Il seguente comando convalida il file di configurazione del cluster specificato, ma non prova a creare il cluster stesso:
```
bmctl check config --cluster CLUSTER_NAME --admin-kubeconfig ADMIN_KUBECONFIG_PATH
```
Sostituisci CLUSTER_NAME con il nome del cluster utente che stai controllando e ADMIN_KUBECONFIG_PATH con il percorso del file kubeconfig del cluster di amministrazione associato.
Questo comando controlla se le macchine e la rete sono pronte per la creazione del cluster:
```
bmctl check preflight --cluster CLUSTER_NAME --admin-kubeconfig ADMIN_KUBECONFIG_PATH
```

bmctl supporta l'utilizzo di --kubeconfig come alias per il flag --admin-kubeconfig.

Controlli preflight interni su cluster esistenti

GKE su Bare Metal esegue anche controlli preflight interni quando applichi risorse Kubernetes a un cluster esistente. Se un controllo non va a buon fine, GKE su Bare Metal non apporterà alcuna modifica ai nodi correlati, a meno che tu non abbia specificatamente superato i controlli.

Bypassa i controlli preflight durante l'applicazione di risorse Kubernetes

Per ignorare i controlli preflight interni durante l'applicazione di risorse ai cluster esistenti, devi impostare il campo BypassPreflightCheck su true nel file YAML del cluster.

Ecco un frammento di un file YAML di configurazione del cluster, che mostra il campo bypassPreflightCheck impostato su true.

# Sample cluster config to bypass preflight check errors:

apiVersion: v1
kind: Namespace
metadata:
  name: cluster-user1
---
apiVersion: baremetal.cluster.gke.io/v1
kind: Cluster
metadata:
  name: user1
  namespace: cluster-user1
spec:
  type: user
  bypassPreflightCheck: true
  # Anthos cluster version.
  anthosBareMetalVersion: 1.14.11
....

Dettagli del controllo preflight dell'installazione

GKE su Bare Metal controlla una varietà di condizioni dei prerequisiti del sistema operativo, del software e delle macchine durante l'esecuzione dei controlli preflight.

Per informazioni più dettagliate, vedi Panoramica dei prerequisiti di installazione.