docs(adapter): grpc·cache-redis README의 env 키 안내를 registry에 맞춘다
pr / done (pull_request) Canceled after 0s

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.
This commit is contained in:
DongHyeonka
2026-11-13 01:48:48 +09:00
parent bd17bf1f00
commit ebbfafe454
2 changed files with 5 additions and 4 deletions
+4 -3
View File
@@ -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`, 그리고 아래 「서버 한도」 절의 전송 한도 키.
+1 -1
View File
@@ -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`) |
## 켜기와 조립