Haproxy Docker Compose 사용법 (개발자를 위한 작동 방식)

HAProxy Docker의 특징

Docker를 사용하여 HAProxy를 설치하고 실행하는 것은 매우 간단한 과정입니다. 단계별로 수행되는 단계는 아래와 같습니다.

Docker 설치

시스템에 Docker가 설치되어 있는지 확인하십시오. 설치를 확인하려면 아래 명령을 실행할 수 있습니다:

docker --version

docker --version

시스템에 Docker가 설치되지 않은 경우, Docker 링크를 방문하여 공식 웹사이트에서 다운로드하고 설치하십시오.

HAProxy Docker 이미지 가져오기

Docker Hub에서 공식 HAProxy 이미지를 가져옵니다. 아래 명령은 최신 안정적인 버전을 다운로드할 것입니다:

docker pull haproxy:latest

docker pull haproxy:latest

HAProxy 구성 파일 생성하기

HAProxy는 동작을 정의하는 구성 파일이 필요합니다. 다음 내용으로 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

이 HAProxy 구성은 다음을 정의합니다:

• 프론트엔드: 포트 80에서 수신 대기하며 백엔드로 트래픽을 라우팅합니다.
• 백엔드: host.docker.internal:32769에 호스팅된 app1을(를) 가리킵니다.

HAProxy Docker 컨테이너 실행

구성 파일을 마운트하고 필요한 포트를 노출하여 HAProxy Docker 컨테이너를 실행합니다:

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: 컨테이너를 분리 모드로 실행합니다.
• --name haproxy-container: 컨테이너에 이름을 지정합니다.
• -p 80:80: 호스트의 포트 80을 컨테이너의 포트 80에 매핑합니다.
• -v $(pwd)/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro: 로컬 구성 파일을 컨테이너에 마운트합니다.

HAProxy에 액세스

웹 브라우저를 열고 http://localhost:80 또는 서버의 IP 주소로 이동하여 트래픽 라우팅을 테스트하세요.

IronSecureDoc 설치 및 실행

다음 명령어를 명령 프롬프트 또는 열린 터미널 창에서 사용하여 IronSecureDoc의 Docker 이미지를 가져오십시오:

docker pull ironsoftwareofficial/ironsecuredoc

docker pull ironsoftwareofficial/ironsecuredoc

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

이 명령은 IronSecureDoc의 컨테이너 인스턴스를 시작합니다. 이제 http://localhost:8080/swagger/index.html 포트에서 IronSecureDoc에 액세스할 수 있습니다.

HAProxy와 IronSecureDoc 통합

프론트엔드 및 백엔드 구성을 정의하기 위해 haproxy.cfg 파일을 준비하세요. 다음은 간단한 예제 구성입니다:

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

이 HAProxy 구성을 통해 여러 IronSecureDoc 서비스의 HTTP 트래픽을 처리합니다. 글로벌 원시 로그 출력을 정의하고 상세 로그와 함께 기본 HTTP 모드를 설정합니다. 프론트엔드는 포트 4500에서 수신 대기하고 경로에 따라 요청을 라우팅합니다. acl body_has_data는 데이터의 존재를 확인하고 필요에 따라 GET 요청을 POST로 변환합니다. 백엔드는 라운드 로빈 알고리즘을 사용하여 부하를 균형 있게 양질의 요청 전달을 보장하며 서버 가용성을 보장하기 위해 건강 상태 검사를 수행합니다.

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'

IronSecureDoc API에 대한 이 요청은 사용자 암호 암호화를 PDF 문서에 적용하며 출력 파일은 안전하게 전송 및 다운로드됩니다.