Разработчикам → Серверы приложений

API App Server

Запускайте своё приложение на NameOcean App Server и управляйте им из кода: деплой через push, перезапуск приложений, чтение их логов, хранение секретов в переменных окружения, резервное копирование и восстановление всего сервера.

Деплой через git

На каждом App Server есть git-репозиторий в /root/app. При push отправленная ветка записывается туда, и запускается .nameocean/deploy.sh, если он есть в Вашем проекте. nameocean deploy выполняет весь цикл:

nameocean

$ nameocean deploy 3f9a1c2e
Remote nameocean → ssh://root@3f9a1c2e.nameocean.org:2152/root/app (added)
Pushed main to nameocean (3f9a1c2 Fix checkout)
Pushed main to origin
Restarted 2 apps, nginx reloaded: web running, worker running

Добавляет git remote с именем nameocean для сервера, если его ещё нет в проекте.
Отправляет текущую ветку в репозиторий сервера.
Также отправляет её в собственный remote проекта (upstream или origin), если не указан --no-origin.
Перезапускает все программы supervisor и перезагружает nginx, затем фиксирует деплой (POST /servers/{server}/deploys) и отправляет событие server.deployed.

Для push используется Ваш SSH-ключ. Если сервер его ещё не знает: nameocean servers ssh-keys add 3f9a1c2e (ключ читается из ~/.ssh/id_ed25519.pub). Обычный git push тоже разворачивает файлы; после него вызовите POST /servers/{server}/deploys, чтобы перезапустить приложения.

Эндпоинты

Области доступа servers:read и servers:write; для создания сервера также нужна billing:write. {server} — это id или домен по умолчанию. Всё описано в справочнике по API.

GET /servers/plans · POST /servers	Тарифы и цены; создание сервера (первый ответ — цена, затем отправьте confirm: true)
POST /servers/{server}/start · stop · restart	Запуск, остановка или перезагрузка сервера
GET /servers/{server}/apps · POST …/reload	Программы supervisor и их состояние; перезапуск всех и перезагрузка nginx
GET /servers/{server}/logs?app=web&lines=200	Последние строки вывода приложения или app=nginx
GET · PATCH /servers/{server}/env	Переменные окружения для всех приложений; после изменения приложения перезапускаются
GET · POST · DELETE /servers/{server}/ssh-keys	Ключи, с которыми можно входить и делать push
GET · POST /servers/{server}/backups · POST …/backups/restore	Список резервных копий, создание копии сейчас, восстановление сервера из копии
POST /servers/{server}/git · GET · POST …/deploys	Подготовка цели для push; развёрнутый коммит и история деплоев

Переменные окружения

curl

$ curl -X PATCH https://nameocean.net/api/v1/servers/3f9a1c2e/env \
    -H "Authorization: Bearer $NAMEOCEAN_API_KEY" -H "Content-Type: application/json" \
    -d '{"set": {"DATABASE_URL": "postgres://app@127.0.0.1/app"}, "unset": ["DEBUG"]}'

Они хранятся только на сервере, в /root/conf/env, и никогда — в нашей базе данных. Их получают программы supervisor, SSH-сессии и .nameocean/deploy.sh. Для их чтения нужна servers:write, а AI по MCP видит только их имена, но не значения.

События

Webhooks могут подписываться на события server.*: server.created, server.started, server.stopped, server.restarted, server.restore.started и server.deployed (с указанием коммита и того, запустились ли приложения).

Из терминала

nameocean

$ nameocean deploy 3f9a1c2e
$ nameocean servers logs 3f9a1c2e --app web -n 200
$ nameocean servers env set 3f9a1c2e DATABASE_URL=postgres://app@127.0.0.1/app
$ nameocean servers restart-apps 3f9a1c2e
$ nameocean servers backups ls 3f9a1c2e

Из Вашего ИИ

Через MCP ассистент может читать логи, перезапускать приложения, задавать переменные окружения, завершать деплой после push, создавать резервную копию сервера и, предварительно показав Вам цену, создавать новый сервер. Перед остановкой, перезапуском и восстановлением он сначала запрашивает Ваше подтверждение.