Перейти к основному содержимому

Запуск вне IDE: консоль и CI/CD

Редакция: запуск скриптов вне IDE не требует OpenIDE Pro: раннер Connekt — отдельный инструмент с открытым исходным кодом. Написание и отладка сценариев в IDE — возможность OpenIDE Pro.

Скрипты Connekt — обычные файлы в репозитории, и выполняет их не IDE, а отдельный раннер (Connekt Scripting Host). Поэтому сценарий, написанный при разработке, запускается тем же способом в консоли и в конвейере CI/CD: проверки ответов из раздела о проверках становятся шагом сборки без переписывания в другой инструмент.

Раннер поставляется отдельно от OpenIDE и распространяется с открытым исходным кодом: github.com/Amplicode/connekt.

Установка CLI​

Установщик кладёт команду connekt в домашний каталог (~/.connekt, на Windows — %USERPROFILE%\.connekt) и при необходимости добавляет её в PATH. Образы Docker при установке не скачиваются — они загружаются при первом запуске скрипта.

Linux и macOS:

curl -sSf https://raw.githubusercontent.com/Amplicode/connekt/main/install/install.sh | bash

Windows:

curl -fsSL https://raw.githubusercontent.com/Amplicode/connekt/main/install/install.bat -o %TEMP%\install-connekt.bat && %TEMP%\install-connekt.bat

Требования: установленный и запущенный Docker, доступная команда curl. На Windows подойдут CMD, PowerShell или Git Bash.

Запуск скрипта​

connekt orders.connekt.kts

Команда принимает файлы .connekt.kts и .kts.

Запуск в контейнере напрямую​

Если ставить CLI не нужно — например, в раннере CI, где уже есть Docker, — образ вызывается вручную:

docker pull ghcr.io/amplicode/connekt:0.2.10
docker run --rm \
--add-host=host.docker.internal:host-gateway \
-v /absolute/path/to/your/scripts:/connekt/scripts \
ghcr.io/amplicode/connekt:0.2.10 \
--script=scripts/orders.connekt.kts \
--env-file=scripts/connekt.env.json \
--env-name=staging \
--env-param apiKey=secret-from-ci

Что здесь важно:

КлючЗачем
--scriptПуть к сценарию внутри контейнера
--env-fileФайл окружений
--env-nameКакое окружение из файла использовать
--env-paramЗначение поверх файла: так секреты приходят из переменных CI, а не из репозитория
--add-host=host.docker.internal:host-gatewayНужен, когда сценарий обращается к приложению, запущенному на хосте

Номер версии в имени образа фиксируйте явно: сборка не должна меняться сама по себе между запусками конвейера.

Что учесть в конвейере​

  • Сценарий останавливается на первой упавшей проверке и пишет причину в журнал, поэтому шаг сборки падает предсказуемо. Проверяйте код ответа даже там, где результат запроса дальше не нужен.
  • Значения, полученные запросами, кешируются между запусками. В CI каждый запуск обычно стартует с чистого окружения, но при локальной отладке об этом стоит помнить.
  • Ответы сохраняются в файлы, ссылка на файл выводится в журнал — это удобно, когда нужно разобрать неудачный запуск постфактум.