Snapshots and Restore in Orbit

Cada projeto Orbit faz um snapshot noturno de duas coisas que, de outra forma, são impossíveis de recuperar após serem deletadas: suas entradas de config store e suas variáveis de ambiente. Trinta noites são mantidas em todos os planos, incluindo o gratuito, e você pode restaurar qualquer uma delas em uma única ação confirmada.

Este guia cobre exatamente o que um snapshot contém, o que não contém, como restaurar um e como desfazer uma restauração.

O que um Snapshot Contém

Cada snapshot noturno contém, para o projeto ao qual pertence:

• Todas as entradas de config store: a chave, o valor e se a entrada é injetada na página.
• Todas as variáveis de ambiente, tanto as de nível de projeto quanto as substituições por ambiente, incluindo seus valores, seus tipos de ambiente de destino e seu escopo de branch.

Os valores são criptografados em repouso com a mesma chave e a mesma cifra que suas variáveis de ambiente, então um snapshot nunca torna um segredo mais fácil de alcançar do que a variável da qual veio.

O que um Snapshot Não Contém

Esta é a parte que vale a pena ler antes de contar com isso.

• Seu repositório git. Ele fica com seu provedor de git e é seu. Orbit não o copia.
• Objetos de blob store. Seu armazenamento de blob já é durável e não faz parte de um snapshot.
• Artefatos de build. Os builds bem-sucedidos são mantidos na janela de retenção de deployment do seu plano, que é uma configuração separada no projeto. Restaurar um snapshot não restaura um build, e fazer rollback de um deployment não restaura config ou variáveis de ambiente. Consulte Rolling Back a Deployment.
• Bancos de dados, logs, análises ou qualquer coisa que seu aplicativo escreva em tempo de execução.

Quanto Tempo os Snapshots São Mantidos

Trinta noites em todos os planos. Depois disso, um snapshot é removido automaticamente.

Há uma exceção deliberada. Os três snapshots mais recentes são sempre mantidos, mesmo depois que passam trinta noites. Um projeto que você não toca há dois meses poderia ter todos os snapshots expirados na mesma noite e deixá-lo sem nada para restaurar exatamente no momento em que você finalmente precisa de um.

Restaurando um Snapshot

1. Abra seu projeto em Orbit.
2. Abra Settings, depois Snapshots.
3. Encontre a noite que deseja. Cada linha mostra quantas entradas de config e variáveis de ambiente ela contém, e quando será removida.
4. Clique em Restore this snapshot.
5. Digite a frase de confirmação exatamente como mostrado. Ela nomeia seu projeto e a noite que você está restaurando, por exemplo restore my-blog 2026-08-30.
6. Clique em Restore now.

Restaurar requer a função Owner ou Admin na conta que possui o projeto. Qualquer pessoa que possa ver o projeto pode ler seu histórico de snapshots.

O que uma Restauração Realmente Faz

Uma restauração coloca seu projeto de volta ao estado daquela noite. Isso significa que não é uma mesclagem:

• entradas e variáveis que existiam então e estão faltando agora são recriadas, com seus valores originais;
• entradas e variáveis cujos valores mudaram desde então são restauradas;
• entradas e variáveis que você adicionou depois daquela noite são removidas.

A tela diz exatamente o que aconteceu depois: quantas foram adicionadas, quantas mudaram e quantas foram removidas, para o config store e para variáveis de ambiente separadamente.

Desfazendo uma Restauração

Antes de uma restauração escrever qualquer coisa, Orbit faz um snapshot do estado que está prestes a substituir. Ele aparece em sua lista como uma linha Before a restore, e a tela de confirmação o nomeia quando a restauração termina.

Então se você restaurar a noite errada, restaure essa linha e você voltará ao ponto de partida. Nada sobre uma restauração é irreversível.

Após Restaurar Variáveis de Ambiente

Um deployment em execução mantém as variáveis de ambiente com as quais foi compilado e iniciado. Restaurá-las muda o que seu próximo deployment usará, então reimplante se você precisar dos valores restaurados em tempo real. O projeto mostra um banner quando sua configuração mudou desde o último deployment.

Toda variável que uma restauração cria, muda ou remove é registrada no histórico de variáveis de ambiente do projeto, com quem fez e quando, exatamente como uma mudança manual.

Perguntas Frequentes

Quando o snapshot é executado? Noturno, às 04:00 UTC, como parte do mesmo passe noturno que remove artefatos de build antigos.

Posso fazer um sob demanda? Não na tela hoje. Uma restauração sempre faz um primeiro, então o estado antes de qualquer restauração é sempre capturado.

Um snapshot custa algo? Não. Snapshots estão inclusos em todos os planos, e o config store em si é gratuito para ler e escrever.

Restaurar revelará um segredo que marquei como write-only? Não. Uma restauração coloca o valor de volta; ela não o exibe. Uma variável write-only permanece write-only.