Redis

Redis에서 Valkey로 마이그레이션해야 할까요?

Scott Sternloff

작성: Scott Sternloff, 시니어 엔터프라이즈 아키텍트

LinkedIn · 업데이트:

REDISv7.xVALKEYforkTEST BEFORE MIGRATEPROTOCOL · MODULES · HARedis vs Valkey Compatibility
이 페이지의 내용

Valkey는 2024년 Redis Ltd.의 라이선스 변경으로 Redis가 완전한 오픈소스 라이선스에서 벗어나자, Linux Foundation의 지원을 받는 Redis 포크로 등장했습니다. Valkey는 같은 프로토콜, 같은 명령, 같은 클라이언트 라이브러리를 쓰는 드롭인 대체품을 표방합니다. 하지만 '드롭인'은 맹목적으로 믿을 주장이 아니라 테스트해야 할 주장입니다. 모듈, 커스텀 구성, 또는 간단하지 않은 메모리 관리 튜닝을 쓰고 있다면 더욱 그렇습니다.

이 글에서는 실제 운영 팀의 Valkey 호환성 병행 테스트를 바탕으로, 마이그레이션을 실제로 어떻게 평가해야 하는지 다룹니다.

Valkey는 기존 Redis 클라이언트 코드와 실제로 호환될까요?

핵심 명령과 표준 프로토콜은 호환됩니다. 그것이 이 포크의 전제이며, 일반적인 Redis 사용 대부분에 해당합니다. 하지만 '호환된다'는 것은 마케팅 문구를 믿고 가정할 것이 아니라 자사 배포에 맞게 검증해야 합니다. 특히 다음을 쓰고 있다면 더욱 그렇습니다.

  • Redis 모듈(RediSearch, RedisJSON, RedisTimeSeries 등). Valkey와의 모듈 호환성은 1:1로 보장되지 않으므로 명시적으로 테스트해야 합니다
  • Redis 고유의 버전 감지나 기능 협상 로직이 있는 클라이언트 라이브러리
  • Valkey에서 이름, 기본값, 동작이 다를 수 있는 기본값이 아닌 구성 파라미터

올바른 접근은 믿음만으로 마이그레이션하는 것이 아니라 실제 워크로드로 병행 테스트하는 것입니다. 실제 운영 환경 평가에서 한 팀은 ElastiCache Valkey 모드의 호환성과 성능을 로컬에서 현재 Redis 구성과 비교해 구성하고 테스트하는 과제를 맡아, Redis 검증에 쓰던 것과 같은 CI 환경에서 실행했습니다. 동시에 그와 무관한 Redis 안정성 문제도 해결하고 있었습니다. 진행 중인 Redis 운영을 대체하는 것이 아니라 병행하는 방식으로 Valkey를 평가했기에, 검증되지 않은 마이그레이션에 운영 안정성을 걸지 않고 호환성을 검증할 수 있었습니다.

Valkey 호환성 테스트는 실제로 무엇을 다뤄야 할까요?

실제 운영 테스트에서 다룬 내용을 그대로 따라, 다음 측면을 중심으로 평가를 구성하십시오.

프로토콜 및 명령 호환성. Redis 대신 Valkey를 대상으로 실제 애플리케이션 테스트 스위트를 실행해 깨지는 것이 없는지 확인하십시오. 흔히 쓰는 GET/SET/HGET 외에 애플리케이션이 사용하는 명령에 특히 주의하십시오. Lua 스크립트, 트랜잭션, pub/sub 패턴을 쓴다면 더욱 그렇습니다.

실제 부하 프로파일에서의 성능. 다른 곳에 공개된 일반적인 Valkey 대 Redis 벤치마크에 의존하지 마십시오. 다른 누군가의 워크로드를 반영한 결과일 뿐입니다. 대표적인 트래픽으로 두 시스템 모두에 직접 부하 테스트(JMeter, redis-benchmark, 또는 기존 부하 테스트 도구)를 실행하십시오.

비용 영향. 매니지드 서비스를 쓰고 있다면 가격 모델을 직접 비교하십시오. 예를 들어 AWS ElastiCache의 Valkey 모드에는 자체 가격 체계가 있으므로, 기본적으로 더 저렴하다고 가정하지 말고 현재 Redis Enterprise나 자체 운영 비용 기준선과 비교해 평가해야 합니다. 비용 영향 평가는 실제 운영 테스트 범위에 명시적으로 포함되어 있었습니다.

모듈 의존성 점검. RediSearch, RedisJSON 등의 모듈에 의존하고 있다면, 결정하기 전에 Valkey의 모듈 생태계가 자사의 구체적인 사용 방식을 지원하는지 확인하십시오. Redis와 비교해 공백이 생길 가능성이 가장 큰 영역입니다.

조직들이 애초에 Valkey를 검토하는 실제 이유는 무엇일까요?

대개 두 가지 별개의 동기가 나타나며, 어느 쪽이 해당하는지 분명히 해 둘 가치가 있습니다. 평가의 우선순위가 달라지기 때문입니다.

라이선스 우려. 2024년 이후 Redis Ltd.의 라이선스 조건이 불편한 조직, 특히 Redis를 재배포하거나 내장하는 제품을 만드는 조직은 기술적 동등성과 무관하게 옮겨야 할 구조적인 이유가 있을 수 있습니다.

현재 Redis 배포의 불안정. Redis 안정성 문제를 한창 디버깅 중인 팀은 더 넓은 개선 작업의 일부로 Valkey를 평가하기도 합니다. Valkey가 본질적으로 더 안정적일 것이라 기대해서라기보다, 마이그레이션이 이미 가능한 해결 경로 중 하나로 올라와 있고 다른 근본 원인 분석이 진행되는 동안 호환성을 테스트하는 것이 효율적이기 때문입니다. 앞서 언급한 실제 사례가 바로 이 패턴이었습니다. Valkey 평가는 누수 자체에 대한 직접적인 대응이 아니라, 진행 중이던 Redis 메모리 누수 조사와 병행해 이루어졌습니다.

동기가 라이선스라면 평가에서 법무/컴플라이언스 승인과 장기적인 프로토콜 호환성 보장을 우선해야 합니다. 동기가 안정성이라면, 그 불안정이 정말 Redis 대 Valkey의 문제인지, 아니면 어느 플랫폼으로 가든 따라올 아키텍처/구성 문제인지 스스로에게 솔직해야 합니다. 예를 들어 잘못 튜닝된 검색 인덱스로 인한 메모리 누수는 어느 포크를 쓰느냐를 바꾼다고 저절로 해결되지 않습니다.

Valkey는 Redis와 같은 고가용성 패턴을 지원할까요?

같은 코드베이스에서 포크되었으므로 Valkey는 Sentinel 방식의 모니터링과 페일오버, 클러스터 모드 샤딩이라는 Redis의 핵심 HA 아키텍처 개념을 그대로 유지합니다. 현재 HA 설계가 표준 Redis Sentinel이나 Redis Cluster 패턴에 기반하고 있다면, 그 아키텍처 지식을 그대로 활용할 수 있습니다.

그렇더라도 마이그레이션의 다른 모든 부분과 마찬가지로 검증하십시오. 동작이 같다고 가정하지 말고, 특히 네트워크 분할 시의 스플릿 브레인 처리와 쿼럼 동작을 중심으로 실제 페일오버 절차를 Valkey에서 테스트하십시오.

호환성을 검증한 뒤 실제 마이그레이션 경로는 어떻게 될까요?

단계적으로 접근하면 리스크가 줄어듭니다.

  1. 비운영 환경에서의 병행 테스트 — 앞서 언급한 사례와 똑같이, 같은 테스트 하네스와 트래픽 패턴으로 기존 Redis 구성과 나란히 Valkey를 실행합니다
  2. 아키텍처가 지원한다면 섀도/이중 쓰기 검증 — 읽기를 전환하기 전에 두 시스템 모두에 쓰고 결과를 비교합니다
  3. 중요도가 낮은 워크로드부터 시작하는 단계적 전환 — 비즈니스에 가장 중요한 Redis 인스턴스부터 옮기지 마십시오
  4. 문서화된 롤백 계획을 갖춘 전면 전환 — Valkey와 Redis는 릴리스마다 더 멀어지므로, 롤백이 현실적으로 불가능해지는 시점을 명확히 정해 두고, 그 결정을 기본값에 맡기지 말고 의도적으로 내리십시오

플랜에 따라 15분부터 시작하는 대응 목표. 전담 시니어 엔지니어.

문의하기

Valkey는 지금 운영 환경에 쓸 만큼 성숙했을까요?

Valkey는 강력한 지원(Linux Foundation, 그리고 AWS를 비롯해 매니지드 Valkey 서비스를 제공하는 주요 클라우드 제공업체)을 받고 있으며, 이 글을 쓰는 시점에 운영 팀들이 활발히 평가하고 도입하고 있습니다. 실험적이거나 검증되지 않은 포크가 아닙니다. 하지만 '신뢰할 만한 조직이 지원한다'는 것과 '우리 워크로드에서 검증되었다'는 것은 다른 이야기이며, 마이그레이션 일정을 정하는 근거는 두 번째여야 합니다.

현실적인 답은 이렇습니다. 실제 사용 패턴에 대한 호환성 및 성능 테스트가 깔끔하게 통과한다면, Valkey는 오늘 당장 운영 환경에 쓸 수 있는 정당한 선택지입니다. 모듈 의존성이 크거나 구성을 많이 커스터마이징했다면, 어느 쪽으로든 결정하기 전에 실제 테스트 시간을 확보하십시오.

Redis에서 Valkey로의 마이그레이션: 실제 운영 환경 마이그레이션에서 문제가 된 것들

저희가 진행한 마이그레이션 대부분은 팀들이 예상한 것보다 조용히 끝났고, 애플리케이션 코드는 바뀌지 않았습니다. 문제가 생긴 곳은 늘 같은 몇 군데였고, 모두 전환 전에 찾아낼 수 있었습니다.

  • 서버를 검사하는 클라이언트 라이브러리. 증상: Redis에서는 잘 동작하던 서비스가 Valkey에 연결을 거부하거나, 연결은 되지만 클라이언트 측 캐싱 같은 기능을 조용히 꺼 버립니다. 원인: 일부 클라이언트는 INFO나 HELLO 응답을 파싱해 "redis"라는 문자열이나 버전 번호를 비교하고, 그 결과에 따라 동작을 제한합니다. Valkey는 자체 이름과 버전을 보고하므로 이 확인이 실패합니다. HELLO로 RESP3를 협상하는 클라이언트는 조용히 RESP2로 되돌아가기도 하는데, 그러면 일부 응답의 형태가 바뀝니다. 해결: Valkey를 인식하는 클라이언트 릴리스로 업그레이드하고, 먼저 일회용 Valkey 컨테이너로 핸드셰이크를 테스트하십시오.
  • Valkey에 대응 모듈이 없는 모듈. 증상: 어떤 명령이 Valkey에서만 unknown command 오류를 반환합니다. 원인: Redis 노드에 검색, JSON, 시계열, Bloom 모듈이 로드되어 있었는데 아무도 목록을 만들어 두지 않았습니다. Valkey에도 자체 모듈 생태계가 있지만 일대일로 대응되지 않으며, Redis용으로 빌드된 모듈은 Valkey에 로드되지 않습니다. 해결: 무엇이든 계획하기 전에 모든 Redis 노드에서 MODULE LIST를 실행하고, 모듈마다 호환되는 Valkey 모듈이 있는지, 워크로드를 핵심 데이터 타입으로 옮길 수 있는지, 아니면 해당 클러스터는 당분간 Redis에 남길지 결정하십시오.
  • 영속성 및 복제 형식. 증상: 레플리카가 동기화를 거부하거나, 복원한 스냅샷이 로드되지 않습니다. 원인: Redis 7.x와 Valkey 8.x 사이에서 RDB 버전이 바뀌었습니다. Valkey 레플리카는 Redis 7.x 프라이머리가 보내는 스냅샷을 로드할 수 있으며, 그 덕분에 레플리카 방식(replica-of) 마이그레이션이 가능합니다. 반대는 성립하지 않습니다. Valkey가 더 새로운 RDB 형식으로 기록하고 나면 Redis 노드는 이를 로드할 수 없습니다. 해결: 마이그레이션 기간 동안 복제는 Redis에서 Valkey로의 한 방향으로만 다루고, 전환 전에 만든 Redis 형식 스냅샷을 롤백용으로 보관하십시오.
  • 구성 및 파일 경로. 증상: 서비스가 기본값으로 시작되거나 아예 시작되지 않습니다. 원인: 그대로 복사한 구성 파일이 여전히 /etc/redis와 /var/lib/redis를 참조하고, 서비스 유닛은 이전 바이너리를 가리키며, 일부 지시어는 버전 간에 이름이 바뀌었거나 지원 중단되었습니다. 해결: 디스크의 파일이 아니라 실행 중인 두 서버에서 CONFIG GET *의 결과를 비교하고, 모든 차이를 하나하나 의도적으로 해결하십시오.
  • 이전 이름을 기준으로 하는 모니터링. 증상: 전환 직후 대시보드가 비고 알림이 더 이상 울리지 않습니다. 원인: 익스포터가 redis-server 프로세스 이름으로 필터링하고, 패널이 redis_version 같은 INFO 필드를 기준으로 선택합니다. 해결: 전환 전에 프로세스 매처와 필드 이름을 수정하고, 스테이징 Valkey 노드에서 패널에 데이터가 채워지는지 확인하십시오. 이런 패널에 무엇이 표시되어야 하는지는 Redis 고가용성 가이드에서 다룹니다.
  • AWS 매니지드 서비스. ElastiCache와 MemoryDB는 모두 Valkey 엔진을 제공하며, Redis OSS 클러스터에서의 인플레이스 엔진 업그레이드는 저희가 써 본 방법 중 가장 문제가 적었습니다. 팀들이 걸려 넘어지는 지점은 두 가지입니다. 파라미터 그룹은 엔진별로 존재하므로 커스텀 Redis 파라미터 그룹은 Valkey 그룹으로 다시 만들고 한 줄씩 검토해야 합니다. 또한 엔드포인트는 그대로인데 보고되는 엔진 이름이 바뀌므로, 위의 클라이언트 및 모니터링 확인에 걸립니다.
  • 손에 익은 습관. 바이너리는 valkey-server, CLI는 valkey-cli이고, 패키지와 서비스 유닛도 새 이름을 씁니다. 런북과 온콜 노트를 수정하지 않으면, 마이그레이션 후 첫 장애 대응이 존재하지 않는 명령으로 시작됩니다.

흔한 실패를 피하는 마이그레이션 런북

  1. 인벤토리. 모든 Redis 노드에서 MODULE LIST, INFO server, CONFIG GET *의 결과를 수집합니다. 배치 작업과 사이드카를 포함해 연결하는 모든 서비스의 클라이언트 라이브러리와 고정된 버전을 목록으로 정리합니다.
  2. 클라이언트부터 수정합니다. 서버 이름 확인에서 실패하는 것은 모두 업그레이드하거나 패치하고, Valkey를 대상으로 HELLO 핸드셰이크를 테스트합니다.
  3. 스테이징에서 Valkey 레플리카를 실행합니다. REPLICAOF로 Redis 프라이머리의 복사본을 바라보게 하고, 운영과 비슷한 형태의 트래픽에서 최소 한 번의 전체 업무 주기 동안 안정화 관찰(soak)을 합니다. 메모리, 지연 시간, slowlog를 Redis 기준선과 비교합니다.
  4. 읽기를 먼저, 쓰기를 나중에 전환합니다. 읽기 트래픽을 Valkey로 옮기고 지켜봅니다. 그다음 Valkey를 승격하고 쓰기를 옮깁니다. 정해 둔 롤백 기간 동안 Redis 노드는 변경 없이 살려 둡니다.
  5. Valkey에서 영속성과 페일오버를 검증합니다. RDB와 AOF가 문제없이 기록되고 다시 로드되는지 확인합니다. 그다음 훈련을 합니다. Valkey 프라이머리를 강제로 내리고, 승격을 확인하고, 클라이언트가 수동 개입 없이 다시 연결되는지 확인하고, 소요 시간을 잽니다. 훈련 중 발생하는 클라이언트 타임아웃은 대개 서버 결함이 아니라 클라이언트 설정 문제입니다. 서버는 정상인데 Redis 클라이언트 타임아웃이 발생할 때를 참고하십시오.
  6. 모니터링을 수정합니다. 프로세스 이름, INFO 필드, 알림 임계값입니다. 대시보드를 믿기 전에 실제 알림을 한 번 발생시켜 봅니다.
  7. 폐기는 롤백 기간이 끝난 뒤에만 합니다.

롤백 경계는 두 가지입니다. 첫째는 Valkey 전용 기능이나 명령을 쓰기 시작하는 순간이고, 둘째는 Valkey가 더 새로운 RDB 버전으로 기록하는 순간입니다. 둘 중 하나라도 지나면 Redis로 되돌려 복제하는 것은 지원되지 않으며, 롤백은 전환 전 Redis 스냅샷을 복원하고 그 사이의 데이터 손실을 감수한다는 뜻이 됩니다. 각 경계를 언제 넘을지 미리 정하고 그 날짜를 런북에 적어 두십시오.

저희는 전체 과정을 지원합니다. 인벤토리와 전환은 Redis 컨설팅이, 이후에는 24/7 체계와 15분 P1 응답의 Valkey 기술 지원이 맡으며, 아직 지원 방식을 정하지 못했다면 Valkey 기술 지원 옵션 비교를 참고하십시오.

Redis에서 Valkey로의 마이그레이션에 관한 도움 받기

Redis에서 Valkey로의 마이그레이션을 검토 중이거나, 호환성 평가를 체계적으로 설계하는 데 도움이 필요하신가요? AceMQ는 두 플랫폼을 모두 지원하며, 일반적인 벤치마크가 아니라 실제 워크로드를 바탕으로 결정하도록 도와드립니다. AceMQ는 엔터프라이즈 Redis 기술 지원과 Valkey 기술 지원을 제공합니다. AceMQ 엔지니어와 상담하십시오.

결정을 내렸다면, 다음 질문은 운영 환경에서 누가 이를 뒷받침하느냐입니다. Valkey 기술 지원 옵션을 참고하십시오.

이 글은 Redis 및 Valkey 기술 지원 구매 가이드의 6단계 중 여섯 번째 단계입니다. 매니지드 캐시, Redis Cloud, 자체 운영 Redis가 각각 어디에 맞는지는 매니지드 Redis 옵션 비교를, 자사 인프라에서 AceMQ가 운영하는 Redis는 매니지드 Redis 서비스를 참고하십시오.

자주 묻는 질문

Valkey는 기존 Redis 클라이언트 코드와 실제로 호환되나요?

핵심 명령과 표준 프로토콜은 호환됩니다. 그것이 이 포크의 전제이며, 일반적인 Redis 사용 대부분에 해당합니다. 하지만 RediSearch나 RedisJSON 같은 모듈, Redis 고유의 버전 감지 로직이 있는 클라이언트 라이브러리, 기본값이 아닌 구성 파라미터는 운영 환경에서 신뢰하기 전에 호환성을 검증해야 합니다.

Valkey 호환성 테스트는 실제로 무엇을 다뤄야 하나요?

네 가지 측면입니다. 실제 애플리케이션 테스트 스위트를 통한 프로토콜 및 명령 호환성, 공개된 벤치마크가 아닌 실제 부하 프로파일에서의 성능, 사용 중인 매니지드 서비스 가격 모델에 따른 비용 영향, 그리고 RediSearch, RedisJSON 등에 의존한다면 모듈 의존성 점검입니다.

조직들이 Valkey를 검토하는 실제 이유는 무엇인가요?

두 가지 서로 다른 동기가 있습니다. 하나는 2024년 이후 Redis Ltd.의 라이선스 조건에 대한 우려이고, 다른 하나는 이미 마이그레이션이 선택지로 올라와 있을 만큼 현재 Redis 배포가 불안정한 경우입니다. 어느 쪽이 해당하는지 솔직하게 판단하십시오. 평가에서 무엇을 우선해야 하는지가 달라집니다.

Valkey는 Redis와 같은 고가용성 패턴을 지원하나요?

네. 같은 코드베이스에서 포크되었으므로 Valkey는 Sentinel 방식의 모니터링과 페일오버, 클러스터 모드 샤딩이라는 핵심 구조를 그대로 유지합니다. 그래도 동작이 같다고 가정하지 말고, 특히 스플릿 브레인과 쿼럼 처리를 중심으로 실제 페일오버 절차를 Valkey에서 테스트하십시오.

호환성을 검증한 뒤 실제 마이그레이션 경로는 어떻게 되나요?

단계적 접근입니다. 비운영 환경에서의 병행 테스트, 아키텍처가 지원한다면 섀도/이중 쓰기 검증, 중요도가 낮은 워크로드부터 시작하는 단계적 전환, 그리고 문서화된 롤백 계획을 갖춘 전면 전환 순입니다.

Valkey는 지금 운영 환경에 쓸 만큼 성숙했나요?

네, 단서가 붙습니다. Linux Foundation과 클라우드 제공업체의 강력한 지원을 받고 있으며 실제 운영 환경에서 활발히 쓰이고 있습니다. 하지만 '신뢰할 만한 조직이 지원한다'는 것과 '우리 워크로드에서 검증되었다'는 것은 다른 이야기입니다. 일정은 자사 사용 패턴에서 깔끔하게 통과한 호환성 및 성능 테스트만을 근거로 정해야 합니다.

대부분의 팀에게 현실적인 답은 이렇습니다. 호환성 및 성능 테스트가 깔끔하게 통과한다면 Valkey는 오늘 당장 운영 환경에 쓸 수 있는 정당한 선택지입니다. 다만 그 답은 드롭인 대체품으로 홍보된다는 사실이 아니라 자사의 테스트 결과에서 나와야 합니다.

Redis에서 Valkey로 마이그레이션할 때 어떤 문제가 생기나요?

저희가 진행한 운영 환경 마이그레이션에서 애플리케이션 계층이 깨진 경우는 거의 없었습니다. 문제는 주변부에서 생겼습니다. 서버 이름이나 버전을 확인해 연결을 거부하거나 기능을 꺼 버리는 클라이언트 라이브러리, Valkey에 대응 모듈이 없는 Redis 전용 모듈, 여전히 Redis 경로를 참조하는 구성 파일과 서비스 유닛, redis-server 프로세스 이름이나 redis_version 같은 INFO 필드로 필터링하는 모니터링입니다. AWS에서는 엔진별 파라미터 그룹도 다시 만들어야 합니다. 이 모두는 제대로 된 인벤토리만 있으면 스테이징에서 찾아낼 수 있으며, 그래서 인벤토리가 저희 런북의 첫 단계입니다.

마이그레이션 중에 Redis에서 Valkey로 복제할 수 있나요?

네, 한 방향으로만 가능합니다. Valkey 8.x 레플리카는 REPLICAOF로 Redis 7.x 프라이머리와 동기화하고, 받은 스냅샷을 로드한 뒤, 복제 스트림으로 최신 상태를 유지할 수 있습니다. 저희가 안정화 관찰(soak) 기간과 '읽기 먼저, 쓰기 나중' 전환에 쓰는 메커니즘입니다. 반대 방향은 안 됩니다. Valkey가 더 새로운 RDB 형식으로 쓰기 시작하거나 Valkey 전용 기능을 쓰기 시작하면, Redis 노드는 그 레플리카가 될 수 없습니다. Redis에서 Valkey로의 연결은 끝이 정해진 마이그레이션 기간으로 다루고, 전환 전 Redis 스냅샷을 롤백용으로 보관하십시오.

Redis 모듈은 Valkey에서 동작하나요?

그대로는 동작하지 않습니다. Redis용으로 컴파일된 모듈은 Valkey에 로드되지 않으며, Redis의 검색, JSON, 시계열, Bloom 모듈은 그대로 대체할 수 있는 동등 모듈이 보장되지 않습니다. Valkey에도 일부 같은 영역을 다루는 자체 모듈 생태계가 있지만, 지원 범위가 모듈과 버전마다 다르므로 하나씩 확인해야 합니다. 마이그레이션을 계획하기 전에 모든 Redis 노드에서 MODULE LIST를 실행하십시오. 모듈마다 호환되는 Valkey 모듈이 있는지, 워크로드를 핵심 데이터 타입으로 옮길 수 있는지, 아니면 해당 클러스터는 당분간 Redis에 남길지 결정하십시오.

무료 상담

Redis 배포 환경, 전문가에게 점검받으세요

프로덕션 장애를 해결하는 중이든, 마이그레이션을 계획 중이든, 아키텍처에 대한 다른 의견이 필요하든 AceMQ 팀이 준비되어 있습니다. 영업 권유 없이 답만 드립니다.

이메일 문의