# gRPC 플랫폼 지원 매트릭스 Stable gRPC 플랫폼(`:grpc:*`)이 무엇에 대해 인증됐고, 무엇에 대해서는 확인만 하고, 무엇은 지켜보기만 하는지다. 그 구별이 요점이다. 「Spring Boot와 동작한다」는 누구도 행동에 옮길 수 없는 말이다. 릴리스 gate는 `.gitea/workflows/release.yml`이 돌리는 Gradle 단계 `releaseCheck`다(`docs/work/release.md`). 인증된 lane마다 아무것도 돌리지 않으면 실패하는 strict test lane이다. > 이력: 코드 안의 `GrpcCompatibilityMatrix`/`GrpcStableReleaseGate` 짝은 지웠다(리뷰 2026-09-24 S5-lead-4). 운영 코드도 빌드 > 코드도 그것을 부르지 않아서 아무것도 막지 않았다. ## lane | lane | 등급 | 실패하면 릴리스를 막나 | | --- | --- | --- | | Boot가 관리하는 플랫폼(저장소의 Spring Boot BOM) | Certified | 예 | | 명시적 `optional`을 쓰는 proto3 | Certified | 예 | | `grpc-netty-shaded` | Certified | 예 | | `grpc-netty`(shade하지 않음) | Compatibility | 아니요 | | upstream gRPC Java 버전 override | Compatibility | 아니요 | | Protobuf Edition 2024 | Watch | 아니요 | | Protobuf Edition 2026 | Watch | 아니요 | ## 런타임 기준선 | | | | --- | --- | | Java | 21 | | Spring Boot | `gradle/libs.versions.toml`의 `springBoot`(이 줄로 컴파일하고 시험한다. 버전별 표는 README 「지원 표」) | | io.grpc | `gradle/libs.versions.toml`의 `grpc`. `GrpcPlatformModuleConventionPlugin`이 그 BOM을 모듈 범위로 import한다 | | Protobuf | `gradle/libs.versions.toml`의 `protobufGrpc`(생성 코드 runtime과 protoc가 같은 줄) | | Stable 전송 | Netty(shaded) | | Stable RPC 모양 | Unary, Server Streaming | | Stable resolver | Static, DNS, Unix domain socket | | Stable load balancing | `pick_first`, `round_robin` | ## 증거 등급 capability는 그것을 세울 수 있는 등급의 증거로만 광고한다. `GrpcEvidenceGrade.requireCertifies`가 이것을 강제하고, `GrpcReleaseEvidence.supports`가 맞지 않는 lane이 뒷받침하는 주장을 거부한다. | 등급 | lane | 세우는 것 | | --- | --- | --- | | `CONTRACT` | `grpcInProcessContractTest` | 어댑터, interceptor 순서, 상태 매핑, 검증, 멱등 replay, context 전파 | | `TRANSPORT` | `grpcNettyContractTest` | HTTP/2, TLS, mTLS, metadata 한도, 메시지 한도, GOAWAY, keepalive, graceful shutdown | | `FAULT` | `grpcFaultTest` | 연결 끊김, 완료 모름, 부분 stream, 증거 분류기 | | `PERFORMANCE` | `grpcPerformanceTest` | 지연, stream 포화, executor 포화, drain 예산 | in-process 결과는 절대 전송 증거가 아니다. in-process 전송은 TLS를 협상하지 않고, HTTP/2 frame을 만들지 않고, 전송 수준 한도를 강제하지 않는다. 그래서 거기서 통과한 suite는 전송이 아니라 어댑터를 시험한 것이다. ## 지원하지 않는 것 | | 있는 곳 | | --- | --- | | client streaming, bidirectional streaming | `grpc-advanced` (`streaming`) | | 수동 flow control | `grpc-advanced` (`streaming`) | | Hedging | `grpc-advanced` (`resilience`) | | 사용자 정의 name resolver, 사용자 정의 load balancer | `grpc-advanced` (`resilience`) | | xDS | `grpc-advanced` (`resilience`) | | gRPC-Web, Servlet HTTP/2, Spring Integration, Reactor, Kotlin | `grpc-advanced-compat` | | Channelz / CSDS 진단 | `grpc-advanced` (`diagnostics`) | ## 지금 릴리스 상태 Gitea Packages에 아직 버전을 내지 않았다(첫 버전은 `v1.0.0`, `docs/work/release.md`). 이 라이브러리를 조립하는 앱도 아직 없다. 플랫폼은 빌드만 된다. 컴파일되고 lane이 돌지만, 배포되는 앱 어디에도 실리지 않는다. 릴리스 gate 입력 둘이 남아 있고, 그것이 지금부터 릴리스까지의 일이다. - **성능 기준선.** 성능 lane은 돌고, 절대 수치가 아니라 모양을 단언한다. 순서 있는 백분위수와 그것을 읽는 gate다. 알려진 runner에서 기록한 기준선이 생겨야 회귀 gate가 된다. - **schema codegen.** 이 빌드에서는 `protoc`가 돌지 않는다(ADR-GRPC-002). 그래서 descriptor 산출물과 consumer-compile fixture는 컴파일한 schema에서 만들어지지 않고 정책으로 다스린다.