Начало работы

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

За пять минут вы поднимете сервис на edge-сети Vlone, увидите его логи в реальном времени и получите постоянный HTTPS-адрес. Ничего, кроме терминала и репозитория, не потребуется.

Установка CLI

CLI — единственный обязательный инструмент. Он распространяется одним бинарником без зависимостей и обновляется командой vlone upgrade.

curl -fsSL https://ru.vlone.cloud/install.sh | sh

# либо через пакетный менеджер
brew install vlone/tap/vlone

Проверьте установку:

$ vlone version
vlone 1.8.2 (linux/amd64, build 4f2ac91, 2026-09-02)

Вход в аккаунт

Команда открывает браузер и сохраняет токен в системном хранилище ключей. В CI используйте сервисный токен вместо интерактивного входа.

vlone auth login

Токен привязан к проекту и области действия. Для деплоя достаточно области 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, иначе прод и стенд окажутся в одном проекте.

Что дальше