# gRPC advanced capability 지원 매트릭스 `:grpc-advanced:*`의 모든 capability, 그 등급, 그리고 등급을 올리는 데 필요한 것이다. 기본 등급의 정본은 `GrpcAdvancedCapability.defaultGrade`다. 근거가 있는 배포는 `GrpcAdvancedFeatureFlags.withGrade`로 바꾼다. capability는 모두 기본으로 꺼져 있다. 스위치는 `app.grpc.advanced..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를 올려도 다른 것의 등급은 바뀌지 않는다.