Snapshot e Ripristino in Orbit

Ogni progetto Orbit esegue uno snapshot notturno di due cose che altrimenti sarebbe impossibile recuperare una volta eliminate: le voci del tuo config store e le tue variabili di ambiente. Trenta notti vengono conservate, su ogni piano incluso quello gratuito, e puoi ripristinarne una qualsiasi da solo con un'azione confermata.

Questa guida copre esattamente cosa contiene uno snapshot, cosa non contiene, come ripristinarne uno e come annullare un ripristino.

Cosa Contiene uno Snapshot

Ogni snapshot notturno contiene, per il progetto a cui appartiene:

• Ogni voce del config store: la chiave, il valore e se la voce viene iniettata nella pagina.
• Ogni variabile di ambiente, sia quelle a livello di progetto che gli override per ambiente specifico, inclusi i loro valori, i tipi di ambiente di destinazione e lo scoping dei rami.

I valori sono crittografati a riposo con la stessa chiave e lo stesso algoritmo delle variabili di ambiente stesse, quindi uno snapshot non rende mai un segreto più accessibile rispetto alla variabile da cui proviene.

Cosa Uno Snapshot Non Contiene

Questa è la parte che vale la pena leggere prima di fare affidamento su di esso.

• Il tuo repository git. Si trova presso il tuo provider git ed è tuo. Orbit non lo copia.
• Oggetti del blob store. Lo storage di blob è già durevole e non fa parte di uno snapshot.
• Artefatti di build. I build riusciti vengono conservati secondo la finestra di conservazione delle distribuzioni del tuo piano, che è un'impostazione separata sul progetto. Il ripristino di uno snapshot non ripristina un build, e il rollback di una distribuzione non ripristina la configurazione o le variabili di ambiente. Vedere Rollback di una Distribuzione.
• Database, log, analitiche o qualsiasi cosa la tua applicazione scriva durante l'esecuzione.

Per Quanto Tempo Gli Snapshot Vengono Conservati

Trenta notti, su ogni piano. Dopo di che uno snapshot viene rimosso automaticamente.

C'è un'eccezione deliberata. I tre snapshot più recenti vengono sempre conservati, anche dopo aver superato trenta notti. Un progetto che non hai toccato per due mesi altrimenti avrebbe ogni snapshot scaduto la stessa notte e ti lascerebbe senza nulla da ripristinare proprio nel momento in cui finalmente ne hai bisogno.

Ripristino di uno Snapshot

1. Apri il tuo progetto in Orbit.
2. Apri Impostazioni, poi Snapshot.
3. Trova la notte che desideri. Ogni riga mostra quante voci di configurazione e variabili di ambiente contiene, e quando verrà rimosso.
4. Fai clic su Ripristina questo snapshot.
5. Digita la frase di conferma esattamente come mostrato. Nomina il tuo progetto e la notte che stai ripristinando, ad esempio restore my-blog 2026-08-30.
6. Fai clic su Ripristina ora.

Il ripristino richiede il ruolo Owner o Admin sull'account che possiede il progetto. Chiunque possa vedere il progetto può leggere la sua cronologia degli snapshot.

Cosa Fa Effettivamente un Ripristino

Un ripristino riporta il tuo progetto allo stato di quella notte. Questo significa che non è un merge:

• le voci e le variabili che esistevano allora e mancano ora vengono ricreate, con i loro valori originali;
• le voci e le variabili i cui valori sono cambiati da allora vengono impostate nuovamente;
• le voci e le variabili che hai aggiunto dopo quella notte vengono rimosse.

La schermata ti dice esattamente cosa è successo dopo: quante sono state aggiunte, quante cambiate e quante rimosse, per il config store e per le variabili di ambiente separatamente.

Annullamento di un Ripristino

Prima che un ripristino scriva qualcosa, Orbit prende uno snapshot dello stato che sta per sovrascrivere. Appare nel tuo elenco come una riga Before a restore, e la schermata di conferma la nomina quando il ripristino termina.

Quindi se ripristini la notte sbagliata, ripristina quella riga e sei di nuovo dov'eri. Nulla di un ripristino è irreversibile.

Dopo il Ripristino delle Variabili di Ambiente

Una distribuzione in esecuzione contiene le variabili di ambiente con cui è stata compilata e avviata. Il loro ripristino cambia ciò che la tua prossima distribuzione userà, quindi ridistribuisci se hai bisogno che i valori ripristinati siano attivi. Il progetto mostra un banner quando la tua configurazione è cambiata dall'ultima distribuzione.

Ogni variabile che un ripristino crea, cambia o rimuove viene registrata nella cronologia delle variabili di ambiente del progetto, con chi l'ha fatto e quando, esattamente come una modifica manuale.

Domande Frequenti

Quando viene eseguito lo snapshot? Ogni notte, alle 04:00 UTC, come parte dello stesso passaggio notturno che elimina i vecchi artefatti di build.

Posso eseguirne uno su richiesta? Non dalla schermata oggi. Un ripristino ne esegue sempre uno prima, quindi lo stato prima di qualsiasi ripristino viene sempre acquisito.

Uno snapshot costa qualcosa? No. Gli snapshot sono inclusi su ogni piano, e il config store stesso è gratuito per la lettura e la scrittura.

Il ripristino rivelerà un segreto che ho contrassegnato come write-only? No. Un ripristino ripristina il valore; non lo visualizza. Una variabile write-only rimane write-only.