Projeler API'si

Bir proje, Alaf Server'ın build ettiği ve çalıştırdığı birimdir: bir kaynak (bir git deposu, yerel bir yol veya yüklenmiş bir klasör), build yapılandırması, ortam değişkenleri, kaynak limitleri, domainler ve deployment geçmişi. dashboard'da bu, bir projenin sayfaları altındaki her şeydir; terminalden ise alaf server projects komutudur.

Uç Noktalar

Proje Oluştur

POST /api/projects

Bir git deposundan veya yerel bir yoldan proje oluşturun, build yapılandırmasını proje satırına dahil edin. Yüklenmiş bir klasör için bunun yerine klasör yükleme akışını kullanın. Yalnızca name zorunludur — diğer her şey otomatik olarak algılanır veya varsayılan olarak ayarlanır.

curl -X POST https://your-host/api/projects \
  -H "Authorization: Bearer $ALAFSERVER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"marketing-site","gitOwner":"acme","gitRepo":"site","gitBranch":"main","framework":"nextjs"}'

# Same thing from the CLI:
alaf server projects create

Projeyi Güncelle

PATCH /api/projects/:id

Güncelleme gövdesi, oluşturma gövdesinin kısmi bir halidir — yalnızca değiştirmek istediğiniz alanları gönderin. Yukarıdaki her alan burada kabul edilir ve isteğe bağlıdır.

curl -X PATCH https://your-host/api/projects/proj_123 \
  -H "Authorization: Bearer $ALAFSERVER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"buildCommand":"pnpm build","gitBranch":"release"}'

alaf server projects update proj_123 --build-command "pnpm build"

Bir Git Deposu Bağla

POST /api/projects/:id/git/link

Mevcut bir projeye bir GitHub deposu bağlayın (veya yeniden yönlendirin). branch atlandığında, deponun varsayılan branch'i kullanılır.

curl -X POST https://your-host/api/projects/proj_123/git/link \
  -H "Authorization: Bearer $ALAFSERVER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"owner":"acme","repo":"site","branch":"main"}'

İlgili git rotaları: POST /api/projects/:id/branch (deploy branch'ini değiştirir), POST /api/projects/:id/auto-deploy (push'ta auto-deploy'u açar/kapatır), GET /api/projects/:id/branches ve GET /api/projects/:id/commit-status (deploy edilmiş commit uzak HEAD'in gerisinde mi?). GitHub App'i bağlamak için GitHub API'sine bakın.

Özel Bir Domain Bağla

POST /api/projects/:id/connect

Bir domain'i projeye ekleyen ve tek bir çağrıda birincil olarak işaretleyen bir kısayoldur. Tam domain yaşam döngüsü (DNS preview, doğrulama, SSL) için Domainler API'sini kullanın.

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

Ortam Değişkenleri

GET   /api/projects/:id/env
PATCH /api/projects/:id/env

GET, gizli değerleri maskelenmiş projenin değişkenlerini listeler. Yazma işlemleri bir birleştirme yoluyla gerçekleşir: yalnızca adlandırdığınız anahtarlara dokunulur — upsert'ler eklenir/güncellenir, delete'ler kaldırılır ve diğer tüm değişkenler (dokunulmamış maskelenmiş gizli bilgiler dahil) olduğu gibi bırakılır.

curl -X PATCH https://your-host/api/projects/proj_123/env \
  -H "Authorization: Bearer $ALAFSERVER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "environment": "production",
    "upserts": [{"key":"DATABASE_URL","value":"postgres://…","isSecret":true}],
    "deletes": ["OLD_FLAG"]
  }'

alaf server env set DATABASE_URL="postgres://…" --project proj_123 --secret

Kaynaklar

GET   /api/projects/:id/resources
PATCH /api/projects/:id/resources
POST  /api/projects/:id/resources

CPU/RAM/disk tahsisini (production ve build için ayrı ayrı), sleep davranışını ve dinleme portunu okuyun veya güncelleyin. POST, PATCH'in bir takma adıdır. Tüm alanlar isteğe bağlıdır; yalnızca değiştirmek istediklerinizi gönderin.

curl -X PATCH https://your-host/api/projects/proj_123/resources \
  -H "Authorization: Bearer $ALAFSERVER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"production":{"cpuCores":1,"memoryMb":1024},"sleepMode":"always_on"}'

Sleep mode'un ayrıca kendi kısayol rotası da vardır: POST /api/projects/:id/sleep-mode.

Ortam Oluştur

POST /api/projects/:id/environments

Klasör Yükleme Deploy'u

API ile dosya sistemi paylaşmayan bir tarayıcıdan veya client'tan yerel bir klasörü deploy edin. Akış dört adımdan oluşur; ikili tarball yüklemesi bant dışı gerçekleşir (ham baytlar, JSON değil).

Oturum gövdesi (POST /api/projects/folder/session) hafif bir ipucudur — tüm alanlar isteğe bağlıdır:

POST /api/projects/ensure, tam oluşturma gövdesini ve yeni bir proje oluşturmak yerine mevcut bir projeyi yerinde güncellemek için isteğe bağlı bir projectId alır. Bir klasör yükleme projesi için gitProvider: "upload" olarak ayarlayın.

Buluta / Buluttan Transfer

POST /api/projects/:id/transfer/to-cloud         † self-hosted only
POST /api/projects/:id/transfer/to-self-hosted   † self-hosted only

Yerel bir projeyi Alaf Server Cloud'a yükseltin veya bir bulut projesini bu instance'a geri çekin. Bunlar SaaS'te anlamsızdır (çünkü o buluttur) ve orada 404 döndürür. Her ikisi de project:admin gerektirir.

curl -X POST https://your-host/api/projects/proj_123/transfer/to-cloud \
  -H "Authorization: Bearer $ALAFSERVER_TOKEN"

Görebileceğiniz Hatalar