From ebbfafe4549e6448c531b54813200202f642cefa Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Fri, 13 Nov 2026 01:48:48 +0900 Subject: [PATCH] =?UTF-8?q?docs(adapter):=20grpc=C2=B7cache-redis=20README?= =?UTF-8?q?=EC=9D=98=20env=20=ED=82=A4=20=EC=95=88=EB=82=B4=EB=A5=BC=20reg?= =?UTF-8?q?istry=EC=97=90=20=EB=A7=9E=EC=B6=98=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit grpc README는 "전용 APP_* 키는 registry에 없다"고 했지만 끄는 값 APP_GRPC_SERVER_ENABLED가 있고, 기동에 꼭 두라는 APP_GRPC_SERVER_ALLOW_INSECURE_LOCAL은 registry에 없었다(앞 커밋이 등록). cache-redis README는 운영 비밀로 읽는 곳 없는 폐기 키 셋 (APP_CACHE_REDIS_PASSWORD, APP_IDEMPOTENCY_/LEASE_REDIS_KEY_HMAC_SECRET)을 넣으라고 했다. 자격 증명은 APP_REDIS_AUTHENTICATION_*의 secret 참조다. 검증: python3 scripts/check-docs.py rc=0. --- src/adapter/inbound/grpc/README.md | 7 ++++--- src/adapter/outbound/cache-redis/README.md | 2 +- 2 files changed, 5 insertions(+), 4 deletions(-) diff --git a/src/adapter/inbound/grpc/README.md b/src/adapter/inbound/grpc/README.md index e713d0cf..81ecdc3e 100644 --- a/src/adapter/inbound/grpc/README.md +++ b/src/adapter/inbound/grpc/README.md @@ -23,9 +23,10 @@ 이 줄을 지우면 서버, 포트, 설정 바인딩이 모두 함께 빠진다. - 켜기와 끄기: 모듈이 있으면 켜진다. `app.grpc.server.enabled=false`로만 끈다. -- 필요한 설정: 전용 `APP_*` env 키는 registry에 없다. 켜진 상태에서 지금 구현이 받는 listener는 - loopback plaintext뿐이라 `app.grpc.server.allow-insecure-local=true`(env - `APP_GRPC_SERVER_ALLOW_INSECURE_LOCAL=true`)를 명시해야 기동한다. 선택: `app.grpc.server.port` +- 필요한 설정: registry 행은 끄는 값 `APP_GRPC_SERVER_ENABLED`와 `APP_GRPC_SERVER_ALLOW_INSECURE_LOCAL` 둘이다. + 켜진 상태에서 지금 구현이 받는 listener는 loopback plaintext뿐이라 + `APP_GRPC_SERVER_ALLOW_INSECURE_LOCAL=true`(`app.grpc.server.allow-insecure-local`)를 명시해야 기동한다. 나머지 + `app.grpc.server.*`는 registry 행 없이 Spring relaxed 이름(`APP_GRPC_SERVER_PORT` 등)으로 받는다. 선택: `app.grpc.server.port` (기본 9090), `.bind-address`(기본 127.0.0.1), `.reflection-enabled`, `.shutdown-grace-seconds`, `.shutdown-drain-seconds`, 그리고 아래 「서버 한도」 절의 전송 한도 키. diff --git a/src/adapter/outbound/cache-redis/README.md b/src/adapter/outbound/cache-redis/README.md index 51cb4fab..265934b3 100644 --- a/src/adapter/outbound/cache-redis/README.md +++ b/src/adapter/outbound/cache-redis/README.md @@ -47,7 +47,7 @@ runtimeOnly project(':adapter:outbound:cache-redis') // brings :adapter:outbou | namespace | `APP_REDIS_NAMESPACE_ENVIRONMENT`, `APP_REDIS_NAMESPACE_SERVICE`, `APP_REDIS_NAMESPACE_DOMAIN` | | role | `APP_CACHE_CANONICAL_DEFAULT_PROVIDER`, `APP_RATE_LIMIT_PROVIDER`, `APP_LEASE_PROVIDER`, `APP_IDEMPOTENCY_PROVIDER=redis` | | role 조정 | `APP_CACHE_REDIS_*`, `APP_RATE_LIMIT_*`, `APP_LEASE_REDIS_*`, `APP_IDEMPOTENCY_REDIS_COMMAND_TIMEOUT` | -| 운영 비밀 값(고른 role마다) | `APP_CACHE_REDIS_PASSWORD`, `APP_CACHE_REDIS_KEY_HMAC_SECRET`, `APP_RATE_LIMIT_REDIS_PASSWORD`, `APP_RATE_LIMIT_REDIS_KEY_HMAC_SECRET`, `APP_IDEMPOTENCY_REDIS_KEY_HMAC_SECRET`, `APP_LEASE_REDIS_KEY_HMAC_SECRET` | +| 운영 비밀 값(고른 role마다) | Redis 접속 자격 증명은 `APP_REDIS_AUTHENTICATION_*`가 가리키는 `secret://` 참조다. 캐시 key HMAC은 `APP_CACHE_REDIS_KEY_HMAC_SECRET`, rate limit은 `APP_RATE_LIMIT_REDIS_PASSWORD`·`APP_RATE_LIMIT_REDIS_KEY_HMAC_SECRET`. 멱등·lease는 호출자가 준 digest를 써서 비밀이 없다. role마다 따로 두던 `APP_CACHE_REDIS_PASSWORD`, `APP_IDEMPOTENCY_REDIS_KEY_HMAC_SECRET`, `APP_LEASE_REDIS_KEY_HMAC_SECRET`는 읽는 곳이 없다(registry `deprecated_orphaned`) | ## 켜기와 조립