Haproxy Docker Compose (Cómo funciona para desarrolladores)

Características de HAProxy Docker

Instalar y ejecutar HAProxy usando Docker es un proceso bastante simple. A continuación se presentan los pasos tomados uno a uno.

Instalación de Docker

Asegúrese de que Docker esté instalado en su sistema. Para verificar la instalación, puede ejecutar el siguiente comando:

docker --version

docker --version

Si Docker no está instalado en el sistema, visite el enlace de Docker aquí para descargarlo e instalarlo desde el sitio web oficial.

Extraer la imagen Docker de HAProxy

Descargue la imagen oficial de HAProxy desde Docker Hub. El siguiente comando descargará la versión más reciente estable:

docker pull haproxy:latest

docker pull haproxy:latest

Crear un archivo de configuración de HAProxy

HAProxy necesita un archivo de configuración que defina su comportamiento. Crea un archivo llamado haproxy.cfg con el siguiente contenido:

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

Esta configuración de HAProxy define:

• Frontend: Escucha en el puerto 80 y enruta el tráfico al back end.
• Backend: Apunta a app1 alojado en host.docker.internal:32769.

Ejecutar HAProxy Docker Container

Ejecute el contenedor Docker de HAProxy, montando el archivo de configuración y exponiendo los puertos necesarios:

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: Ejecuta el contenedor en modo desconectado.
• --name haproxy-container: Nombra el contenedor.
• -p 80:80: Asigna el puerto 80 del host al puerto 80 en el contenedor.
• -v $(pwd)/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro: Monta el archivo de configuración local en el contenedor.

Acceder a HAProxy

Abra un navegador web y navegue a http://localhost:80 o la dirección IP de su servidor para probar el enrutamiento de tráfico.

Instalar y ejecutar IronSecureDoc

Descargue la imagen Docker de IronSecureDoc utilizando el siguiente comando en el Símbolo del sistema o una ventana de terminal abierta:

docker pull ironsoftwareofficial/ironsecuredoc

docker pull ironsoftwareofficial/ironsecuredoc

Ejecute el contenedor de 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 una instancia de contenedor de IronSecureDoc. Ahora puede acceder a IronSecureDoc en el puerto http://localhost:8080/swagger/index.html.

Integrar IronSecureDoc con HAProxy

Prepare un archivo haproxy.cfg para definir sus configuraciones de frontend y backend. A continuación hay un ejemplo simple de configuración:

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 configuración de HAProxy maneja el tráfico HTTP para múltiples servicios IronSecureDoc. Define la salida de registro en bruto global y establece el modo HTTP predeterminado con registro detallado. El frontend escucha en el puerto 4500 y enruta las solicitudes en función de la ruta. El acl body_has_data verifica la presencia de datos y convierte solicitudes GET en POST si es necesario. El backend utiliza el algoritmo Round Robin para el balanceo de carga, asegurando que las solicitudes se reenvíen adecuadamente con controles de salud para asegurar la disponibilidad del servidor.

Para enviar una simple solicitud de cifrado 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 solicitud a la API de IronSecureDoc aplica cifrado de contraseña de usuario a un documento PDF, y el archivo de salida se envía y descarga de manera segura.