Traefik과 Docker를 활용한 개발 환경 구축

2024년 5월 10일 · 6 min read

개발 환경에서는 다양한 서비스가 실행되고, 이러한 서비스들이 서로 연결되거나 외부와 통신해야 하는 경우가 많습니다.

Traefik은 Docker 기반 개발 환경에서 역방향 프록시 및 로드 밸런서로 뛰어난 유연성과 편리함을 제공합니다. 특히 HTTPS 설정과 동적 라우팅 측면에서 많은 장점을 제공하여 개발자들의 시간과 노력을 크게 절약할 수 있습니다.

이 글에서는 Traefik과 Docker를 결합해 개발 환경에서 어떤 이점을 누릴 수 있는지, 그리고 이를 효과적으로 설정하고 사용하는 방법을 심도 있게 다뤄보겠습니다.

Traefik이란 무엇인가? #

Traefik은 클라우드 네이티브 애플리케이션을 위한 오픈소스 역방향 프록시 및 로드 밸런서입니다. Docker, Kubernetes, Consul과 같은 다양한 제공자(provider)와 통합할 수 있으며, 동적 라우팅, HTTPS, 자동화된 설정 등 강력한 기능을 제공합니다. 특히 Docker와의 긴밀한 연계성은 개발 환경에서 Traefik을 선택하는 가장 큰 이유 중 하나입니다.

주요 기능

동적 라우팅: Docker 컨테이너의 레이블을 기반으로 자동으로 라우팅을 설정합니다.
HTTPS 자동화: Let’s Encrypt 통합으로 인증서를 자동 발급 및 갱신합니다.
다중 프로토콜 지원: HTTP, HTTPS, TCP, UDP 등 다양한 네트워크 프로토콜을 처리할 수 있습니다.
사용자 친화적 대시보드: 실시간 상태와 트래픽을 시각적으로 확인할 수 있습니다.

Traefik과 Docker를 함께 사용하는 이유 #

Docker 기반 개발 환경에서는 애플리케이션과 서비스를 컨테이너로 분리하여 운영합니다. 이 과정에서 서비스 간 통신과 외부 트래픽 관리가 필수적으로 요구됩니다. Traefik은 이러한 요구를 간단하고 효율적으로 처리할 수 있는 도구입니다.

동적 라우팅으로 설정 간소화

Traefik은 Docker 컨테이너의 **레이블(label)**을 읽어 자동으로 라우팅 규칙을 생성합니다. 즉, 추가적인 설정 파일 없이 컨테이너의 메타데이터만으로 HTTP 요청을 처리할 수 있습니다. 새로운 서비스가 추가되거나 기존 서비스가 삭제될 때도 Traefik은 이를 자동으로 감지하여 라우팅 구성을 갱신합니다.

HTTPS 설정의 간편화

HTTPS는 오늘날 보안 통신의 기본 요소로 자리 잡았지만, 인증서를 설정하고 관리하는 것은 여전히 번거로운 작업입니다. Traefik은 Let’s Encrypt와의 통합을 통해 ACME 프로토콜을 지원하며, 인증서를 자동으로 발급 및 갱신합니다. 개발자는 HTTPS를 설정하기 위해 별도의 작업을 할 필요 없이, Traefik 설정 파일에 몇 줄의 옵션만 추가하면 됩니다.

로컬 환경에서도 실서비스와 유사한 구성

Traefik은 개발 환경에서도 HTTPS를 적용하고, 외부 도메인을 통해 서비스에 접근할 수 있는 환경을 제공합니다. 이를 통해 개발 환경과 프로덕션 환경의 차이를 최소화할 수 있습니다.

컨테이너 간 손쉬운 서비스 연결

Docker 네트워크 내에서 실행되는 여러 컨테이너가 있을 때, Traefik은 각 컨테이너에 고유한 도메인 또는 서브도메인을 연결해 줍니다. 예를 들어, api.localhost와 web.localhost 같은 방식으로 각 서비스를 구분하고 접근할 수 있습니다.

Traefik과 Docker를 설정하는 방법 #

Traefik을 Docker Compose와 함께 사용하는 예제를 통해 설정 과정을 살펴보겠습니다.

기본 설정

Traefik을 사용하려면 Docker Compose 파일에 Traefik 서비스와 원하는 애플리케이션 서비스를 정의해야 합니다. 아래는 간단한 설정 예제입니다.

version: "3.8"

services:
  traefik:
    image: traefik:v2.10
    container_name: traefik
    command:
      - "--api.insecure=true"
      - "--providers.docker=true"
      - "--entrypoints.web.address=:80"
      - "--entrypoints.websecure.address=:443"
      - "--certificatesresolvers.myresolver.acme.tlschallenge=true"
      - "[email protected]"
      - "--certificatesresolvers.myresolver.acme.storage=/letsencrypt/acme.json"
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - "/var/run/docker.sock:/var/run/docker.sock:ro"
      - "./letsencrypt:/letsencrypt"

  web:
    image: nginx
    container_name: nginx
    labels:
      - "traefik.http.routers.web.rule=Host(`web.localhost`)"
      - "traefik.http.routers.web.entrypoints=web"

주요 구성 요소

providers.docker=true: Docker 컨테이너를 Traefik의 동적 설정 제공자로 사용합니다.
certificatesresolvers: Let’s Encrypt를 통한 HTTPS 인증서 발급 및 관리 설정입니다.
레이블(Label): Nginx 컨테이너에 Traefik 라우터 설정을 추가합니다.

HTTPS 설정 추가

위 예제에서는 Let’s Encrypt를 활용해 HTTPS 인증서를 자동으로 관리하도록 구성했습니다. 아래는 HTTPS와 관련된 주요 설정 옵션입니다.

TLSChallenge: HTTP가 아닌 DNS를 통해 인증서를 발급합니다.
ACME 스토리지: 발급된 인증서를 저장하는 위치를 지정합니다. 여기에서는 ./letsencrypt/acme.json 경로를 사용합니다.

HTTPS 설정을 완료하면, https://web.localhost로 서비스에 접근할 수 있습니다.

로컬 환경에서 도메인 설정

Traefik을 로컬에서 사용할 때, /etc/hosts 파일을 수정해 도메인을 매핑해야 합니다.

127.0.0.1 web.localhost
127.0.0.1 api.localhost

이 설정을 통해 web.localhost와 api.localhost로 Traefik을 통해 접근할 수 있습니다.

Traefik 대시보드 활성화

Traefik은 기본적으로 대시보드 기능을 제공합니다. 위 설정에서는 --api.insecure=true 옵션을 사용해 로컬 환경에서 대시보드를 활성화했습니다. 브라우저에서 http://localhost:8080/dashboard에 접속하면 Traefik의 대시보드를 확인할 수 있습니다.

Traefik의 장점 #

자동화된 서비스 관리

Traefik은 새로운 서비스가 추가되거나 기존 서비스가 제거될 때 이를 자동으로 감지하고 라우팅을 업데이트합니다. 이를 통해 서비스 변경 사항을 수동으로 관리하는 번거로움을 줄이고, 개발 및 운영 환경에서 높은 유연성을 제공합니다.

간단한 HTTPS 설정

Let’s Encrypt와의 통합으로 HTTPS 인증서를 자동으로 발급 및 갱신하며, 설정도 간단합니다. 이를 통해 개발 환경에서도 HTTPS를 손쉽게 활성화할 수 있으며, 안전한 통신이 보장됩니다.

일관된 네트워크 구성

Traefik은 서비스 이름과 도메인 이름 간의 매핑을 간단하게 설정할 수 있습니다. 이는 복잡한 네트워크 구성을 단순화하며, 로컬 환경에서도 프로덕션 환경과 유사한 구성을 유지할 수 있어 배포 전에 문제를 미리 확인할 수 있습니다.

실시간 상태 확인

Traefik의 대시보드는 서비스 상태, 라우팅 규칙, 트래픽 데이터를 시각적으로 확인할 수 있는 강력한 도구를 제공합니다. 이를 통해 트래픽 흐름과 서비스 상태를 실시간으로 모니터링하고, 문제를 신속히 파악하고 해결할 수 있습니다.

주의할 점 #

단순한 환경에서는 과도할 수 있음

Traefik은 고도로 동적인 환경에서 빛을 발하지만, 소규모 프로젝트나 단일 서비스에는 Nginx나 Apache와 같은 더 단순한 대안이 적합할 수 있습니다. 필요 이상의 복잡성을 도입하지 않도록 환경에 맞는 도구를 선택하는 것이 중요합니다.

초기 학습 곡선

Traefik의 설정 방식과 동작 원리는 기존의 정적 웹 서버와 다른 부분이 많아, 처음 사용하는 개발자에게는 익숙해지기까지 시간이 걸릴 수 있습니다. 특히 복잡한 라우팅 규칙이나 TLS 설정 등을 처음부터 완벽히 이해하려면 추가 학습이 필요할 수 있습니다.

리소스 사용량

Traefik은 다양한 기능을 제공하는 만큼 기본적으로 더 많은 리소스를 사용할 수 있습니다. 메모리 및 CPU 사용량을 고려하여 인프라 자원이 충분한지 확인해야 합니다.

결론 #

Traefik은 Docker 기반 개발 환경에서 HTTPS, 동적 라우팅, 간편한 설정 등 강력한 기능을 제공합니다. 이를 통해 개발자는 더 적은 시간과 노력으로 복잡한 네트워크 구성을 관리하고, 안정적이고 효율적인 개발 환경을 구축할 수 있습니다. Traefik을 적절히 활용하면, 개발 환경이 프로덕션 환경에 더 가까워지고, 개발-디버깅-배포 간의 격차를 줄일 수 있습니다.

Traefik을 활용해 개발 환경의 생산성을 높여보세요!