Servisler API'si

Bir servis, bir projenin içindeki çalıştırılabilir bir birimdir: bir docker-compose yığınındaki bir container veya bir monorepo'daki bir alt uygulama. Her ikisi de aynı tabloda bulunur (kind ile ayrılır), bu nedenle bu API, servisleri listelemeyi ve düzenlemeyi, bunları bir docker-compose dosyasından senkronize etmeyi, container'larını başlatmayı/durdurmayı/yeniden başlatmayı, compose drift'ini çözmeyi ve servis başına ortam değişkenlerini ayarlamayı kapsar. dashboard'da bu, bir projenin Servisler sekmesidir; terminalden ise alaf server service komutudur.

Uç Noktalar

Servis ekle

POST /api/projects/:id/services

Bir servis satırı bir birleşimdir: kind: "compose" container alanlarını (image, build, ports…) kullanırken, kind: "monorepo" alt uygulama build alanlarını (rootDirectory, framework…) kullanır. Her iki alan kümesi de kabul edilir ve isteğe bağlıdır; kind hangi alt kümenin doğruluk kaynağı olduğuna karar verir. Bilinmeyen anahtarlar reddedilir.

Compose alanları (kind compose olduğunda kullanılır):

Monorepo alt uygulama alanları (kind monorepo olduğunda kullanılır):

curl -X POST https://your-host/api/projects/proj_123/services \
  -H "Authorization: Bearer $ALAFSERVER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"db","kind":"compose","image":"postgres:16","ports":["5432:5432"]}'

# CLI'dan aynı işlem:
alaf server service create -p my-stack db --image postgres:16 --port 5432:5432

Servisi güncelle

PATCH /api/projects/:id/services/:serviceId

Her alan isteğe bağlıdır — yalnızca değişenleri gönderin. Oluşturma ile aynı compose ve monorepo alanlarını kabul eder, kind hariç: bir satırın türünü değiştirmek yıkıcı bir işlemdir, bu nedenle servisi silip yeni tür altında yeniden oluşturun.

curl -X PATCH https://your-host/api/projects/proj_123/services/svc_456 \
  -H "Authorization: Bearer $ALAFSERVER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"restart":"unless-stopped","enabled":true}'

docker-compose'dan senkronize et

Projenin docker-compose dosyasını okur ve servis tablosunu buna uyacak şekilde düzenler — servisleri ekler, günceller ve işaretler. Düzenlemeleriniz compose dosyasından farklılaştığında, etkilenen servisler drifted olarak işaretlenir, böylece bunları açıkça çözebilirsiniz (aşağıya bakın).

POST /api/projects/:id/services/sync

alaf server service sync -p my-stack docker-compose.yml

Compose drift'ini çöz

Bir servisin depolanan yapılandırması yukarı akış docker-compose dosyasından farklılaştığında, drifted olarak işaretlenir. Servis başına bir çözüm seçin:

POST /api/projects/:id/services/:serviceId/drift/accept   # yukarı akışı al, düzenlemelerinizi at
POST /api/projects/:id/services/:serviceId/drift/keep     # düzenlemelerinizi tut, işaretlemeyi durdur

alaf server service drift accept -p my-stack web
alaf server service drift keep   -p my-stack web

Container eylemleri

Tek bir servis için çalışan container'ı başlatın, durdurun veya yeniden başlatın. Bunlar, servisin aktif-deploy container'ı üzerinde işlem yapar.

POST /api/projects/:id/services/:serviceId/start
POST /api/projects/:id/services/:serviceId/stop
POST /api/projects/:id/services/:serviceId/restart

alaf server service restart -p my-stack web

Tüm stack'teki çalışan container'ları listelemek için GET /api/projects/:id/services/containers (alaf server service containers -p my-stack) kullanın.

Ortam değişkenleri

GET .../env bir servisin ortam değişkenlerini listeler (gizli değerler maskelenir). PUT .../env bir ortam için tüm seti değiştirir — tutmak istediğiniz her değişkeni gönderin.

GET /api/projects/:id/services/:serviceId/env
PUT /api/projects/:id/services/:serviceId/env

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

# CLI'dan aynı işlem:
alaf server service env set -p my-stack web DATABASE_URL=postgres://… --env production

Görebileceğiniz hatalar