Kehittäjät → Sovelluspalvelimet

App Server API

Aja sovellustasi NameOcean App Serverillä ja hallitse sitä koodista: ota käyttöön pushilla, käynnistä sovellukset uudelleen, lue niiden lokeja, säilytä salaisuudet ympäristömuuttujissa ja varmuuskopioi tai palauta koko palvelin.

Käyttöönotto gitillä

Jokaisella App Serverillä on git-repositorio hakemistossa /root/app. Push kirjoittaa sinne pushatun haaran ja suorittaa tiedoston .nameocean/deploy.sh, jos projektissasi on sellainen. nameocean deploy hoitaa koko kierroksen:

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

Lisää palvelimelle git-etärepositorion nimeltä nameocean, jos projektissa ei vielä ole sitä.
Pushaa nykyisen haaran palvelimen repositorioon.
Pushaa sen myös projektin omaan etärepositorioon (sen upstreamiin tai originiin), ellei annata valitsinta --no-origin.
Käynnistää kaikki supervisor-ohjelmat uudelleen ja lataa nginxin uudelleen, minkä jälkeen kirjaa käyttöönoton (POST /servers/{server}/deploys) ja lähettää server.deployed-tapahtuman.

Push käyttää SSH-avaintanne. Jos palvelin ei vielä tunne sitä: nameocean servers ssh-keys add 3f9a1c2e (se lukee tiedoston ~/.ssh/id_ed25519.pub). Myös pelkkä git push ottaa tiedostot käyttöön; kutsukaa sen jälkeen POST /servers/{server}/deploys käynnistääksenne sovellukset uudelleen.

Päätepisteet

Oikeudet servers:read ja servers:write; palvelimen luominen vaatii lisäksi oikeuden billing:write. {server} on tunniste tai oletusverkkotunnus. Kaikki löytyy API-dokumentaatiosta.

GET /servers/plans · POST /servers	Paketit ja hinnat; luo palvelin (ensimmäinen vastaus on hinta, lähetä sitten confirm: true)
POST /servers/{server}/start · stop · restart	Käynnistä, pysäytä tai käynnistä palvelin uudelleen
GET /servers/{server}/apps · POST …/reload	Supervisor-ohjelmat ja niiden tila; käynnistä kaikki uudelleen ja lataa nginx uudelleen
GET /servers/{server}/logs?app=web&lines=200	Sovelluksen tulosteen viimeiset rivit tai app=nginx
GET · PATCH /servers/{server}/env	Ympäristömuuttujat, jotka jokainen sovellus saa; sovellukset käynnistyvät uudelleen muutoksen jälkeen
GET · POST · DELETE /servers/{server}/ssh-keys	Avaimet, joilla voi kirjautua ja pushata
GET · POST /servers/{server}/backups · POST …/backups/restore	Listaa varmuuskopiot, varmuuskopioi nyt, palauta varmuuskopio palvelimen päälle
POST /servers/{server}/git · GET · POST …/deploys	Valmistele push-kohde; käyttöön otettu commit ja käyttöönottohistoria

Ympäristömuuttujat

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

Ne säilytetään vain palvelimella, tiedostossa /root/conf/env, eikä koskaan tietokannassamme. Supervisor-ohjelmat, SSH-istunnot ja .nameocean/deploy.sh saavat ne. Niiden lukeminen vaatii oikeuden servers:write, ja tekoäly näkee MCP:n kautta niiden nimet, ei arvoja.

Tapahtumat

Webhookit voivat tilata server.*-tapahtumat: server.created, server.started, server.stopped, server.restarted, server.restore.started ja server.deployed (sisältää commitin ja tiedon siitä, käynnistyivätkö sovellukset).

Päätteestä

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

Tekoälystäsi

MCP:n kautta avustaja voi lukea lokeja, käynnistää sovelluksia uudelleen, asettaa ympäristömuuttujia, viimeistellä käyttöönoton pushin jälkeen, varmuuskopioida palvelimen ja luoda palvelimen näytettyään sinulle ensin hinnan. Pysäyttäminen, uudelleenkäynnistys ja palautus vaativat ensin hyväksyntäsi.