Docker ile On-Premise Kurulum

Bu rehber, Proxus IIoT platformunu Docker kullanarak kendi sunucunuzda (on-premise) nasıl kurup çalıştıracağınızı detaylandırır.

info

Lisans Gerekli

Kurulumdan sonra Proxus'u kullanmaya başlamak için bir demo lisansına ihtiyacınız olacak. Talebinizi iletmek için lütfen proxus.io/demo adresini ziyaret edin.

Gereksinimler

Devam etmeden önce, sisteminizin Proxus için Sistem Gereksinimlerini karşıladığından emin olun.

Sunucunuzda aşağıdakilerin kurulu olduğundan emin olun:

Docker Engine: İşletim sisteminizle uyumlu sürümü resmi web sitesinden indirin.
Docker Compose: Genellikle Windows/macOS'ta Docker Desktop ile birlikte gelir. Linux kullanıcılarının ayrıca yüklemesi gerekebilir.

1. Kurulum

Proxus'u otomatik betiğimizi kullanarak (önerilen) veya konfigürasyon dosyalarını manuel olarak indirerek kurabilirsiniz.

Seçenek A: Hızlı Başlangıç (Önerilen)

Gerekli tüm dosyaları otomatik olarak indirmek ve dizin yapısını kurmak için terminalinizde aşağıdaki komutu çalıştırın.

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

Desteklenen Ortamlar:

Linux / macOS: Standart Terminal
Windows: Git Bash veya WSL (Windows Subsystem for Linux)

Seçenek B: Manuel Kurulum

Dosyaları manuel olarak indirmeyi tercih ederseniz, işletim sisteminiz için aşağıdaki komutları kullanın.

Seçenek 1: wget kullanarak

BASE_URL="https://raw.githubusercontent.com/proxusiiotplatform/docs/main/"
CONFIGS_DIR="Configs"

# Compose Dosyasını İndir
wget -O docker-compose.yml "${BASE_URL}docker-compose.yml"

# Config Dizinini Oluştur
mkdir -p "${CONFIGS_DIR}"

# Config Dosyalarını İndir
for file in dashboard.yml datasource.yml dotnet-otel-dashboard.json \
jaeger-ui.json logs-dashboard.json loki.yml \
otel-collector-config.yml prometheus.yml grafana.ini \
accounts.conf hub.conf; do
wget -O "${CONFIGS_DIR}/${file}" "${BASE_URL}Configs/${file}"
done

Seçenek 2: curl kullanarak

CONFIGS_DIR="Configs"
BASE_URL="https://raw.githubusercontent.com/proxusiiotplatform/docs/main/"

# Compose Dosyasını İndir
curl -LO "${BASE_URL}docker-compose.yml"

# Config Dizinini Oluştur
mkdir -p "${CONFIGS_DIR}"

# Tüm Configleri İndir
curl -L
"${BASE_URL}Configs/{dashboard.yml,datasource.yml,dotnet-otel-dashboard.json,jaeger-ui.json,logs-dashboard.json,loki.yml,otel-collector-config.yml,prometheus.yml,grafana.ini,accounts.conf,hub.conf}"
-o "${CONFIGS_DIR}/#1"

@echo off
SET
BASE_URL=https://raw.githubusercontent.com/proxusiiotplatform/docs/main/
SET CONFIGS_DIR=Configs

curl -sS -LO %BASE_URL%docker-compose.yml
IF NOT EXIST "%CONFIGS_DIR%" mkdir "%CONFIGS_DIR%"

curl -sS -L %BASE_URL%Configs/dashboard.yml -o %CONFIGS_DIR%/dashboard.yml
curl -sS -L %BASE_URL%Configs/datasource.yml -o %CONFIGS_DIR%/datasource.yml
curl -sS -L %BASE_URL%Configs/dotnet-otel-dashboard.json -o %CONFIGS_DIR%/dotnet-otel-dashboard.json
curl -sS -L %BASE_URL%Configs/jaeger-ui.json -o %CONFIGS_DIR%/jaeger-ui.json
curl -sS -L %BASE_URL%Configs/logs-dashboard.json -o %CONFIGS_DIR%/logs-dashboard.json
curl -sS -L %BASE_URL%Configs/loki.yml -o %CONFIGS_DIR%/loki.yml
curl -sS -L %BASE_URL%Configs/otel-collector-config.yml -o %CONFIGS_DIR%/otel-collector-config.yml
curl -sS -L %BASE_URL%Configs/prometheus.yml -o %CONFIGS_DIR%/prometheus.yml
curl -sS -L %BASE_URL%Configs/grafana.ini -o %CONFIGS_DIR%/grafana.ini
curl -sS -L %BASE_URL%Configs/accounts.conf -o %CONFIGS_DIR%/accounts.conf
curl -sS -L %BASE_URL%Configs/hub.conf -o %CONFIGS_DIR%/hub.conf

$b =
"https://raw.githubusercontent.com/proxusiiotplatform/docs/main/"
$c = "Configs"

Invoke-WebRequest "${b}docker-compose.yml" -OutFile "docker-compose.yml"
New-Item -ItemType Directory -Force -Path $c

"dashboard.yml datasource.yml dotnet-otel-dashboard.json jaeger-ui.json logs-dashboard.json loki.yml
otel-collector-config.yml prometheus.yml grafana.ini accounts.conf hub.conf".Split() | ForEach-Object {
Invoke-WebRequest "${b}Configs/$_" -OutFile "${c}/$_"
}

2. Platformu Çalıştırma

Dosyaları indirdiğiniz dizine gidin ve şu komutu çalıştırın:

docker-compose -p "proxus" up -d

lightbulb

İzinler

Yönetici yetkilerine ihtiyacınız olabilir. Linux/macOS'ta sudo kullanın veya Windows'ta terminali Yönetici olarak çalıştırın.

Arayüze Erişim

Konteynerler çalışmaya başladıktan sonra tarayıcınızı açın:

open_in_new

Yönetim Konsolunu Aç

http://localhost:8080

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

3. Bakım ve Güncellemeler

Platformu Güncelleme

En son imajları çekmek ve yığını yeniden başlatmak için:

# 1. Verinizi yedekleyin (aşağıya bakın)
# 2. Son imajları çekin
docker compose -p "proxus" pull

# 3. Konteynerleri yeniden başlatın
docker compose -p "proxus" up -d

Konfigürasyonu Değiştirme

Proxus-config.toml dosyasını çalışan volume içinde düzenlemek için (dosya kopyalamadan):

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

Yerel Dosyaları Konteynerlere Kopyalama

Yerelde düzenlemeyi tercih ederseniz veya DLL (Oracle vb.) eklemeniz gerekirse:

# Config'i UI Konteynerine Kopyala
docker cp Proxus-config.toml proxus-ui:/app/config/Proxus-config.toml

# Oracle DLL'ini Server Konteynerine Kopyala
docker cp Oracle.ManagedDataAccess.dll proxus-server:/app/Oracle.ManagedDataAccess.dll

4. Yedekleme ve Geri Yükleme

warning

Önce Konteynerleri Durdurun

Veri bozulmasını önlemek için geri yükleme yapmadan önce platformu durdurmanız (docker compose down) önerilir.

Yedekleme Betiği

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

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

for volume in proxus-db-volume nats config proxus_modules; do
echo "$volume yedekleniyor..."
docker run --rm \
-v "$volume:/data" \
-v "$backup_dir:/backup" \
busybox tar czf "/backup/${volume}_backup.tar.gz" -C /data .
echo "$volume yedeği tamamlandı."
done

Geri Yükleme Betiği

proxus_backup dizinindeki verileri 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 (${backup_file})..."
docker run --rm \
-v "${volume}:/data" \
-v "${backup_dir}:/backup" \
busybox tar xzf "/backup/${volume}_backup.tar.gz" -C /data
echo "${volume} geri yüklemesi tamamlandı."
done

Sorun Giderme

UI veya Server başlamazsa logları kontrol edin:

docker logs proxus-ui
docker logs proxus-server

Temel Yetenekler

Akıllı Sistemler

Operasyonlar

Sektörler

Kullanım Senaryoları