Skip to content

RKE2 Snapshot: Comandi Utili (Cheat Sheet rke2 etcd-snapshot)

Questa guida raccoglie i comandi principali per creare, conservare e ripristinare snapshot di etcd in un cluster RKE2 con datastore embedded.


Creazione Snapshot

Comando Descrizione
sudo rke2 etcd-snapshot save --name snapshot-manuale Crea uno snapshot manuale di etcd con nome esplicito.
sudo rke2 etcd-snapshot save --name snapshot-pre-upgrade-$(date +%F-%H%M) Crea uno snapshot con timestamp, utile prima di upgrade o manutenzioni.
sudo ls -lh /var/lib/rancher/rke2/server/db/snapshots/ Verifica la presenza degli snapshot salvati localmente.
sudo find /var/lib/rancher/rke2/server/db/snapshots/ -type f -name "*.zip" Elenca i file snapshot generati da RKE2.

Ripristino Snapshot

Comando Descrizione
sudo cat /var/lib/rancher/rke2/server/node-token Recupera il token originale del cluster, necessario quando il restore deve riavviare il control plane con la stessa identita.
sudo systemctl stop rke2-server Ferma il servizio RKE2 server prima di un restore pianificato.
sudo rke2 server --cluster-reset --cluster-reset-restore-path=/var/lib/rancher/rke2/server/db/snapshots/snapshot-manuale.zip Avvia il ripristino del cluster partendo da uno snapshot locale.
sudo rke2 server --cluster-reset --cluster-reset-restore-path=/var/lib/rancher/rke2/server/db/snapshots/snapshot-manuale.zip --token=<TOKEN_ORIGINALE> Esegue il restore indicando il token originale del cluster, utile quando si ricostruisce il control plane o si deve mantenere la coerenza con i nodi esistenti.
sudo systemctl start rke2-server Riavvia RKE2 server dopo il completamento della procedura di reset.
sudo journalctl -u rke2-server -f Monitora i log del servizio durante riavvio e riallineamento del control plane.

Diagnostica e Troubleshooting

Comando Descrizione
sudo systemctl status rke2-server Verifica lo stato del servizio RKE2 server.
kubectl get nodes Controlla che i nodi siano tornati disponibili dopo il restore.
kubectl get pods -A Verifica lo stato dei Pod di sistema e dei workload applicativi.
kubectl get events -A --sort-by=.lastTimestamp Analizza gli eventi recenti del cluster dopo il ripristino.

Comandi consigliati prima di modifiche critiche

sudo rke2 etcd-snapshot save --name snapshot-pre-change-$(date +%F-%H%M)
sudo ls -lh /var/lib/rancher/rke2/server/db/snapshots/
kubectl get nodes

Comandi consigliati prima del ripristino

sudo systemctl stop rke2-server
sudo ls -lh /var/lib/rancher/rke2/server/db/snapshots/
sudo cat /var/lib/rancher/rke2/server/node-token
sudo sha256sum /var/lib/rancher/rke2/server/db/snapshots/snapshot-manuale.zip

Comandi consigliati dopo il ripristino

sudo systemctl status rke2-server
kubectl get nodes
kubectl get pods -A