Linux Native Operasyon¶
Önerilen Linux native üretim yolu: offline prebuilt binary + systemd. Müşteri host’ta Go, Git veya kaynak ağacı gerekmez.
Depoda scriptler scripts/linux/service altındadır; GitHub Release tarball’ında (iqv-integration-api-<sürüm>-linux-native-amd64.tar.gz) scripts/*.sh olarak gelir.
Kurulum: Linux systemd Kurulumu.
systemd birimi¶
| Öğe | Değer |
|---|---|
| Unit | iqv-integration-api.service |
| Kullanıcı | iqvapi |
| Env | /etc/iqvizyon/iqv-integration-api.env |
| Binary | /opt/iqvizyon/iqv-integration-api/bin/iqv-integration-api serve |
| Restart | on-failure, RestartSec=5 |
Yalnız Windows’a ait iqv-integration-api service install|start|... CLI Linux üretim yolu değildir. systemd kullanın.
status / start / stop / restart / enable¶
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
sudo systemctl enable iqv-integration-api.service
sudo systemctl disable iqv-integration-api.service
sudo ./scripts/status.sh
journalctl¶
Uygulama slog’u süreç stdout’udur. systemd bunu journal’a yazar. LOG_DIR=/var/log/iqvizyon/iqv-integration-api birimde yazılabilir yoldur; Go süreci uygulama log dosyasını oraya yazmaz.
bash
sudo journalctl -u iqv-integration-api.service -f
sudo journalctl -u iqv-integration-api.service --since "1 hour ago"
Runtime ve config¶
text
/opt/iqvizyon/iqv-integration-api/bin/
/opt/iqvizyon/iqv-integration-api/deployment/
/etc/iqvizyon/iqv-integration-api.env
/var/lib/iqvizyon/iqv-integration-api/backups/
/var/log/iqvizyon/iqv-integration-api/ # ayrılmış; slog hedefi değil
Mevcut env kurulum/güncellemede üzerine yazılmaz.
Güvenlik duvarı¶
Kurucu ufw allow <port>/tcp veya firewalld --add-port=<port>/tcp ekleyebilir. İkisi de yoksa atlanır.
Health¶
bash
curl -sS http://127.0.0.1:<HTTP_PORT>/health/live
curl -sS http://127.0.0.1:<HTTP_PORT>/health/ready
Güncelleme ve geri alma¶
bash
sudo ./scripts/update.sh --binary-path ./bin/iqv-integration-api
Karar binary SHA256 üzerindendir. Aynı özet ⇒ NO-OP. --force-redeploy aynı baytları yeniden yayınlar. Başarısız start/health önceki binary’yi geri yükler. Veritabanı geri alınmaz.
Lab: IQV_TEST_FAIL_AT=Health veya AfterStart.
Kaldırma¶
bash
sudo ./scripts/uninstall.sh
Varsayılan env, log dizini, yedekler ve metadata’yı bırakır. Bkz. Kaldırma.