qlik-cli 3.0.0: поддержка команд с пространствами имён

qlik-cli версии 3.0.0 теперь поддерживает группы команд с пространствами имён (namespaces) — логическими блоками, которые повторяют новую структуру API. Команды вызываются внутри соответствующего пространства. Старые команды (legacy) по-прежнему доступны для ресурсов без собственного namespace.

Новая структура команд

Команды сгруппированы по namespace в соответствии со структурой API. Например, qlik ml deployment — для деплоев ML-моделей и экспериментов.

Вызовите qlik --help, чтобы увидеть все доступные группы с namespace и legacy-команды.

Legacy-команды

Для большинства ресурсов legacy-команды (например, qlik app, qlik user) работают без изменений. Они обращаются к существующим эндпоинтам (адресам API) /api/v1/. Их можно использовать, пока вы не выполните миграцию на команды с namespace.

Breaking change: удалены команды ml

Legacy-команды qlik ml удалены. Поддержка эндпоинтов /api/v1/ml/ прекращена. Команды ml с namespace (обращающиеся к /api/ml/...) появятся в одном из будущих релизов. Если вы используете qlik ml deployment или qlik ml experiment, планируйте миграцию к моменту выхода соответствующих команд с namespace.

Предупреждения о замене

При вызове legacy-команды, для которой есть замена с namespace, выводится предупреждение с указанием нового пути. Например:

Warning: Эта команда заменена на 'qlik workflows automation ls'.

Это поможет определить, какие команды нужно обновить при миграции.

Путь миграции

Команды с namespace — новый стандарт. Legacy-команды API v1 остаются доступными в переходный период. В будущем они будут помечены как устаревшие (deprecated) с предварительным уведомлением.

Начинайте планировать миграцию уже сейчас. Даты прекращения поддержки будут публиковаться в журнале изменений (changelog) для каждого эндпоинта API v1 по мере появления эквивалентных команд с namespace. Ранний старт обеспечит готовность к объявлению об устаревании.

Чтобы подготовиться:

  1. Проведите аудит скриптов и определите, какие команды qlik-cli вы используете (см. qlik --help).
  2. Для команд, имеющих аналоги с namespace, определите сроки миграции.
  3. Для команд, у которых пока нет версий с namespace, продолжайте использовать legacy-команды.
  4. Следите за журналом изменений: там будут публиковаться анонсы новых команд с namespace и даты устаревания API v1.