Digita almeno due lettere per cercare in ogni pagina della documentazione.

↑ ↓ per navigare ↵ per aprire esc per chiudere

Usare rdev

Backup e impostazioni

rdev esegue il backup di ciò che è difficile da ricostruire, e i backup vanno sempre su uno spazio di archiviazione di tua proprietà.

Impostazioni degli agenti

Le impostazioni, le regole e le skill dei tuoi agenti AI (impostazioni di Claude Code e Codex, agenti, skill, comandi, hook, la tua configurazione git e SSH) vengono salvate ogni notte su un repository git di tua proprietà. Credenziali e chiavi non vengono mai copiate. Se configuri un nuovo server, i tuoi agenti tornano con la stessa configurazione. È incluso in ogni piano.

Crea un repository privato vuoto, poi sul server esegui:

sudo rdev backup setup git [email protected]:you/rdev-settings.git

Stampa una chiave SSH; aggiungila al repository come deploy key con accesso in scrittura, poi esegui il primo backup con rdev backup run --settings. Ogni ambiente scrive nella propria cartella, quindi nel piano Team il team condivide un repository con una cartella per ogni sviluppatore.

Backup notturni

Nei piani Pro e Team, i tuoi database MySQL, MariaDB, PostgreSQL e MongoDB e la tua cartella ~/Code vengono salvati ogni notte su un bucket compatibile con S3 di tua proprietà: Amazon S3, Cloudflare R2, Hetzner, Backblaze o il tuo MinIO. node_modules, vendor e altre cartelle ricostruibili vengono escluse. I backup sono cifrati e deduplicati; rdev conserva 7 copie giornaliere, 4 settimanali e 6 mensili.

Il modo più semplice è il pannello: nella pagina del tuo server, Archiviazione dei backup > Configura l'archiviazione dei backup. Scegli il tuo provider, inserisci l'endpoint, il bucket e una chiave che possa scrivere e eliminare al suo interno, e conserva la password di cifratura generata dal pannello (oppure inserisci la password dei backup già presenti in quel bucket per proseguirli). Il tuo browser cifra le chiavi e la password per quel server, quindi il pannello non le vede mai. Il server poi scrive un file di prova nel bucket, lo elimina e apre il repository cifrato; solo se funziona conserva le impostazioni, altrimenti ti dice cosa è andato storto (bucket inesistente, chiave o regione errata, nessun permesso). Testa la connessione esegue lo stesso controllo in seguito.

Da un terminale è:

sudo rdev backup setup s3 --endpoint s3.eu-central-1.amazonaws.com --bucket my-backups \
  --access-key AKIA… --secret-key …

Esegue lo stesso controllo (sudo rdev backup test lo ripete), accetta --region quando l'endpoint non ne indica una, e stampa la password di cifratura una sola volta. Conservala in un posto sicuro, fuori dal server: senza di essa i backup non possono essere ripristinati. Esegui il primo backup con rdev backup run --data.

Il bucket lo scegli tu e le credenziali le conservi tu; non abbiamo mai accesso ai tuoi backup. Se un backup fallisce, ricevi una notifica sui tuoi canali.

Storage di backup del team

Con il piano Team, il proprietario o un amministratore può configurare un unico bucket per tutto il team nella pagina Il tuo team: Storage di backup del team > Configura lo storage del team. Inserisci l'endpoint, il bucket, una chiave che possa scrivere ed eliminare al suo interno e, se vuoi, un prefisso di cartella, e conserva la password di cifratura. Il tuo browser cifra le chiavi e la password separatamente per ogni ambiente del team, quindi il pannello non le vede mai. Ogni ambiente fa il backup nella propria cartella, <prefix>/<member>/<environment>, così i membri non si sovrascrivono mai; chi ha la chiave e la password può ripristinare i backup di qualsiasi membro.

Ogni membro sceglie nella pagina del proprio server, sotto Storage di backup: Storage del team o Il mio storage. Un ambiente senza storage proprio usa quello del team, anche per i membri che entrano dopo: ricevono le impostazioni da un ambiente che lo usa già. Un ambiente che ha già il proprio bucket lo mantiene finché il suo membro non cambia. rdev backup status mostra quale storage è in uso e la cartella. Da terminale, --prefix su rdev backup setup s3 mette i backup di un ambiente in una cartella a tua scelta, ad esempio in un bucket condiviso.

Scegliere cosa salvare

Potresti voler salvare le impostazioni dei tuoi agenti ma non i tuoi progetti, o viceversa. Nella pagina del tuo server nel pannello, Annulla e ripristina > Backup notturno ha un interruttore per ciascuno: Impostazioni degli agenti e Progetti e database. Il server applica la scelta dalla notte successiva; rdev backup status la mostra, e rdev backup run esegue comunque un backup a mano qualunque sia la scelta. La scelta richiede rdev 0.2.0-beta.20 o successivo.

Verificare e ripristinare

  • rdev backup status mostra dove vanno i backup e come sono andate le ultime esecuzioni.
  • rdev backup snapshots elenca gli snapshot notturni.
  • Per ripristinare dal pannello, apri il tuo server e usa Annulla e ripristina > Backup dei dati: scegli un backup, poi un progetto di cui ripristinare i file o un database da ripristinare. Il server lo fa in pochi secondi e il risultato compare in Ripristini recenti.
  • Oppure sul server: rdev backup restore <snapshot> --project shop oppure rdev backup restore <snapshot> --database mysql:shop (mariadb:<name> per MariaDB, postgres:<name> per PostgreSQL, mongodb:all per tutti i database MongoDB in una volta). MariaDB e MongoDB vengono salvati da rdev 0.2.0-beta.19 in poi.

Un progetto ripristinato sostituisce la cartella del progetto; la cartella sostituita viene spostata in ~/rdev-restored, non eliminata. Un database ripristinato viene eliminato e ricaricato dal backup, quindi le modifiche fatte dopo quel backup vanno perse. Il pannello conosce l'elenco dei backup e dei database dopo ogni esecuzione notturna; il ripristino richiede rdev 0.2.0-beta.16 o successivo. Puoi comunque usare restic direttamente con il tuo bucket e la password che hai salvato.

Il tuo codice

I tuoi progetti vivono in git come al solito, e la sincronizzazione dei file mantiene una copia di lavoro sul tuo laptop. rdev non sostituisce il tuo hosting git.