Kurulum Kılavuzu

Bu öğretici, WEVA ortamını bir ana makinede dağıtmak için adım adım talimatlar sağlar.

Ön Koşullar

Kuruluma başlamadan önce aşağıdaki koşulların karşılanmasını sağlayın:

1. Donanım: Ana makine Sistem Gereksinimlerini karşılamaktadır.
2. Yazılım: Docker Desktop veya Docker Engine yüklü ve çalışıyor durumundadır.
3. Ağ: Ana makinenin terminaline yönetici erişimi (PowerShell veya Bash).
4. WDX Runtime: WDX Docker imajınız olduğundan emin olun. Yoksa, buradan alın

---

1. WDX Runtime Dağıtımı (PLC Visu)

WDX runtime, WEVA ile diğer kontrolörler arasındaki birincil iletişim köprüsüdür.

İmajı Yükleyin

Sağlanan WDX Docker imajını yerel deponuza aktarın.

• WDX'in indirildiği klasörü açın.
• Bu klasör konumunda bir terminal açın.
• Aşağıdaki komutu çalıştırın:

Windows, Linux ve Mac

# PowerShell veya Terminal'de
docker load -i /{path-to-plcvisu}/plcvisu.tar

Konteyner Başlatın

Aşağıdaki komutu kullanarak konteyner çalıştırın. Bu kalıcı eşleme, günlüklerin ve konfigürasyonların ana makinede saklanmasını sağlar.

Windows

docker run -d `
  -p 7081:80 `
  -p 7481:443 `
  --name wdx-runtime `
  --restart unless-stopped `
  -v "$env:USERPROFILE\Documents\WAGO\data:/opt/elrest/edesign/wdx/data" `
  -v "$env:USERPROFILE\Documents\WAGO\config:/opt/elrest/edesign/wdx/config" `
  -v "$env:USERPROFILE\Documents\WAGO\js-storage:/opt/elrest/edesign/wdx/storage" `
  plcvisu:{version-number}-X86_64-alpine

Linux ve Mac

docker run -d \
  -p 7081:80 \
  -p 7481:443 \ 
  --name wdx-runtime \
  --restart unless-stopped \
  -v "$HOME/Documents/WAGO/wdx-logs/data:/opt/elrest/edesign/wdx/data" \
  -v "$HOME/Documents/WAGO/wdx-logs/config:/opt/elrest/edesign/wdx/config" \
  -v "$HOME/Documents/WAGO/wdx-logs/js-storage:/opt/elrest/edesign/wdx/storage" \
  plcvisu:{version-number}-X86_64-alpine

UYARI:

• Komutu çalıştırmadan önce birim yollarının (örn. C:\WAGO\...) ana makinede mevcut olduğundan emin olun.
• Mac'te komutlar farklı olabilir. Kullanmadan önce onaylayın.
• Komutlardaki alanlar değiştirilirse, kurulum sürecinin geri kalanında tutarlı olduğundan emin olun.
• Docker'da gösterilen plcvisu sürüm numarasının komuttakiyle eşleştiğinden emin olun.
• Komuttaki -p, port numarasıdır (bu durumda 7081:80), burada 7081 bilgisayarınızın port numarası ve 80 konteyner port numarasıdır.

Başlatmayı Doğrulayın

WDX'in başarıyla yüklendiğini doğrulamak için bir tarayıcı açın ve önceki bölümde çalıştırılan komutta belirtilen porta erişin.

WDX web sayfasına erişilememesi durumunda WDX'i yeniden başlatmak gereklidir:

---

2. WEVA Uygulamasını Dağıtın

WDX runtime doğrulandıktan sonra WEVA uygulaması yığınını dağıtın.

WEVA İmajını Yükleyin

İmajınız bir .tar dosyasındaysa:

Windows, Linux ve Mac

docker load -i weva-app-image.tar

Docker Compose'u Yapılandırın

Dağıtım için bir dizin oluşturun ve docker-compose.yaml dosyasını içine yerleştirin.

Not: docker-compose.yaml dosyanız yoksa, bulunduğunuz klasörde docker-compose.yaml adında yeni bir boş dosya oluşturun ve aşağıdaki içeriği dosyaya yapıştırın 👇.

# docker-compose.yml
services:
  app:
    #.tar dosyanız varsa, Docker'da yazılan 'name:tag' olarak adı değiştirin
    image: ustaz/weva-app:1.0.8

    #oluşturulan konteyner adı
    container_name: weva

    #konteyner'in her zaman çalışmaya devam etmesini sağlamak için
    restart: unless-stopped

    #BU PARAMETRELERI DEĞİŞTİRMEYİN!!
    ports:
      - "5170:5170"
    extra_hosts:
      - "host.docker.internal:host-gateway"
    environment:
      HTTP_SERVER_PORT: 5170
      
      # Veri aktarım sıklığı
      UPDATE_RATE: 3000

      DB_HOST: mysql
      DB_USER: root
      # İdeal olarak bunlar değiştirilmelidir!
      DB_PASSWORD: mypassword
      DB_NAME: wagopa
      WDX_SERVER_HOST: host.docker.internal
      WDX_SERVER_PORT: 7081
      # Not: Ağındaki başka bir bilgisayardan erişilirse,
      # 'localhost' yerine ana makinenin gerçek IP adresini yazın.
      VITE_BACKEND_HOST: localhost
      VITE_WEBSOCKET_PORT: 3031
    depends_on:
      - mysql
    networks:
      - weva_net

  mysql:
    image: mysql:latest
    container_name: mysql-db
    restart: unless-stopped
    ports:
      - "3306:3306"
    environment:
    
    #DB_PASSWORD parametresiyle aynı olmalıdır
      MYSQL_ROOT_PASSWORD: mypassword
    volumes:
      - mysql_data:/var/lib/mysql
      # Bu, klasör içindeki init.sql dosyasını işaret eder.
      #Bu dosyayla aynı klasörde olduğundan emin olun!!
      - ./init.sql:/docker-entrypoint-initdb.d/init.sql:ro
    networks:
      - weva_net

networks:
  weva_net:
    driver: bridge

volumes:
  mysql_data:

Not: init.sql dosyasının docker-compose.yaml dosyasıyla aynı dizinde bulunduğundan emin olun. Bu, mysql konteyner'ını düzgün şekilde kurmaktır.

Yığını Başlatın

Dizine gidin ve çalıştırın:

Windows, Linux ve Mac

docker compose up -d

Bunu yaparak Docker, çalışan konteynerleri oluşturur ve hiçbir hata olmadan işlemleri çalıştırmaya başlar.

GIF: 'docker compose up' komutunun gösterildiği ve başarılı konteyner başlatma kaydı.

---

3. Doğrulama

1. Konteyner Durumu: Tüm konteyner'ların (weva-backend, weva-db, wdx-runtime) Up durumunda olduğundan emin olmak için docker ps komutunu çalıştırın.
2. Web Erişimi: Ana makinede bir tarayıcı açın ve http://localhost:5170 adresine gidin.
3. Kayıt: Yazılımla birlikte varsayılan bir profil olmadığından Kayıt Sayfasında profilinizi oluşturun.

---

NOT: Herhangi bir hatayla karşılaşılırsa Sorun Giderme Sayfası sayfasına bakın!!