API и CLI
CLI
Команда livops — деплой, логи и переменные из терминала.
livops — команда для управления Livops из терминала. Она работает с API-токеном.
Установка
macOS и Linux:
curl -fsSL https://livops.uz/install.sh | sh
Windows (PowerShell):
irm https://livops.uz/install.ps1 | iex
Скрипт выбирает сборку для вашей системы, проверяет её контрольную сумму SHA-256 и кладёт livops в ~/.local/bin (Windows: %LOCALAPPDATA%\livops\bin). LIVOPS_VERSION=1.2.3 ставит нужную версию, LIVOPS_INSTALL_DIR — другую папку. Проверка: livops --version.
Или скачайте вручную: текущая версия — в livops.uz/cli/latest.txt, файлы — https://livops.uz/cli/<версия>/livops_<os>_<arch>, где os — linux, darwin или windows (.exe), arch — amd64 или arm64; рядом лежит checksums.txt.
Вход
livops login
Команда запросит токен (раздел команды Настройки → API-токены, /<команда>/settings/tokens) и сохранит его в папке пользовательских настроек (~/.config/livops/token).
В CI используйте без файла, через переменную:
export LIVOPS_TOKEN=lvp_xxx
livops projects
Команды
| Команда | Что делает |
|---|---|
livops login |
сохраняет API-токен |
livops projects |
сервисы команды: имя, тип, статус, адрес |
livops stacks |
проекты, их окружения и сервисы |
livops deploy <сервис> |
деплоит и следит за сборкой до завершения (live или failed) |
livops logs <сервис> [-f] |
лог работающего сервиса; -f — следить, --tail N (по умолчанию 200) |
livops env ls <сервис> |
список переменных |
livops env set <сервис> K=V... |
задаёт переменные; --secret (до или после пар) делает значения секретами |
livops env unset <сервис> K... |
удаляет переменную |
livops open <сервис> |
открывает адрес сервиса в браузере |
livops mcp |
отдаёт инструменты MCP через stdio для ИИ-клиентов |
<сервис> — имя, которое показывает livops projects.
Примеры
# деплой и ожидание результата
livops deploy shop-api
# следить за логом в реальном времени
livops logs shop-api -f
# задать секрет
livops env set shop-api --secret STRIPE_KEY=sk_xxx
Настройки
| Переменная / флаг | Значение |
|---|---|
LIVOPS_TOKEN |
Токен. Если не задан, читается файл, сохранённый livops login. |
LIVOPS_API |
Адрес API. По умолчанию https://livops.uz/api. |
--api URL |
Адрес API только для этой команды; можно указать в любом месте команды. |
env unset — не DELETE, а обновление списка переменных, поэтому работает с токеном.
Коды выхода
| Код | Значение |
|---|---|
0 |
готово |
1 |
API отказал, нет сети или деплой не стал live |
2 |
команда набрана неверно (неизвестная команда или флаг) |
130 |
прервано Ctrl-C; деплой продолжает собираться на сервере |