Haproxy Docker Compose (jak to działa dla programistów)

Funkcje HAProxy Docker

Instalacja i uruchomienie HAProxy przy użyciu Docker jest dość prostym procesem. Poniżej przedstawiono poszczególne etapy pracy.

Instalacja Docker

Upewnij się, że w systemie zainstalowano Docker. Aby sprawdzić instalację, możesz uruchomić poniższe polecenie:

docker --version

docker --version

Jeśli Docker nie jest zainstalowany w systemie, przejdź do linku Docker tutaj, aby pobrać i zainstalować go z oficjalnej strony internetowej.

Pobierz obraz HAProxy dla Docker

Pobierz oficjalny obraz HAProxy z serwisu Docker Hub. Poniższe polecenie pozwoli pobrać najnowszą stabilną wersję:

docker pull haproxy:latest

docker pull haproxy:latest

Utwórz plik konfiguracyjny HAProxy

HAProxy wymaga pliku konfiguracyjnego, który definiuje jego zachowanie. Utwórz plik o nazwie haproxy.cfg o następującej treści:

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

Ta konfiguracja HAProxy definiuje:

• Frontend: nasłuchuje na porcie 80 i kieruje ruch do backendu.
• Backend: Odwołuje się do app1 hostowanego na host.docker.internal:32769.

Uruchom kontener Docker HAProxy

Uruchom kontener HAProxy Docker, montując plik konfiguracyjny i udostępniając niezbędne porty:

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: Uruchamia kontener w trybie odłączonym.
• --name haproxy-container: Nadaje nazwę kontenerowi.
• -p 80:80: Mapuje port 80 na hoście do portu 80 w kontenerze.
• -v $(pwd)/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro: Montuje lokalny plik konfiguracyjny w kontenerze.

Dostęp do HAProxy

Otwórz przeglądarkę internetową i przejdź do http://localhost:80 lub adresu IP swojego serwera, aby przetestować routing ruchu.

Zainstaluj i uruchom IronSecureDoc

Pobierz obraz Docker IronSecureDoc, używając następującego polecenia w wierszu poleceń lub otwartym oknie terminala:

docker pull ironsoftwareofficial/ironsecuredoc

docker pull ironsoftwareofficial/ironsecuredoc

Uruchom kontener IronSecureDoc:

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

To polecenie uruchamia instancję kontenerową IronSecureDoc. Teraz możesz uzyskać dostęp do IronSecureDoc na porcie http://localhost:8080/swagger/index.html.

Zintegruj IronSecureDoc s HAProxy

Przygotuj plik haproxy.cfg, aby zdefiniować konfiguracje frontendu i backendu. Poniżej znajduje się prosty przykład konfiguracji:

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

Ta konfiguracja HAProxy obsługuje ruch HTTP dla wielu usług IronSecureDoc. Definiuje globalny surowy wydruk logów i ustawia domyślny tryb HTTP ze szczegółowym logowaniem. Frontend nasłuchuje na porcie 4500 i kieruje żądania na podstawie ścieżki. acl body_has_data sprawdza obecność danych i w razie potrzeby konwertuje żądania GET na POST. Backend wykorzystuje algorytm Round Robin do równoważenia obciążenia, zapewniając odpowiednie przekazywanie żądań wraz z kontrolami stanu w celu zapewnienia dostępności serwera.

Aby wysłać proste żądanie szyfrowania za pomocą cURL:

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'

To żądanie skierowane do interfejsu API IronSecureDoc powoduje zaszyfrowanie hasła użytkownika w dokumencie PDF, a plik wyjściowy jest bezpiecznie wysyłany i pobierany.