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

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

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

Установка

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

pkg add cobalt

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

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

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

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

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

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

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

Команды CLI

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

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

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

Переменная	Значение
`COBALT_TOKEN`	токен доступа к проекту; обязателен в CI
`COBALT_ENV`	окружение по умолчанию для команд без --env
`COBALT_CACHE_DIR`	каталог общего кэша сборки
`COBALT_LOG_FORMAT`	text или json для машинного разбора

Что дальше

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

← На главную