Снимки и восстановление в Kapsule Orbit

Каждый проект Orbit берёт ночной снимок двух вещей, которые в противном случае невозможно восстановить после их удаления: записей вашего хранилища конфигурации и переменных окружения. Тридцать ночей хранятся на каждом плане, включая бесплатный, и вы можете восстановить любой из них сами в одном подтверждённом действии.

Это руководство охватывает ровно то, что содержит снимок, что он не содержит, как восстановить снимок и как отменить восстановление.

Что содержит снимок

Каждый ночной снимок содержит для принадлежащего ему проекта:

• Каждую запись хранилища конфигурации: ключ, значение и то, внедряется ли запись на страницу.
• Каждую переменную окружения, как проектные, так и переопределения для отдельного окружения, включая их значения, типы целевого окружения и область действия ветви.

Значения шифруются в покое с тем же ключом и тем же шифром, что и сами переменные окружения, поэтому снимок никогда не делает секрет более доступным, чем переменная, из которой он был получен.

Что снимок не содержит

Это часть, которую стоит прочитать, прежде чем полагаться на неё.

• Ваш репозиторий git. Он находится у вашего поставщика git и принадлежит вам. Orbit не копирует его.
• Объекты хранилища больших двоичных объектов. Хранилище больших двоичных объектов уже устойчиво и не является частью снимка.
• Артефакты сборки. Успешные сборки хранятся в соответствии с окном хранения развёртывания вашего плана, которое является отдельным параметром проекта. Восстановление снимка не восстанавливает сборку, а откат развёртывания не восстанавливает конфигурацию или переменные окружения. См. Откат развёртывания.
• Базы данных, логи, аналитика или что-либо, что ваше приложение записывает во время выполнения.

Как долго хранятся снимки

Тридцать ночей на каждом плане. После этого снимок удаляется автоматически.

Есть одно намеренное исключение. Три самых последних снимка всегда сохраняются, даже после того как они пройдут тридцать ночей. Проект, который вы не трогали два месяца, в противном случае имел бы каждый снимок истекший в одну и ту же ночь и оставил бы вас без возможности восстановления именно в момент, когда он вам наконец понадобится.

Восстановление снимка

1. Откройте ваш проект в Orbit.
2. Откройте Settings, затем Snapshots.
3. Найдите ночь, которую вы хотите. Каждая строка показывает, сколько записей конфигурации и переменных окружения она содержит, и когда она будет удалена.
4. Нажмите Restore this snapshot.
5. Введите фразу подтверждения точно в том виде, как показано. Она называет ваш проект и ночь, которую вы восстанавливаете, например restore my-blog 2026-08-30.
6. Нажмите Restore now.

Восстановление требует роли Owner или Admin на учёте, который владеет проектом. Любой, кто может видеть проект, может прочитать его историю снимков.

Что на самом деле делает восстановление

Восстановление приводит ваш проект в состояние той ночи. Это означает, что это не слияние:

• записи и переменные, которые существовали тогда и отсутствуют сейчас, пересоздаются с их исходными значениями;
• записи и переменные, значения которых изменились с тех пор, устанавливаются обратно;
• записи и переменные, которые вы добавили после той ночи, удаляются.

Экран показывает вам точно то, что произошло впоследствии: сколько было добавлено, сколько изменилось и сколько было удалено для хранилища конфигурации и для переменных окружения отдельно.

Отмена восстановления

Прежде чем восстановление что-то напишет, Orbit берёт снимок состояния, которое оно вот-вот перезапишет. Он появляется в вашем списке как строка Before a restore, и экран подтверждения называет его, когда восстановление завершается.

Итак, если вы восстановили неправильную ночь, восстановите эту строку и вы вернётесь к тому месту, где начали. Ничто в восстановлении не является односторонним.

После восстановления переменных окружения

Работающее развёртывание содержит переменные окружения, с которыми оно было собрано и запущено. Их восстановление изменяет то, что будет использовать ваше следующее развёртывание, поэтому переразверните, если вам нужны восстановленные значения в действии. Проект показывает баннер, когда ваша конфигурация изменилась со времени последнего развёртывания.

Каждая переменная, которую восстановление создаёт, изменяет или удаляет, записывается в историю переменных окружения проекта, с указанием того, кто это сделал и когда, точно так же, как и ручное изменение.

Часто задаваемые вопросы

Когда выполняется снимок? Ночью, в 04:00 UTC, как часть того же ночного прохода, который удаляет старые артефакты сборки.

Могу ли я взять снимок по требованию? Не на экране сегодня. Восстановление всегда берёт его в первую очередь, поэтому состояние перед любым восстановлением всегда фиксируется.

Стоит ли снимок чего-нибудь? Нет. Снимки включены в каждый план, и само хранилище конфигурации бесплатно для чтения и записи.

Раскроет ли восстановление секрет, который я отметил как «только для записи»? Нет. Восстановление возвращает значение; оно не отображает его. Переменная «только для записи» остаётся переменной «только для записи».