Справочник

Справочник CLI

CLI покрывает всё, что умеет панель. Любая команда принимает --json для машинного вывода и --env для выбора окружения.

Глобальные флаги

Флаг	По умолчанию	Назначение
`--env`	`production`	Окружение, к которому применяется команда
`--project`	из `vlone.toml`	Явное имя проекта
`--json`	выкл.	Машиночитаемый вывод
`--no-color`	авто	Отключает ANSI-последовательности
`--timeout`	`10m`	Предел ожидания долгих операций
`-v, --verbose`	выкл.	Печатает HTTP-запросы к API

vlone deploy

Собирает проект и выкатывает новую ревизию.

vlone deploy                          # сборка из текущего каталога
vlone deploy --env staging            # в другое окружение
vlone deploy --image ghcr.io/org/app:1.4   # уже собранный образ
vlone deploy --strategy canary --canary-percent 10
vlone deploy --wait=false             # не ждать завершения

vlone logs

vlone logs --follow
vlone logs --since 2h --until 1h
vlone logs --region msk1 --instance msk1-a
vlone logs --grep "level=error" --json | jq '.msg'

vlone secrets

Секреты шифруются на стороне клиента ключом проекта и никогда не попадают в логи сборки.

vlone secrets set DATABASE_URL="postgres://..."
vlone secrets set --from-file .env.production
vlone secrets list                    # только имена и хеши
vlone secrets rm STRIPE_KEY

vlone secrets list намеренно не показывает значения. Если значение потеряно, его нужно задать заново — расшифровать на стороне платформы нельзя.

vlone domains

vlone domains add api.example.com
vlone domains verify api.example.com
vlone domains list
# ДОМЕН              СТАТУС     СЕРТИФИКАТ   ОБНОВИТСЯ
# api.example.com    active     ECDSA P-256  через 58 дней

vlone tokens

vlone tokens create ci-deploy --scope deploy:write --ttl 90d
vlone tokens list
vlone tokens revoke tok_7f21ac

Коды возврата

Код	Значение
`0`	Успех
`1`	Общая ошибка выполнения
`2`	Неверные аргументы или конфигурация
`3`	Ошибка аутентификации или доступа
`4`	Сборка завершилась неуспешно
`5`	Health-проверка новой ревизии не прошла
`7`	Таймаут ожидания