Traefik 구성 문서
본문
구성 소개
마법이 일어나는 방식
Traefik에서 "구성"이라고 하면 두 가지를 가리킬 수 있어요:
-
설치(시작) 구성 (예전에는 정적 구성이라고 불렀어요)
-
라우팅 구성 (예전에는 동적 구성이라고 불렀어요)
설치 구성에 들어 있는 요소들은 프로바이더와의 연결을 세우고 Traefik이 들을 엔트리포인트를 정의해요 (이 요소들은 자주 바뀌지 않죠).
라우팅 구성은 요청을 시스템이 어떻게 처리할지 정의하는 모든 것을 담아요. 이 구성은 바뀔 수 있고, 요청 중단이나 연결 손실 없이 매끄럽게 핫-리로드됩니다.
호환되지 않는 구성
참고로, Traefik v1.x의 옛 구성은 현재 v2.x 구성과 호환되지 않아요. v2를 실행 중이라면 반드시 v2 구성을 쓰고 있는지 확인하세요.
라우팅 구성
Traefik은 라우팅 구성을 프로바이더에게서 받아요. 오케스트레이터든, 서비스 레지스트리든, 평범한 옛 구성 파일이든 상관없죠.
이 구성은 여러분의 인프라 선택에 따라 달라지기 때문에, 이 문서의 전용 섹션을 참고하시길 권합니다.
빠른 시작 예시에서는 whoami 애플리케이션의 라우팅 구성이 whoami 컨테이너에 붙은 레이블 형태로 docker에게서 옵니다.
HTTPS 인증서도 라우팅 구성에 속해요. Traefik 인스턴스를 재시작할 필요 없이 추가/갱신/제거할 수 있습니다.
설치 구성
Traefik에서 설치 구성 옵션을 정의하는 방법은 세 가지가 있어요. 셋은 서로 배타적이라서(즉, 동시에 하나만 쓸 수 있어요):
-
구성 파일에서
-
명령줄 인자에서
-
환경 변수로
이 세 방식은 위에 나열된 순서대로 평가돼요.
어떤 옵션에 값이 주어지지 않으면 기본값이 적용됩니다. 게다가 어떤 옵션에 하위 옵션이 있고 그 하위 옵션 중 어느 것도 지정되지 않았다면 기본값이 적용되기도 해요.
예를 들어 --providers.docker 옵션은 --providers.docker.endpoint 같은 하위 옵션이 있음에도 그 자체만으로 Docker 프로바이더를 활성화하기에 충분해요.
이 옵션이 놓이면 --providers.docker의 하위 옵션 기본값들을 (재)설정해 줍니다.
구성 파일
시작 시에 Traefik은 traefik.yml(또는 traefik.yaml이나 traefik.toml)이라는 이름의 파일에서 설치 구성을 찾아요. 다음 위치에서요:
-
/etc/traefik/
-
$XDG_CONFIG_HOME/
-
$HOME/.config/
-
. (현재 작업 디렉터리).
configFile 인자로 이걸 덮어쓸 수 있어요.
traefik --configFile=foo/bar/myconfigfile.yml
인자
사용 가능한 모든 인자 목록을 보려면:
traefik --help
# or
docker run traefik[:version] --help
# ex: docker run traefik:v3.7 --help
사용 가능한 모든 인자에 대한 개요는 CLI 참조를 확인하세요.
환경 변수
사용 가능한 모든 환경 변수는 설치 구성 환경 개요에서 찾을 수 있어요.
사용 가능한 구성 옵션
모든 구성 옵션은 각각의 관련 섹션에 문서화돼 있어요. 메뉴에서 사용 가능한 기능, 프로바이더, 또는 라우팅 섹션을 둘러보며 직접 확인할 수 있습니다.
프로덕션에서 Traefik OSS를 쓰고 있나요?
직장에서 Traefik을 쓰고 있다면, 엔터프라이즈급 API 게이트웨이 기능이나 Traefik OSS용 상업 지원을 추가하는 걸 고려해 보세요.
-
API Gateway 데모 영상 보기
-
24/7/365 OSS 지원 요청하기
Traefik OSS에 API 게이트웨이 기능을 더하는 건 빠르고 매끄러워요. 갈아엎을 필요도 없고 모든 구성이 그대로 유지됩니다. 짧은 영상으로 직접 확인해 보세요.