Desarrolladores → Servidores de aplicaciones

API de App Server

Ejecute su app en un App Server de NameOcean y gestiónelo desde código: haga push para desplegar, reinicie las apps, lea sus logs, guarde secretos en variables de entorno y haga copias de seguridad o restaure el servidor completo.

Desplegar con git

Cada App Server tiene un repositorio git en /root/app. Un push escribe allí la rama enviada y ejecuta .nameocean/deploy.sh si su proyecto lo incluye. nameocean deploy realiza todo el proceso:

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

Añade un remoto git llamado nameocean para el servidor si el proyecto no lo tiene.
Hace push de la rama actual al repositorio del servidor.
También hace push al remoto propio del proyecto (su upstream, u origin), salvo que indique --no-origin.
Reinicia todos los programas de supervisor y recarga nginx; después registra el despliegue (POST /servers/{server}/deploys) y envía un evento server.deployed.

El push usa su clave SSH. Si el servidor aún no la conoce: nameocean servers ssh-keys add 3f9a1c2e (lee ~/.ssh/id_ed25519.pub). Un git push normal también despliega los archivos; llame después a POST /servers/{server}/deploys para reiniciar las apps.

Puntos de conexión

Ámbitos servers:read y servers:write; crear un servidor también requiere billing:write. {server} es el id o el dominio predeterminado. Encontrará todo en la referencia de la API.

GET /servers/plans · POST /servers	Planes y precios; crear un servidor (la primera respuesta es el precio; luego envíe confirm: true)
POST /servers/{server}/start · stop · restart	Iniciar, detener o reiniciar el servidor
GET /servers/{server}/apps · POST …/reload	Programas de supervisor y su estado; reiniciarlos todos y recargar nginx
GET /servers/{server}/logs?app=web&lines=200	Las últimas líneas de la salida de una app, o app=nginx
GET · PATCH /servers/{server}/env	Variables de entorno que reciben todas las apps; las apps se reinician tras un cambio
GET · POST · DELETE /servers/{server}/ssh-keys	Claves que pueden iniciar sesión y hacer push
GET · POST /servers/{server}/backups · POST …/backups/restore	Listar copias de seguridad, crear una ahora, restaurar una sobre el servidor
POST /servers/{server}/git · GET · POST …/deploys	Preparar el destino del push; el commit desplegado y el historial de despliegues

Variables de entorno

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

Se guardan solo en el servidor, en /root/conf/env, nunca en nuestra base de datos. Las reciben los programas de supervisor, las sesiones SSH y .nameocean/deploy.sh. Leerlas requiere servers:write, y la IA mediante MCP ve sus nombres, no sus valores.

Eventos

Los webhooks pueden suscribirse a server.*: server.created, server.started, server.stopped, server.restarted, server.restore.started y server.deployed (con el commit y si las aplicaciones se iniciaron correctamente).

Desde la terminal

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

Desde su IA

A través de MCP, un asistente puede leer registros, reiniciar aplicaciones, configurar variables de entorno, completar un despliegue después de hacer push, hacer una copia de seguridad de un servidor y, tras mostrarle el precio, crear uno. Detener, reiniciar y restaurar requieren primero su aprobación.