Fejlesztők → Alkalmazásszerverek

App Server API

Futtassa alkalmazását NameOcean App Serveren, és kezelje kódból: telepítés pusholással, az alkalmazások újraindítása, naplóik olvasása, titkos adatok env változókban, valamint a teljes szerver mentése és visszaállítása.

Telepítés git segítségével

Minden App Server rendelkezik egy git tárolóval a /root/app könyvtárban. A push oda írja a feltöltött ágat, és lefuttatja a .nameocean/deploy.sh fájlt, ha a projektben van ilyen. A nameocean deploy a teljes folyamatot elvégzi:

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

Hozzáad egy nameocean nevű git remote-ot a szerverhez, ha a projektben még nincs ilyen.
Feltölti az aktuális ágat a szerver tárolójába.
A projekt saját remote-jára is feltölti (az upstreamre vagy az originre), kivéve, ha megadja a --no-origin kapcsolót.
Újraindítja az összes supervisor programot és újratölti az nginxet, majd rögzíti a telepítést (POST /servers/{server}/deploys), és server.deployed eseményt küld.

A push az Ön SSH kulcsát használja. Ha a szerver még nem ismeri: nameocean servers ssh-keys add 3f9a1c2e (a ~/.ssh/id_ed25519.pub fájlt olvassa be). Egy egyszerű git push is telepíti a fájlokat; utána hívja meg a POST /servers/{server}/deploys végpontot az alkalmazások újraindításához.

Végpontok

Jogosultságok: servers:read és servers:write; szerver létrehozásához billing:write is szükséges. A {server} az azonosító vagy az alapértelmezett domain. Minden megtalálható az API referenciában.

GET /servers/plans · POST /servers	Csomagok és árak; szerver létrehozása (az első válasz az ár, majd küldje el a confirm: true értéket)
POST /servers/{server}/start · stop · restart	A szerver indítása, leállítása vagy újraindítása
GET /servers/{server}/apps · POST …/reload	Supervisor programok és állapotuk; mindegyik újraindítása és az nginx újratöltése
GET /servers/{server}/logs?app=web&lines=200	Egy alkalmazás kimenetének utolsó sorai, vagy app=nginx
GET · PATCH /servers/{server}/env	Minden alkalmazás által megkapott env változók; módosítás után az alkalmazások újraindulnak
GET · POST · DELETE /servers/{server}/ssh-keys	Bejelentkezésre és pusholásra jogosult kulcsok
GET · POST /servers/{server}/backups · POST …/backups/restore	Mentések listázása, azonnali mentés, egy mentés visszaállítása a szerverre
POST /servers/{server}/git · GET · POST …/deploys	A push cél előkészítése; a telepített commit és a telepítési előzmények

Env változók

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"]}'

Ezek kizárólag a szerveren, a /root/conf/env fájlban tárolódnak, soha nem az adatbázisunkban. A Supervisor programok, az SSH-munkamenetek és a .nameocean/deploy.sh megkapják őket. Az olvasásukhoz servers:write jogosultság szükséges, az MCP-n keresztül csatlakozó AI pedig csak a nevüket látja, az értéküket nem.

Események

A webhookok feliratkozhatnak a server.* eseményekre: server.created, server.started, server.stopped, server.restarted, server.restore.started és server.deployed (a committal, valamint azzal az információval, hogy az alkalmazások elindultak-e).

Terminálból

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

Az AI-jából

Az MCP-n keresztül egy asszisztens naplókat olvashat, alkalmazásokat indíthat újra, környezeti változókat állíthat be, push után befejezheti a telepítést, biztonsági mentést készíthet egy szerverről, és az ár megmutatása után létrehozhat egy újat. A leállítás, az újraindítás és a visszaállítás előtt az Ön jóváhagyását kéri.