# 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`가 난다. ## 이 관문이 다루지 않는 것 데이터 마이그레이션. 여기의 어떤 것도 저장된 값을 옮기거나 모양을 바꾸지 않는다. 주소 잡는 방식이 아니라 저장하는 것을 바꾸는 변경에는 따로 계획이 필요하다.