---
kind: CONCEPT
slug: grpc-advanced-bootstrap-c01
title: 능력을 하나씩 등급 매기는 것이 설계다
topic: admission-budget-and-backpressure
project: clean-architecture-backend-template
status: 게시 전
sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916
rootTreeNode: concept:grpc-advanced-bootstrap-c01
evidenceCapturedOn: 2026-09-01
assets:
  - key: grpc-advanced-bootstrap-c01
    file: ../../../final/evidence/rendered/grpc-advanced-bootstrap-c01.svg
evidence:
  - ../../../final/evidence/raw/grpc-advanced-bootstrap-c01.txt
source:
  - 원본 분석 절은 analysis/grpc/grpc-advanced-bootstrap.md#L53 이다.
module: grpc-advanced-bootstrap
---

# 능력을 하나씩 등급 매기는 것이 설계다

능력 15종을 한 깃발로 묶지 않고 각각 등급을 매긴다. 그렇게 하지 않으면 gRPC-Web을 켜는 결정과 xDS를 켜는 결정이 같은 결정이 된다.

## 본문

<!-- body:start -->

능력을 하나씩 등급 매기는 것이 설계다.

> "Bundling them under one 'advanced' flag makes enabling gRPC-Web — a compatibility bridge with a proxy in front of it — the same decision as enabling xDS, which brings a control plane and its outage modes. They are not the same decision, and a single switch is how the second one gets made by accident."

| 등급 | 시작 가능 | production 별도 승인 |
|---|---|---|
| `ADVANCED_STABLE` | 예 | 아니오 |
| `EXPERIMENTAL` | 예 | **예** |
| `WATCH` | 아니오 | — |
| `DISABLED` | 아니오 | — |

기본 등급 분포는 `ADVANCED_STABLE` 11, `EXPERIMENTAL` 3(`HEDGING`·`CUSTOM_LOAD_BALANCER`·`XDS`), `WATCH` 1(`EDITION_2026`)이다.

## EXPERIMENTAL에 두 번째 승인을 요구하는 근거

> "The flag says somebody wanted the feature; the approval says somebody accepted that its failure modes are not fully characterised, which is a different person's decision on most teams."

## 이 기록이 다루는 파일 범위

:::evidence key="grpc-advanced-bootstrap-c01" alt="코드베이스에서 파일 목록을 만든 출력 9줄. 이 기록이 다루는 범위가 그 목록이다." caption="코드베이스 파일 목록 — 9줄 · exit 0" zoom="true"
:::

<!-- body:end -->