Files
grpc-library/docs/compatibility/grpc-advanced-support-matrix.md
T
DongHyeonka fd6a45f888 docs(compatibility): gRPC 지원 매트릭스를 한국어로 옮기고 정본을 가리킨다
문제: `docs/compatibility`의 두 문서가 영어였고, `grpc-support-matrix.md`는 Spring Boot
버전을 복사했다(number 예외). 지운 `GrpcAdvancedSupportMatrix`·
`GrpcAdvancedPromotionEvidence`와 없는 `runtime_memberships`, `src/build.gradle`의
`ext.grpcVersion`을 가리켰다.

고친 것: 둘을 번역했다. 버전은 `src/gradle/libs.versions.toml`을 가리키고, 등급의 정본은
`GrpcAdvancedCapability.defaultGrade`, 빌드 상태는 registry의 `"build": "optional-grpc"`로
적었다. 예외 목록에서 language 줄 2개와 number 줄 1개를 지웠다.

검증: 최종 트리 기준(첫 커밋 본문 참고).
2026-11-07 17:56:35 +09:00

3.1 KiB

gRPC advanced capability 지원 매트릭스

:grpc-advanced:*의 모든 capability, 그 등급, 그리고 등급을 올리는 데 필요한 것이다. 기본 등급의 정본은 GrpcAdvancedCapability.defaultGrade다. 근거가 있는 배포는 GrpcAdvancedFeatureFlags.withGrade로 바꾼다.

capability는 모두 기본으로 꺼져 있다. 스위치는 app.grpc.advanced.<capability>.enabled다.

등급

등급 뜰 수 있나 운영에 별도 승인이 필요한가
ADVANCED_STABLE 예 아니요
EXPERIMENTAL 예 예
WATCH 아니요 —
DISABLED 아니요 —

capability

capability 스위치 등급 증거에 필요한 실제 인프라
Protobuf Edition 2024 edition-2024 ADVANCED_STABLE —
Protobuf Edition 2026 edition-2026 WATCH —
client streaming client-streaming ADVANCED_STABLE —
bidirectional streaming bidi-streaming ADVANCED_STABLE —
수동 flow control manual-flow-control ADVANCED_STABLE —
읽기 전용 unary hedging hedging EXPERIMENTAL —
사용자 정의 name resolver custom-resolver ADVANCED_STABLE —
사용자 정의 load balancer custom-load-balancer EXPERIMENTAL —
proxyless xDS xds EXPERIMENTAL xDS control plane
gRPC-Web grpc-web ADVANCED_STABLE gRPC-Web proxy
Servlet HTTP/2 servlet-compat ADVANCED_STABLE(스위치만 있다. 2026-09-25부터 Servlet 전송 코드가 없다) Servlet 컨테이너
Spring Integration bridge integration-bridge ADVANCED_STABLE —
Reactor 어댑터 reactor ADVANCED_STABLE —
Kotlin coroutine / Flow kotlin ADVANCED_STABLE Kotlin toolchain
Channelz / CSDS 진단 channel-diagnostics ADVANCED_STABLE —

여기서 등급이 구체적으로 뜻하는 것

등급은 배포가 아니라 계약에 대한 말이다. 모든 capability의 계약은 이 저장소에서 구현되고 시험됐다. 실제 배포에서 나온 증거는 어느 capability에도 없고, 승격된 것도 없다.

capability 넷은 여기서 의미 있는 증거를 아예 낼 수 없다. 필요한 인프라(gRPC-Web proxy, Servlet 컨테이너, xDS control plane, Kotlin toolchain)가 없고, 인프라 없이 돈 suite는 통과해도 아무것도 세우지 않기 때문이다.

Kotlin이 가장 날카로운 경우다. 이 저장소에는 Kotlin toolchain이 없으므로 그것이 생기기 전까지 Kotlin은 여기서 지원할 수 없다. Java 쪽 coroutine 취소 bridge(GrpcCoroutineContextBridge)만 구현되고 시험됐다. 컴파일 lane은 없다.

승격 기준

목표 soak 그 밖에 필요한 것
ADVANCED_STABLE 7일 호환성 증거, 보안 리뷰, 장애 증거, 성능 증거, ADR, runbook, 실제 환경 시험
Stable 기본값 30일 위의 모두와 의존성·보안·운영 비용 리뷰

WATCH는 무엇보다 먼저 EXPERIMENTAL이 된다. 승격은 서로 독립이다. 한 capability를 올려도 다른 것의 등급은 바뀌지 않는다.