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