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

Что нового

v0.1.9

На этой странице

В Holkas v0.1.9 перенос встраивается в конвейер сборки: CLI стал полноценным инструментом для CI/CD, а у REST API появился опубликованный справочник. Установка под Windows стала проще и безопаснее: данные хранятся вне папки программы, по умолчанию нужен вход, пароль администратора задаётся в браузере. Обращение в поддержку теперь само сообщает, что вы запускали и чем кончилась каждая команда.

CLI для конвейеров сборки

Раньше holkas не мог довести перенос до конца: он не дожидался плана и сообщал «Применение запущено», что бы ни ответил сервер. Теперь каждая команда ждёт окончания того, что запустила, и завершается кодом, по которому конвейер может ветвиться.

  • Команды: status, connections, catalog refresh, expand (состав сборки по описателю или манифесту со сверкой по источнику), manifest, plan, migrate, apply, operation, log, download, proposals.
  • Коды завершения от 0 до 5: успех, отрицательный итог, отказ сервера, неверные параметры, нужно подтверждение человека, не дождались.
  • Применение в базу по-прежнему подтверждает человек. CLI останавливается с кодом 4 и печатает команду, которой продолжить после подтверждения.
  • --input загружает пакет, --out скачивает то, что создала операция. С --json результат выводится одним документом в stdout, ход работы — в stderr.
  • Появилась сборка CLI для Linux x64 — для раннеров CI.

Исправлено: имя файла с точкой (release-1.0) теряло расширение .zip.

Подробнее — Holkas CLI и справочник команд.

Справочник REST API

REST API описан как публичный контракт: операции, выбор команд, файлы, заявки на подтверждение, каталог, сравнение базы с git, состав сборки, журнал и администрирование — с примерами запросов и кодами отказов. Справочник — REST API.

Перед публикацией REST приведён к тем же правилам, что и MCP:

  • действовать над операцией (применить, перестроить, отменить, выбрать команды) может только тот, кто её видит; чужая операция — «не найдена»;
  • секреты подключений отдаются замаскированными, адрес git скрывает токен;
  • журнал аудита администратор видит целиком, остальные — свою часть;
  • правила соответствия ролей читаются только при правах на оба подключения;
  • любой отказ приходит в одном виде: {error, message} с причиной по-русски.

Применяется только готовый план. Раньше REST и MCP могли применить отменённую операцию, повторно применить завершённую и применить строящуюся, у которой ещё нет плана. Объект, которого нет в источнике, теперь называется «не найден», а не ошибкой источника.

Установка под Windows: распаковал и запустил

  • Данные — вне папки программы. Без настроек Holkas хранит данные в %LOCALAPPDATA%\Holkas, поэтому замена папки программы при обновлении их не трогает. Если рядом с программой осталась holkas-data от прежних версий, при первом старте Holkas копирует её в новое место.
  • По умолчанию нужен вход. Сборка без настроек стартует в режиме Standalone, а не Local без авторизации.
  • Пароль администратора задаётся в браузере. Если HolkasWeb__BootstrapAdminPassword не задан, при первом открытии Holkas попросит придумать пароль. Для этого нужен одноразовый код, который Holkas печатает в окне консоли: так пароль задаст только тот, кто запустил программу. Пользователя admin/admin больше не бывает.
  • Программа находит свой веб-интерфейс и настройки рядом с исполняемым файлом, поэтому запускается из любой папки.

Пошагово — Установка под Windows.

База состояния защищена при обновлении

Перед переводом базы состояния на новую схему Holkas сам сохраняет её копию в папку backup каталога данных и пишет в окне имя файла. Откат — прежняя версия программы вместе с этой копией. Если базу уже обновила более новая версия Holkas, более старая версия не стартует и объясняет почему, а не ломается на первой операции.

Обращение в поддержку отвечает на первые вопросы

К обращению по операции Holkas теперь прикладывает:

  • что вы запускали: весь план, всё кроме снятых команд или только отмеченные вместе с их зависимостями;
  • чем кончилась каждая команда: исполнено, не удалось, пропущено, выполнено вне плана;
  • отказ СУБД по полям: код с пояснением (например, «23505 — нарушена уникальность»), таблица, ограничение, колонка;
  • окружение: релизы Паруса и версии СУБД обоих концов, режим работы и ОС, время построения плана и применения;
  • файл отчёта: упавшие команды с изменёнными полями и SQL и последние 100 строк лога операции.

Всё это видно до отправки. Пароли и адреса вычищаются, имена подключений заменяются словами «источник» и «приёмник», данные таблиц не отправляются. Имена объектов и файл отчёта можно убрать одной галочкой. Тексты функций, процедур и представлений прикладываются только по отдельной галочке: это ваш код. Если сервер Holkas не выходит в интернет, отчёт можно скачать кнопкой Скачать отчёт и приложить к обращению в форме поддержки.

Агент делает то же через holkas_support_create, у инструмента появился параметр includeCode.

Сравнение и план

  • Неизменённые объекты Паруса больше не выглядят изменёнными. Домены, классы и другие объекты со списками внутри при сравнении базы с git и в предпросмотре отмечались изменёнными, даже когда совпадали полностью. Теперь они неизменённые.
  • Колонки таблиц сравниваются по имени. Колонка, добавленная в существующую таблицу, встаёт последней, и из-за другого порядка таблица больше не считается изменённой.
  • Изменение текста видно сразу. Если у представления или процедуры меняется только текст, план помечает такую команду, карточка говорит, что меняется, а сравнение текста стоит сразу после полей. Длинные блоки сравнения ограничены по высоте, неизменённые строки можно свернуть.
  • Пустой список прав показывается как «только владелец (<владелец>)». Раньше он выглядел пустой строкой, которую легко принять за права по умолчанию для всех.
  • Проверена совместимость с Парусом 8.5.6.1 от 28.11.2024.

Обновление

  • Сборка для Windows без переменных запуска раньше работала в режиме Local без входа и хранила данные в holkas-data рядом с программой. Теперь это Standalone со входом и %LOCALAPPDATA%\Holkas: данные скопируются сами, а при первом открытии, если пользователей ещё нет, Holkas попросит задать пароль администратора. Если вы запускаете Holkas своим сценарием с HolkasWeb__Mode и HolkasWeb__DataPath, ничего не меняется.
  • Токен агента больше не принимается в REST API (/api). Для скриптов и CI выпустите обычный токен. Токены выпускаются и отзываются только из веб-интерфейса.
  • Схема служебной базы обновится сама при первом запуске, копия прежней базы останется в backup.

Дистрибутивы

Holkas Web и Holkas CLI для Windows x64, Holkas CLI для Linux x64 (holkas-cli-linux-x64-0.1.9.tar.gz), файл SHA256SUMS для проверки архивов. Docker-образ: belousov2501/holkas:0.1.9.

Обратная связь

Написать приватно — из раздела Поддержка в Holkas или на странице поддержки. Публично — GitHub Issues.

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

Образ Docker: belousov2501/holkas:0.1.9

Страница релиза v0.1.9 на GitHub