Haproxy Docker Compose (Funktionsweise für Entwickler)

Funktionen von HAProxy Docker

Die Installation und Ausführung von HAProxy mit Docker ist ein recht einfacher Prozess. Im Folgenden sind die Schritte aufgeführt, die nacheinander durchgeführt werden.

Docker-Installation

Stellen Sie sicher, dass Docker auf Ihrem System installiert ist. Um die Installation zu überprüfen, können Sie den unten stehenden Befehl ausführen:

docker --version

docker --version

Falls Docker nicht auf dem System installiert ist, besuchen Sie den Docker-Link hier, um es von der offiziellen Website herunterzuladen und zu installieren.

Ziehen Sie das HAProxy-Docker-Image

Ziehen Sie das offizielle HAProxy-Image von Docker Hub. Der folgende Befehl lädt die neueste stabile Version herunter:

docker pull haproxy:latest

docker pull haproxy:latest

Erstellen Sie eine HAProxy-Konfigurationsdatei

HAProxy benötigt eine Konfigurationsdatei, die sein Verhalten definiert. Erstellen Sie eine Datei namens haproxy.cfg mit folgendem Inhalt:

global
    log stdout format raw local0
defaults
    log     global
    mode    http
    timeout connect 5s
    timeout client  50s
    timeout server  50s
frontend http_front
    bind *:80
    default_backend http_back
backend http_back
    server app1 host.docker.internal:32769 check

Diese HAProxy-Konfiguration definiert:

• Frontend: Hört auf Port 80 und leitet den Verkehr an das Backend weiter.
• Backend: Zeigt auf app1, das unter host.docker.internal:32769 gehostet wird.

HAProxy Docker Container ausführen

Führen Sie den HAProxy-Docker-Container aus, montieren Sie die Konfigurationsdatei und stellen Sie die notwendigen Ports bereit:

docker run -d --network haproxy --name haproxy-container -p 80:80 -v $(pwd)/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro haproxy:latest

docker run -d --network haproxy --name haproxy-container -p 80:80 -v $(pwd)/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro haproxy:latest

• -d: Fährt den Container im Hintergrundbetrieb.
• --name haproxy-container: Benennt den Container.
• -p 80:80: Ordnet Port 80 auf dem Host Port 80 im Container zu.
• -v $(pwd)/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro: Montiert die lokale Konfigurationsdatei in den Container.

Zugang zu HAProxy

Öffnen Sie einen Webbrowser und navigieren Sie zu http://localhost:80 oder der IP-Adresse Ihres Servers, um das Verkehrs-Routing zu testen.

Installieren und starten Sie IronSecureDoc

Ziehen Sie das Docker-Image von IronSecureDoc mit dem folgenden Befehl im Befehlsfenster oder einem geöffneten Terminal-Fenster:

docker pull ironsoftwareofficial/ironsecuredoc

docker pull ironsoftwareofficial/ironsecuredoc

Führen Sie den IronSecureDoc-Container aus:

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

docker container run --rm -p 8080:8080 -e IronSecureDoc_LicenseKey=<IRONSECUREDOC_LICENSE_KEY> -e ENVIRONMENT=Development -e HTTP_PORTS=8080 ironsoftwareofficial/ironsecuredoc:latest

Dieser Befehl startet eine Containerinstanz von IronSecureDoc. Sie können jetzt auf IronSecureDoc auf Port http://localhost:8080/swagger/index.html zugreifen.

Integration von IronSecureDoc mit HAProxy

Bereiten Sie eine haproxy.cfg-Datei vor, um Ihre Frontend- und Backend-Konfigurationen zu definieren. Im Folgenden finden Sie ein einfaches Beispiel für eine Konfiguration:

global
    log stdout format raw local0
defaults
    log     global
    mode    http
    option  httplog
    timeout connect 5000ms
    timeout client  50000ms
    timeout server  50000ms
frontend http_front
    bind *:4500
    acl body_has_data req.hdr_val(Content-Length) gt 0
    http-request set-method POST if METH_GET body_has_data
    use_backend ironsecuredoc if { path /ironsecuredoc } || { path_beg /ironsecuredoc/ }
    use_backend ironsecuredoc_ping if { path /ping } || { path_beg /ping/ }
    use_backend ironsecuredoc_encrypt if { path /encrypt } || { path_beg /encrypt/ }
backend ironsecuredoc
    balance roundrobin
    http-request set-path /swagger/index.html
    server ironsecuredoc_server host.docker.internal:8080 check
backend ironsecuredoc_encrypt
    balance roundrobin
    http-request set-path /v1/document-services/pdfs/encrypt
    server ironsecuredoc_server host.docker.internal:8080 check
backend ironsecuredoc_ping
    balance roundrobin
    http-request set-path /v1/document-services/ping
    server ironsecuredoc_server host.docker.internal:8080 check

Diese HAProxy-Konfiguration verarbeitet HTTP-Verkehr für mehrere IronSecureDoc-Dienste. Es definiert globale Rohprotokollausgaben und legt den Standard-HTTP-Modus mit detaillierter Protokollierung fest. Das Frontend hört auf Port 4500 und leitet Anfragen basierend auf dem Pfad weiter. Die acl body_has_data überprüft das Vorhandensein von Daten und konvertiert GET-Anfragen bei Bedarf in POST. Das Backend verwendet den Round Robin-Algorithmus zur Lastverteilung und stellt sicher, dass Anfragen entsprechend weitergeleitet werden, mit Integritätsprüfungen zur Sicherstellung der Serververfügbarkeit.

Um eine einfache Verschlüsselungsanfrage mit cURL zu senden:

curl -X 'POST' \
  'http://localhost:4500/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

curl -X 'POST' \
  'http://localhost:4500/encrypt?user_password=demo' \
  -H 'accept: */*' \
  -H 'Content-Type: multipart/form-data' \
  -F 'pdf_file=@test.pdf;type=application/pdf'

Diese Anfrage an die IronSecureDoc API wendet die Benutzerpasswortverschlüsselung auf ein PDF-Dokument an, und die Ausgabedatei wird sicher gesendet und heruntergeladen.