Haproxy Docker Compose (Como funciona para desenvolvedores)

Recursos do HAProxy Docker

Instalar e executar HAProxy usando Docker é um processo relativamente simples. Abaixo estão os passos tomados um a um.

Instalação do Docker

Certifique-se de que o Docker está instalado no seu sistema. Para verificar a instalação, você pode executar o comando abaixo:

docker --version

docker --version

Se o Docker não estiver instalado no sistema, visite o link do Docker aqui para baixá-lo e instalá-lo do site oficial.

Puxe a imagem Docker do HAProxy

Puxe a imagem oficial do HAProxy do Docker Hub. O comando abaixo fará o download da versão estável mais recente:

docker pull haproxy:latest

docker pull haproxy:latest

Crie um arquivo de configuração do HAProxy

HAProxy precisa de um arquivo de configuração que defina seu comportamento. Crie um arquivo chamado haproxy.cfg com o seguinte conteúdo:

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

Essa configuração do HAProxy define:

• Frontend: Escuta na porta 80 e roteia o tráfego para o backend.
• Backend: Aponta para app1 hospedado em host.docker.internal:32769.

Execute o Container Docker do HAProxy

Execute o container Docker do HAProxy, montando o arquivo de configuração e expondo as portas necessárias:

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: Executa o contêiner em modo isolado.
• --name haproxy-container: Nomeia o contêiner.
• -p 80:80: Mapeia a porta 80 no host para a porta 80 no contêiner.
• -v $(pwd)/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro: Monta o arquivo de configuração local no contêiner.

Acesse o HAProxy

Abra um navegador web e navegue até http://localhost:80 ou o endereço IP do seu servidor para testar o roteamento de tráfego.

Instalar e Executar o IronSecureDoc

Puxe a imagem Docker do IronSecureDoc usando o seguinte comando no Prompt de Comando ou em uma janela de terminal aberta:

docker pull ironsoftwareofficial/ironsecuredoc

docker pull ironsoftwareofficial/ironsecuredoc

Execute o container do 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

Este comando inicia uma instância de container do IronSecureDoc. Você pode agora acessar IronSecureDoc na porta http://localhost:8080/swagger/index.html.

Integre o IronSecureDoc com o HAProxy

Prepare um arquivo haproxy.cfg para definir suas configurações de frontend e backend. Abaixo está um exemplo simples de configuração:

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

Esta configuração do HAProxy lida com o tráfego HTTP para vários serviços do IronSecureDoc. Define saída de log bruto global e define o modo HTTP padrão com log detalhado. O frontend escuta na porta 4500 e roteia solicitações com base no caminho. O acl body_has_data verifica a presença de dados e converte requisições GET para POST, se necessário. O backend usa o algoritmo Round Robin para balanceamento de carga, garantindo que as requisições sejam encaminhadas adequadamente com verificações de integridade para assegurar a disponibilidade do servidor.

Para enviar uma requisição simples de criptografia usando 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'

Esta requisição para a API do IronSecureDoc aplica criptografia de senha de usuário a um documento PDF, e o arquivo de saída é enviado e baixado com segurança.