Ubuntu Yerel Kurulum¶
Üretim Önerisi
systemd, Linux üretim ortamları için önerilen yerel servis yöneticisidir. Tam servis kurulumu, yönetimi, güncelleme, geri alma ve sorun giderme kılavuzu için Linux systemd Kurulumu sayfasına bakın.
Çalışma Zamanı Dizin Yapısı¶
```text /opt/iqvizyon/iqv-integration-api/ bin/ # Uygulama ikili dosyası deployment/ # Dağıtım meta verileri
/etc/iqvizyon/iqv-integration-api.env # Ortam dosyası
/var/log/iqvizyon/iqv-integration-api/ # Uygulama günlükleri
/var/lib/iqvizyon/iqv-integration-api/ backups/ # Güncelleme öncesi yedekler ```
Hızlı Kurulum¶
Kurulum Betiği ile¶
bash
sudo bash ./scripts/linux/service/install.sh
Bu, ayrılmış bir servis kullanıcısı oluşturacak, ikili dosyayı kuracak, iqv-integration-api.service birimini systemd'ye kaydedecek ve servisi başlatacaktır.
Ortam Dosyası¶
Kurulum betiği .env dosyasını asla otomatik oluşturmaz. Kurulum betiğini çalıştırmadan önce elle oluşturmalısınız:
bash
sudo mkdir -p /etc/iqvizyon
sudo cp ./config/.env.example /etc/iqvizyon/iqv-integration-api.env
sudo chmod 600 /etc/iqvizyon/iqv-integration-api.env
Dosyayı düzenleyin ve tüm zorunlu değerleri ayarlayın — en azından MONGODB_URI, AUTH_CLIENT_SECRET, AUTH_JWT_SECRET.
Servis Yönetimi¶
bash
sudo systemctl status iqv-integration-api.service
sudo systemctl start iqv-integration-api.service
sudo systemctl stop iqv-integration-api.service
sudo systemctl restart iqv-integration-api.service
İkili dosya doğrudan servis komutlarını da destekler:
bash
./iqv-integration-api service install --env-file /etc/iqvizyon/iqv-integration-api.env
./iqv-integration-api service status
./iqv-integration-api service start
./iqv-integration-api service stop
./iqv-integration-api service restart
./iqv-integration-api service uninstall
Doğrulama¶
bash
curl -s http://localhost:8080/health/live
curl -s http://localhost:8080/health/ready
Kurulum başarılı sayılmadan önce her iki uç nokta da HTTP 200 döndürmelidir.
Docker (Ayrı Dağıtım Türü)¶
Docker, systemd'den ayrı bir dağıtım türüdür. Bkz. Ubuntu Docker Kurulumu ve Docker Kurulumu.