문제: `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개를 지웠다. 검증: 최종 트리 기준(첫 커밋 본문 참고).
3.1 KiB
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를 올려도 다른 것의 등급은 바뀌지 않는다.