История и восстановление

Что хранит History

History показывает устойчивые версии файлов проекта, связанные с Git-коммитами. Завершённая работа агента и явное восстановление могут добавлять новые версии. Сначала загружаются свежие записи, а более старые появляются при дальнейшем просмотре. Это отдельная история, не совпадающая с сообщениями каждого чата.

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

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

Задачи, которые только проверяют проект, не создают новую версию, если файлы и настройки не изменились. Версия только с изменениями настроек может показывать +0 / −0 изменений файлов: эти счётчики учитывают строки исходников, а не настройки приложений.

Если задача агента завершается с ошибкой после внесения изменений, Amazi сохраняет их в History до запуска следующей задачи. У задачи остаётся статус ошибки, а версия может содержать незавершённую или непроверенную работу. Нажмите Продолжить в чате, чтобы продолжить с сохранённых файлов. Ошибка до внесения изменений не создаёт пустую версию.

History включает редактируемые исходники и файлы миграций, конфигурацию приложений, привязку владельца managed database и scopes проектных переменных окружения. Значения переменных не откатываются. Она не создаёт снимок:

• данных PostgreSQL;
• объектного хранилища;
• volumes приложений;
• сторонних сервисов и другого внешнего состояния.

Для этих систем нужны собственные правила резервного копирования и миграций.

Просмотр старой версии

Участники с доступом «Только просмотр» могут открывать старые версии и возвращаться к текущей, пока агент не работает. Для просмотра нажмите на строку ленты. Под заголовком указаны дата и краткое описание, справа — иконка восстановления. Текущая, просматриваемая и опубликованная версии сохраняют отдельные метки. Отдельная кнопка восстановления остаётся видимой, но заблокирована без прав редактора или полного доступа.

Выберите версию для просмотра её исходников в существующем Preview разработки. Общее рабочее пространство временно показывает выбранный коммит; выбор виден всем участникам проекта. Основная ветка не перемещается, отдельная среда не создаётся. Отправка задач агенту блокируется до возврата к текущей версии. База, сохранённые файлы, volumes и значения окружения остаются действующими: работа со старой страницей может менять текущие данные.

Если уйти из History при выбранном старом Preview, Amazi попросит подтверждение. Продолжение вернёт текущие исходники в общее рабочее пространство. Оно не создаёт коммит восстановления и не откатывает внешние данные.

Исключение файлов из будущих версий и удаление из History

В чате проекта укажите точные пути к файлам или папкам и нужный результат:

• Перестать отслеживать, сохранив файлы: файлы остаются в текущем рабочем пространстве, но больше не входят в автоматические версии и экспорт исходников. Старые версии сохраняют их содержимое.
• Удалить из всех прошлых версий: владелец проекта может попросить Amazi очистить History от этих путей. Текущие файлы остаются на месте, но восстановить их прежнее содержимое через History уже нельзя. Новые автоматические версии и экспорт исходников тоже исключают эти файлы.

Перед любой из этих операций вернитесь к текущей версии. Перед очисткой истории отключите GitHub. Операция не удаляет копии из GitHub, других проектов, существующих публикаций и резервных копий. Для переименованных копий нужно отдельно указать старые пути. Существующие публикации продолжают работать с прежними файлами; после очистки старая метка «Опубликовано» может исчезнуть до следующей публикации. Удаление из истории не меняет работающую публикацию.

Восстановление файлов

Используйте явное восстановление только после проверки этой границы. Его можно запустить из History, а по вашему запросу Amazi может выполнить тот же защищённый soft revert для зарегистрированного Git-коммита. Amazi создаёт новый прямой коммит, дерево и конфигурация приложений которого соответствуют выбранной версии; ветка проекта не перемещается назад. Приложения, добавленные после этой версии, переходят в pending deletion, чтобы production-ресурсы не уничтожались неявно. Базы, значения переменных, объекты, volumes и внешние сервисы остаются прежними, поэтому старому коду может понадобиться доработка для совместимости с текущими данными. При смешанном или частично изменённом состоянии операция завершается безопасной ошибкой, а не угадывает, что перезаписать.