Questa pagina è stata tradotta dall'API Cloud Translation.

Risoluzione dei problemi di registrazione dei nodi

Standard

Questo documento descrive come risolvere i problemi riscontrati durante l'aggiunta di nodi a del tuo cluster Google Kubernetes Engine (GKE) Standard. Alcuni degli scenari in cui si verificano questi problemi includono la creazione di cluster e pool di nodi e gli eventi di scale up.

Per risolvere i problemi relativi ai cluster GKE Autopilot, consulta Risoluzione dei problemi relativi ai cluster Autopilot.

Se hai bisogno di ulteriore assistenza, contatta l'assistenza clienti Google Cloud.

Informazioni sulla registrazione dei nodi

I nodi sono le istanze VM di Compute Engine create da GKE per conto tuo. Quando un nuovo nodo viene aggiunto a un cluster GKE, deve essere registrate nel piano di controllo del cluster. Questa procedura, chiamata registrazione del nodo o bootstrap del nodo, si verifica quando viene creato un nodo.

Quando si verifica la registrazione del nodo

La registrazione dei nodi avviene ogni volta che vengono creati, inclusi i seguenti scenari:

Hai creato un cluster.
Crea un pool di nodi.
GKE crea un pool di nodi con provisioning automatico dei nodi.
Il gestore della scalabilità automatica dei cluster esegue il scale up del cluster.
Devi ridimensionare il cluster.
La riparazione automatica dei nodi crea un nuovo nodo.

Il processo di registrazione dei nodi segue questi passaggi:

Il numero di nodi impostato per il pool di nodi viene replicato ai gruppi di istanze gestite (MIG).
I gruppi di istanze gestite creano il numero richiesto di istanze VM.
Per ogni istanza VM creata:
1. L'istanza VM si avvia.
2. L'istanza VM configura e installa i pacchetti necessari da eseguire come nodo Kubernetes.
3. Il kubelet ora in esecuzione sull'istanza VM comunica con il server API del piano di controllo per registrarsi come nodo.

Messaggio di errore relativo alla registrazione del nodo

Quando GKE tenta di aggiungere nodi al cluster, nella console Google Cloud viene visualizzato il seguente errore se la registrazione dei nodi non è riuscita:

  All cluster resources were brought up, but: only 0 nodes out of * have
  registered; this is likely due to the Nodes failing to start correctly; try
  re-creating the cluster or contact support if that doesn't work.

Questo messaggio di errore indica che la registrazione dei nodi non è riuscita nel cluster. Le seguenti sezioni descrivono alcune delle potenziali cause di questo errore.

Prerequisiti per la corretta registrazione dei nodi

La registrazione dei nodi in un cluster GKE corretta dipende da fattori ad esempio:

Connettività di rete.
Disponibilità delle risorse.
Autorizzazioni dell'account di servizio.

Prerequisiti per la creazione dell'istanza

Quando GKE crea un nodo per il tuo cluster, il primo passaggio consiste nel creare una nuova istanza VM di Compute Engine.

La creazione dell'istanza potrebbe non riuscire per uno dei seguenti motivi:

La creazione dell'istanza non riuscita significa che nell'intervallo di tempo durante il quale GKE ha tentato di creare l'istanza da registrare come al nodo GKE, mancano i log per la creazione dell'istanza non sono mai state create. Per verificare la presenza di log mancanti, consulta le istruzioni per trovare un'istanza in cui la registrazione del nodo non è riuscita.

Autorizzazioni account di servizio

I nodi GKE hanno un account di servizio IAM associato. Per impostazione predefinita, questo account di servizio è Compute Engine servizio predefinito Google Cloud. Me per rafforzare la protezione del cluster, usando un servizio IAM personalizzato che abbia il minimo richiesto autorizzazioni.

Questo account di servizio deve disporre delle autorizzazioni corrette per le istanze VM come nodi GKE. Se elimini l'account di servizio, lo disattivi o non gli concedi le autorizzazioni corrette, la registrazione dei nodi potrebbe non riuscire.

Prerequisiti per la connessione di rete alle API e ai servizi Google

L'istanza VM scarica i pacchetti per prepararsi all'esecuzione come GKE e un timeout della connessione potrebbe indicare che il cluster non ha soddisfatto i requisiti di rete necessari per connettersi alle API e ai servizi Google, come storage.googleapis.com. Se un'istanza non riesce a connettersi a questi servizi, non può scaricare la distribuzione di Kubernetes e completare la registrazione del nodo e il processo di sviluppo.

A seconda della connessione di rete, consentire questa connessione potrebbe significare configurare l'accesso privato Google. o con regole firewall e route nella rete VPC (Virtual Private Cloud) del tuo cluster che consente la connessione.

Prerequisiti per la connessione di rete con il piano di controllo

La connettività tra il piano di controllo e i nodi è fondamentale per il nodo registrazione e funzione regolare. Questa comunicazione è consentita per impostazione predefinita. Assicurati che, quando vengono applicate le regole firewall VPC, la comunicazione sia ancora consentito tra i nodi e il piano di controllo.

Per maggiori informazioni, consulta Consentire la connettività del piano di controllo.

Utilizzare lo strumento di controllo della registrazione dei nodi per risolvere i problemi relativi alla registrazione dei nodi

Per i pool di nodi creati su GKE 1.24.0-gke.100 o versioni successive, un'utilità chiamata Node Registration Checker viene eseguita sulle istanze appena create e controlla se l'istanza ha completato correttamente i passaggi di registrazione dei nodi.

Quando la registrazione dei nodi non va a buon fine, l'utilità genera un report di riepilogo possono vedere quali prerequisiti non sono stati soddisfatti in base al punto del processo in cui istanza non riuscita.

Utilizza le istruzioni nella sezione seguente per trovare un'istanza con errore registrazione dei nodi e usa il riepilogo dello strumento di controllo della registrazione dei nodi per scoprire i motivi non riuscito.

Se non riesci a utilizzare il controllo della registrazione dei nodi nel pool di nodi, consulta Risolvi i problemi di registrazione dei nodi senza lo strumento di controllo della registrazione dei nodi.

Trovare un'istanza in cui la registrazione del nodo non è riuscita

Quando una o più istanze non vengono registrate come nodi con GKE di un cluster Kubernetes, puoi vedere il numero di istanze il messaggio di errore visualizzato pagina Dettagli cluster della console Google Cloud. Quando si verificano più istanze la mancata registrazione in una sola volta, potrebbe essere per lo stesso motivo di base. A causa di Puoi utilizzare una delle istanze non riuscite per capire perché tutte le istanze non riuscito.

Tuttavia, poiché le istanze non sono state registrate come nodi GKE, seguire le istruzioni riportate di seguito per trovare i nomi dei componenti VM di Compute Engine la cui registrazione non è riuscita.

Nella console Google Cloud, vai a Esplora log. pagina:

Vai a Esplora log

Usa il seguente filtro di log per trovare i log della creazione delle istanze VM:

resource.type="gce_instance"
logName="projects/PROJECT_ID/logs/cloudaudit.googleapis.com%2Factivity"
protoPayload.requestMetadata.callerSuppliedUserAgent="GCE Managed Instance Group for GKE"
protoPayload.response.status="RUNNING"

Sostituisci PROJECT_ID con l'ID progetto del tuo cluster.

Utilizza l'istogramma sotto il filtro log per restringere l'intervallo di tempo a quando si sarebbe verificata la creazione del nodo.
Fai clic su uno dei log visualizzati in Risultati delle query, quindi su Espandi campi nidificati per visualizzare ulteriori dettagli.
Trova il campo protoPayload.resourceName. La parte finale del percorso elencato è il nome dell'istanza. I nomi delle istanze seguono un formato che inizia con il nome del cluster e del pool di nodi, ad esempio:

gke-cluster-1-default-pool-b0ac62d3-9g1v è un'istanza per Pool di nodi default-pool in gke-cluster-1.
Nella console Google Cloud, vai a Compute Engine Pagina Istanze VM:

Vai a Istanze VM

Trova il nome dell'istanza VM utilizzando il filtro. Fai clic per ulteriori dettagli.

Risolvere i problemi di un'istanza con lo strumento di controllo della registrazione dei nodi

Dopo aver trovato il nome dell'istanza di cui non è andata a buon fine la registrazione, puoi esaminare il motivo del mancato completamento utilizzando lo strumento di controllo della registrazione dei nodi.

Nella scheda Dettagli dell'istanza VM, nella sezione Log, fai clic su Porta seriale 1 (console).

Per i pool di nodi creati su GKE versione 1.24.0-gke.100 o successive, l'output per le istanze appena create include quanto segue, per indicare che è iniziato il controllo della registrazione dei nodi:

** Starting Node Registration Checker **
** Loading variables from kube-env **
** Sleeping for 7m to allow registration to complete  **

Se la registrazione del nodo va a buon fine, l'output include i seguenti messaggi:

** Node ready and registered. **
** Completed running Node Registration Checker **

Se non vedi questi messaggi, la registrazione del nodo non è riuscita e lo strumento di controllo della registrazione dei nodi ha generato un report che riassume il motivo della mancata registrazione. Cerca il seguente messaggio aggiuntivo per visualizzare il riepilogo:

** Here is a summary of the checks performed: **

Sotto questo messaggio, cerca una tabella simile alla seguente:

------------------------------
Service    DNS      Reachable
------------------------------
LOGGING    true     true
GCR        true     true
GCS        true     true
Master     N/A      false
------------------------------

Se LOGGING, GCR o GCS sono indicati come non raggiungibili, controlla le autorizzazioni dell'account di servizio per la registrazione dei nodi e la connessione di rete alle API e ai servizi Google per la registrazione dei nodi.

Se Master non è raggiungibile, controlla i prerequisiti per la connessione di rete con il control plane per la registrazione dei nodi.

Dopo aver risolto tutti i problemi che impediscono la corretta registrazione dei nodi, consulta Completare la registrazione dei nodi dopo aver risolto la causa principale.

Se i passaggi precedenti non indicano il motivo dell'errore di registrazione del nodo, consulta Raccogliere informazioni per ulteriori accertamenti.

Risolvere i problemi di registrazione dei nodi senza lo strumento di controllo della registrazione dei nodi

Se la registrazione dei nodi non è riuscita in un pool di nodi creato su un cluster GKE precedente alla 1.24.0-gke.100, puoi risolvere i problemi solo manualmente registrazione. Se il pool di nodi è stato creato nella versione GKE 1.24.0-gke.100 o versioni successive, segui le istruzioni per Utilizza lo strumento di controllo della registrazione dei nodi per risolvere i problemi relativi alla registrazione dei nodi.

Dopo aver risolto tutti i problemi che impediscono la registrazione del nodo, segui le istruzioni riportate di seguito per completare la registrazione del nodo dopo aver corretto la causa principale.

Se nessuno dei passaggi di indagine in questa pagina indica il motivo della registrazione del nodo non è andata a buon fine, consulta l'articolo Raccogliere informazioni per ulteriori indagini.

Controlla le autorizzazioni dell'account di servizio per la registrazione del nodo

L'account di servizio utilizzato dai nodi deve avere autorizzazioni prerequisiti per la registrazione dei nodi. Segui le istruzioni riportate di seguito per verificare di aver soddisfatto questi prerequisiti:

Trova un'istanza in cui la registrazione del nodo non è riuscita.
Nella scheda Dettagli dell'istanza VM in Gestione di API e identità trova il nome dell'account di servizio nella sezione Account di servizio . Se il nodo ha utilizzato l'account di servizio predefinito di Compute Engine, il nome segue il formato PROJECT_NUMBER-compute@developer.gserviceaccount.com. Questo account di servizio deve disporre delle autorizzazioni minime richieste.
Verifica la presenza degli indicatori di registrazione riuscita nell'output della console seriale. Nella scheda Dettagli dell'istanza VM, nella sezione Log, fai clic su Porta seriale 1 (console).

Se l'istanza ha utilizzato un account di servizio con le autorizzazioni corrette, l'output include quanto segue:
- Started Download and install k8s binaries and configurations
- Started Docker Application Container Engine.
- Started Configure kubernetes node.
- Reached target Kubernetes.
Questi messaggi si trovano in punti diversi in questo output. Potrebbero anche essere presenti timestamp o altri elementi che li interrompono, ad esempio: Starting [0;1;39mConfigure kubernetes node. Se vedi tutti questi messaggi, significa che i prerequisiti dell'account di servizio sono stati soddisfatti.

Se non vedi questi messaggi, l'account di servizio assegnato all'istanza VM potrebbe essere stato eliminato, disattivato o non disporre delle autorizzazioni corrette.

Controlla la connessione di rete alle API e ai servizi Google per la registrazione dei nodi

Controlla la connessione con accesso SSH

Se disponi dell'accesso SSH alle istanze VM nel tuo progetto, puoi anche verificare che l'istanza VM abbia una connessione di rete alle API e ai servizi Google.

Trova un'istanza in cui la registrazione del nodo non è riuscita.
Nella scheda Dettagli dell'istanza VM, fai clic su SSH.
Dopo aver eseguito la connessione alla riga di comando dell'istanza VM, esegui il seguente comando per verificare la connessione alle API e ai servizi Google:
```
curl -m 5 -v https://storage.googleapis.com/generate_204
```
Se la connessione viene stabilita, l'output è simile al seguente:
```
*   Trying 142.250.148.128:443...
* Connected to storage.googleapis.com (142.250.148.128) port 443 (#0)

...

< HTTP/1.1 204 No Content
< Content-Length: 0
< Cross-Origin-Resource-Policy: cross-origin
< Date: Wed, 04 Jan 2023 00:58:41 GMT
< 
* Connection #0 to host storage.googleapis.com left intact
```
Se la connessione non riesce, l'output è simile al seguente:
```
*   Trying 142.250.148.128:443...
* Connection timed out after 5000 milliseconds
* Closing connection 0
curl: (28) Connection timed out after 5000 milliseconds```
```
Se la connessione scade e l'indirizzo IP restituito rientra nell'199.36.153.0/24intervallo di indirizzi IP, verifica che il cluster soddisfi i requisiti di rete per la connessione ad API e servizi Google. Se la connessione scade e l'indirizzo IP restituito non rientra nell'intervallo di indirizzi IP indicato, controlla se esistono regole firewall che bloccano il traffico in uscita o route configurati in modo errato nella rete VPC del cluster.

Tieni aperta la connessione SSH all'istanza VM e procedi alla prossima sezione.

Verificare la connessione senza accesso SSH utilizzando Connectivity Tests

Se non disponi dell'accesso SSH alle istanze VM, utilizza i test di connettività per verificare che l'istanza VM abbia una connessione alle API e ai servizi Google.

Trova un'istanza in cui la registrazione del nodo non è riuscita.
Crea ed esegui test di connettività con l'istanza VM come Origine e storage.googleapis.com TCP/443 come Destinazione.

Utilizza i risultati del test per verificare la configurazione di rete del cluster.

Controlla la connessione di rete con il piano di controllo per la registrazione dei nodi

Se disponi dell'accesso SSH alle istanze VM nel tuo progetto, puoi verificare se l'istanza VM ha una connessione di rete al piano di controllo del cluster.

Individua un'istanza la cui registrazione del nodo non è riuscita.
Nella scheda Dettagli dell'istanza VM, fai clic su SSH.
Dopo aver eseguito la connessione alla riga di comando dell'istanza VM, salva l'endpoint del piano di controllo del cluster come variabile di ambiente:
```
source <(sudo grep KUBERNETES_MASTER_NAME /home/kubernetes/kube-env)
```

Invia una richiesta GET all'endpoint del piano di controllo:

curl -k -m 5  https://${KUBERNETES_MASTER_NAME}/version

Se l'output è simile al seguente, l'istanza VM può stabilire una connessione con il piano di controllo:

{
"major": "1",
"minor": "24",
"gitVersion": "v1.24.7-gke.900",
"gitCommit": "e35c4457f66187eff006dda6d2c0fe12144ef2ec",
"gitTreeState": "clean",
"buildDate": "2022-10-26T09:25:34Z",
"goVersion": "go1.18.7b7",
"compiler": "gc",
"platform": "linux/amd64"
}

Se l'output è simile al seguente, l'istanza VM non può stabilisci una connessione con il piano di controllo:

curl: (28) Connection timed out after 5000 milliseconds

Se l'istanza VM non è in grado di stabilire una connessione con il piano di controllo, consulta la sezione relativa a come consentire la connettività al piano di controllo nelle Best practice di networking di GKE.

Completa la registrazione del nodo dopo aver risolto la causa principale

Dopo aver risolto il problema che blocca la registrazione del nodo, procedi come segue dipende dal contesto dell'errore:

Se la registrazione del nodo non è riuscita durante la creazione del cluster, elimina il cluster e riprova.
Se la registrazione dei nodi non è riuscita durante lo scale up con il gestore della scalabilità automatica del cluster, attendi che le istanze VM riprovino a registrarsi.
Se la registrazione del nodo non è riuscita durante la creazione del pool di nodi:
- Se le istanze VM sono state create, attendi che le istanze VM provino e registrati di nuovo.
- Se le istanze VM non sono state create, elimina il pool di nodi e riprova.
Se la registrazione dei nodi non è riuscita durante il ridimensionamento del cluster, esegui di nuovo il comando per aumentare le dimensioni del cluster.
Se la registrazione del nodo al di fuori dell'ambito di un'operazione, ad esempio durante un'operazione di riparazione, attendi che le istanze VM provino a registrarsi di nuovo.

Raccogliere informazioni per ulteriori indagini

Se non riesci a risolvere il problema di registrazione del nodo, puoi raccogliere informazioni aggiuntive per aiutare l'assistenza clienti Google Cloud a svolgere le indagini seguendo le istruzioni riportate di seguito. Questi passaggi richiedono l'accesso SSH alle istanze VM nel tuo progetto e utilizza l'utilità sosreport, inclusa nelle immagini COS.

Trova un'istanza in cui la registrazione del nodo non è riuscita.

Raccogliere informazioni di debug utilizzando sosreport.

In alternativa, se nei tuoi nodi non è stata scaricata l'utilità sosreport e non è possibile installarla, raccogli le informazioni di debug manualmente eseguendo i seguenti comandi:

sudo journalctl -u cloud-init-local
sudo journalctl -u cloud-init
sudo journalctl -u cloud-final
sudo journalctl -u cloud-config
systemctl status kubelet
journalctl -u kubelet
systemctl status kube-node-installation.service
systemctl status kube-node-configuration.service
journalctl -u kube-node-installation.service --no-pager
journalctl -u kube-node-configuration.service --no-pager
journalctl -u kubelet.service --no-pager

Pacchettizza queste informazioni in un file ZIP e includile quando invii una richiesta di assistenza all'assistenza clienti Google Cloud.

Passaggi successivi

Se hai bisogno di ulteriore assistenza, contatta Assistenza clienti Google Cloud.