Traffic Director GKE API 참조

이 문서는 Kubernetes Gateway API를 사용하는 Traffic Director의 API 참조입니다.

`TDMesh`

필드	설명
`apiVersion`	문자열 net.gke.io/v1alpha1
`kind`	문자열 TDMesh
`metadata`	Kubernetes meta/v1.ObjectMeta/td>
`spec`	MeshSpec
`status`	MeshStatus

`MeshSpec`

필드	설명
`allowedRoutes`	gateway.networking.k8s.io/v1alpha2.AllowedRoutes
`gatewayClassName`	string gke-td

`MeshStatus`

필드	설명
`conditions`	조건 필드는 메시의 현재 조건을 설명합니다. 알려진 조건 유형: 예약됨 준비됨 자세한 내용은 Kubernetes meta/v1.Condition을 참조하세요.

`GatewayClass`

GatewayClass 참조 문서를 확인하세요.

`TDGRPCRoute`

TDGRPCRoute는 TDMesh 또는 Gateway 리스너에서 API 객체(예: Service)로의 gRPC 요청 라우팅 동작을 지정합니다.

필드	설명
`apiVersion`	문자열 net.gke.io/v1alpha1
`kind`	문자열 `TDGRPCRoute`
`metadata`	metav1.ObjectMeta
`spec`	GRPCRouteSpec `GRPCRoute`의 원하는 상태를 정의합니다.
`Status`	GRPCRouteStatus HTTPRouteStatus와 동일합니다.

`GRPCRouteSpec`

TDGRPCRoute 사양은 다음 표의 값으로 구성됩니다.

필드 설명

CommonRouteSpec CommonRouteSpec

필드	설명
`CommonRouteSpec`	CommonRouteSpec
`Hostnames`	[]호스트 이름 호스트 이름은 요청을 처리할 GRPCRoute를 선택하기 위해 gRPC `Host` 헤더와 일치해야 하는 호스트 이름 집합을 정의합니다. `Hostname`은 RFC 3986에 정의된 네트워크 호스트의 정규화된 도메인 이름입니다. RFC에 정의된 URI의 '호스트' 부분에서 다음 편차를 확인합니다. IP 주소는 허용되지 않습니다. 포트가 허용되지 않으므로 `:` 구분 기호가 적용되지 않습니다. 수신 요청은 `TDGRPCRoute` 규칙 전에 호스트 이름과 일치합니다. 호스트 이름이 지정되지 않은 경우 트래픽은 `GRPCRouteRules`를 기반으로 라우팅됩니다. `Hostname`은 네트워크 호스트의 종료 점이 없는 도메인 이름(예: `butterfly.example.com`)처럼 정확하거나 `wildcard`로 단일 와일드 카드 레이블이 앞에 붙는 도메인 이름(예: '.example.com')일 수 있습니다. 와일드 카드 문자 ``는 단독으로 첫 번째 DNS 라벨로 표시되어야 하며 단일 라벨과만 일치합니다. 와일드 카드 라벨만 가질 수는 없습니다(예: Host == "*"). 요청은 다음 순서에 따라 '호스트' 필드와 비교됩니다. `Host`가 정확하면 gRPC 호스트 헤더가 `Host`와 같으면 요청이 이 규칙과 일치합니다. `Host`가 와일드 카드인 경우 gRPC 호스트 헤더가 와일드 카드 규칙의 서픽스(첫 번째 라벨 삭제)와 같으면 요청이 이 규칙과 일치합니다.
`Rules`	[]GRPCRouteRule gRPC 일치자, 필터, 작업의 목록을 정의합니다.

Hostnames

[]호스트 이름
호스트 이름은 요청을 처리할 GRPCRoute를 선택하기 위해 gRPC Host 헤더와 일치해야 하는 호스트 이름 집합을 정의합니다.

Hostname은 RFC 3986에 정의된 네트워크 호스트의 정규화된 도메인 이름입니다. RFC에 정의된 URI의 '호스트' 부분에서 다음 편차를 확인합니다.

IP 주소는 허용되지 않습니다.
포트가 허용되지 않으므로 `:` 구분 기호가 적용되지 않습니다.

수신 요청은 TDGRPCRoute 규칙 전에 호스트 이름과 일치합니다. 호스트 이름이 지정되지 않은 경우 트래픽은 GRPCRouteRules를 기반으로 라우팅됩니다.

Hostname은 네트워크 호스트의 종료

점이 없는 도메인 이름(예: butterfly.example.com)처럼 정확하거나 wildcard로 단일 와일드 카드 레이블이 앞에 붙는 도메인 이름(예: '*.example.com')일 수 있습니다. 와일드 카드 문자 `*`는 단독으로 첫 번째 DNS 라벨로 표시되어야 하며 단일 라벨과만 일치합니다. 와일드 카드 라벨만 가질 수는 없습니다(예: Host == "*"). 요청은 다음 순서에 따라 '호스트' 필드와 비교됩니다.

Host가 정확하면 gRPC 호스트 헤더가 Host와 같으면 요청이 이 규칙과 일치합니다.
Host가 와일드 카드인 경우 gRPC 호스트 헤더가 와일드 카드 규칙의 서픽스(첫 번째 라벨 삭제)와 같으면 요청이 이 규칙과 일치합니다.

Rules []GRPCRouteRule
gRPC 일치자, 필터, 작업의 목록을 정의합니다.

`GRPCRouteRule`

규칙은 gRPC 요청을 조건에 따라 일치시키고 선택적으로 API 객체에 요청을 전달하는 시맨틱스를 정의합니다. 규칙은 다음으로 구성됩니다.

필드	설명
`Matches`	`GRPCRouteMatch` gRPC 요청을 일치시키는 데 사용되는 조건을 정의합니다. 각 일치 항목은 독립적입니다. 즉, 이 규칙은 일치 항목이 하나라도 충족되면 일치합니다.
`BackendRefs`	[]`GRPCBackendRef` 일치하는 요청을 전송할 백엔드를 정의합니다. 지정되지 않거나 잘못된 경우(존재하지 않는 리소스 또는 엔드포인트가 없는 서비스 참조) 규칙은 전달을 수행하지 않습니다. `GRPCBackendRef`는 `HTTPBackendRef`와 동일합니다.

`GRPCRouteMatch`

규칙은 gRPC 요청을 조건에 따라 일치시키고 선택적으로 API 객체에 요청을 전달하는 시맨틱스를 정의합니다. 규칙은 다음과 같이 정의됩니다.

필드	설명
방법	`GRPCMethodMatch` 일치시킬 gRPC 메서드를 정의합니다.
헤더	[]`GRPCHeaderMatch` gRPC 요청 헤더 일치자를 정의합니다. 여러 일치 값이 AND 연산과 결합되어 요청이 지정된 모든 헤더와 일치해야 경로를 선택할 수 있습니다. 참고: `GRPCHeaderMatch`의 정의는 ``HTTPHeaderMatch``와 동일합니다.

`GRPCMethodMatch`

GRPCMethodMatch는 다음으로 구성됩니다.

필드	설명
유형	`MethodMatchType` 이름과 일치시킬 방법을 지정하는 유형을 정의합니다. 지정하지 않으면 기본값 `EXACT`가 사용됩니다. `EXACT` 또는 `RegularExpression`을 선택할 수 있습니다.
서비스	문자열 일치할 서비스의 이름을 정의합니다. 지정하지 않으면 모든 서비스와 일치합니다.
방법	문자열 일치할 메서드를 정의합니다. 지정하지 않으면 모든 메서드와 일치합니다.

`GRPCHeaderMatch`

GRPCHeaderMatch는 다음으로 구성됩니다.

필드	설명
유형	HeaderMatchType 헤더의 값과 대조하는 방법을 정의합니다.
이름	문자열 이름은 일치시킬 gRPC 헤더의 이름입니다. 이름 일치는 대소문자를 구분하지 않습니다. (https://tools.ietf.org/html/rfc7230#section-3.2 참조)
값	문자열 값은 일치시킬 HTTP 헤더의 값입니다.

GRPCBackendRef

필드	설명
BackendRef	BackendRef `BackendRef` 는 일치하는 요청을 전달할 백엔드에 대한 참조입니다.

`HTTPRoute`

HTTPRoute에 대한 오픈소스 Gateway API 참조를 확인하세요.

`TCPRoute`

TCPRoute에 대한 오픈소스 Gateway API 참조를 확인하세요.