Ana içeriğe geç

Kurulum Kılavuzu

Bu sayfa dağıtım modelini seçer. Ayrıntılı prosedür platform sayfalarındadır.

Ortak önkoşullar

  • 64-bit Windows veya Ubuntu
  • Erişilebilir harici MongoDB 6.0+ (API kurucusu MongoDB kurmaz)
  • INTEGRATION_ACTOR_USER_ID için gerçek aktif kullanıcı ObjectID’si (üretilmiş ID değil)
  • Hazır yapılandırma (.env veya kurucu CLI bayrakları)
  • API host’tan MongoDB’ye ağ yolu

Hangi model

Durum Kullanın
Windows üretim Windows Native Service
Windows lab / konteyner tercihi Windows Docker (bugün kaynak ağacı kurucusu)
Linux üretim, konteyner yok Linux Native systemd (offline prebuilt binary)
Linux üretim, konteyner zorunlu Linux Docker (offline prebuilt image) 
flowchart LR
  subgraph win [Windows]
    WN[Native]
    WD[Docker]
  end
  subgraph lin [Linux]
    LN[Native]
    LD[Docker]
  end

Paket şekli — dürüst özet

Model Müşteri host gereksinimi Mevcut paket
Windows Native PowerShell, Yönetici, mevcut kurucu için Go ve Git GitHub Release *-windows-native-amd64.zip: kaynak + mevcut kurucu. Prebuilt exe değildir.
Windows Docker Docker Desktop, Linux containers, Yönetici GitHub Release *-windows-docker-amd64.zip: kaynak + docker build. Açılmış zip release-package mode kullanır (manifest provenance; .git / clone zorunlu değil). Offline image tar değildir.
Linux Native systemd, root, sha256sum GitHub Release *-linux-native-amd64.tar.gz (offline prebuilt binary)
Linux Docker Docker Engine + Compose v2, root GitHub Release *-linux-docker-amd64.tar.gz (offline prebuilt image tar)

Olmayan Windows prebuilt kurucuyu uydurmayın

Windows zip, mevcut kurucular için checksum’lı kaynak paketidir. Go/Git (Native) veya Docker Desktop / docker build (Docker) gereksinimini kaldırmaz. İndirme ve doğrulama: Sürüm Süreci.

Harici MongoDB

Önerilen tüm üretim yolları mevcut MongoDB kullanır.

  • Windows Native çoğu zaman yerel Windows MongoDB servisine (MongoDB) bağlanır ve servis bağımlılığı tanımlayabilir.
  • Windows Docker, MongoDB Docker host’taysa genelde host.docker.internal kullanır.
  • Linux Docker üretim URI’yi olduğu gibi kullanır. Konteyner içi loopback reddedilir. Kurucu URI’yi host.docker.internal olarak yeniden yazmaz.
  • Paketlenmiş MongoDB compose yalnızca geliştirme/lab/isteğe bağlı eski yoldur.

Güvenli örnek:

text MONGODB_URI=mongodb://<MONGODB_HOST>:27017 MONGODB_DATABASE=<DATABASE_NAME> INTEGRATION_ACTOR_USER_ID=<24-hex-existing-active-user> PUBLIC_BASE_URL=http://<API_HOST>:<HOST_PORT>

Temiz kurulum kontrol listesi

  1. MongoDB’nin API host’tan erişilebilir olduğunu doğrulayın.
  2. Yapılandırmayı hazırlayın (Windows: önce .env.example kopyalayın; Linux kurucuları paket örneği + CLI ile bootstrap eder ve mevcut env’in üzerine yazmaz).
  3. Platform kurucusunu Yönetici / root olarak çalıştırın.
  4. /health/live ve /health/ready HTTP 200 dönmeli.
  5. status beklenen servis/konteyner ve portları göstermelidir.

Sonraki sayfalar