Гайд · Быстрый старт

Деплой приложения за 5 минут

Пять понятных шагов от пустого каталога до работающего сервиса в облаке. Без YAML-конфигураций на 200 строк и без звонка в поддержку.

Схема шагов деплоя приложения в DevFlux
Шаг 1 · ~30 секунд

Установка CLI-инструмента

DevFlux CLI — это лёгкий бинарник на Go, который работает на macOS (Apple Silicon и Intel), Linux и Windows 11. Он сам управляет сборкой, загрузкой артефактов и связью с API платформы.

После установки вы сразу попадаете в интерактивный мастер авторизации — вводить токен руками не нужно.

Команды установки

macOS / Linux:

brew install devflux-cli
или
curl -sSL https://get.devflux.io | sh

Windows (PowerShell):

winget install DevFlux.CLI

Шаг 2 · ~1 минута

Настройка проекта

CLI определяет язык и фреймворк автоматически. Если вы используете нестандартную сборку — просто укажите команду в файле devflux.toml. Он создаётся командой devflux init и живёт прямо в корне вашего репозитория.

Никаких Dockerfile и Kubernetes-манифестов не требуется — платформа сама подберёт оптимальный образ рантайма.

Пример devflux.toml

[app] name = "shop-api" runtime = "node20" port = 3000 [build] command = "npm ci && npm run build" output = "dist/server.js" [env.production] DATABASE_URL = "managed:postgres"

Шаг 3 · ~2 минуты

Деплой в облако одной командой

Команда devflux deploy собирает проект, упаковывает артефакты в immutable-образ, загружает их в ближайший region и переключает трафик по стратегии blue-green. В терминале вы видите живой лог сборки и статус каждого этапа.

По умолчанию приложение поднимается в регионе eu-central-1 (Франкфурт). Сменить регион можно флагом --region.

Что вы увидите в терминале

$ devflux deploy --region eu-central-1 ✓ Сборка завершена (42s) ✓ Образ sha256:9f3a...c21e загружен ✓ Балансировка переключена ✓ Health-check пройден (200 OK) Готово: https://shop-api-9f3a.devflux.app Версия: v1.4.2 · uptime 0s · CPU 12%

Шаг 4 · ~1 минута

Настройка домена и SSL

Привяжите свой домен одной командой. DevFlux автоматически выпустит сертификат Let's Encrypt и настроит HSTS. Если домен уже указывает на наши nameservers — привязка занимает меньше минуты.

Для поддоменов и wildcard-доменов сертификат выпускается автоматически, без ручной генерации CSR.

Привязка домена

devflux domain add api.yourshop.ru

Дальше добавьте в DNS провайдера записи:
A → 84.12.33.19   CNAME api.yourshop.ru → edge.devflux.net

Шаг 5 · ~2 минуты

Масштабирование и мониторинг

Горизонтальное масштабирование включается флагом --autoscale. Вы задаёте минимальное и максимальное число реплик, а платформа следит за загрузкой CPU и памятью. Все метрики доступны в веб-дашборде и через Prometheus-эндпоинт.

Логи каждого реплики хранятся 30 дней и стримятся в ваш Slack или Telegram-канал по Webhook.

Быстрое масштабирование

devflux scale shop-api --min 2 --max 12

devflux logs shop-api --follow --since 5m

5
шагов до продакшена
~5 мин
среднее время запуска
0
строк YAML нужно писать

Частые ошибки и их решение

Собрали то, с чем чаще всего сталкиваются на первых деплоях. Почти все проблемы решаются одной командой.

Ошибка «runtime not found» после devflux init

CLI не распознал фреймворк. Укажите runtime явно в devflux.toml, например runtime = "node20" или runtime = "python312". Поддерживаются: node18/20/22, python3.10–3.12, go1.22, rust1.79, java17/21.

Деплой завис на этапе «building image» больше 10 минут

Обычно это долгая установка зависимостей. Добавьте кэш каталога в [build] cache_dir = "node_modules" — повторные сборки становятся в 3–4 раза быстрее. Также убедитесь, что .gitignore не исключает package-lock.json.

Приложение запустилось, но health-check возвращает 502

Проверьте, что приложение слушает порт из devflux.toml (поле port). Если сервис стартует дольше 30 секунд, увеличьте [runtime] startup_timeout = "90s". Логи старта доступны через devflux logs shop-api --since 2m.

SSL-сертификат не выпущен после привязки домена

Убедитесь, что DNS-записи A/CNAME уже пропалигированы (проверьте dig CNAME api.yourshop.ru). После этого запустите devflux domain verify api.yourshop.ru — сертификат выпустится в течение 60 секунд.

После --autoscale реплики не добавляются при росте нагрузки

По умолчанию масштабирование срабатывает при CPU > 70% в течение 60 секунд. Ускорьте реакцию флагом --scale-up-window 30s. Если нагрузка кратковременная (спайк на 10 секунд), это ожидаемое поведение — оно защищает от перебора реплик.

Попробуйте на своём проекте сегодня

Бесплатный тариф включает 1 приложение, 512 МБ RAM и 10 ГБ трафика в месяц. Карточку не нужно — просто зарегистрируйтесь и запустите devflux deploy.

Создать аккаунт