문제: docs/httpclient 아래 살아 있는 문서 9개가 영어였다(language 예외). repository-adaptation.md는 registry의 leaf 수를 「exactly 19 leaf identities」로, Spring Boot 버전을 4.0.8로 옮겨 적었다(number 예외 두 줄). 같은 문서가 testkit을 `testkit` source set이라고 했지만 1절 표와 실제 코드는 `testFixtures`다. 고친 방법: 뜻을 그대로 옮기고 식별자·명령·경로·설정 key·예외·metric·위반 코드·표 구조는 원문으로 둔다. scripts/verify-httpclient-docs.py가 코드에서 뽑는 이름이 모두 문서에 남는다. leaf 수는 registry(src/config/architecture/modules.json)를, 버전은 src/gradle/libs.versions.toml의 `springBoot`를 가리킨다. 등급 이름(Stable, Default, Restricted, Internal, Experimental)은 꼬리표라 원문으로 둔다. env-fields.yaml은 머리 주석만 옮겼다. HttpClientPlatformEnvManifestTest는 주석을 읽지 않는다(`- field:`·`env:` 줄만). configuration-reference.md의 「Three of these」 뒤 목록이 다섯이라 「아래 코드들」로 고쳤다. 버린 대안: 리뷰 번호(RR-03-14 등)를 걷어 내기. 이 작업은 번역이고 내용 감사는 다음 리뷰 몫이라 날짜와 함께 그대로 둔다. 위험·한계: 내용 감사는 하지 않았다. 검증: python3 scripts/check-docs.py rc=0(이 폴더 예외 줄 0). python3 scripts/verify-httpclient-docs.py PASS(코드에서 뽑은 이름 156개 모두 문서에 있음).
2.6 KiB
2.6 KiB
HTTP Client 플랫폼 — 릴리스 점검표
아래 항목마다 검토가 아니라 명령으로 보여 줬을 때 릴리스가 끝난다.
게이트
cd src
./gradlew :adapter:outbound:httpclient:test --console=plain
./gradlew :adapter:outbound:httpclient:httpClientStableContractTest --console=plain
./gradlew :adapter:outbound:httpclient:httpClientSecurityTest --console=plain
./gradlew :adapter:outbound:httpclient:spring62ApiSurfaceScan --console=plain
./gradlew :adapter:outbound:httpclient:spring70CompatibilityTest --console=plain
./gradlew :adapter:outbound:httpclient:httpClientFailureInjectionTest --console=plain # Docker 필요
./gradlew :adapter:outbound:httpclient:httpClientPerformanceTest --console=plain # 모든 상한을 단언
./gradlew verifyCleanArchitectureDependencies --console=plain
./gradlew :app-bootstrap:architectureTest --console=plain
python3 ../scripts/verify-httpclient-docs.py
완료 기준 (설계서 §33)
- 타입 있는 client가 기본 진입점이다. H2와 H3은 따로 허가한다.
- H1–H4는 timeout, host, TLS, 인증, 크기, 관측 정책을 우회할 수 없다.
- Apache와 JDK가 같은 결과와 예외 metadata를 낸다.
- pool, DNS, 연결, TLS, 재시도 backoff가 모두 실제 기한 안에 들어간다.
- 추가 시도마다 멱등성, 재전송 가능성, 증거, 기한, 예산으로 설명된다.
- 멱등이 아닌
SENT_NO_RESPONSE는HttpAmbiguousExecutionException으로 드러난다. - 읽지 않은 본문, 디코딩 오류, 취소, 크기 거부 뒤에 pool과 buffer를 되찾는다.
- OAuth2 갱신은 한 번만 날아가고, 401 재전송은 많아야 한 번이다.
- trust-all과 hostname 검증 우회는 시작 때 실패한다.
- 정규화, DNS/IP 검증, redirect 재검증, egress 통제가 모두 통과한다.
- 첫 바이트를 넘긴 뒤에는 투명한 재시도가 일어나지 않는다.
- 협상한 wire protocol이 support matrix가 transport마다 주장하는 것과 맞는다.
- 논리 호출과 시도는 따로 된 metric이고 금지 label이 없다.
- DNS, pool, TLS, reset, 부분 응답, HTTP/2 GOAWAY를 재현할 수 있다.
- 스레드, heap, direct memory, pool, 재시도 예산 상한이 지켜진다.
- support matrix, 설정 참조, 보안 안내, runbook이 코드와 맞는다.
Experimental
Jetty HTTP/3은 Http3CapabilityReport가 QUIC와 TLS 1.3을 보고하고, 그것이 선언한 계약 부분집합이 전용 환경에서
통과할 때까지 Experimental로 남는다. Stable starter가 자동 구성하는 일은 없다.