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

HAProxy Docker'in Özellikleri

Docker kullanarak HAProxy'yi yüklemek ve çalıştırmak oldukça basit bir süreçtir. Aşağıda birer birer atılan adımlar verilmiştir.

Docker Yükleme

Sisteminizde Docker yüklü olduğundan emin olun. Yüklemeyi doğrulamak için aşağıdaki komutu çalıştırabilirsiniz:

docker --version

docker --version

Sistemde Docker yüklü değilse, burayı ziyaret ederek Docker bağlantısından resmi web sitesinden indirip yükleyin.

HAProxy Docker Görüntüsünü Çekme

Docker Hub'dan resmi HAProxy görüntüsünü çekin. Aşağıdaki komut, en son kararlı sürümü indirir:

docker pull haproxy:latest

docker pull haproxy:latest

Bir HAProxy Yapılandırma Dosyası Oluşturun

HAProxy'nin davranışını tanımlayan bir yapılandırma dosyasına ihtiyaçı vardır. Aşağıdaki içerikle haproxy.cfg adlı bir dosya oluşturun:

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ı tanımlar:

• Ön Uç: Port 80'de dinler ve trafiği arka uca yollar.
• Backend: app1 adresine ev sahipliği yapan sisteme yönlendirir at host.docker.internal:32769.

HAProxy Docker Container'ını çalıştırın

Gerekli portları açarak yapılandırma dosyasını bağlayarak HAProxy Docker kapsülü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: Konteyneri ayrık modda çalıştırır.
• --name haproxy-container: Konteynere isim verir.
• -p 80:80: Host'taki port 80'i konteynerdeki port 80 ile eşleştirir.
• -v $(pwd)/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro: Yerel yapılandırma dosyasını konteynere monte eder.

HAProxy'a 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'u Kur ve Çalıştır

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

docker pull ironsoftwareofficial/ironsecuredoc

docker pull ironsoftwareofficial/ironsecuredoc

IronSecureDoc konteynerını ç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 portu üzerinden erişebilirsiniz.

IronSecureDoc'u HAProxy ile Entegre Edin

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

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 çok IronSecureDoc hizmeti için HTTP trafiğini yönetir. Genel ham günlük çıkışını tanımlar ve ayrıntılı günlük kaydı ile varsayılan HTTP modunu ayarlar. Ön uç, 4500 numaralı portta dinler ve istekleri yol bazında yönlendirir. acl body_has_data, verilerin varlığını kontrol eder ve gerektiğinde GET isteklerini POST'a dönüştürür. Arka uç, yük dengelemesi için Round Robin algoritması kullanır ve sunucu kullanılabilirliğini sağlamaya yönelik sağlık kontrolleri ile isteklerin uygun şekilde iletilmesini sağlar.

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 yapılan bu istek, bir PDF belgesine kullanıcı şifresi şifrelemesi uygular ve çıktı dosyası güvenli bir şekilde gönderilir ve indirilir.