CLI referansı

deppul — terminalden deploy et, log izle. Beş komut var.

Kurulum

CLI şu an ayrı bir npm paketi olarak yayınlanmadı — DETPUL monorepo'sundan derlenir. Kaynaktan kurulum:

pnpm --filter @deppul/cli build
cd apps/cli && npm link   # 'deppul' komutunu global PATH'e ekler

npm link olmadan doğrudan da çalıştırabilirsin: node apps/cli/dist/index.js --help.

Kimlik ve hedef API

Her komut bir API key ve bir control-plane adresi kullanır. İkisi de aynı öncelik sırasını izler: komut satırı bayrağı → ortam değişkeni → ~/.deppul/config.json (yalnız deppul login ile yazılır, dosya izni 0600).

Kimlik ve hedef API öncelik sırası
Seçenek	Açıklama
--token / DEPPUL_TOKEN	API key önceliği (deppul_sk_... ile başlar).
--api-url / DEPPUL_API_URL	Control plane adresi. Varsayılan: http://localhost:3001 (yerel geliştirme).

API key'i Dashboard → API Keys sayfasından oluşturursun; token yalnızca oluşturma anında bir kez gösterilir.

deppul login

API key ile giriş yapar, ~/.deppul/config.json içine kaydeder.

deppul login seçenekleri
Seçenek	Açıklama
--token <token>	API key (deppul_sk_...) — verilmezse gizli (terminale yansımayan) giriş istenir.
--api-url <url>	Control plane API adresi.

Örnek

$ deppul login
API key: ****************************
Giriş başarılı: sen@example.com

deppul logout

Kayıtlı oturumu (API key) yerel config'ten siler. Seçeneği yok.

$ deppul logout
Çıkış yapıldı.

deppul whoami

Giriş yapılmış kullanıcının e-postasını gösterir — key'in geçerliliğini test etmenin en hızlı yolu.

deppul whoami seçenekleri
Seçenek	Açıklama
--token <token>	API key (config yerine bunu kullan).
--api-url <url>	Control plane API adresi.

Örnek

$ deppul whoami
sen@example.com

deppul deploy

Bağlı repo'yu veya image'i build alıp deploy eder. --project zorunlu; --image veya --repo'dan en az biri gerekli. Repo gereksinimleri için Deploy sayfasına bak.

deppul deploy seçenekleri
Seçenek	Açıklama
--project <slug>	Proje slug, ad veya id (zorunlu).
--image <image>	Doğrudan container image referansı.
--repo <url>	Deploy edilecek repo URL'i (https git).
--port <port>	Container portu. Varsayılan: 3000.
--follow	Deploy LIVE/FAILED olana kadar durumu izler (2.5sn aralıkla).
--token <token>	API key (config yerine bunu kullan).
--api-url <url>	Control plane API adresi.

Örnek — repo'dan build + izle

$ deppul deploy --project my-app --repo https://github.com/kullanici/my-app.git --follow
Deploy kuyruğa alındı: cknj1a2b3c (QUEUED)
Durum: BUILDING
Durum: DEPLOYING
Durum: LIVE
Canlı: http://cknj1a2b3c.deppul.app

Örnek — hazır image

deppul deploy --project my-app --image ghcr.io/kullanici/my-app:latest --port 3000

deppul logs [deploymentId]

Deploy'un runtime loglarını akıtır (SSE). Deployment id verilmezse --project ile o projenin en son deploy'u kullanılır. -f verilmezse ~3 saniyelik bir anlık görüntü alıp kapanır.

deppul logs seçenekleri
Seçenek	Açıklama
--project <slug>	Proje slug, ad veya id (deploymentId verilmediğinde kullanılır).
-f, --follow	Canlı takip et — Ctrl+C ile çıkılır.
--token <token>	API key (config yerine bunu kullan).
--api-url <url>	Control plane API adresi.

Örnek

deppul logs --project my-app -f

Tüm komutlar aynı hata formatını kullanır: sunucu hatası varsa mesaj olduğu gibi terminale yazılır, işlem çıkış kodu 1 döner.