Holkas
Написать в поддержку Поддержка

Задача / по шагам

Хранить версии доработки Паруса в Git

Сохраните объект из базы коммитом, измените его и выберите конкретную версию для сравнения с приёмкой. Реальная история одной учебной функции.

На этой странице
  1. 01
    Разработка

    Текущая функция

  2. 02
    Git

    История версий

  3. 03
    Приёмка

    Сравнение с выбранной версией

Пример выполнен на учебной функции PostgreSQL и открытом репозитории GitHub Holkas-Example. Обе версии сохранены через Holkas; выбор конкретного коммита и повторное сравнение проверены на тестовом стенде.

Учебный пример

Git полезен, когда нужно сохранить несколько состояний доработки, знать происхождение версии и повторить её доставку. Holkas хранит объекты в файлах репозитория и записывает изменения коммитами.

Возьмём учебную функцию проверки суммы договора. Сначала сохраним правило «сумма больше нуля», затем — «не меньше 100». В конце выберем прежнюю версию и убедимся, что Holkas сравнивает именно её.

JFP

Один объект

parus.f_hksite_contract_check — достаточно одной функции, чтобы увидеть весь путь.

> 0

Версия 1.1

Принимает любую положительную сумму. Уже доставлена в приёмку через ZIP.

≥ 100

Версия 1.2

Новое учебное правило: сумма договора не меньше 100.

Перед началом

  • 01

    Репозиторий для доработки

    Подготовьте свой Git-репозиторий с начальной веткой. Holkas-Example открыт для просмотра результата. Это хранилище учебного объекта доработки; клонировать исходники Holkas не требуется.

  • 02

    Подключение Git

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

  • 03

    Небольшой первый состав

    В примере выбираем только функцию. Полный состав решения собирают из нужных объектов и зависимостей — см. первый перенос.

Постройте план сохранения в Git

В разделе «Перенести» выберите разработку источником, Git-подключение — приёмником. Укажите ветку main; на шаге объектов выберите функцию, затем перейдите к параметрам и нажмите «Запустить план». Если этой функции в репозитории ещё нет, будет одна команда Create.

План создания учебной функции в Git — одна команда Create
Сравниваются база разработки и ветка main. Примените план, чтобы записать объект в репозиторий.

В отличие от ZIP, Git хранит текущее состояние объектов: Holkas может сравнить с ним источник. Сохранение в Git не изменяет базу приёмки.

Сохраните следующую версию

Примените первый план. Затем измените функцию в разработке: вместо суммы больше нуля потребуйте сумму не меньше 100. Повторите маршрут база → Git с той же функцией. План покажет Update; проверьте его и примените.

Второе сохранение функции в Git — одна команда Update
Версия 1.1 остаётся в истории. Новое правило суммы сохраняется следующим коммитом в main.

Коммит появляется после применения изменений к Git. План сам по себе ещё не сохраняет новую версию. В нашем примере обе операции завершились успешно.

Посмотрите результат в GitHub

Откройте учебный репозиторий. В каталоге FunctionPostgres появился файл parus.f_hksite_contract_check.yaml. Holkas сохраняет в нём описание функции и её тело. В коммите версии 1.2 виден тот же переход от amount > 0 к amount >= 100, который мы разобрали перед применением.

Настоящий diff коммита Holkas-Example в GitHub: правило суммы > 0 заменяется на >= 100
GitHub, коммит b0e9abb: один изменённый YAML-файл, две удалённые и две добавленные строки. Репозиторий открыт — результат можно проверить по ссылке над скриншотом.

Это результат двух сохранений через Holkas. Код в GitHub доступен для чтения и сравнения независимо от базы. GitHub — один из вариантов размещения Git-репозитория; для переноса вернитесь в Holkas и выберите нужную версию.

Выберите конкретный коммит источником

Начните новый перенос. Источником выберите «Учебная · GitHub». Переключитесь на «Коммит»: Holkas покажет историю ветки. Выберите b5d8a36b — сохранение версии 1.1 — и нажмите «Выбрать @ b5d8a36b».

Выбор старого коммита b5d8a36b при наличии более новой версии
Верхняя строка — версия 1.2, выбранная строка ниже — версия 1.1. Это настоящие коммиты учебного репозитория; в вашей истории SHA будут другими.

Ветка со временем меняется. Для повторяемой доставки используйте конкретный коммит; при необходимости можно выбрать существующий тег. Приёмником Git, наоборот, может быть только ветка.

Сравните выбранную версию с приёмкой

Приёмником укажите учебную приёмку, выберите функцию, перейдите к параметрам и нажмите «Запустить план». В ней уже находится версия 1.1 из ZIP, поэтому план пустой. Более новая версия в main на этот результат не повлияла.

Пустой план из Git с зафиксированным коммитом версии 1.1
Выбор коммита проверен: приёмка совпала именно с 1.1, хотя текущая ветка уже содержит 1.2.

Проверьте коммит в строке маршрута операции. Если выбрать main или новый коммит, сравниваться будет другое состояние функции.

Версии сохранены

Оба варианта правила есть в истории.

Источник зафиксирован

Выбран конкретный SHA, а не меняющаяся ветка.

Приёмка сравнена

План относится именно к выбранной версии.

Если что-то пошло не так

После сохранения не видно новой версии

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

Репозиторий изменил другой человек

Не считайте старый план актуальным. Проверьте журнал отказа и перестройте план относительно текущей ветки. Не обходите конфликт принудительной перезаписью без разбора чужих изменений.

Хочу откатить базу старым коммитом

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