GatewayClass 기능


이 페이지에는 Google Kubernetes Engine(GKE)에서 사용할 수 있는 GatewayClass 리소스의 기능과 지원 사양이 나와 있습니다.

표 범례

이 문서의 다양한 표에 대해 표 범례는 다음과 같습니다.

  • 은 필드가 지원됨을 나타냅니다.
  • -은 필드가 지원되지 않음을 나타냅니다.
  • GKE가 필드의 일부 값을 지원하는 경우 지원되는 값은 표에 설명되어 있습니다.

GatewayClass 기능

다음 표에는 GKE에서 사용할 수 있는 GatewayClass 리소스의 특징이 나와 있습니다.

아키텍처

특성 gke-l7-global-external-managed gke-l7-global-external-managed-mc gke-l7-regional-external-managed gke-l7-regional-external-managed-mc gke-l7-rilb gke-l7-rilb-mc gke-l7-gxlb gke-l7-gxlb-mc
GKE Gateway Controller Google에서 호스팅하는 게이트웨이 컨트롤러
위치 Google Cloud 인프라
플랫폼 GKE
클러스터 유형 GKE Autopilot 또는 GKE Standard
클러스터 범위 단일 클러스터 멀티 클러스터 단일 클러스터 멀티 클러스터 단일 클러스터 멀티 클러스터 단일 클러스터 멀티 클러스터
GKE 버전 GKE Autopilot: 1.26 이상
GKE Standard: 1.24 이상
API 유형 CRD
CRD 버전 새 클러스터 및 클러스터 업그레이드:
GKE 1.24에서 1.27.10, 1.28.4, 1.29.0: 0.7.0
GKE 1.27.10 이상, 1.28.4 이상, 1.29.0~1.29.2: 0.8.1
GKE 1.29.3-gke.1282001, 1.30.0-gke.1000000 이상: 1.0.0
API 버전 gateway.networking.k8s.io/v1beta1 (CRD 버전: 0.7.0 이상, 1.0.0 포함)
gateway.networking.k8s.io/v1 (CRD 버전: 1.0.0 이상)
API 사용 설정 GKE Autopilot: 기본적으로 사용 설정됨
출시 단계 GA

멀티 클러스터 서비스

특성 gke-l7-global-external-managed gke-l7-global-external-managed-mc gke-l7-regional-external-managed gke-l7-regional-external-managed-mc gke-l7-rilb gke-l7-rilb-mc gke-l7-gxlb gke-l7-gxlb-mc
필수
API 버전 net.gke.io/v1 net.gke.io/v1 net.gke.io/v1 net.gke.io/v1
리소스 유형 ServiceExport ServiceExport ServiceExport ServiceExport

부하 분산기

특성 gke-l7-global-external-managed gke-l7-global-external-managed-mc gke-l7-regional-external-managed gke-l7-regional-external-managed-mc gke-l7-rilb gke-l7-rilb-mc gke-l7-gxlb gke-l7-gxlb-mc
유형 전역 외부 애플리케이션 부하 분산기 리전 외부 애플리케이션 부하 분산기 내부 애플리케이션 부하 분산기 기본 애플리케이션 부하 분산기
부하 분산기 범위 전역 리전 리전 전역
컨테이너 기반 부하 분산 (기본값, GCE_VM_IP_PORT 영역 NEG 사용)

VPC

특성 gke-l7-global-external-managed gke-l7-global-external-managed-mc gke-l7-regional-external-managed gke-l7-regional-external-managed-mc gke-l7-rilb gke-l7-rilb-mc gke-l7-gxlb gke-l7-gxlb-mc
공유 VPC 지원 동일한 공유 VPC 호스트 또는 서비스 프로젝트에 있는 모든 클러스터 및 Fleet 호스트 프로젝트
여러 경로에 대한 공유 게이트웨이/인그레스
VPC 방화벽 수명 주기 관리 자동화
참고: 공유 VPC 환경에서 게이트웨이에 대해 방화벽 규칙을 수동으로 배포해야 합니다.
자세한 내용은 게이트웨이의 방화벽 규칙을 참조하세요.

게이트웨이 IP 주소

특성 gke-l7-global-external-managed gke-l7-global-external-managed-mc gke-l7-regional-external-managed gke-l7-regional-external-managed-mc gke-l7-rilb gke-l7-rilb-mc gke-l7-gxlb gke-l7-gxlb-mc
게이트웨이 IP 주소 할당 정적 또는 동적
네트워크 서비스 등급 IP 주소 프리미엄 등급 표준 등급 프리미엄 등급 프리미엄 등급
게이트웨이 IP 주소 연결 가능성 인터넷 인터넷 VPC 내부 인터넷
여러 포트에 동일한 IP 주소(HTTP, HTTPS)

라우팅 및 트래픽 관리

특성 gke-l7-global-external-managed gke-l7-global-external-managed-mc gke-l7-regional-external-managed gke-l7-regional-external-managed-mc gke-l7-rilb gke-l7-rilb-mc gke-l7-gxlb gke-l7-gxlb-mc
전역 액세스 전역 부하 분산기의 암시적 전역 부하 분산기의 암시적 전역 부하 분산기의 암시적
리전 간 백엔드 부하 분산
프로젝트 간 부하 분산 백엔드 서비스와 NEG는 동일한 프로젝트에 있어야 합니다.
(GKE Gateway Controller에서 관리)
네임스페이스 간 라우팅
호스트/경로 라우팅 프리픽스, 일치검색
헤더 기반 라우팅 일치검색
경로 리디렉션
URL 재작성
트래픽 분할
트래픽 미러링
트래픽 컷오버
트래픽 기반 자동 확장 미리보기 프리뷰 미리보기
커스텀 요청 헤더
커스텀 응답 헤더

프런트엔드 보안

특성 gke-l7-global-external-managed gke-l7-global-external-managed-mc gke-l7-regional-external-managed gke-l7-regional-external-managed-mc gke-l7-rilb gke-l7-rilb-mc gke-l7-gxlb gke-l7-gxlb-mc
SSL 정책
HTTP-HTTPS 간 리디렉션
여러 TLS 인증서 지원
Kubernetes 보안 비밀 기반 인증서
자체 관리형 Compute Engine SSL 인증서
Google 관리형 Compute Engine SSL 인증서
인증서 관리자를 사용하는 자체 관리형 SSL 인증서
인증서 관리자를 사용하는 Google 관리형 SSL 인증서
미리보기

미리보기

미리보기

미리보기

백엔드 서비스 속성

특성 gke-l7-global-external-managed gke-l7-global-external-managed-mc gke-l7-regional-external-managed gke-l7-regional-external-managed-mc gke-l7-rilb gke-l7-rilb-mc gke-l7-gxlb gke-l7-gxlb-mc
연결 드레이닝 제한 시간
세션 어피니티
HTTP 액세스 로깅 구성
백엔드 서비스 제한 시간
커스텀 부하 분산기 상태 확인 구성
백엔드 서비스에 대한 TLS
지원되는 백엔드 서비스 프로토콜 HTTP, HTTPS, HTTP/2
커스텀 기본 백엔드

추가 Google Cloud 서비스

기능 gke-l7-global-external-managed gke-l7-global-external-managed-mc gke-l7-regional-external-managed gke-l7-regional-external-managed-mc gke-l7-rilb gke-l7-rilb-mc gke-l7-gxlb gke-l7-gxlb-mc
IAP(Identity-Aware Proxy)
Google Cloud Armor 백엔드 보안 정책
Cloud CDN

지원되는 게이트웨이 API 필드

다음 표에는 GKE에서 지원되는 Gateway API 사양의 필드가 나와 있습니다.

게이트웨이

spec.addresses

자세한 내용은 게이트웨이 문서의 spec.addresses를 참조하세요.

필드 gke-l7-global-external-managed gke-l7-global-external-managed-mc gke-l7-regional-external-managed gke-l7-regional-external-managed-mc gke-l7-rilb gke-l7-rilb-mc gke-l7-gxlb gke-l7-gxlb-mc
type NamedAddress
value 고정 전역 외부 주소 고정 리전 외부 주소 고정 리전 내부 주소 고정 전역 외부 주소

spec.listeners

자세한 내용은 게이트웨이 문서의 spec.listeners를 참조하세요.

필드 gke-l7-global-external-managed gke-l7-global-external-managed-mc gke-l7-regional-external-managed gke-l7-regional-external-managed-mc gke-l7-rilb gke-l7-rilb-mc gke-l7-gxlb gke-l7-gxlb-mc
protocol HTTP, HTTPS
port 80 또는 8080(HTTP), 443(HTTPS)
name
hostname
tls
allowedRoutes

spec.listeners.tls

자세한 내용은 게이트웨이 문서의 spec.listeners.tls를 참조하세요.

필드 gke-l7-global-external-managed gke-l7-global-external-managed-mc gke-l7-regional-external-managed gke-l7-regional-external-managed-mc gke-l7-rilb gke-l7-rilb-mc gke-l7-gxlb gke-l7-gxlb-mc
mode Terminate
certificateRefs

spec.listeners.tls.options

자세한 내용은 게이트웨이 문서의 spec.listeners.tls.options를 참조하세요.

필드 gke-l7-global-external-managed gke-l7-global-external-managed-mc gke-l7-regional-external-managed gke-l7-regional-external-managed-mc gke-l7-rilb gke-l7-rilb-mc gke-l7-gxlb gke-l7-gxlb-mc
networking.gke.io/pre-shared-certs 전역 SSL 인증서 리소스 참조(자체 관리형 또는 Google 관리형) 리전, 자체 관리형 SSL 인증서 리소스 참조 리전, 자체 관리형 SSL 인증서 리소스 참조 전역 SSL 인증서 리소스 참조(자체 관리형 또는 Google 관리형)

HTTPRoute

다음 표에는 GKE에서 지원하는 HTTPRoute API 사양의 값이 나와 있습니다.

spec.parentRefs

자세한 내용은 게이트웨이 문서의 spec.parentRefs를 참조하세요.

필드 gke-l7-global-external-managed gke-l7-global-external-managed-mc gke-l7-regional-external-managed gke-l7-regional-external-managed-mc gke-l7-rilb gke-l7-rilb-mc gke-l7-gxlb gke-l7-gxlb-mc
parentRefs.group
parentRefs.kind
parentRefs.namespace
parentRefs.name
parentRefs.sectionName
parentRefs.port

spec.hostnames

자세한 내용은 게이트웨이 문서의 spec.hostnames를 참조하세요.

필드 gke-l7-global-external-managed gke-l7-global-external-managed-mc gke-l7-regional-external-managed gke-l7-regional-external-managed-mc gke-l7-rilb gke-l7-rilb-mc gke-l7-gxlb gke-l7-gxlb-mc
precise, wildcard

spec.rules

자세한 내용은 게이트웨이 문서의 spec.rules를 참조하세요.

필드 gke-l7-global-external-managed gke-l7-global-external-managed-mc gke-l7-regional-external-managed gke-l7-regional-external-managed-mc gke-l7-rilb gke-l7-rilb-mc gke-l7-gxlb gke-l7-gxlb-mc
path.type Exact, PathPrefix
path.value
headers.type Exact
headers.name
headers.value
queryParams
method

spec.rules.backendRefs

자세한 내용은 게이트웨이 문서의 spec.rules.backendRefs를 참조하세요.

필드 gke-l7-global-external-managed gke-l7-global-external-managed-mc gke-l7-regional-external-managed gke-l7-regional-external-managed-mc gke-l7-rilb gke-l7-rilb-mc gke-l7-gxlb gke-l7-gxlb-mc
backendRef.group (empty), gateway.networking.k8s.io, net.gke.io
backendRef.kind Service ServiceImport Service ServiceImport Service ServiceImport Service ServiceImport
backendRef.name
backendRef.namespace
backendRef.port
backendRef.weight
backendRef.filters

spec.rules.filters

자세한 내용은 게이트웨이 문서의 spec.rules.filters를 참조하세요.

필드 gke-l7-global-external-managed gke-l7-global-external-managed-mc gke-l7-regional-external-managed gke-l7-regional-external-managed-mc gke-l7-rilb gke-l7-rilb-mc gke-l7-gxlb gke-l7-gxlb-mc
type requestHeaderModifier, responseHeaderModifier, requestMirror, requestRedirect, urlRewrite
requestHeaderModifier.add
requestHeaderModifier.remove
requestHeaderModifier.set
responseHeaderModifier.add
responseHeaderModifier.remove
responseHeaderModifier.set
requestMirror.backendRef
requestRedirect.scheme HTTP, HTTPS
requestRedirect.hostname
requestRedirect.path replaceFullPath, replacePrefixMatch
requestRedirect.port
requestRedirect.statusCode
urlRewrite.hostname
urlRewrite.path replacePrefixMatch