Что нового
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