Traefik Consul 문서
Traefik Consul 문서 (Traefik Consul Documentation)
본문
Traefik & Consul
구성 예시 (Configuration Example)
아래에서 설명하는 것처럼 Consul 프로바이더를 활성화할 수 있어요.
File (YAML)
providers:
consul: {}
File (TOML)
[providers.consul]
CLI
--providers.consul=true
구성 옵션 (Configuration Options)
| Field | Description | Default | Required |
| providers.providersThrottleDuration | 구성 리로드 이후, 새로운 구성 갱신 이벤트를 반영하기까지 기다리는 최소 시간. 이 시간 안에 여러 이벤트가 발생하면 가장 최근 이벤트 하나만 반영되고 나머지는 모두 버려져요. 이 옵션은 프로바이더별로 설정할 수 없지만, 스로틀링 알고리즘은 각 프로바이더에 독립적으로 적용됩니다. | 2s | No |
| providers.consul.endpoints | Consul에 접근하기 위한 엔드포인트를 정의해요. | "127.0.0.1:8500" | yes |
| providers.consul.rootKey | 구성의 루트 키를 정의해요. | "traefik" | yes |
| providers.consul.namespaces | 쿼리할 네임스페이스를 정의해요. 자세한 내용은 여기를 참고하세요. | "" | no |
| providers.consul.token | Consul에 연결할 때 사용할 토큰을 정의해요. | "" | no |
| providers.consul.tls | Consul과의 보안 연결에 사용되는 TLS 구성을 정의해요. | - | No |
| providers.consul.tls.ca | Consul과의 보안 연결에 사용되는 인증 기관(CA)의 경로를 정의해요. 기본값은 시스템 번들(system bundle)이에요. | - | Yes |
| providers.consul.tls.cert | Consul과의 보안 연결에 사용되는 공개 인증서의 경로를 정의해요. 이 옵션을 사용하려면 key 옵션도 설정해야 해요. | - | Yes |
| providers.consul.tls.key | Consul과의 보안 연결에 사용되는 개인 키의 경로를 정의해요. 이 옵션을 사용하려면 cert 옵션도 설정해야 해요. | - | Yes |
| providers.consul.tls.insecureSkipVerify | TLS 연결을 수립할 때 인증서가 커버하는 호스트 이름과 무관하게, Consul이 제시하는 어떤 인증서든 수락하도록 프로바이더에 지시해요. | false | No |
namespaces
namespaces 옵션은 쿼리할 네임스페이스를 정의해요. namespaces 옵션을 사용하면 발견된 구성 객체 이름이 아래와 같이 접미사로 붙게 됩니다.
<resource-name>@consul-<namespace>
경고 (Warning)
namespaces 옵션은 네임스페이스 기능을 제공하는 Consul Enterprise에서만 동작해요.
경고 (Warning)
namespaces 옵션과 namespace 옵션 중 하나만 정의해야 해요.
File (YAML)
providers:
consul:
namespaces:
- "ns1"
- "ns2"
# ...
File (TOML)
[providers.consul]
namespaces = ["ns1", "ns2"]
# ...
CLI
--providers.consul.namespaces=ns1,ns2
# ...
라우팅 구성 (Routing Configuration)
라우팅(routing) 문서의 전용 섹션을 참고하세요.