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

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

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

Установка

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

pkg add halcyon

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

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

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

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

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

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

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

Команды CLI

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

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

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

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

Что дальше

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

← На главную