Snapshots y Restore en Kapsule Orbit

Cada proyecto de Kapsule Orbit realiza una instantánea nocturna de dos cosas que de otro modo sería imposible recuperar una vez las elimina: sus entradas del almacén de configuración y sus variables de entorno. Se conservan treinta noches en todos los planes, incluido el gratuito, y puede restaurar cualquiera de ellas usted mismo en una sola acción confirmada.

Esta guía cubre exactamente qué contiene una instantánea, qué no contiene, cómo restaurar una y cómo deshacer una restauración.

Qué contiene una instantánea

Cada instantánea nocturna contiene, para el proyecto al que pertenece:

• Cada entrada del almacén de configuración: la clave, el valor y si la entrada se inyecta en la página.
• Cada variable de entorno, tanto las del nivel de proyecto como los reemplazos por entorno, incluidos sus valores, sus tipos de entorno de destino y su alcance de rama.

Los valores se cifran en reposo con la misma clave y el mismo cifrado que sus propias variables de entorno, por lo que una instantánea nunca hace que un secreto sea más accesible que la variable de la que proviene.

Qué una instantánea no contiene

Esta es la parte que merece la pena leer antes de confiar en ella.

• Su repositorio de git. Reside con su proveedor de git y le pertenece. Kapsule Orbit no lo copia.
• Objetos del almacén de blob. Su almacenamiento de blob ya es duradero y no forma parte de una instantánea.
• Artefactos de compilación. Las compilaciones exitosas se conservan dentro de la ventana de retención de implementación de su plan, que es una configuración separada en el proyecto. Restaurar una instantánea no restaura una compilación, y revertir una implementación no restaura la configuración ni las variables de entorno. Consulte Reversión de una implementación.
• Bases de datos, registros, análisis o cualquier cosa que su aplicación escriba en tiempo de ejecución.

Cuánto tiempo se conservan las instantáneas

Treinta noches en todos los planes. Después de eso, una instantánea se elimina automáticamente.

Hay una excepción deliberada. Las tres instantáneas más recientes siempre se conservan, incluso después de que superen treinta noches. Un proyecto que no ha tocado durante dos meses de otro modo tendría cada instantánea expirada la misma noche y lo dejaría sin nada que restaurar exactamente en el momento en que finalmente lo necesita.

Restaurar una instantánea

1. Abra su proyecto en Kapsule Orbit.
2. Abra Configuración, luego Instantáneas.
3. Encuentre la noche que desea. Cada fila muestra cuántas entradas de configuración y variables de entorno contiene, y cuándo se eliminará.
4. Haga clic en Restaurar esta instantánea.
5. Escriba la frase de confirmación exactamente como se muestra. Nombra su proyecto y la noche que está restaurando, por ejemplo restore my-blog 2026-08-30.
6. Haga clic en Restaurar ahora.

Para restaurar se necesita el rol de Propietario o Administrador en la cuenta que posee el proyecto. Cualquiera que pueda ver el proyecto puede leer su historial de instantáneas.

Qué hace realmente una restauración

Una restauración devuelve su proyecto al estado de esa noche. Eso significa que no es una fusión:

• las entradas y variables que existían entonces y faltan ahora se recrean, con sus valores originales;
• las entradas y variables cuyos valores han cambiado desde entonces se restablecen;
• las entradas y variables que añadió después de esa noche se eliminan.

La pantalla le dice exactamente qué sucedió después: cuántas se añadieron, cuántas cambiaron y cuántas se eliminaron, para el almacén de configuración y para las variables de entorno por separado.

Deshacer una restauración

Antes de que una restauración escriba cualquier cosa, Kapsule Orbit toma una instantánea del estado que está a punto de sobrescribir. Aparece en su lista como una fila de Antes de una restauración, y la pantalla de confirmación la nombra cuando termina la restauración.

Así que si restaura la noche equivocada, restaure esa fila y estará de nuevo donde comenzó. Nada en una restauración es unidireccional.

Después de restaurar variables de entorno

Una implementación en ejecución contiene las variables de entorno con las que se compiló e inició. Restaurarlas cambia lo que su próxima implementación utilizará, así que reimplemente si necesita que los valores restaurados estén activos. El proyecto muestra un banner cuando su configuración ha cambiado desde la última implementación.

Cada variable que una restauración crea, cambia o elimina se registra en el historial de variables de entorno del proyecto, con quién lo hizo y cuándo, exactamente como lo hace un cambio manual.

Preguntas frecuentes

¿Cuándo se ejecuta la instantánea? Nocturna, a las 04:00 UTC, como parte del mismo paso nocturno que elimina los artefactos de compilación antiguos.

¿Puedo tomar una bajo demanda? No desde la pantalla hoy. Una restauración siempre toma una primero, por lo que el estado antes de cualquier restauración siempre se captura.

¿Una instantánea cuesta algo? No. Las instantáneas se incluyen en todos los planes, y el almacén de configuración en sí es gratuito para leer y escribir.

¿Una restauración revelará un secreto que marqué como de solo escritura? No. Una restauración devuelve el valor; no lo muestra. Una variable de solo escritura permanece como solo escritura.