Files
clean-architecture-backend-…/docs/redis/command-policy.md
T
DongHyeonka 4e2f08a687 docs(redis): Redis SDK 운영 문서를 한국어로 옮긴다
문제: docs/redis 아래 살아 있는 문서 4개가 영어였다(language 예외).

고친 방법: 뜻을 그대로 옮기고 식별자·명령·경로·표 구조는 원문으로 둔다.
support-matrix.md의 표 첫 칸(package·capability·토폴로지 이름)과 증거 칸의 테스트 클래스
이름은 RedisSupportMatrixTest가 그대로 읽으므로 바꾸지 않았다. 번역하며 고친 것:
- 「pinned to Lettuce 6.8.2」: build.gradle은 버전 없이 Boot BOM을 따른다. 숫자 대신
  BOM과 leaf gradle.lockfile을 가리킨다.
- 「five defects」 뒤 목록이 일곱 항목이라 「결함 일곱」으로 고쳤다.

위험·한계: 내용 감사는 하지 않았다.

검증: python3 scripts/check-docs.py에서 이 폴더 예외 줄 0. RedisSupportMatrixTest의 세
단언(package·capability가 첫 칸에 있음, 토폴로지 행이 있는 테스트 클래스를 댐)을 같은
규칙으로 문서에 돌려 보았다(빠진 것 0).
2026-11-07 17:29:57 +09:00

3.0 KiB
Raw Blame History

명령 정책

src/adapter/outbound/redis-sdk/src/main/resources/redis-sdk/redis-command-policy.yml이 이 SDK가 Redis 명령마다 무엇을 해도 되는지 정하는 유일한 정본이다. 명령이 무엇인지는 공식 서버 metadata가 정하고, 무엇을 허락할지는 이 파일이 정한다.

거기에 분류되지 않은 명령은 거부한다. 그래서 명령을 더하는 것은 코드를 쓰는 일이 아니라 그 파일을 고치는 일이고, 위험 판단을 내리고 검토하는 곳이 그 수정이다.

필드

필드 기본값 뜻
risk 필수 R1 일상, R2 명시적 허가 필요, R3 관리, R4 절대 허락 안 함
support 필수 TYPED, ADVANCED_TYPED, RAW_ONLY, ADMIN_ONLY, VERSION_GATED, BLOCKED
minimum-version 7.2 그 명령이 있는 가장 낮은 서버 버전
access support에서 정함 어느 ACL 계정이 보낼 수 있는지
blocking false 서버가 답할 때까지 connection을 잡는다
optional-block false 그 명령에 blocking 아닌 형태도 있다. XREAD와 XREADGROUP만 가진다
read-only false 데이터를 절대 바꾸지 않는다
retry-safe read-only 서버에 닿았을 수 있는 실패 뒤에도 재시도해도 된다
may-be-ambiguous !read-only 실패가 결과를 모르는 상태로 남길 수 있다
timeout-profile 정함 FAST, COLLECTION, ADMIN, BLOCKING
key-spec 1 1 1 key가 있는 곳. 또는 none, movable
required-policy – R2 명령이 요구하는 허가 정책

목록이 강제하는 규칙

  • R2 ADVANCED_TYPED 명령은 요구하는 허가 정책의 이름을 대야 한다. 발급한 허가 없이 누구나 보낼 수 있는 R2 명령은 없다.
  • R4 명령은 BLOCKED여야 하고, R3 명령은 ADMIN_ONLY여야 한다. 그 밖의 조합은 불러올 때 타입 체계가 거부한다.
  • BLOCKED 명령에는 ACL 계정이 없다. 그래서 SDK의 어떤 경로도 그것에 닿을 수 없다.
  • blocking 명령은 BLOCKING timeout profile을 써야 하고, 그 요청은 상한 있는 서버 block을 선언해야 한다. optional-block도 선언하면 예외인데, stream 읽기 둘만 그렇다.
  • 폐기된 명령 이름은 SDK가 그 동작을 제공하더라도 BLOCKED로 남는다. 타입 있는 sorted-set 범위 조회는 ZRANGEBYSCORE가 아니라 ZRANGE ... BYSCORE|BYLEX|REV를 보낸다. 그래서 guard가 들은 명령과 wire에 닿는 명령이 같다.

지원 등급마다 닿는 곳

지원 닿는 곳
TYPED 타입 있는 연산, 허가 없이
ADVANCED_TYPED 타입 있는 연산, 이름 댄 허가와 함께
VERSION_GATED probe가 그 기능을 찾았을 때만 있는 capability bean
RAW_ONLY sdk.raw, 그리고 배포가 등록한 승인이 있을 때만
ADMIN_ONLY sdk.admin, 읽기 전용 진단만
BLOCKED 어디에도 없음