Запуск вне 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 каждый запуск обычно стартует с чистого окружения, но при локальной отладке об этом стоит помнить.
- Ответы сохраняются в файлы, ссылка на файл выводится в журнал — это удобно, когда нужно разобрать неудачный запуск постфактум.