Deployments API

Deployments API, bir projenin derleme ve sürüm yaşam döngüsünü yönetir: derlemeleri başlatır (bağlı bir git deposundan veya yüklenmiş bir klasörden), durum ve logları raporlar ve sonrasında çalıştırdığınız işlemleri — redeploy, roll back, pin, cancel, restart ve kısmi başarısız compose deploy'u çözme — ele alır. dashboard'da bu, deploy sihirbazı ve Deployments sekmesidir; terminalden ise alaf server deploy ve alaf server deployment komutlarıdır.

Uç Noktalar

Git deploy'u tetikleme

Zaten bağlı bir projeyi git kaynağından yeniden deploy eder. Bunun yerine yerel bir klasörü deploy etmek için, /build/access ile biten yükleme akışını kullanın.

POST /api/deployments

curl -X POST https://your-host/api/deployments \
  -H "Authorization: Bearer $ALAFSERVER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"proj_123","branch":"main"}'

# CLI'dan aynı işlem:
alaf server deploy --project proj_123 --branch main

Hazırlık (derleme yapılandırmasını algılama)

Yan etkisi yoktur: bir git deposuna veya yerel bir yola işaret edin ve sihirbazın önceden doldurabilmesi için algılanan framework'ü, paket yöneticisini ve derleme/başlatma komutlarını döndürür. Hiçbir şey oluşturmaz.

POST /api/deployments/prepare

Deploy sihirbazı (/build/access)

Sihirbazın Deploy düğmesi. Yeni bir deployment oluşturur ve derlemeyi başlatır. Klasör yükleme deploy'u için, projectId (projects/ensure'dan) ve uploadSessionId (projects/folder/session'dan) geçirin; bir git projesi için projectId ve isteğe bağlı olarak branch geçirin. { success, deployment_id, project_id } döndürür.

POST /api/deployments/build/access

Her bir publicEndpoints girişi, domainType'ın "free" veya "custom" olduğu { port?, targetPath?, domain?, customDomain?, domainType? } şeklindedir. Bir services girişi, bir compose/monorepo servisini (name, image?, build?, dockerfile?, ports, dependsOn, environment, volumes ve isteğe bağlı uygulama başına derleme alanları) yansıtır.

curl -X POST https://your-host/api/deployments/build/access \
  -H "Authorization: Bearer $ALAFSERVER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"projectId":"proj_123","branch":"main","buildStrategy":"server"}'

Durum, loglar ve stream alma

GET /api/deployments/:id
GET /api/deployments/:id/logs
GET /api/deployments/:id/stream

/:id, deployment'ın durumunu, URL'lerini, zamanlamasını ve herhangi bir hata özetini döndürür. /logs, kaydedilmiş derleme/çalışma zamanı çıktısını döndürür; /stream, canlı derlemenin bir Server-Sent Events akışıdır — kaldığınız yerden devam etmek için ?since=<seq> imleciyle yeniden bağlanın.

alaf server deployment get <deploymentId>

Yeniden deploy etme

Derlemeyi yeniden çalıştırır. Varsayılan olarak branch'teki en son commit'i çözer (otomatik redeploy semantiği); orijinal deployment'ın kullandığı tam commit'e göre yeniden derlemek için { "useExistingCommit": true } gönderin.

POST /api/deployments/:id/redeploy

alaf server deployment redeploy <deploymentId>

Rollback ve pinleme

Rollback, önceki bir deployment'ın artifact'ını/commit'ini aktif sürüm olarak geri yükler. Pinleme, bir deployment'ı korumalı olarak işaretler, böylece rollback penceresi temizliği tarafından geri alınmaz — POST /:id/pin varsayılan olarak { "pinned": true } değerini alır; pinini kaldırmak için { "pinned": false } gönderin.

POST /api/deployments/:id/rollback
POST /api/deployments/:id/pin

alaf server deployment rollback <deploymentId>
alaf server deployment pin <deploymentId>

Çalışan bir deploy'u iptal etme

POST /api/deployments/:id/cancel

alaf server deployment cancel <deploymentId>

Kısmi başarısız compose deploy'ları: tut veya reddet

Çoklu servis (compose) bir deploy'da bazı servisler başarılı olup diğerleri başarısız olduğunda, partial_failure durumunda decision: pending ("Eylem Gerekli") ile tutulur. Açıkça çözün:

• Tut (Keep), başarılı olan servisleri kabul eder ve geri kalanları önceki sürümlerinde bırakır.
• Reddet (Reject), değişen servisleri önceki durumlarına geri alır.

POST /api/deployments/:id/keep
POST /api/deployments/:id/reject

alaf server deployment keep <deploymentId>
alaf server deployment reject <deploymentId>

SSL durumu ve yenileme

Her ikisi de JSON gövdesinde domain'i alır. /ssl/status, yan etkisi olmayan bir probdur (hostname'in gövdede taşınması için yalnızca POST); /ssl/renew sertifikayı yeniden düzenler.

POST /api/deployments/ssl/status
POST /api/deployments/ssl/renew

curl -X POST https://your-host/api/deployments/ssl/status \
  -H "Authorization: Bearer $ALAFSERVER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"domain":"app.example.com"}'

alaf server deployment ssl status app.example.com
alaf server deployment ssl renew app.example.com

Görebileceğiniz hatalar