Docker ile On-Premise Kurulum

Bu rehber, Proxus'u Docker ile kendi sunucunuzda nasıl kurup çalıştıracağınızı anlatır. Yükleyici, makineniz için dağıtım dosyalarını üretir, kültür ve timezone seçimini alır ve isterseniz platformu hemen başlatır.

Gereksinimler

Devam etmeden önce sisteminizin Sistem Gereksinimlerini karşıladığından emin olun.

Ayrıca şunlar gerekir:

• Docker Engine veya Docker Desktop: İşletim sisteminize uygun sürümü Docker'ın resmi sitesinden kurun.
• Docker Compose v2: Windows/macOS üzerinde Docker Desktop ile birlikte gelir. Linux kullanıcılarının Docker Compose'u ayrıca kurması gerekebilir.
• Çalışan Docker daemon: Yükleyiciyi çalıştırmadan önce Docker Desktop'ı veya Docker servisini başlatın.

Kurulum

İşletim sisteminize uygun yükleyiciyi çalıştırın. Yükleyici proxus-platform dizinini oluşturur, docker-compose.yml üretir, gerekli yerel konfigürasyon dosyalarını yazar ve platformu başlatmak isteyip istemediğinizi sorar.

curl -fsSL https://proxus.io/install.sh | bash

irm https://proxus.io/install.ps1 | iex

Kurulum sırasında şu seçimler sorulur:

• Culture: UI'daki sayı ve tarih formatını belirler.
• Timezone: Konteyner zamanını ve ekranda gösterilen tarih/saatleri belirler.
• Start now: İmajları çekip servisleri hemen başlatmak için Y, daha sonra başlatmak için n seçin.

Platformu Başlatma veya Yeniden Başlatma

Kurulum sırasında başlatmayı atladıysanız ya da platformu daha sonra başlatmak istiyorsanız:

cd proxus-platform
docker compose up -d

Konteyner durumunu kontrol etmek için:

docker compose ps

İlk başlatmada Docker imajları çekildiği ve servisler hazırlandığı için health check durumlarının yeşile dönmesi 1-2 dakika sürebilir.

Arayüze Erişim

Konteynerler çalışmaya başladıktan sonra şu adresi açın:

• Kullanıcı Adı: Admin
• Şifre: (Boş bırakın)

Bakım ve Güncellemeler

Platformu Güncelleme

Üretilen dağıtım dizininden:

cd proxus-platform
docker compose pull
docker compose up -d

Konfigürasyonu Değiştirme

Çalışan Docker volume içindeki Proxus-config.toml dosyasını düzenlemek için:

VOLUME_PATH=$(docker volume inspect proxus-platform_config --format '{{ .Mountpoint }}')
CONFIG_FILE="${VOLUME_PATH}/Proxus-config.toml"
nano "$CONFIG_FILE"

Yerel Dosyaları Konteynerlere Kopyalama

Yerelde düzenlemeyi tercih ediyorsanız veya harici bir sürücü dosyası eklemeniz gerekiyorsa:

docker cp Proxus-config.toml proxus-ui:/app/config/Proxus-config.toml
docker cp DriverFile.dll proxus-server:/app/DriverFile.dll

Yedekleme ve Geri Yükleme

Servisleri Durdurma

cd proxus-platform
docker compose down

Yedekleme Betiği

Bu betik, her platform volume'ü için proxus_backup dizininde sıkıştırılmış arşiv oluşturur.

backup_dir="$(pwd)/proxus_backup"
mkdir -p "$backup_dir"

for volume in proxus-platform_proxus-db-volume proxus-platform_nats proxus-platform_config proxus-platform_proxus_modules proxus-platform_clickhouse_data; do
  echo "$volume yedekleniyor..."
  docker run --rm \
    -v "$volume:/data" \
    -v "$backup_dir:/backup" \
    busybox tar czf "/backup/${volume}_backup.tar.gz" -C /data .
done

Geri Yükleme Betiği

proxus_backup dizinindeki arşivleri Docker volume'lerine geri yükler.

backup_dir="$(pwd)/proxus_backup"

for backup_file in "${backup_dir}"/*_backup.tar.gz; do
  volume="$(basename "${backup_file}" _backup.tar.gz)"
  echo "${volume} geri yükleniyor..."
  docker run --rm \
    -v "${volume}:/data" \
    -v "${backup_dir}:/backup" \
    busybox tar xzf "/backup/${volume}_backup.tar.gz" -C /data
done

Sorun Giderme

UI veya Server başlamazsa logları kontrol edin:

cd proxus-platform
docker compose logs proxus-ui
docker compose logs proxus-server

Docker kurulu değilse, Docker daemon çalışmıyorsa veya Docker Compose v2 eksikse yükleyici dağıtım dosyalarını yazmadan önce görünür bir hata ile durur.