Servis ve süreç yöneticisi

Bu sayfa bir Linux düğümünün Cluster ERP sunucusunu nasıl çalıştırdığını açıklar: systemd birimi deploy/cluster-erp.service, gunicorn yapılandırması deploy/gunicorn.conf.py ve iki giriş noktası src/cluster_erp/server/asgi.py ile src/cluster_erp/server/main.py. Sayfa bir işçinin açılış sırasıyla biter. Uygulamanın kendi açılışında ne yaptığı sunucu açılışı ve uygulama fabrikası sayfasında açıklanır.

Kapsam ve kaynak¶

• Tanımlandığı yer: deploy/cluster-erp.service, deploy/gunicorn.conf.py, src/cluster_erp/server/asgi.py (app), src/cluster_erp/server/main.py (main).
• Sayı: birim tablosu [Unit], [Service] ve [Install] bölümlerinin her yönergesini; gunicorn tablosu yapılandırma dosyasının modül düzeyindeki her ayarını listeler.

Gerçek bir düğümün yolları değer olarak değil, birimin kendi adlarıyla (WorkingDirectory, EnvironmentFile, ReadWritePaths) yazılır.

Giriş noktaları¶

main.py vekil sunucu ayarlarını uvicorn'a geçirir: trust_proxy_headers değerinden proxy_headers, trusted_proxy_ips değerinden forwarded_allow_ips, erişim günlüğü anahtarı ve keep-alive saniyeleri (src/cluster_erp/server/main.py:39-58).

Systemd birimi¶

Gunicorn yapılandırması¶

Her değer, uygulamanın okuduğu aynı ortam dosyasından gelir (deploy/gunicorn.conf.py:11-13, deploy/gunicorn.conf.py:22-23).

Açılış sırası¶

Diyagram systemctl start komutundan bir işçinin hazır olmasına kadar olanları gösterir. Her işçi sıranın tamamını koşar; göç kilidi işçilerin şema adımında sırayla ilerlemesini sağlar.

flowchart TD
  systemd["systemd cluster-erp.service"] --> master["gunicorn ana süreci"]
  master --> w1["işçi 1 asgi:app içe aktarır"]
  master --> w2["işçi N asgi:app içe aktarır"]
  w1 --> life["lifespan başlar"]
  w2 --> life
  life --> mt{"multi_tenant"}
  mt -- "evet" --> lock["migration_lock altında upgrade_database_to_head"]
  lock --> ctl["TenantRegistry.ensure_schema ve ilk operatör"]
  mt -- "hayır" --> budget["bağlantı bütçesi denetimi"]
  ctl --> budget
  budget --> load["registry.load_all ve tohumlar"]
  load --> loops["arka plan döngüleri başlar"]
  loops --> ready["GET /ready 200 döndürür"]

Düz yazıyla:

1. systemd gunicorn ana sürecini yapılandırma dosyasıyla başlatır (deploy/cluster-erp.service:25).
2. Ana süreç işçileri başlatır; her biri create_app() çağıran cluster_erp.server.asgi:app modülünü içe aktarır (src/cluster_erp/server/asgi.py:17-19).
3. Her işçinin lifespan bağlamı başlar (src/cluster_erp/server/app.py:58-65).
4. Çok kiracılı kipte işçi gerekirse varsayılan veritabanını oluşturur ve onu danışma niteliğindeki göç kilidi içinde en yeni revizyona göç ettirir; ikinci bir işçi bekler ve sonra yapacak bir şey bulamaz (src/cluster_erp/server/app.py:99-113, src/cluster_erp/core/tenancy.py:693-720). Ardından kontrol düzlemini ve ilk operatörü hazırlar (src/cluster_erp/server/app.py:114-118). Tek kiracılı bir işçi göç ettirmez.
5. İşçi en kötü durumdaki bağlantı talebini sunucunun max_connections değeriyle karşılaştırır ve sığmadığında POOL BUDGET uyarısı yazar (src/cluster_erp/server/app.py:119-128, src/cluster_erp/server/app.py:610-631).
6. İşçi etkin her modülü yükler, dizileri ve yetkileri tohumlar, silme defterini yeniden oynatır ve arka plan döngülerini başlatır (src/cluster_erp/server/app.py:139-194).
7. Bağlam yield eder; /ready veritabanını ve çok kiracılı kipte kontrol düzlemini yoklar (src/cluster_erp/server/app.py:196, src/cluster_erp/server/app.py:1476-1504).

Yeniden yükleme ve yeniden başlatma¶

• systemctl reload bir HUP gönderir; uygulama önceden yüklenmediği için yeni işçiler güncel kodu içe aktarır (deploy/gunicorn.conf.py:3-10, deploy/gunicorn.conf.py:32-34).
• install.sh, ortam dosyası çalışan servisten yeniyse, birim değiştiyse veya requirements.lock değiştiyse yeniden yükleme yerine yeniden başlatır. Yeniden yüklenen bir işçi ana sürecin önceden içe aktardığı paketleri devralır (deploy/install.sh:140-144, deploy/install.sh:228-246).

Kısıtlar ve doğrulama¶

• Windows'ta main.py birden büyük server_workers değerini yok sayar ve bir uyarı yazar (src/cluster_erp/server/main.py:27-35).
• main.py içinde yeniden yükleme ve işçi süreçleri birbirini dışlar (src/cluster_erp/server/main.py:36-38).

Tutarsızlıklar¶

Tanıtılan terimler¶

İlgili sayfalar¶

• İşletim
• Sunucu açılışı ve uygulama fabrikası
• Veritabanı göçleri
• Ters vekil sunucu

92f8051 numaralı commit ile 2026-11-13 tarihinde doğrulandı.