5.7.5. 라우터 환경 변수
이 섹션에 설명된 모든 항목에 대해 라우터의 배포 구성에 환경 변수를 설정하여 구성을 변경하거나 oc set env
명령을 사용할 수 있습니다.
$ oc set env <object_type>/<object_name> KEY1=VALUE1 KEY2=VALUE2
예를 들면 다음과 같습니다.
$ oc set env dc/router ROUTER_SYSLOG_ADDRESS=127.0.0.1 ROUTER_LOG_LEVEL=debug
Variable | Default | 설명 |
---|---|---|
| PEM 형식의 TLS 서버 인증서를 노출하지 않는 경로에 사용할 기본 인증서의 내용입니다. | |
|
tls.crt 라는 파일이 포함된 디렉터리의 경로입니다. tls.crt 가 개인 키가 포함된 PEM 파일이 아닌 경우 먼저 동일한 디렉터리에 tls.key라는 파일과 결합됩니다. 그런 다음 PEM-format 콘텐츠가 기본 인증서로 사용됩니다. | |
|
PEM 형식의 TLS 서버 인증서를 노출하지 않는 경로에 사용할 기본 인증서 경로입니다. | |
|
|
|
| 감시할 네임스페이스에 적용할 레이블 선택기는 모두 있음을 의미합니다. | |
| 조사할 프로젝트에 적용할 레이블 선택기이며, emtpy는 모두 를 의미합니다. | |
| 라우터를 다시 로드하는 데 사용할 다시 로드 스크립트의 경로입니다. | |
|
경로의 호스트 이름만 포함할 수 있는 쉼표로 구분된 도메인 목록입니다. 도메인의 모든 하위 도메인을 사용할 수 있습니다. | |
| 템플릿 기능 processEndpointsForAlias를 사용하는 동안 끝점을 처리하는 방법을 지정하는 문자열입니다. 유효한 값은 ["shuffle", ""]입니다. "shuffle"은 모든 호출 시 요소를 임의로 지정합니다. 기본 동작은 사전 결정된 순서로 반환됩니다. | |
|
|
|
| 내부적으로 생성된 기본 이름을 재정의하는 쿠키 이름을 지정합니다. 이름은 대문자와 소문자, 숫자, ‘_’, ‘-’의 조합으로 구성해야 합니다. 기본값은 경로의 해시된 내부 키 이름입니다. | |
| "text/html text/plain text/css" | 압축할 공백으로 구분된 MIME 유형 목록입니다. |
|
경로의 호스트 이름을 포함할 수 없는 쉼표로 구분된 도메인 목록입니다. 도메인의 하위 도메인도 사용할 수 없습니다. | |
|
| |
| 0.0.0.0:1936 | 라우터 지표에 대한 수신 대기 주소를 설정합니다. |
| 경고 | syslog 서버로 전송할 로그 수준입니다. |
| 20000 | 최대 동시 연결 수입니다. |
| 500 | |
|
CSV 형식으로 수집된 지표입니다. 예를 들어 | |
| 5s | |
| 5s | |
| haproxy | HAProxy 라우터에 대한 지표를 생성합니다(haproxy가 지원되는 유일한 값임) |
|
쉼표로 구분된 도메인 이름 목록입니다. 경로의 도메인 이름이 경로의 호스트와 일치하는 경우 호스트 이름은 무시되고 | |
|
| |
| 443 | HTTPS 요청을 수신 대기할 포트입니다. |
| 80 | HTTP 요청을 수신 대기할 포트입니다. |
| 공용 | 라우터가 경로 상태에서 식별하는 이름입니다. |
| 경로 상태에 표시된 라우터의 (선택 사항) 호스트 이름입니다. | |
|
라우터가 경로 상태에서 식별하는 네임스페이스입니다. | |
| 10443 | 백엔드 통신에 대한 일부 프런트 엔드의 내부 포트(아래 참조). |
| 10444 | 백엔드 통신에 대한 일부 프런트 엔드의 내부 포트(아래 참조). |
| spec.host 없이 경로에 대한 호스트 이름을 생성하는 데 사용해야 하는 템플릿(예: ${name}-${namespace}.myapps.mycompany.com). | |
| 로그 메시지를 보낼 주소입니다. 비어 있는 경우 비활성화됨. | |
| 설정된 경우 기본 라우터 구현에서 사용하는 기본 로그 형식을 재정의합니다. 해당 값은 기본 라우터 구현의 사양을 준수해야 합니다. | |
| 소스 |
부하 분산 전략. 패스쓰루(Pass-through) 경로를 위한 여러 엔드포인트의 경우. 사용 가능한 옵션은 |
| haproxy 라우터의 스레드 수를 지정합니다. | |
| leastconn |
여러 엔드포인트가 있는 경로의 경우 로드 밸런싱 전략입니다. 사용 가능한 옵션은 |
| 감시할 경로에 적용할 레이블 선택기는 모두 있음을 의미합니다. | |
| 라우터 구현에서 지원하는 경우 라우터 통계에 액세스하는 데 필요한 암호입니다. | |
| 통계를 노출하는 포트(라우터 구현에서 지원하는 경우). 설정되지 않으면 통계가 노출되지 않습니다. | |
| 라우터 구현에서 지원하는 경우 라우터 통계에 액세스해야 하는 사용자 이름. | |
|
| HAProxy 템플릿 파일(컨테이너 이미지)의 경로입니다. |
|
| |
|
| |
|
네임스페이스 소유권 정책을 완화하려면 | |
| ||
| 중간 | 바인딩에서 지원하는 암호 집합을 지정합니다. |
|
| |
| 3600 | 동적 구성 관리자의 변경 사항을 커밋하는 빈도를 지정합니다. 이로 인해 기본 템플릿 라우터 구현이 구성을 다시 로드합니다. |
| 동적 구성 관리자의 청사진 역할을 하는 경로가 포함된 네임스페이스로 설정합니다. 이를 통해 동적 구성 관리자는 사용자 지정 주석, 인증서 또는 구성 파일을 사용하여 사용자 지정 경로를 지원할 수 있습니다. | |
| 블루프린트 경로 네임스페이스의 경로에 적용하려면 레이블 선택기로 설정합니다. 이를 통해 동적 구성 관리자의 청사진 역할을 할 수 있는 네임스페이스에서 경로를 지정할 수 있습니다. | |
| 10 |
동적 구성 관리자가 관리하는 각 경로 청사진에 대해 사전 할당된 풀의 크기를 지정합니다. 이는 청사진 경로에서 |
| 5 | 동적 구성 관리자가 사용할 각 경로에 추가된 최대 동적 서버 수를 지정합니다. |
동일한 시스템에서 여러 라우터를 실행하려면 라우터가 수신 대기 중인 포트, ROUTER_SERVICE_ SNI_PORT 및
를 변경해야 합니다. 이 포트는 시스템에서 고유한 포트만 사용할 수 있습니다. 이러한 포트는 외부에 노출되지 않습니다.
ROUTER_SERVICE_
NO_SNI_PORT
라우터 시간 제한 변수
TimeUnits
는 다음과 같이 표시됩니다. us
*(마이크로초), ms
(밀리초, 기본값), s
(초), m
(분), h
*(시간), d
(일).
정규 표현식은 [1-9][0-9]*(us\|ms\|s\|m\|h\d)입니다.
| 5000ms | 백엔드의 후속 활성 검사 사이의 시간입니다. |
| 1s | 경로에 연결된 클라이언트의 TCP FIN 시간 제한 기간을 제어합니다. 지정된 시간 내에 연결을 닫기 위해 전송된 FIN이 응답하지 않으면 HAProxy가 연결을 종료합니다. 낮은 값으로 설정하면 문제가 없으며 라우터에서 더 적은 리소스를 사용합니다. |
| 30s | 클라이언트가 데이터를 승인하거나 보내야 하는 시간입니다. |
| 5s | 최대 연결 시간. |
| 1s | 라우터에서 경로를 지원하는 pod로의 TCP FIN 시간 초과를 제어합니다. |
| 30s | 서버에서 데이터를 승인하거나 보내야 하는 시간입니다. |
| 1h | TCP 또는 WebSocket 연결이 열린 상태로 유지되는 동안의 시간입니다. websockets/tcp 연결이 있고 HAProxy가 다시 로드될 때마다 이전 HAProxy 프로세스는 해당 기간 동안 유지됩니다. |
| 300s |
새 HTTP 요청이 표시될 때까지 대기할 최대 시간을 설정합니다. 이 값을 너무 낮게 설정하면 작은 |
| 10s | HTTP 요청 전송에 걸리는 시간입니다. |
| 5s | 새 변경 사항을 수락하도록 라우터를 다시 로드할 수 있는 최소 빈도입니다. |
| 5s | HAProxy 메트릭 수집에 대한 시간 제한입니다. |
일부 유효한 시간 제한 값은 예상되는 특정 시간 초과가 아니라 특정 변수의 합계일 수 있습니다.
예를 들면 다음과 같습니다. ROUTER_SLOWLORIS_HTTP_KEEPALIVE
는 시간 초과 http-keep-alive
를 조정하며 기본적으로 300s
로 설정되어 있지만 haproxy는 5s
로 설정된 tcp-request inspect-delay
도 대기합니다. 이 경우 전체 시간 초과는 300s
+ 5s
입니다.