21장. Route [route.openshift.io/v1]

alternateBackends

array

alternateBackends를 사용하면 경로에 최대 3개의 추가 백엔드를 할당할 수 있습니다. 서비스 유형만 허용되며 기본적으로 서비스합니다. RouteTargetReference 오브젝트의 weight 필드를 사용하여 상대 기본 설정을 지정합니다.

alternateBackends[]

object

RouteTargetReference는 끝점으로 확인되는 대상을 지정합니다. '서비스' 유형만 허용됩니다. 'weight' 필드를 사용하여 다른 필드보다 강조하십시오.

host

string

host는 서비스를 가리키는 별칭/DNS입니다. 선택 사항입니다. 지정하지 않으면 일반적으로 경로 이름이 자동으로 선택됩니다. DNS952 하위 도메인 규칙을 따라야 합니다.

httpHeaders

object

RouteHTTPHeaders는 HTTP 헤더에 대한 정책을 정의합니다.

path

string

라우터가 감시하는 경로를 통해 서비스에 대한 트래픽을 라우팅합니다. 선택 사항

port

object

RoutePort는 라우터에서 서비스 끝점의 엔드포인트로 포트 매핑을 정의합니다.

subdomain

string

하위 도메인은 Ingress 컨트롤러의 도메인(도메인) 내에서 요청된 DNS 하위 도메인입니다. host가 설정된 경우 이 필드는 무시됩니다. 수신 컨트롤러는 제안된 이름을 무시하도록 선택할 수 있습니다. 이 경우 컨트롤러는 status.ingress 배열에서 할당된 이름을 보고하거나 경로를 허용하지 않습니다. 이 값이 설정되고 서버가 이 필드 호스트를 지원하지 않으면 자동으로 채워집니다. 그렇지 않으면 호스트는 비어 있습니다. 이 필드에는 점으로 구분된 여러 부분이 있을 수 있지만 모든 Ingress 컨트롤러가 요청을 이행할 수 있는 것은 아닙니다. 이 필드는 업데이트 경로/사용자 정의 호스트 권한이 있는 사용자를 제외하고 생성 후 변경할 수 없습니다.

예: 하위 도메인 프런트 엔드는 전체 호스트 이름 frontend. apps.mycluster.com 을 갖도록 라우터 하위 도메인 apps.mycluster.com 을 자동으로 수신합니다.

tls

object

tlsConfig는 경로를 보호하고 종료를 제공하는 데 사용되는 구성을 정의합니다.

다음으로 변경

object

RouteTargetReference는 끝점으로 확인되는 대상을 지정합니다. '서비스' 유형만 허용됩니다. 'weight' 필드를 사용하여 다른 필드보다 강조하십시오.

wildcardPolicy

string

경로에 대한 와일드카드 정책(있는 경우). 현재 'Subdomain' 또는 '없음'만 허용됩니다.

kind

string

경로가 참조하는 대상의 유형입니다. 현재 '서비스'만 허용됩니다.

name

string

참조되는 서비스/대상의 이름(예: 서비스 이름)

weight

integer

weight는 다른 대상 참조 오브젝트에 대한 대상의 상대적 가중치를 지정하는 0에서 256, default 100 사이의 정수입니다. 0은 이 백엔드에 대한 요청을 비활성화합니다.

작업

object

RouteHTTPHeaderActions는 HTTP 요청 및 응답 헤더에 대한 작업에 대한 구성을 정의합니다.

요청

array

request는 수정할 HTTP 요청 헤더 목록입니다. 현재는 작업이 헤더 값 설정 또는 삭제 로 정의할 수 있습니다. 여기에 정의된 작업은 경로를 통해 수행된 모든 요청의 요청 헤더를 수정합니다. 이러한 작업은 경로를 통해 이루어진 연결, 즉 클러스터 내에 정의된 특정 경로에 적용됩니다. 현재는 작업이 헤더 값 설정 또는 삭제 로 정의할 수 있습니다. 요청 헤더에 대한 IngressController 작업 후에 경로 작업이 실행됩니다. 작업은 이 목록에 정의된 대로 순서대로 적용됩니다. 최대 20개의 요청 헤더 작업이 구성될 수 있습니다. 이 필드를 사용하여 클라이언트에서 애플리케이션으로 연결을 전달할 때 설정하거나 삭제해야 하는 HTTP 요청 헤더를 지정할 수 있습니다. 허용되는 샘플 페너는 "req.hdr" 및 "ssl_c_der"입니다. 허용되는 변환기는 "낮은" 및 "base64"입니다. 헤더 값의 예: "%[req.hdr(X-target),lower]", "%{+Q}[ssl_c_der,base64]". 이 API를 사용하여 경로 리소스를 통해 직접 적용되는 요청 헤더 구성은 IngressController 또는 경로 주석의 spec.httpHeaders.actions를 통해 적용된 동일한 이름의 헤더에 대한 헤더 구성을 재정의합니다. 참고: 이 필드는 라우팅에서 TLS 패스스루를 사용하는 경우 사용할 수 없습니다.

request[]

object

RouteHTTPHeader는 HTTP 헤더를 설정하거나 삭제하기 위한 구성을 지정합니다.

응답

array

response는 수정할 HTTP 응답 헤더 목록입니다. 현재는 작업이 헤더 값 설정 또는 삭제 로 정의할 수 있습니다. 여기에서 정의된 작업은 경로를 통해 수행된 모든 요청의 응답 헤더를 수정합니다. 이러한 작업은 경로를 통해 이루어진 연결, 즉 클러스터 내에 정의된 특정 경로에 적용됩니다. 응답 헤더에 대한 IngressController 작업 전에 경로 작업이 실행됩니다. 작업은 이 목록에 정의된 대로 순서대로 적용됩니다. 최대 20개의 응답 헤더 작업이 구성될 수 있습니다. 이 필드를 사용하여 애플리케이션에서 클라이언트로 응답을 전달할 때 설정하거나 삭제해야 하는 HTTP 응답 헤더를 지정할 수 있습니다. 허용되는 샘플 페너는 "res.hdr" 및 "ssl_c_der"입니다. 허용되는 변환기는 "낮은" 및 "base64"입니다. 헤더 값의 예: "%[res.hdr(X-target),lower]", "%{+Q}[ssl_c_der,base64]". 참고: 이 필드는 라우팅에서 TLS 패스스루를 사용하는 경우 사용할 수 없습니다.

response[]

object

RouteHTTPHeader는 HTTP 헤더를 설정하거나 삭제하기 위한 구성을 지정합니다.

작업

object

RouteHTTPHeaderActionUnion은 HTTP 헤더에서 수행할 작업을 지정합니다.

name

string

name은 작업을 수행할 헤더의 이름을 지정합니다. 해당 값은 RFC 2616 섹션 4.2에 정의된 대로 유효한 HTTP 헤더 이름이어야 합니다. 이름은 영숫자 및 다음 특수 문자 "-!#$%&'*+.^_'"로만 구성되어야 합니다. 다음 헤더 이름은 예약되어 있으며 이 API를 통해 수정할 수 없습니다: Strict-Transport-Security, Proxy, Settings, Set-Cookie. 길이가 255자 이하여야 합니다. 헤더 이름은 고유해야 합니다.

set

object

RouteSetHTTPHeader는 HTTP 헤더에 설정해야 하는 값을 지정합니다.

type

string

type은 헤더에 적용할 작업의 유형을 정의합니다. 가능한 값은 설정 또는 삭제입니다. set을 사용하면 HTTP 요청 및 응답 헤더를 설정할 수 있습니다. delete를 사용하면 HTTP 요청 및 응답 헤더를 삭제할 수 있습니다.

value

string

value는 헤더 값을 지정합니다. 동적 값을 추가할 수 있습니다. 값은 http://cbonte.github.io/haproxy-dconv/2.6/configuration.html#8.2.6 에 정의된 HAProxy 형식 문자열로 해석되며 HAProxy의 %[] 구문을 사용할 수 있으며 그렇지 않으면 https://datatracker.ietf.org/doc/html/rfc7230#section-3.2 에 정의된 유효한 HTTP 헤더 값이어야 합니다. 이 필드의 값은 길이가 16384자 이하여야 합니다. 동적 값을 보간 후 모든 net add 헤더의 총 크기는 IngressController의 spec.tuningOptions.headerBufferMaxRewriteBytes 값을 초과해서는 안 됩니다.

작업

object

RouteHTTPHeaderActionUnion은 HTTP 헤더에서 수행할 작업을 지정합니다.

name

string

name은 작업을 수행할 헤더의 이름을 지정합니다. 해당 값은 RFC 2616 섹션 4.2에 정의된 대로 유효한 HTTP 헤더 이름이어야 합니다. 이름은 영숫자 및 다음 특수 문자 "-!#$%&'*+.^_'"로만 구성되어야 합니다. 다음 헤더 이름은 예약되어 있으며 이 API를 통해 수정할 수 없습니다: Strict-Transport-Security, Proxy, Settings, Set-Cookie. 길이가 255자 이하여야 합니다. 헤더 이름은 고유해야 합니다.

set

object

RouteSetHTTPHeader는 HTTP 헤더에 설정해야 하는 값을 지정합니다.

type

string

type은 헤더에 적용할 작업의 유형을 정의합니다. 가능한 값은 설정 또는 삭제입니다. set을 사용하면 HTTP 요청 및 응답 헤더를 설정할 수 있습니다. delete를 사용하면 HTTP 요청 및 응답 헤더를 삭제할 수 있습니다.

value

string

value는 헤더 값을 지정합니다. 동적 값을 추가할 수 있습니다. 값은 http://cbonte.github.io/haproxy-dconv/2.6/configuration.html#8.2.6 에 정의된 HAProxy 형식 문자열로 해석되며 HAProxy의 %[] 구문을 사용할 수 있으며 그렇지 않으면 https://datatracker.ietf.org/doc/html/rfc7230#section-3.2 에 정의된 유효한 HTTP 헤더 값이어야 합니다. 이 필드의 값은 길이가 16384자 이하여야 합니다. 동적 값을 보간 후 모든 net add 헤더의 총 크기는 IngressController의 spec.tuningOptions.headerBufferMaxRewriteBytes 값을 초과해서는 안 됩니다.

targetPort

IntOrString

이 경로가 가리키는 서비스에서 선택한 Pod의 대상 포트입니다. 문자열이면 대상 끝점 포트 목록에서 이름이 지정된 포트로 조회됩니다. 필수 항목

caCertificate

string

caCertificate는 인증 기관 인증서 콘텐츠를 제공합니다.

certificate

string

인증서는 인증서 콘텐츠를 제공합니다. 이는 인증서 체인이 아닌 단일 제공 인증서여야 합니다. CA 인증서를 포함하지 마십시오.

destinationCACertificate

string

destinationCACertificate는 최종 대상의 ca 인증서 내용을 제공합니다. 재암호화 종료를 사용하는 경우 라우터에서 보안 연결의 상태 점검을 위해 이 파일을 제공해야 합니다. 이 필드를 지정하지 않으면 라우터에서 자체 대상 CA를 제공하고 짧은 서비스 이름(service.namespace.svc)을 사용하여 호스트 이름 검증을 수행할 수 있으므로 인프라 생성 인증서가 자동으로 확인할 수 있습니다.

externalCertificate

object

LocalObjectReference에는 동일한 네임스페이스 내에서 참조된 오브젝트를 찾을 수 있는 충분한 정보가 포함되어 있습니다.

insecureEdgeTerminationPolicy

string

insecureEdgeTerminationPolicy는 경로에 대한 비보안 연결에 필요한 동작을 나타냅니다. 각 라우터는 노출할 포트를 자체적으로 결정할 수 있지만 일반적으로 포트 80입니다.

경로에서 insecureEdgeTerminationPolicy를 지정하지 않으면 기본 동작은 "없음"입니다.

* allow - 트래픽은 비보안 포트의 서버로 전송됩니다(지위/암호화 종료만 해당).

* none - 비보안 포트에서 트래픽이 허용되지 않습니다(기본값).

* 리디렉션 - 클라이언트가 보안 포트로 리디렉션됩니다.

key

string

key 파일 콘텐츠 제공

종료

string

종료는 종료 유형을 나타냅니다.

* 엣지 - TLS 종료는 라우터에서 수행되며 http는 백엔드(기본값) * 패스스루와 통신하는 데 사용됩니다. TLS 종료를 제공하지 않고 라우터(기본값) * 재암호화 기능을 제공하지 않고 트래픽이 바로 대상으로 전송됩니다. 라우터 및 https는 백엔드와 통신하는 데 사용됩니다.

참고: 패스스루 종료는 httpHeader 작업과 호환되지 않음

name

string

추천자의 이름입니다. 자세한 내용은 https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

kind

string

경로가 참조하는 대상의 유형입니다. 현재 '서비스'만 허용됩니다.

name

string

참조되는 서비스/대상의 이름(예: 서비스 이름)

weight

integer

weight는 다른 대상 참조 오브젝트에 대한 대상의 상대적 가중치를 지정하는 0에서 256, default 100 사이의 정수입니다. 0은 이 백엔드에 대한 요청을 비활성화합니다.

Ingress

array

Ingress는 경로가 노출될 수 있는 위치를 설명합니다. 수신 지점 목록에 중복된 Host 또는 RouterName 값이 포함될 수 있습니다. 경로가 준비되면 실시간으로 간주됩니다.

ingress[]

object

RouteIngress는 경로가 노출되는 위치에 대한 정보를 보유합니다.

conditions

array

조건은 경로의 상태이며 비어 있을 수 있습니다.

conditions[]

object

RouteIngressCondition에는 특정 라우터에서 이 경로의 현재 상태에 대한 세부 정보가 포함되어 있습니다.

host

string

host는 경로가 노출되는 호스트 문자열입니다. 이 값은 필수입니다.

routerCanonicalHostname

string

CanonicalHostname은 이 경로에 요청된 호스트의 CNAME으로 사용할 수 있는 라우터의 외부 호스트 이름입니다. 이 값은 선택 사항이며 모든 경우에 설정되지 않을 수 있습니다.

routerName

string

이름은 라우터에서 자체적으로 식별하기 위해 선택한 이름입니다. 이 값은 필수입니다.

wildcardPolicy

string

와일드카드 정책은 이 경로가 노출되는 데 허용되는 와일드카드 정책입니다.

lastTransitionTime

시간

이 조건이 마지막으로 전환된 RFC 3339 날짜 및 시간

message

string

마지막 전환에 대한 세부 정보를 나타내는 사람이 읽을 수 있는 메시지입니다.

reason

string

조건의 마지막 전환 이유는 일반적으로 사람이 읽을 수 있는 머신입니다.

status

string

Status는 조건의 상태입니다. True, False, 알 수 없음

type

string

type은 조건의 유형입니다. 현재 Admitted 또는 UnservableInFutureVersions만 제공됩니다.