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

Основные понятия

Модель Vlone намеренно маленькая: пять сущностей, каждая с одной ответственностью. Если вы понимаете их связи, поведение платформы перестаёт удивлять.

Проект

Проект — единица биллинга, доступа и имени. Внутри проекта живут окружения, секреты и домены. Имя проекта глобально уникально в рамках организации и входит в адрес по умолчанию <project>.vlone.app.

Окружение

Окружение — изолированный набор ревизий, переменных и доменов. По умолчанию создаются production и preview. Preview-окружения эфемерны: каждая ветка получает своё и удаляется через 72 часа после слияния.

Свойство	production	preview
Время жизни	Постоянное	72 часа после закрытия ветки
Масштабирование	До лимита тарифа	Максимум 2 инстанса
Домены	Свои и `*.vlone.app`	Только `*.preview.vlone.app`
Секреты	Собственный набор	Наследуются, можно переопределить
Холодный старт	Отключён при `min ≥ 1`	Всегда включён

Ревизия

Ревизия — неизменяемый результат сборки: образ, конфигурация и снимок переменных окружения. Ревизии нумеруются последовательно и никогда не переиспользуются. Откат — это не пересборка, а переключение трафика на уже существующую ревизию, поэтому он занимает секунды.

vlone revisions list
# REV   СОЗДАНА            ОБРАЗ           ТРАФИК  СТАТУС
# r184  2026-09-18 14:22   sha256:9c1f...  100%    active
# r183  2026-09-17 09:05   sha256:3ab7...  0%      retired
# r182  2026-09-15 18:40   sha256:71ee...  0%      retired

vlone rollback r183

Ревизии хранятся 30 дней на тарифе Team и 90 дней на Scale. Откат на удалённую ревизию невозможен — нужна пересборка из коммита.

Регион

Регион — площадка, где запускаются инстансы. Список регионов ревизии задаётся в vlone.toml; трафик попадает в ближайший здоровый регион по anycast. Если регион деградирует, балансировщик убирает его из ротации за 2–3 секунды и возвращает после двух успешных health-проверок подряд.

Инстанс

Инстанс — один работающий процесс ревизии в конкретном регионе. Автоскейлер меняет их число по загрузке CPU и глубине очереди запросов, оставаясь в границах scale.min и scale.max.

Как это связано

Организация
└── Проект (billing, RBAC, имя)
    ├── Окружение production
    │   ├── Ревизия r184  ← 100% трафика
    │   │   ├── Инстанс msk1-a
    │   │   ├── Инстанс msk1-b
    │   │   └── Инстанс ams1-a
    │   └── Ревизия r183  ← 0%, доступна для отката
    └── Окружение preview/feature-payments
        └── Ревизия r12