Haproxy Docker Compose (Geliştiriciler için Nasıl Çalışır)

HAProxy Docker Özellikleri

Docker kullanarak HAProxy'yi kurmak ve çalıştırmak oldukça basit bir işlemdir. Aşağıda, birer birer adımlar verilmiştir.

Docker Kurulumu

Docker'ın sisteminize yüklü olduğundan emin olun. Kurulumun doğrulanması için aşağıdaki komutu çalıştırabilirsiniz:

docker --version

docker --version

Docker sistemde kurulu değilse, Docker bağlantısı buradan indirilebilir ve resmi web sitesinden yüklenebilir.

HAProxy Docker Resmini Çekin

Docker Hub'dan resmi HAProxy resmini çekin. Aşağıdaki komut, en son kararlı sürümü indirecektir:

docker pull haproxy:latest

docker pull haproxy:latest

HAProxy Yapılandırma Dosyası Oluşturun

HAProxy, davranışını belirleyen bir yapılandırma dosyasına ihtiyaç duyar. Aşağıdaki içeriğe sahip bir dosya oluşturun: haproxy.cfg

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

Bu HAProxy yapılandırması şunları tanımlar:

• Frontend: 80 portundan dinler ve trafiği arka uca yönlendirir.
• Backend: app1 adresinde barındırılan sunucuya işaret eder.

HAProxy Docker Kapsayıcısını Çalıştırın

Yapılandırma dosyasını bağlayarak ve gerekli portları açarak HAProxy Docker kapsayıcısını çalıştırın:

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: Konteynerı bağımsız modda çalıştırır.
• --name haproxy-container: Konteynera isim verir.
• -p 80:80: Ana bilgisayardaki 80 numaralı portu konteynerdaki 80 numaralı porta eşler.
• -v $(pwd)/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro: Yerel yapılandırma dosyasını konteyner'a monte eder.

HAProxy'ye Erişin

Bir web tarayıcısı açın ve trafik yönlendirmesini test etmek için http://localhost:80 veya sunucunuzun IP adresine gidin.

IronSecureDoc Kurun ve Çalıştırın

Komut İstemi'nde veya açık bir terminal penceresinde IronSecureDoc'un Docker imajını aşağıdaki komut ile çekin:

docker pull ironsoftwareofficial/ironsecuredoc

docker pull ironsoftwareofficial/ironsecuredoc

IronSecureDoc konteynerini çalıştırın:

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

Bu komut, IronSecureDoc'un bir konteyner örneğini başlatır. Şimdi IronSecureDoc'a http://localhost:8080/swagger/index.html portundan erişebilirsiniz.

IronSecureDoc'u HAProxy ile entegre edin

Ön ve arka uç yapılandırmalarınızı tanımlamak için haproxy.cfg dosyası hazırlayın. Aşağıda basit bir yapılandırma örneği verilmiştir:

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

Bu HAProxy yapılandırması, birden fazla IronSecureDoc hizmeti için HTTP trafiğini yönetir. Küresel ham log çıktısını tanımlar ve detaylı loglama ile varsayılan HTTP modunu ayarlar. Ön taraf @@--CODE-29635--@@ portunda dinler ve istekleri yola göre yönlendirir. acl body_has_data veri varlığını kontrol eder ve gerekirse GET isteklerini POST'a dönüştürür. Arka taraf, yük dengelemesi için Round Robin algoritmasını kullanır ve sunucu kullanılabilirliğini sağlamak için sağlık kontrolleri ile istekleri uygun bir şekilde iletir.

cURL kullanarak basit bir şifreleme isteği göndermek için:

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'

IronSecureDoc API'ye gönderilen bu istek, bir PDF belgesine kullanıcı şifresi şifrelemesi uygular ve çıktı dosyası güvenli bir şekilde gönderilir ve indirilir.