문제: 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).
3.6 KiB
Redis와 client 업그레이드 관문
Redis 서버 버전이나 Lettuce 버전을 바꾸는 것은 의존성 올리기가 아니다. 둘 다 어떤 명령이 있는지, 무엇을 답하는지, ACL 계정이 무엇을 해도 되는지를 바꾼다. 셋 모두 이 SDK가 고정된 결정으로 담고 있는 것이다. 어느 버전이든 움직이기 전에 아래 검사를 통과해야 하고, 각 검사를 건너뛰면 운영에서만 드러나는 특정한 실패가 생긴다.
1. 명령 metadata diff
새 서버의 COMMAND DOCS / COMMAND INFO를 정책과 손으로 비교한다. 서버가 보고하는 모든 명령이
src/adapter/outbound/redis-sdk/src/main/resources/redis-sdk/redis-command-policy.yml에 분류돼 있어야 하고, 정책이
기대는 모든 key 명세, ACL 분류, 폐기 표시가 여전히 맞아야 한다. 자동 diff는 없다. RedisCommandMetadataDiff는 아무도
가져온 적 없는 서버 metadata와 비교했고, 지웠다(docs/capability-status.md).
이유: 분류하지 않은 명령은 CommandPolicyGuard가 거부한다. 그래서 명령이 늘어난 서버는 구멍을 만들지 않는다. 다만
상위에서 위험도가 바뀌었는데 여기서 아직 R1로 분류된 명령은 구멍을 만든다. 그것을 드러내는 것이 비교다.
2. ACL 회귀
RedisAdminOperations.aclDryRun으로, SDK가 보낼 수 있는 모든 명령에 대해 모든 계정의 ACL DRYRUN을 다시 돌린다.
이유: 허가는 ACL 계정을 절대 넓히지 않는다. 그래서 계정이 마지막 경계다. 새 서버 버전이 명령을 다른 ACL 분류로 옮기면, 되던 호출이 그것이 필요한 첫 요청에서 실행 중 거부로 조용히 바뀐다.
3. Serializer golden byte
등록한 모든 codec의 인코딩 결과를 저장해 둔 golden byte와 비교한다.
이유: 옛 버전이 쓴 값이 업그레이드 뒤에도 디코딩돼야 한다. 왕복 테스트에서 해롭지 않아 보이는 codec 변경도 이미 인스턴스에 있는 데이터에 대해서는 해롭다.
4. 지원 매트릭스
docs/redis/support-matrix.md를 고친다. RedisSupportMatrixTest는 모듈이나 capability가 빠지면 실패한다. 인증 버전
표는 그 토폴로지 lane이 실제로 돌기 전까지 버전을 주장하면 안 된다.
5. 토폴로지 suite
src/adapter/outbound/redis-sdk/compose/에 선언한 standalone, Sentinel, Cluster lane을 돌린다. 버전은 숫자가 더 새것이라서가
아니라 lane이 통과해서 인증된다.
이유: failover 확실성과 slot을 넘는 동작은 메모리 안 fixture가 증명할 수 없는 두 가지다. ExecutionCertainty와
RedisSlotCalculator는 분류와 산수다. 승격이나 재분배 중에 driver가 정말 그렇게 동작하는지는 실제 토폴로지에서만 볼 수
있다.
6. 되돌리기
업그레이드 전에 앞 서버 버전, 앞 Lettuce 버전, 등록한 모든 script의 SCRIPT LOAD digest를 적어 둔다. 되돌린 버전에서
digest가 다시 풀릴 때까지 되돌리기는 끝나지 않은 것이다.
이유: digest는 프로세스마다 cache되고 SCRIPT FLUSH와 재시작으로 무효가 된다. 되돌린 서버가 모르는 digest를 쥔
프로세스가 남으면, cache를 버릴 때까지 script를 쓰는 모든 호출에서 NOSCRIPT가 난다.
이 관문이 다루지 않는 것
데이터 마이그레이션. 여기의 어떤 것도 저장된 값을 옮기거나 모양을 바꾸지 않는다. 주소 잡는 방식이 아니라 저장하는 것을 바꾸는 변경에는 따로 계획이 필요하다.