Geliştiriciler → Uygulama sunucuları

App Server API

Uygulamanızı bir NameOcean App Server üzerinde çalıştırın ve koddan yönetin: push ile dağıtın, uygulamaları yeniden başlatın, günlüklerini okuyun, gizli bilgileri ortam değişkenlerinde saklayın ve sunucunun tamamını yedekleyin veya geri yükleyin.

Git ile deploy

Her App Server'da /root/app içinde bir git deposu bulunur. Push işlemi gönderilen dalı buraya yazar ve projenizde varsa .nameocean/deploy.sh dosyasını çalıştırır. nameocean deploy tüm süreci baştan sona yürütür:

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

Projede yoksa sunucu için nameocean adında bir git remote ekler.
Geçerli dalı sunucunun deposuna gönderir.
--no-origin belirtmediğiniz sürece dalı projenin kendi remote'una da (upstream veya origin) gönderir.
Tüm supervisor programlarını yeniden başlatır ve nginx'i yeniden yükler, ardından dağıtımı kaydeder (POST /servers/{server}/deploys) ve bir server.deployed olayı gönderir.

Push işlemi SSH anahtarınızı kullanır. Sunucu anahtarınızı henüz tanımıyorsa: nameocean servers ssh-keys add 3f9a1c2e (~/.ssh/id_ed25519.pub dosyasını okur). Düz bir git push da dosyaları dağıtır; uygulamaları yeniden başlatmak için ardından POST /servers/{server}/deploys çağrısı yapın.

Uç noktalar

Kapsamlar: servers:read ve servers:write; sunucu oluşturmak için ayrıca billing:write gerekir. {server}, kimlik veya varsayılan alan adıdır. Tüm ayrıntılar API referansında.

GET /servers/plans · POST /servers	Planlar ve fiyatlar; sunucu oluşturma (ilk yanıt fiyattır, ardından confirm: true gönderin)
POST /servers/{server}/start · stop · restart	Sunucuyu başlatın, durdurun veya yeniden başlatın
GET /servers/{server}/apps · POST …/reload	Supervisor programları ve durumları; tümünü yeniden başlatma ve nginx'i yeniden yükleme
GET /servers/{server}/logs?app=web&lines=200	Bir uygulamanın çıktısının son satırları veya app=nginx
GET · PATCH /servers/{server}/env	Tüm uygulamalara sağlanan ortam değişkenleri; değişiklikten sonra uygulamalar yeniden başlar
GET · POST · DELETE /servers/{server}/ssh-keys	Oturum açıp push yapabilen anahtarlar
GET · POST /servers/{server}/backups · POST …/backups/restore	Yedekleri listeleme, hemen yedekleme, bir yedeği sunucuya geri yükleme
POST /servers/{server}/git · GET · POST …/deploys	Push hedefini hazırlama; dağıtılan commit ve dağıtım geçmişi

Ortam değişkenleri

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

Yalnızca sunucuda, /root/conf/env içinde saklanır; asla veritabanımızda tutulmaz. Supervisor programları, SSH oturumları ve .nameocean/deploy.sh bunlara erişir. Okumak için servers:write gerekir; MCP üzerinden yapay zekâ değerlerini değil, yalnızca adlarını görür.

Olaylar

Webhook'lar server.* olaylarına abone olabilir: server.created, server.started, server.stopped, server.restarted, server.restore.started ve server.deployed (commit bilgisi ve uygulamaların ayağa kalkıp kalkmadığıyla birlikte).

Terminalden

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

Yapay zekânızdan

Bir asistan MCP üzerinden logları okuyabilir, uygulamaları yeniden başlatabilir, ortam değişkenlerini ayarlayabilir, push sonrasında bir dağıtımı tamamlayabilir, bir sunucuyu yedekleyebilir ve size fiyatı gösterdikten sonra yeni bir sunucu oluşturabilir. Durdurma, yeniden başlatma ve geri yükleme işlemleri için önce onayınız istenir.