Kestrel
Документация

Быстрый старт

От установки до первого деплоя за несколько минут. Всё, что нужно знать, чтобы начать.

Установка

Kestrel ставится менеджером пакетов вашей системы одной командой. Отдельная среда выполнения не требуется - бинарник самодостаточен.

pkg add kestrel

Проверьте установку: kestrel version - должна вывестись текущая версия.

Инициализация проекта

В корне репозитория выполните kestrel init. Команда просканирует проект, определит язык и сборщик и создаст минимальный конфиг kestrel.yml с разумными значениями по умолчанию - его можно сразу коммитить.

Конфигурация окружений

Окружения описываются в одном файле. Пример трёх сред с разными доменами и набором секретов:

  • dev - локальная и ветки; эфемерные, создаются и удаляются автоматически;
  • stage - предпрод; данные обезличены, доступ по ссылке;
  • prod - боевое; деплой по правилу или по кнопке, с проверками после релиза.

Секреты не хранятся в файле - они лежат в зашифрованном хранилище и подставляются процессу на лету.

Команды CLI

КомандаЧто делает
kestrel initсоздать конфиг проекта
kestrel build --watchгорячая инкрементальная сборка
kestrel testпрогнать тесты в изолированном окружении
kestrel deploy --env prodсобрать, проверить и выкатить
kestrel rollbackоткатить последний релиз
kestrel logs --tailживые логи сборки и деплоя

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

Агент читает настройки из окружения - это удобно в CI, где конфиг лежит не в репозитории.

ПеременнаяЗначение
KESTREL_TOKENтокен доступа к проекту; обязателен в CI
KESTREL_ENVокружение по умолчанию для команд без --env
KESTREL_CACHE_DIRкаталог общего кэша сборки
KESTREL_LOG_FORMATtext или json для машинного разбора

Что дальше

Загляните в раздел тарифов, чтобы выбрать план под размер команды, или посмотрите последние обновления. Вопросы - на почту поддержки, отвечаем в рабочий день.

← На главную