Задача / по шагам
Хранить версии доработки Паруса в Git
Сохраните объект из базы коммитом, измените его и выберите конкретную версию для сравнения с приёмкой. Реальная история одной учебной функции.
На этой странице
- 01Разработка
Текущая функция
- 02Git
История версий
- 03Приёмка
Сравнение с выбранной версией
Пример выполнен на учебной функции PostgreSQL и открытом репозитории GitHub Holkas-Example. Обе версии сохранены через Holkas; выбор конкретного коммита и повторное сравнение проверены на тестовом стенде.
Учебный пример
Git полезен, когда нужно сохранить несколько состояний доработки, знать происхождение версии и повторить её доставку. Holkas хранит объекты в файлах репозитория и записывает изменения коммитами.
Возьмём учебную функцию проверки суммы договора. Сначала сохраним правило «сумма больше нуля», затем — «не меньше 100». В конце выберем прежнюю версию и убедимся, что Holkas сравнивает именно её.
Один объект
parus.f_hksite_contract_check — достаточно одной функции, чтобы увидеть весь путь.
Версия 1.1
Принимает любую положительную сумму. Уже доставлена в приёмку через ZIP.
Версия 1.2
Новое учебное правило: сумма договора не меньше 100.
Перед началом
- 01
Репозиторий для доработки
Подготовьте свой Git-репозиторий с начальной веткой. Holkas-Example открыт для просмотра результата. Это хранилище учебного объекта доработки; клонировать исходники Holkas не требуется.
- 02
Подключение Git
В «Подключениях» добавьте узел Git с адресом репозитория и веткой по умолчанию. При необходимости задайте учётные данные. Для сохранения нужен доступ на запись, для чтения версии — на чтение.
- 03
Небольшой первый состав
В примере выбираем только функцию. Полный состав решения собирают из нужных объектов и зависимостей — см. первый перенос.
Постройте план сохранения в Git
В разделе «Перенести» выберите разработку источником, Git-подключение — приёмником. Укажите ветку main; на шаге объектов выберите функцию, затем перейдите к параметрам и нажмите «Запустить план». Если этой функции в репозитории ещё нет, будет одна команда Create.
В отличие от ZIP, Git хранит текущее состояние объектов: Holkas может сравнить с ним источник. Сохранение в Git не изменяет базу приёмки.
Сохраните следующую версию
Примените первый план. Затем измените функцию в разработке: вместо суммы больше нуля потребуйте сумму не меньше 100. Повторите маршрут база → Git с той же функцией. План покажет Update; проверьте его и примените.
Коммит появляется после применения изменений к Git. План сам по себе ещё не сохраняет новую версию. В нашем примере обе операции завершились успешно.
Посмотрите результат в GitHub
Откройте учебный репозиторий. В каталоге FunctionPostgres появился файл parus.f_hksite_contract_check.yaml. Holkas сохраняет в нём описание функции и её тело. В коммите версии 1.2 виден тот же переход от amount > 0 к amount >= 100, который мы разобрали перед применением.
Это результат двух сохранений через Holkas. Код в GitHub доступен для чтения и сравнения независимо от базы. GitHub — один из вариантов размещения Git-репозитория; для переноса вернитесь в Holkas и выберите нужную версию.
Выберите конкретный коммит источником
Начните новый перенос. Источником выберите «Учебная · GitHub». Переключитесь на «Коммит»: Holkas покажет историю ветки. Выберите b5d8a36b — сохранение версии 1.1 — и нажмите «Выбрать @ b5d8a36b».
Ветка со временем меняется. Для повторяемой доставки используйте конкретный коммит; при необходимости можно выбрать существующий тег. Приёмником Git, наоборот, может быть только ветка.
Сравните выбранную версию с приёмкой
Приёмником укажите учебную приёмку, выберите функцию, перейдите к параметрам и нажмите «Запустить план». В ней уже находится версия 1.1 из ZIP, поэтому план пустой. Более новая версия в main на этот результат не повлияла.
Проверьте коммит в строке маршрута операции. Если выбрать main или новый коммит, сравниваться будет другое состояние функции.
Версии сохранены
Оба варианта правила есть в истории.
Источник зафиксирован
Выбран конкретный SHA, а не меняющаяся ветка.
Приёмка сравнена
План относится именно к выбранной версии.
Если что-то пошло не так
После сохранения не видно новой версии
Проверьте завершение применения, журнал и выбранную ветку. Построить план недостаточно: запись происходит при применении.
Репозиторий изменил другой человек
Не считайте старый план актуальным. Проверьте журнал отказа и перестройте план относительно текущей ветки. Не обходите конфликт принудительной перезаписью без разбора чужих изменений.
Хочу откатить базу старым коммитом
Старый коммит может стать источником нового сравнения, но это не общий откат базы. Проверьте конкретные команды и ограничения типов объектов; данные и уже выполненные скрипты таким способом не восстанавливаются.