CLI referansı

detpul — 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 @detpul/cli build
cd apps/cli && npm link   # 'detpul' 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

DocsCli.auth.body1

Kimlik ve hedef API öncelik sırası
Seçenek	Açıklama
--token / DETPUL_TOKEN	API key (config yerine bunu kullan).
--api-url / DETPUL_API_URL	Control plane API adresi.

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

detpul login

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

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

Örnek

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

detpul logout

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

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

detpul whoami

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

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

Örnek

$ detpul whoami
sen@example.com

detpul deploy

Bağlı repo'yu build alıp deploy eder. --project ve --repo zorunlu. Repo gereksinimleri için Deploy sayfasına bak.

detpul deploy seçenekleri
Seçenek	Açıklama
--project <slug>	Proje slug, ad veya id (zorunlu).
--repo <url>	Deploy edilecek repo URL'i — https git (zorunlu).
--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

$ detpul 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.detpul.app

detpul 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.

detpul 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

detpul 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.