우분투(Ubuntu) 환경에 HAProxy로 서브도메인(subdomain) 설정하기

이 포스트에서는 우분투(ubuntu) 환경에 HAProxy(haproxy)를 활용한 서브도메인(subdomain) 설정 방법을 소개합니다.

선행조건(PREREQUISITE)

ubuntu 환경에 haproxy가 설치되어 있어야 합니다.
방화벽 설정이 필요합니다.

ubuntu 설치 방법은 우분투(Ubuntu) 서버(Server) 16.04 설치하기 또는 우분투(Ubuntu) 서버(Server) 18.04 설치하기 포스트를 참고하시기 바랍니다.

haproxy 설치 방법은 우분투(Ubuntu) 환경에 패키지(Package)로 HAProxy 설치하기 포스트를 참고하시기 바랍니다.

방화벽 설정 방법은 우분투(Ubuntu) 환경에 방화벽(Firewalld) 설치 및 설정하기 포스트를 참고하시기 바랍니다.

테스트 환경(TEST ENVIRONMENT)

AWS EC2 instance
- Ubuntu Server 18.04 LTS (HVM), EBS General Purpose (SSD) Volume Type (64비트 Arm)
- m5.large (ECU, 2 vCPUs, 3.1 GHz, 8 GiB 메모리, EBS 전용)
Ubuntu 18.04.5 LTS (GNU/Linux 5.4.0-1043-aws x86_64)
haproxy 1.8.8

요약(SUMMARY)

(선택사항) haproxy 설치 확인
(선택사항) haproxy 설정 확인
haproxy subdomain 설정

내용(CONTENTS)

1. (선택사항) haproxy 설치 확인

# haproxy -v
HA-Proxy version 1.8.8-1ubuntu0.11 2020/06/22
Copyright 2000-2018 Willy Tarreau <willy@haproxy.org>

2. (선택사항) haproxy 설정 확인

# cat /etc/haproxy/haproxy.cfg
global
    log /dev/log    local0
    log /dev/log    local1 notice
    chroot /var/lib/haproxy
    stats socket /run/haproxy/admin.sock mode 660 level admin expose-fd listeners
    stats timeout 30s
    user haproxy
    group haproxy
    daemon

    # Default SSL material locations
    ca-base /etc/ssl/certs
    crt-base /etc/ssl/private

    # Default ciphers to use on SSL-enabled listening sockets.
    # For more information, see ciphers(1SSL). This list is from:
    #  https://hynek.me/articles/hardening-your-web-servers-ssl-ciphers/
    # An alternative list with additional directives can be obtained from
    #  https://mozilla.github.io/server-side-tls/ssl-config-generator/?server=haproxy
    ssl-default-bind-ciphers ECDH+AESGCM:DH+AESGCM:ECDH+AES256:DH+AES256:ECDH+AES128:DH+AES:RSA+AESGCM:RSA+AES:!aNULL:!MD5:!DSS
    ssl-default-bind-options no-sslv3

defaults
    log global
    mode    http
    option  httplog
    option  dontlognull
        timeout connect 5000
        timeout client  50000
        timeout server  50000
    errorfile 400 /etc/haproxy/errors/400.http
    errorfile 403 /etc/haproxy/errors/403.http
    errorfile 408 /etc/haproxy/errors/408.http
    errorfile 500 /etc/haproxy/errors/500.http
    errorfile 502 /etc/haproxy/errors/502.http
    errorfile 503 /etc/haproxy/errors/503.http
    errorfile 504 /etc/haproxy/errors/504.http

3. haproxy subdomain 설정

# vi /etc/haproxy/haproxy.cfg

global
        log /dev/log    local0
        log /dev/log    local1 notice
        chroot /var/lib/haproxy
        stats socket /run/haproxy/admin.sock mode 660 level admin expose-fd listeners
        stats timeout 30s
        user haproxy
        group haproxy
        daemon

        # Default SSL material locations
        ca-base /etc/ssl/certs
        crt-base /etc/ssl/private

        # Default ciphers to use on SSL-enabled listening sockets.
        # For more information, see ciphers(1SSL). This list is from:
        #  https://hynek.me/articles/hardening-your-web-servers-ssl-ciphers/
        # An alternative list with additional directives can be obtained from
        #  https://mozilla.github.io/server-side-tls/ssl-config-generator/?server=haproxy
        ssl-default-bind-ciphers ECDH+AESGCM:DH+AESGCM:ECDH+AES256:DH+AES256:ECDH+AES128:DH+AES:RSA+AESGCM:RSA+AES:!aNULL:!MD5:!DSS
        ssl-default-bind-options no-sslv3

defaults
        log     global
        mode    http
        option  httplog
        option  dontlognull

        # ADDED
        option http-server-close
        option forwardfor       except 127.0.0.0/8
        option                  redispatch
        retries                 3
        timeout http-request    10s
        timeout queue           1m
        timeout connect         10s # 5000
        timeout client          1m  # 50000
        timeout server          1m  # 50000
        timeout http-keep-alive 10s
        timeout check           10s
        maxconn                 3000

        errorfile 400 /etc/haproxy/errors/400.http
        errorfile 403 /etc/haproxy/errors/403.http
        errorfile 408 /etc/haproxy/errors/408.http
        errorfile 500 /etc/haproxy/errors/500.http
        errorfile 502 /etc/haproxy/errors/502.http
        errorfile 503 /etc/haproxy/errors/503.http
        errorfile 504 /etc/haproxy/errors/504.http

frontend http-rex
        bind :::80 v4v6   # bind *:80
        option        http-server-close
 
        acl domain_net_scm hdr(host) -i scm.rex-domain.net
        acl domain_net_ci hdr(host) -i ci.rex-domain.net
        acl domain_net_sonar hdr(host) -i sonar.rex-domain.net

        use_backend domain_net_app_scm        if domain_net_scm
        use_backend domain_net_app_ci        if domain_net_ci
        use_backend domain_net_app_sonar        if domain_net_sonar

backend domain_net_app_scm
        balance roundrobin
        server host1 10.0.10.6:8801
 
backend domain_net_app_ci
        balance roundrobin
        server host1 10.0.10.6:8802
 
backend domain_net_app_sonar
        balance roundrobin
        server host1 10.0.10.6:8803

3.1. global 섹션(section)

global section 설정은 우분투(Ubuntu) 환경에 HAProxy 설정하기 포스트를 참고하시기 바랍니다.

3.2. defaults section

아래 항목 외의 defaults section 설정은 우분투(Ubuntu) 환경에 HAProxy 설정하기 포스트를 참고하시기 바랍니다.

# ADDED
option http-server-close
option forwardfor       except 127.0.0.0/8
option                  redispatch
retries                 3
timeout http-request    10s
timeout queue           1m
timeout http-keep-alive 10s
timeout check           10s
maxconn                 3000

# MODIFIED
timeout connect         10s # 5000
timeout client          1m  # 50000
timeout server          1m  # 50000

3.2.1. ‘option http-server-close’

option http-server-close

클라이언트(client)에서 HTTP 연결(connection) 유지(keep-alive) 및 파이프 라이닝 기능을 유지하면서 서버(server)에서 HTTP connection을 닫을 수 있는 설정입니다.
이 설정은 client에서 가장 낮은 대기 시간(latency)을 제공하고 server에서 가장 빠른 세션(session) 재사용을 제공하여 리소스(resource)를 절약합니다.
“option” 앞에 “no” 키워드 추가로 설정을 비활성화 할 수 있습니다.

haproxy는 기본적으로 keep-alive 모드(mode)로 작동합니다.

3.2.2. ‘option forwardfor’

option forwardfor       except 127.0.0.0/8

server로 전송된 요청(request)에 “X-Forwarded-For” 헤더(header) 삽입에 대한 설정입니다.
“except” 키워드(keyword)를 적용하여 주소(address) 또는 네트워크(network)를 header에 추가하지 않을 수 있습니다.

haproxy는 리버스(reverse) 프락시(proxy) mode로 작동하므로, haproxy server는 해당(server 자신) IP address를 client address로 간주합니다.

3.2.3. ‘option redispatch’

option                  redispatch

connection 실패 시, session 재전송(redistribution)에 대한 설정입니다.
“option” 앞에 “no” 키워드 추가로 설정을 비활성화 할 수 있습니다.
frontend section에서는 사용할 수 없습니다.

3.2.4. ‘retries’

retries                 3

connection 실패 후, server에서 수행할 재시도 횟수 설정입니다.
이 설정은 전체 request가 아닌 connection 시도 횟수에 적용됩니다.
frontend section에서는 사용할 수 없습니다.

3.2.5. ‘timeout http-request’

timeout http-request    10s

전체 HTTP request를 대기할 최대 허용 시간 설정입니다.
이 설정을 활성화하면, client 유형(type)과 관계없이 request가 제시간에 완료되지 않으면 request는 중단됩니다.
이 설정에서 제한 시간이 만료(expire)되면, client에게 HTTP 408 응답(response)을 전송하고 connection을 닫습니다.

3.2.6. ‘timeout queue’

timeout queue           1m

queue에서 보류(pending) 중인 request의 제한 시간 설정입니다.
이 설정을 지정하지 않으면, “timeout connect” 설정과 같은 값을 적용합니다.
frontend section에서는 사용할 수 없습니다.

3.2.7. ‘timeout http-keep-alive’

timeout http-keep-alive 10s

새로운 HTTP request를 대기할 최대 허용 시간 설정입니다.
“keep-alive”의 새 request를 대기 시간은 “timeout http-request”로 설정합니다.

3.2.8. ‘timeout check’

timeout check           10s

“timeout check” 설정은 “timeout connect” 설정의 최대 허용 연결 시간을 사용한 후, “timeout check” 설정을 추가로 최대 허용 읽기 시간으로 적용합니다.
이 설정을 지정하지 않으면, “timeout connect” 설정으로 적용합니다.
frontend section에서는 사용할 수 없습니다.

3.2.9. ‘maxconn’

maxconn                 3000

frontend의 최대 동시 connection 수를 설정합니다.
기본값은 2,000이며, global maxconn을 초과하지 않아야 합니다.
backend section에서는 사용할 수 없습니다.

3.2.10. ‘timeout’

timeout connect         10s # 5000
timeout client          1m  # 50000
timeout server          1m  # 50000

위 설정은 우분투(Ubuntu) 환경에 HAProxy 설정하기 포스트를 참고하시기 바랍니다.

3.3. frontend section

3.3.1. ‘frontend’

frontend http-rex

“frontend section”은 client connection에 대한 IP address와 포트(port)를 설정합니다.
“http-rex”는 frontend 이름(name)입니다.
필요에 따라 “frontend section”을 추가 할 수 있으며, “frontend” 키워드 뒤에 name을 설정하여 구분할 수 있습니다.

모든 proxy section name은 대소문자, 숫자, “-“(대시), “_“(밑줄), “.”(점), “:”(콜론)으로 구성되어야 합니다.

3.3.2. ‘bind’

bind :::80 v4v6   # bind *:80

”:::80”은 frontend가 수신할 address 설정이며, 선택 사항입니다.
address 값은 호스트 name, IPv4 address, IPv6 address, “*“로 설정할 수 있으며, 미설정 시 IPv4 address가 수신됩니다.
“v4v6”는 기본 address 사용 시 IPv4 및 IPv6 모두 socket에 바인딩(bind)하는 설정이며, 리눅스(linux) 커널(kernel) 2.4.21 이상에서 지원합니다.
defaults section과 backend section에서는 사용할 수 없습니다.

3.3.3. ‘acl’

acl domain_net_scm hdr(host) -i scm.rex-domain.net
acl domain_net_ci hdr(host) -i ci.rex-domain.net
acl domain_net_sonar hdr(host) -i sonar.rex-domain.net

“acl”은 액세스 제어 목록(access control lists)을 의미하며. 데이터(data) 샘플(sample)의 패턴(pattern) 일치 여부에 따라 작업을 수행합니다.
- data sample은 request 또는 response, client 또는 server 정보 등에서 추출합니다.
“acl”은 일반적으로 request 차단(block), backend 선택 또는 header 추가로 구성됩니다.
“domain_net_scm”, “domain_net_ci”, “domain_net_sonar”는 acl name입니다.
- acl name은 대소문자, 숫자, “-“(대시), “_“(밑줄), “.”(점), “:”(콜론)으로 구성되며, 대소문자를 구분합니다.
“hdr(host)”의 “hdr”은 header를 의미하며, “host”는 header가 포함된 HTTP request를 수락하는 설정입니다.
“-i”는 acl flag이며, 대소문자를 무시하는 설정입니다.
- acl flag는 “-f”, “-m”, “-n” 등이 있습니다.
“scm.rex-domain.net”, “ci.rex-domain.net”, “sonar.rex-domain.net”은 acl 값(value)입니다.

3.3.4. ‘use_backend’

use_backend domain_net_app_scm        if domain_net_scm
use_backend domain_net_app_ci        if domain_net_ci
use_backend domain_net_app_sonar        if domain_net_sonar

“use_backend”는 acl 기반 조건(condition) 일치 시, 특정 backend로 전환하는 설정입니다.
“domain_net_app_scm”, “domain_net_app_ci”, “domain_net_app_sonar”는 backend name 또는 listen section name입니다.
“if domain_net_scm”, “if domain_net_ci”, “if domain_net_sonar”는 backend의 condition이며, “if” 뒤의 value는 acl name입니다.
- condition은 “if” 또는 “unless”를 사용할 수 있습니다.
backend section에서는 사용할 수 없습니다.

3.4. backend section

3.4.1. ‘backend’

backend domain_net_app_scm
...
backend domain_net_app_ci
...
backend domain_net_app_sonar
...

“backend section”은 들어오는 connection 전달을 위해 proxy가 연결할 server에 대한 설정입니다.
“domain_net_app_scm”, “domain_net_app_ci”, “domain_net_app_sonar”는 backend name입니다.
필요에 따라 “backend section”을 추가 할 수 있으며, backend 키워드 뒤에 name을 설정하여 구분할 수 있습니다.

3.4.2. ‘balance’

balance roundrobin

“balance”는 로드 밸런싱(load balancing) 알고리즘(algorithm) 설정입니다.
위 설정은 roundrobin algorithm을 지정합니다.
사용 가능한 algorithm은 “roundrobin”, static-rr”, “leastconn”, “first” 등이 있습니다.
frontend section에서는 사용할 수 없습니다.

3.4.3. ‘server’

...
server host1 10.0.10.6:8801
...
server host1 10.0.10.6:8802
...
server host1 10.0.10.6:8803

“server”는 backend의 server 설정입니다.
“host1”은 내부(internal) name이며, 로그(log) 및 경고(alert)에 표시됩니다.
“10.0.10.6:8801”, “10.0.10.6:8802”, “10.0.10.6:8803”의 “10.0.10.6”은 server의 IPv4 또는 IPv6 address입니다.
- “0.0.0.0” 또는 “*” 설정 시, client connection IP address와 동일한 IP address로 전달되며, 이는 투명(transparent) proxy 아키텍처(architecture)에 유용합니다.
“10.0.10.6:8801”, “10.0.10.6:8802”, “10.0.10.6:8803”의 “8801”, “8802”, “8803”은 port 정보이며 선택사항입니다.
- port 설정 시, 모든 connection은 해당 port로 전송됩니다.
- port 미설정 시, client가 연결된 port로 전송됩니다.
frontend section에서는 사용할 수 없습니다.

transparent proxy란 client가 server에 request 시, transparent proxy가 request를 가로채서 캐싱(caching), 리디렉션(redirection) 및 인증(authentication) 등 다양한 작업을 수행하여 client 모니터링(monitoring) 또는 특정 server에 대한 access block 등을 설정할 수 있는 proxy입니다.

마무리(CONCLUSION)

ubuntu 환경에 haproxy를 활용한 subdomain 설정을 완료했습니다.

haproxy 설정에 대한 더 자세한 내용은 아래 참고 페이지를 확인해 주시기 바랍니다.

참고(REFERENCES)

https://cbonte.github.io/haproxy-dconv/1.8/configuration.html

Share on

Twitter Facebook LinkedIn

우분투(Ubuntu) 환경에 HAProxy로 서브도메인(subdomain) 설정하기

선행조건(PREREQUISITE)

테스트 환경(TEST ENVIRONMENT)

요약(SUMMARY)

내용(CONTENTS)

1. (선택사항) haproxy 설치 확인

2. (선택사항) haproxy 설정 확인

3. haproxy subdomain 설정

3.1. global 섹션(section)

3.2. defaults section

3.2.1. ‘option http-server-close’

3.2.2. ‘option forwardfor’

3.2.3. ‘option redispatch’

3.2.4. ‘retries’

3.2.5. ‘timeout http-request’

3.2.6. ‘timeout queue’

3.2.7. ‘timeout http-keep-alive’

3.2.8. ‘timeout check’

3.2.9. ‘maxconn’

3.2.10. ‘timeout’

3.3. frontend section

3.3.1. ‘frontend’

3.3.2. ‘bind’

3.3.3. ‘acl’

3.3.4. ‘use_backend’

3.4. backend section

3.4.1. ‘backend’

3.4.2. ‘balance’

3.4.3. ‘server’

마무리(CONCLUSION)

참고(REFERENCES)

Share on

Leave a comment

You may also enjoy

우분투(Ubuntu) 환경에 AWS CLI 버전 2 설치하기

Java StringUtils(org.apache.commons.lang3) 소개

Java HttpSession(javax.Servlet.Http) 소개

MySQL 개행 문자(newline character) 치환(replace)하기