Документация по раннерам Unishift

Этот раздел содержит документацию по каждому из раннеров платформы Unishift.

Обзор раннеров

Раннер	Тип	Назначение
Shell	shell	Выполнение shell-команд на хосте
Docker	docker	Выполнение задач в Docker-контейнерах
SQL	sql	Выполнение SQL-запросов к базам данных
Ollama	ollama	Генерация текста через LLM-модели (Ollama API)
DOCX Generator	docx-generator	Генерация DOCX-документов из HTML-шаблонов
PDF Generator	pdf-generator	Генерация PDF-документов из HTML-шаблонов
XLSX Generator	xlsx-generator	Генерация XLSX-файлов (в разработке)

Общие параметры

Все раннеры используют runner-common и поддерживают следующие общие параметры:

Флаги командной строки

Флаг	Описание	По умолчанию
-config	Путь к конфигурационному файлу (YAML/JSON)	-
-url	URL сервиса Unishift	https://app.com/
-name	Имя раннера	-
-token	Токен доступа	-
-insecure	Использовать небезопасный gRPC транспорт	false
-untagged	Разрешить задачи без тегов	true
-temporary	Пометить раннер как временный (эфемерный)	false
-session-timeout	Таймаут сессии в мс	10000
-task-timeout	Таймаут выполнения задачи в мс	300000 (5 мин)
-concurrency	Количество одновременных задач	1
-tags	Теги через запятую	-
-description	Описание раннера	-
-artifact-tmp	Временная директория для артефактов	~/.cache

Переменные окружения

Переменная	Описание
URL	URL сервиса
TOKEN	Токен доступа
NAME	Имя раннера
SESSION_TIMEOUT	Таймаут сессии в мс
TASK_TIMEOUT	Таймаут задачи в мс
CONCURRENCY	Количество одновременных задач
TAGS	Теги через запятую
DESCRIPTION	Описание раннера
INSECURE	Небезопасный транспорт (true/false)
UNTAGGED	Разрешить задачи без тегов (true/false)
TEMPORARY	Временный раннер (true/false)
ARTIFACT_TMP	Директория для артефактов

Приоритет конфигурации

1. Флаги командной строки (наивысший приоритет)
2. Переменные окружения
3. Конфигурационный файл
4. Значения по умолчанию (наименьший приоритет)

Запуск с конфигурационным файлом

./runner-shell -config config.yaml