Docker Compose Beispiel für Redundanz Failover mit Traefik

Im folgenden Beispiel wird gezeigt, wie Traefik in Docker Compose konfiguriert werden kann. Dabei kann vollständig auf separate Konfigurationsdateien verzichtet werden. Die benötigten Konfigurationen werden als Befehlsparameter übergeben oder über Labels festgelegt.

Die Dateien, die als Projekt verwendet werden, befinden sich auf der Seite HTTP(S)-Failover-Konzepte für REST, OPC UA Server & Web-Management im OPC Router.

Wie beim Nginx-Beispiel betrifft auch diese Konfiguration nur das externe Failover für die Server-Endpunkte. Die eigentliche Redundanz des OPC Router-Paares wird unabhängig davon im OPC Router konfiguriert.

warnung

Die Traefik-Option --api.insecure=true dient in diesem Beispiel nur dazu, das Dashboard für Test- und Einrichtungszwecke einfach erreichbar zu machen. In produktiven Umgebungen sollte das Dashboard nicht ungeschützt veröffentlicht, sondern abgesichert oder deaktiviert werden.

docker-compose.yaml

services:
  traefik:
    image: traefik:v3.0
    restart: always
    networks:
      - opcrouter-net
    # Konfigurationen als Befehlsparameter
    command:
      - "--api.dashboard=true"
      - "--api.insecure=true"
      - "--entrypoints.web.address=:80"
      - "--providers.docker=true"
      - "--providers.docker.exposedbydefault=false"
      - "--ping"
    ports:
      - "5080:80"
      - "5081:8080" # Traefik Dashboard (optional)
    volumes:
      - "/var/run/docker.sock:/var/run/docker.sock:ro"

  opcrouter-primary:
    image: inrayhub.azurecr.io/opcrouter-runtime:5.3.6001.68
    restart: always
    networks:
      - opcrouter-net
    ports:
      - "5085:8080"
    environment:
      - OR_I_ACCEPT_EULA=true
      - INITIAL_USERNAME=admin
      - INITIAL_PASSWORD=SuperSecret123
      - OR_REDUNDANCY_MODE=1
      - OR_REDUNDANCY_LOCAL_MANAGEMENT_ADDRESS=http://opcrouter-primary:8080
      - OR_REDUNDANCY_SHARED_KEY=LUyLxk4kZdvYW9kM6ZSBWbBatdj9RGow9Bp
      - OR_IMPORT_SOURCE=/inray/REST_Primary.rpe
    volumes:
      # Projekt im Container verfügbar machen
      - ../REST_Primary.rpe:/inray/REST_Primary.rpe
    # Konfigurationen über Labels
    labels:
      - "traefik.enable=true"
      # Reagiert auf den Präfix /api
      - "traefik.http.routers.api-router.rule=PathPrefix(`/api`)"
      - "traefik.http.routers.api-router.entrypoints=web"
      - "traefik.http.routers.api-router.service=opcrouter-service"
      - "traefik.http.routers.api-router.middlewares=api-rewrite"
      # Ersetzt /api/ durch /services/MyRestServer/api/
      - "traefik.http.middlewares.api-rewrite.replacepathregex.regex=^/api/(.*)"
      - "traefik.http.middlewares.api-rewrite.replacepathregex.replacement=/services/MyRestServer/api/$$1"
      # Load Balancing Konfiguration
      - "traefik.http.services.opcrouter-service.loadbalancer.server.port=8080"
      # Verfügbarekeit durch Anfragen an angegebenen Pfad prüfen
      - "traefik.http.services.opcrouter-service.loadbalancer.healthcheck.path=/health/runtime/ready"
      - "traefik.http.services.opcrouter-service.loadbalancer.healthcheck.interval=5s"
      - "traefik.http.services.opcrouter-service.loadbalancer.healthcheck.timeout=2s"

  opcrouter-secondary:
    image: inrayhub.azurecr.io/opcrouter-runtime:5.3.6001.68
    restart: always
    networks:
      - opcrouter-net
    ports:
      - "5086:8080"
    environment:
      - OR_I_ACCEPT_EULA=true
      - INITIAL_USERNAME=admin
      - INITIAL_PASSWORD=SuperSecret123
      - OR_REDUNDANCY_MODE=2
      - OR_REDUNDANCY_SHARED_KEY=LUyLxk4kZdvYW9kM6ZSBWbBatdj9RGow9Bp
      - OR_REDUNDANCY_ADDRESS=http://opcrouter-primary:8080
      - OR_REDUNDANCY_LOCAL_MANAGEMENT_ADDRESS=http://opcrouter-secondary:8080
      - OR_REDUNDANCY_PRIMARY_TIMEOUT=30
      - OR_REDUNDANCY_SECONDARY_HEARTBEAT_INTERVAL=10
      - OR_IMPORT_SOURCE=/inray/REST_Secondary.rpe
    volumes:
      # Projekt im Container verfügbar machen
      - ../REST_Secondary.rpe:/inray/REST_Secondary.rpe
    # Konfigurationen über Labels
    labels:
      - "traefik.enable=true"
      # Reagiert auf den Präfix /api
      - "traefik.http.routers.api-router.rule=PathPrefix(`/api`)"
      - "traefik.http.routers.api-router.entrypoints=web"
      - "traefik.http.routers.api-router.service=opcrouter-service"
      - "traefik.http.routers.api-router.middlewares=api-rewrite"
      # Ersetzt /api/ durch /services/MyRestServer/api/
      - "traefik.http.middlewares.api-rewrite.replacepathregex.regex=^/api/(.*)"
      - "traefik.http.middlewares.api-rewrite.replacepathregex.replacement=/services/MyRestServer/api/$$1"
      # Load Balancing Konfiguration
      - "traefik.http.services.opcrouter-service.loadbalancer.server.port=8080"
      # Verfügbarekeit durch Anfragen an angegebenen Pfad prüfen
      - "traefik.http.services.opcrouter-service.loadbalancer.healthcheck.path=/health/runtime/ready"
      - "traefik.http.services.opcrouter-service.loadbalancer.healthcheck.interval=5s"
      - "traefik.http.services.opcrouter-service.loadbalancer.healthcheck.timeout=2s"

networks:
  opcrouter-net: