Начало работы
Быстрый старт
За пять минут вы поднимете сервис на edge-сети Vlone, увидите его логи в реальном времени и получите постоянный HTTPS-адрес. Ничего, кроме терминала и репозитория, не потребуется.
Установка CLI
CLI — единственный обязательный инструмент. Он распространяется одним бинарником
без зависимостей и обновляется командой vlone upgrade.
curl -fsSL https://ru.vlone.cloud/install.sh | sh
# либо через пакетный менеджер
brew install vlone/tap/vlonewinget install Vlone.CLI
# или скачайте архив со страницы /downloads/docker run --rm -it -v "$PWD:/app" -w /app ghcr.io/vlone/cli:1.8 vlone versionПроверьте установку:
$ vlone version
vlone 1.8.2 (linux/amd64, build 4f2ac91, 2026-09-02)Вход в аккаунт
Команда открывает браузер и сохраняет токен в системном хранилище ключей. В CI используйте сервисный токен вместо интерактивного входа.
vlone auth loginexport VLONE_TOKEN="vlt_xxxxxxxxxxxxxxxxxxxx"
vlone auth whoamiТокен привязан к проекту и области действия. Для деплоя достаточно области deploy:write — не выдавайте CI полный доступ.
Первый деплой
Vlone определяет тип проекта автоматически: Node.js, Go, Python, Rust, статика
и произвольный Dockerfile. Явная конфигурация нужна только тогда,
когда автоопределение вас не устраивает.
cd my-service
vlone init # создаст vlone.toml
vlone deploy # соберёт и выкатитТипичный вывод:
→ Проект my-service (runtime: node@22)
→ Сборка ......................... 18.4s
→ Образ sha256:9c1f... 42.8 MB
→ Регионы: msk1, ams1, fra1
→ Прогрев ........................ 2.1s
✓ Готово за 24.9s
https://my-service.vlone.appКонфигурация
Файл vlone.toml лежит в корне репозитория и коммитится вместе с кодом.
Он описывает то, что должно быть воспроизводимо, а секреты хранятся отдельно.
name = "my-service"
runtime = "node@22"
[build]
command = "npm ci && npm run build"
output = "dist"
[deploy]
regions = ["msk1", "ams1", "fra1"]
strategy = "rolling"
health_path = "/healthz"
[scale]
min = 1
max = 12
target_cpu = 65
[env]
NODE_ENV = "production"
LOG_LEVEL = "info"Логи и метрики
Логи стримятся сразу после деплоя, без настройки агентов.
vlone logs --follow
vlone logs --since 15m --region msk1 --grep "status=5"
vlone metrics --window 1hПервый деплой создаёт проект в области по умолчанию. Если у вас несколько окружений, сразу задайте --env staging, иначе прод и стенд окажутся в одном проекте.
Что дальше
- Полный справочник CLI — все команды и флаги.
- Стратегии выката — rolling, canary и мгновенный откат.
- Наблюдаемость — трейсы, метрики, алерты.