Redis 및 Valkey 워크로드를 Memorystore for Valkey로 마이그레이션

이 문서에서는 자체 관리형 Redis 및 Valkey 워크로드를 Memorystore for Valkey로 마이그레이션하는 작업을 자동화하는 방법을 설명합니다. 완전 관리형 환경으로 마이그레이션하면 자체 인프라를 관리하는 운영 부담이 사라지므로 수동 OS 패치, 복제 설정, 커스텀 백업 스크립트를 처리할 필요가 없습니다. 이 기능을 사용하면 기본 제공되는 자동 장애 조치, 안전한 VPC 연결, 다운타임 없는 확장을 활용할 수 있습니다.

자체 관리형 워크로드를 Memorystore for Valkey로 마이그레이션하면 운영 부담을 없애고 데이터베이스 인프라를 현대화하는 다음과 같은 이점을 누릴 수 있습니다.

• 운영 오버헤드 제거: OS 패치, 인프라 모니터링, 백업 스크립트, 복제 관리와 같은 수동적이고 시간이 많이 소요되는 작업을 Google Cloud에 오프로드합니다. 따라서 데이터베이스 유지보수 대신 애플리케이션 개발에 집중할 수 있습니다.
• 엔터프라이즈급 고가용성 달성: 완전 관리형 99.99% SLA의 이점을 누릴 수 있습니다. Memorystore for Valkey는 자동 장애 조치와 기본 제공 백업 및 복원 기능을 제공합니다. 이렇게 하면 예기치 않은 노드 장애로부터 애플리케이션을 보호하고 신속한 재해 복구를 보장할 수 있습니다.
• 다운타임이 거의 없는 확장: 예측할 수 없는 트래픽 급증에 맞게 인스턴스를 동적으로 수평 확장 또는 축소합니다. 애플리케이션을 오프라인으로 전환하지 않고도 수백 개의 노드(최대 250개 샤드)로 확장할 수 있습니다.
• 보안 강화: 복잡하고 수동으로 구성된 네트워크 규칙을 안전한 기본 제공 VPC 연결 및 세분화된 Identity and Access Management(IAM) 기반 액세스 제어로 대체합니다. 이렇게 하면Google Cloud의 엄격한 보안 경계가 데이터를 보호합니다.
• 인스턴스 통합 및 업그레이드: 분산되고 사일로화된 자체 관리형 인스턴스를 Memorystore for Valkey의 단일 고성능 배포로 병합합니다. 이 마이그레이션의 일환으로 오래된 Redis 또는 Valkey 버전을 지원되는 최신 출시 버전으로 자동 업그레이드할 수도 있습니다.
• 고급 실시간 분석 및 생성형 AI 활용: 캐싱 및 세션 관리를 위해 마이크로초 지연 시간을 제공하는 최적화된 환경으로 전환합니다. 생성형 AI(GenAI) 애플리케이션을 지원하기 위해 벡터 검색과 같은 고급 기능에 대한 관리형 액세스 권한을 즉시 얻을 수 있습니다.

버전 지원

이 섹션의 표에는 소스 Redis 및 Valkey 자체 관리형 인스턴스와 Memorystore for Valkey의 대상 인스턴스에 대한 다음 정보가 나와 있습니다.

• 마이그레이션에서 지원하는 소스 인스턴스의 유형 및 버전
• 워크로드를 마이그레이션할 수 있는 대상 Memorystore for Valkey 인스턴스의 버전

소스 인스턴스 유형	소스 인스턴스 버전	대상 인스턴스 버전
Redis	3.2.x~7.2.x	Valkey 7.2, 8.0, 9.0, 9.1
Valkey	7.x, 8.x, 9.x	Valkey 7.2, 8.0, 9.0, 9.1

중요: 대상 인스턴스의 버전은 소스 인스턴스와 동일하거나 이후 버전이어야 합니다. 대상 인스턴스를 이전 버전으로 다운그레이드할 수 없습니다.

시작하기 전에

워크로드 이전을 시작하기 전에 이 섹션의 기본 요건을 완료하세요.

Google Cloud 콘솔, gcloud CLI, API 사용

Google Cloud 콘솔, Google Cloud CLI(gcloud CLI), API를 사용하려면 다음을 수행합니다.

1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Roles required to select or create a project

   • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
   • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

2. Verify that billing is enabled for your Google Cloud project.

3. Google Cloud CLI를 설치하고 초기화합니다.

   이전에 gcloud CLI를 설치한 경우 gcloud components update를 실행하여 최신 버전이 설치되어 있는지 확인합니다. Memorystore for Valkey gcloud CLI 명령어에 액세스하려면 최소한 gcloud CLI 버전 489.0.0 이상이 필요합니다.

4. Memorystore for Valkey API를 사용 설정합니다.
   Memorystore for Valkey API
5. Network Connectivity API를 사용 설정합니다.
   Network Connectivity API
6. Service Consumer Management API를 사용 설정합니다.
   Service Consumer Management API
7. Compute Engine API를 사용 설정합니다.
   Compute Engine API

역할 및 권한 할당

자체 관리형 Redis 및 Valkey 워크로드를 Memorystore for Valkey로 마이그레이션하려면 관리자에게 Google Cloud 프로젝트에 대한 Memorystore 관리자(roles/memorystore.admin) IAM 역할을 부여해 달라고 요청하세요. 이 역할에 대한 자세한 내용은 사전 정의된 역할을 참조하세요.

네트워크 연결을 만들고 보려면 관리자에게 Google Cloud 프로젝트에 대한 Compute 네트워크 관리자(roles/compute.networkAdmin) IAM 역할을 부여해 달라고 요청하세요. 이 역할에 대한 자세한 내용은 Compute Engine 역할을 참조하세요.

워크로드 마이그레이션 워크플로

자체 관리형 Redis 및 Valkey 워크로드를 Memorystore for Valkey로 마이그레이션하려면 다음 작업을 수행합니다.

1. 소스 인스턴스 준비: Memorystore for Valkey에 대한 보안 연결 및 아웃바운드 복제를 허용하도록 자체 관리형 Redis 또는 Valkey 인스턴스를 구성합니다.
2. 대상 인스턴스 준비: 샤드 수, 노드 유형 등 필요한 인스턴스 사양을 결정합니다.
3. 대상 인스턴스 만들기: 마이그레이션된 데이터를 수신하는 Memorystore for Valkey 인스턴스를 프로비저닝합니다.
4. 네트워크 연결 구성: 네트워크 연결을 설정합니다. 이 연결을 통해 대상 인스턴스(Google 관리형 VPC 네트워크에 있음)가 소스 인스턴스(VPC 네트워크에 있음)에 대한 연결을 시작할 수 있습니다. 이에 따라 복제가 설정됩니다.
5. 이전 시작: 동기화 프로세스를 시작합니다. 대상 인스턴스는 소스 인스턴스에 자동으로 연결되고 데이터를 읽기 복제본으로 지속적으로 복제합니다.
6. 마이그레이션 모니터링: 마이그레이션이 문제 없이 진행되고 마이그레이션 상태가 HEALTHY인지 확인합니다.
7. 마이그레이션 완료: 애플리케이션 트래픽을 대상 인스턴스로 컷오버합니다.

소스 인스턴스 준비

워크로드를 대상 Memorystore for Valkey 인스턴스로 마이그레이션할 수 있도록 자체 관리형 Redis 또는 Valkey 인스턴스를 준비해야 합니다.

대상 인스턴스의 노드에서 소스 인스턴스의 노드로 연결을 허용하려면 다음을 수행합니다.

• 소스 노드에서 보호 모드를 사용 설정한 경우 비활성화합니다.
• 명시적 bind 지시어를 사용하여 소스 노드를 구성한 경우 대상 노드에서 들어오는 연결을 허용하도록 노드를 업데이트합니다. 대상 노드는 네트워크 연결의 서브넷에 있는 IP 주소에서 연결을 시작합니다.
• 대상 노드에서 들어오는 연결을 차단할 수 있는 방화벽 규칙을 업데이트합니다.
• 소스 노드에서 인증 및 전송 계층 보안(TLS)을 사용 설정한 경우 비활성화합니다.

대상 노드가 소스 노드와 복제를 설정하도록 하려면 다음을 수행합니다.

• 데이터 수정을 수행하거나 복제에 사용되는 Valkey 또는 Redis 명령어(예: PING, PSYNC, HSET)의 이름을 바꾸지 마세요.
• 인스턴스에 액세스 제어 목록(ACL)을 사용하는 경우 대상 인스턴스가 복제를 설정할 수 있도록 default 사용자에 대해 다음 명령어를 허용합니다.
  • REPLCONF
  • SYNC
  • PSYNC
  • PING
  • INFO
  • CLUSTER | NODES
• 소스 인스턴스에 대상 노드의 추가 복제 부하를 관리할 수 있는 충분한 메모리와 CPU 용량이 있는지 확인합니다.

중요: 소스 인스턴스의 IP 주소와 포트 번호를 기록해 둡니다. 이전 프로세스를 시작하려면 이 정보가 필요합니다.

또한 Memorystore for Valkey는 마이그레이션 프로세스 전반에서 이 IP 주소 및 포트와 통신할 수 있어야 합니다. Memorystore for Valkey는 IP 주소와 포트를 사용하여 인스턴스 토폴로지의 다른 노드를 자동으로 검색합니다.

대상 인스턴스 준비

원활한 복제 프로세스를 보장하려면 소스 인스턴스에서 들어오는 워크로드를 처리할 수 있도록 Valkey용 Memorystore 대상 인스턴스의 크기를 적절하게 조정해야 합니다. 이렇게 하려면 대상 인스턴스의 정확한 사양을 결정합니다. 이러한 사양에는 소스 인스턴스, 클러스터 모드, 데이터베이스 수, 샤드 수, 인스턴스 버전, 노드 유형과의 호환성이 포함됩니다.

대상 인스턴스를 준비하려면 다음 가이드라인을 따르세요.

• 소스 인스턴스와의 호환성: 소스 및 대상 인스턴스는 동일한 Google Cloud 프로젝트 및 리전에 있어야 합니다.
• 클러스터 모드: 대상 인스턴스의 클러스터 모드가 소스 인스턴스의 클러스터 모드와 일치해야 합니다. 소스 인스턴스가 클러스터 모드 사용 중지됨인 경우 대상 인스턴스도 클러스터 모드 사용 중지됨이어야 합니다. 그렇지 않으면 대상 인스턴스가 클러스터 모드 사용 설정 상태여야 합니다.
• 데이터베이스 수: 대상 인스턴스가 클러스터 모드 사용 중지인 경우 인스턴스의 논리적 데이터베이스 수가 소스 인스턴스의 데이터베이스 수 이상이어야 합니다.
• 샤드 수: 대상 인스턴스가 클러스터 모드 사용 설정인 경우 인스턴스의 샤드 수가 소스 인스턴스의 샤드 수와 일치해야 합니다. 하지만 소스 및 대상 인스턴스의 복제본 수는 다를 수 있습니다.
• 인스턴스 버전: 대상 인스턴스의 버전은 소스 인스턴스의 버전과 호환되어야 합니다. 자세한 내용은 버전 지원을 참조하세요.
• 유지보수 버전: 대상 인스턴스의 유지보수 버전은 MEMORYSTORE_20260313_01_00 이상이어야 합니다. 자세한 내용은 유지보수 정보를 참조하세요.
• 노드 유형: 대상 인스턴스의 노드 유형은 소스 노드에서 수신하는 데이터를 처리할 수 있을 만큼 커야 합니다. 대상 인스턴스에 선택할 수 있는 노드 유형과 각 노드 유형에 해당하는 키스페이스 용량에 대한 자세한 내용은 노드 유형 사양을 참조하세요.

중요: 리전 간 복제 인스턴스를 대상 인스턴스로 사용할 수 없습니다. 또한 Memorystore for Valkey가 소스 인스턴스에서 사용하는 명령어를 차단하지 않는지 확인합니다.

대상 인스턴스 만들기

Memorystore for Valkey가 소스 인스턴스에서 마이그레이션하는 데이터를 수신하기 위한 요구사항을 충족하는 대상 인스턴스가 없으면 인스턴스를 만들어야 합니다.

이 인스턴스를 만들려면 Google Cloud 콘솔, gcloud CLI 또는 REST API를 사용합니다. 인스턴스 만들기에 대한 자세한 내용은 인스턴스 만들기를 참조하세요.

중요: 대상 인스턴스를 만들기 전에 가이드라인을 검토하여 적절하게 크기를 조정하고 구성하세요. 자세한 내용은 대상 인스턴스 준비를 참조하세요.

네트워크 연결 구성

소스 인스턴스의 워크로드를 대상 인스턴스로 마이그레이션하려면 대상 노드가 소스 노드에 연결되어야 합니다. 이 연결을 사용 설정하려면 네트워크 연결을 사용해야 합니다. 대상 노드는 네트워크 연결에 연결된 소스 인스턴스의 VPC 네트워크에 있는 서브넷에서 연결을 시작합니다.

다음 요구사항을 충족하는 네트워크 연결을 사용할 수 있습니다.

• 대상 인스턴스와 동일한 Google Cloud 프로젝트 및 리전에 있어야 합니다.
• 서브넷은 소스 인스턴스와 동일한 VPC 네트워크 내에 있어야 합니다.
• 소스 인스턴스의 서브넷에는 최소 N+1개의 사용 가능한 IP 주소를 지원하는 적절한 IP CIDR 범위가 있어야 합니다(여기서 N는 대상 인스턴스의 노드 수). 예를 들어 대상 인스턴스에 샤드 3개와 복제본 1개가 있는 경우 노드 6개(기본 인스턴스 노드 3개, 복제본 노드 3개)가 있습니다. 따라서 IP 주소가 7개 이상 필요합니다.
• Memorystore for Valkey에서 이 범위를 예약하므로 서브넷 범위가 10.0.0.0/23와 겹칠 수 없습니다.

네트워크 연결이 이러한 요구사항을 충족하지 않거나 네트워크 연결이 없는 경우 네트워크 연결을 만들어야 합니다. 자세한 내용은 네트워크 연결 만들기를 참조하세요.

마이그레이션 시작

마이그레이션을 시작하면 대상 인스턴스가 소스 인스턴스와 복제를 설정합니다. 대상 인스턴스는 애플리케이션이 소스 인스턴스에 쓰는 모든 데이터를 자동으로 복제합니다. 대상 인스턴스는 소스 인스턴스의 읽기 복제본이 됩니다.

마이그레이션을 시작하려면 Google Cloud 콘솔, gcloud CLI 또는 REST API를 사용합니다.

중요: 마이그레이션을 시작하기 전에 네트워크 연결 구성의 가이드라인을 검토하세요. 또한 마이그레이션을 시작한 후에는 마이그레이션을 완료할 때까지 소스 인스턴스에서 슬롯 마이그레이션 작업(예: 인스턴스 재분산 또는 샤드 간에 해시 슬롯 수동 이동)을 수행하지 마세요.

콘솔

1. Google Cloud 콘솔에서 Memorystore for Valkey 페이지로 이동합니다.

   Memorystore for Valkey

2. 대상 인스턴스의 ID를 클릭합니다.

3. 인스턴스 한눈에 보기 페이지에서 이전 시작을 클릭합니다.

4. 자체 관리형 Redis 및 Valkey 인스턴스 마이그레이션 창에서 다음을 수행합니다.

5. 준비 탭에서 소스 인스턴스의 기본 요건과 네트워크 연결 가이드라인에 대한 정보를 읽습니다. 그런 다음 계속을 클릭합니다.

6. 연결 탭에서 다음을 수행합니다.

   1. 소스 인스턴스의 IP 주소 및 포트를 입력합니다. 이 정보는 소스 인스턴스 준비에서 기록해 두었습니다.
   2. 데이터를 마이그레이션하는 데 사용할 네트워크 연결을 선택합니다.
   3. 계속을 클릭합니다.

7. 검토 탭에서 마이그레이션 프로세스와 관련된 정보를 검토합니다. 이 정보에는 대상 인스턴스의 ID, 소스 인스턴스의 IP 주소 및 포트, 네트워크 연결 이름이 포함됩니다. 이 정보를 검토한 후 이전 시작을 클릭합니다.

8. 인스턴스 한눈에 보기 페이지에서 마이그레이션 중 상태가 표시되는지 확인합니다.

대상 노드가 소스 노드에 연결할 수 없거나 소스 인스턴스가 대상 인스턴스에 데이터를 복제할 수 없으면 마이그레이션이 실패합니다.

이 경우 Memorystore for Valkey는 대상 인스턴스를 마이그레이션 프로세스를 시작하기 전 상태로 롤백합니다. 대상 인스턴스의 상태가 준비로 되돌아가고 인스턴스에 다시 읽기 및 쓰기 기능이 모두 포함됩니다.

마이그레이션 실패의 원인이 된 문제를 해결한 후 마이그레이션을 다시 시작할 수 있습니다.

gcloud

다음과 같이 gcloud memorystore instances start-migration 명령어를 사용합니다.

gcloud memorystore instances start-migration INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--source-ip=SOURCE_IP_ADDRESS \
--source-port=SOURCE_PORT \
--network-attachment=projects/PROJECT_ID/locations/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID

다음을 바꿉니다.

• INSTANCE_ID: 대상 인스턴스의 ID입니다.
• PROJECT_ID: 이 인스턴스가 포함된Google Cloud 프로젝트의 ID 또는 프로젝트 번호입니다.
• REGION_ID: 인스턴스가 있는 리전의 ID입니다.
• SOURCE_IP_ADDRESS: 소스 인스턴스의 IP 주소입니다. 소스 인스턴스 준비에서 이 IP 주소를 기록해 두었습니다.
• SOURCE_PORT: 소스 인스턴스의 포트 번호입니다. 소스 인스턴스 준비에서 이 포트를 기록했습니다.
• NETWORK_ATTACHMENT_ID: 네트워크 연결의 ID입니다.

마이그레이션이 성공적으로 시작되었는지 확인하려면 다음과 같이 gcloud memorystore instances describe 명령어를 사용합니다.

gcloud memorystore instances describe INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID

state 매개변수 옆에 MIGRATING 상태가 표시되는지 확인합니다.

대상 노드가 소스 노드에 연결할 수 없거나 소스 인스턴스가 대상 인스턴스에 데이터를 복제할 수 없으면 마이그레이션이 실패합니다.

이 경우 Memorystore for Valkey는 대상 인스턴스를 마이그레이션 프로세스를 시작하기 전 상태로 롤백합니다. 대상 인스턴스의 상태가 ACTIVE로 되돌아가고 인스턴스에 읽기 및 쓰기 기능이 다시 포함됩니다.

마이그레이션 실패의 원인이 된 문제를 해결한 후 마이그레이션을 다시 시작할 수 있습니다.

REST

마이그레이션을 시작하려면 다음 REST API 명령어를 사용합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: 대상 인스턴스가 포함된 Google Cloud 프로젝트의 ID 또는 프로젝트 번호
• REGION_ID: 이 인스턴스가 있는 리전의 ID입니다.
• INSTANCE_ID: 인스턴스의 ID입니다.
• SOURCE_IP_ADDRESS: 소스 인스턴스의 IP 주소입니다. 이 IP 주소는 소스 인스턴스 준비에서 기록한 주소입니다.
• SOURCE_PORT: 소스 인스턴스의 포트 번호입니다. 소스 인스턴스 준비에서 이 포트를 기록했습니다.
• NETWORK_ATTACHMENT_ID: 네트워크 연결의 ID입니다.

HTTP 메서드 및 URL:

POST https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID:startMigration

JSON 요청 본문:

{
  "selfManagedSource": {
    "ipAddress": "SOURCE_IP_ADDRESS",
    "port": SOURCE_PORT,
    "networkAttachment": "projects/PROJECT_ID/regions/REGION_ID/networkAttachments/NETWORK_ATTACHMENT_ID"
  }
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID:startMigration"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID:startMigration" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.memorystore.v1.OperationMetadata",
    "createTime": "2026-10-26T20:00:00.000000000Z",
    "target": "projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID",
    "verb": "startMigration",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

마이그레이션 모니터링

마이그레이션이 문제없이 진행되도록 소스 및 대상 인스턴스를 모두 모니터링합니다.

소스 인스턴스 모니터링

소스 인스턴스에서 소스 노드의 클라이언트 출력 버퍼 사용량이 낮게 유지되는지 확인합니다. 버퍼 사용량을 확인하려면 다음 중 하나를 실행합니다.

• 기존 모니터링 대시보드 사용
• Redis 또는 Valkey 클라이언트를 사용하여 소스 인스턴스에 연결한 후 INFO CLIENTS 명령어를 실행하여 출력 버퍼 측정항목을 확인합니다.

사용량이 지속적으로 낮으면 지연이 최소화되고 소스 인스턴스에서 대상 인스턴스로 데이터가 성공적으로 동기화되었음을 나타냅니다.

대상 인스턴스 모니터링

소스 인스턴스에서 Memorystore for Valkey로의 마이그레이션 상태를 모니터링할 수 있습니다. 이렇게 하려면 대상 인스턴스의 마이그레이션 상태(/instance/migration_status) 측정항목을 확인하여 인스턴스의 현재 상태가 HEALTHY인지 확인합니다. 이 상태는 마이그레이션 프로세스 중에 소스 및 대상 인스턴스의 샤드 간 복제 링크가 활성 상태이고 올바르게 작동하고 있음을 나타냅니다.

Google Cloud 콘솔을 사용하여 인스턴스의 마이그레이션 상태 측정항목을 확인하려면 다음을 수행합니다.

1. Google Cloud 콘솔에서 측정항목 탐색기 페이지로 이동합니다.

   측정항목 탐색기

2. 측정항목 메뉴에서 마이그레이션 상태 측정항목을 선택합니다. 이렇게 하려면 Memorystore 인스턴스  > 인스턴스  > 마이그레이션 상태를 선택한 다음 적용을 클릭합니다.

3. 필터 필드에서 instance_id = (equals) INSTANCE_ID 필터를 추가합니다.

   INSTANCE_ID를 대상 인스턴스의 ID로 바꿉니다.

4. 결과 섹션에서 인스턴스의 현재 상태를 확인합니다. HEALTHY 상태가 표시되면 인스턴스가 작동하는 것이며 마이그레이션을 완료할 수 있습니다.

   HEALTHY 상태가 표시되지 않으면 대상 인스턴스의 기본 노드에 마이그레이션 상태 측정항목을 사용할 수 있습니다. 이러한 노드를 모니터링하여 특정 노드가 비정상인지 확인할 수 있습니다.

   인스턴스 노드에 마이그레이션 상태 측정항목을 사용하려면 다음을 수행합니다.

   1. 측정항목 메뉴에서 마이그레이션 상태 측정항목을 선택합니다. 이렇게 하려면 Memorystore 인스턴스 노드  > 인스턴스  > 마이그레이션 상태를 선택한 후 적용을 클릭합니다.

   2. 필터 필드에서 role = (equals) primary 필터를 추가합니다.

   3. 결과 섹션에서 모든 기본 노드의 현재 상태가 정상인지 확인합니다. 상태가 HEALTHY이면 노드가 작동 중이며 마이그레이션을 완료할 수 있습니다.

이전 완료

마이그레이션을 완료하려면 Google Cloud 콘솔, gcloud CLI 또는 REST API를 사용합니다.

중요: 기본적으로 Memorystore for Valkey는 마이그레이션을 완료할 때까지 대상 인스턴스가 소스 인스턴스를 완전히 따라잡도록 합니다. 마이그레이션을 완료한 후 소스 인스턴스에 대한 쓰기는 복제되지 않을 수 있습니다.

소스 인스턴스와 대상 인스턴스 간에 완전한 데이터 일관성을 유지하고 데이터 손실을 방지하려면 마이그레이션을 완료하기 전에 소스 인스턴스에 대한 모든 쓰기 작업을 중지하세요.

콘솔

1. Google Cloud 콘솔에서 Memorystore for Valkey 페이지로 이동합니다.

   Memorystore for Valkey

2. 대상 인스턴스의 ID를 클릭합니다.

3. 인스턴스 한눈에 보기 페이지에서 이전 완료를 클릭합니다.

4. 이전 완료 대화상자에서 다음을 수행합니다.

   1. 대상 인스턴스가 소스 인스턴스의 모든 데이터를 복제하도록 하려면 표준을 선택합니다.

      주의: 애플리케이션 트래픽을 대상 인스턴스로 즉시 컷오버하려면 강제(동기화 건너뛰기)를 선택합니다. 하지만 이 옵션을 선택하면 Memorystore for Valkey가 소스 인스턴스의 모든 데이터를 대상 인스턴스에 복제하지 못할 수도 있습니다.

   2. 인스턴스 ID 텍스트 필드에 대상 인스턴스의 ID를 입력합니다.

   3. 이전 완료를 클릭합니다.

5. 인스턴스 한눈에 보기 페이지에서 마이그레이션됨 상태가 표시되는지 확인합니다.

중요: 마이그레이션을 완료한 후 모든 트래픽이 대상 인스턴스를 가리키도록 애플리케이션의 구성 파일을 업데이트합니다.

gcloud

다음과 같이 gcloud memorystore instances finish-migration 명령어를 사용합니다.

gcloud memorystore instances finish-migration INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID

다음을 바꿉니다.

• INSTANCE_ID: 대상 인스턴스의 ID
• PROJECT_ID: 이 인스턴스가 포함된Google Cloud 프로젝트의 ID 또는 프로젝트 번호
• REGION_ID: 인스턴스가 있는 리전의 ID입니다.

주의: 애플리케이션 트래픽을 대상 인스턴스로 즉시 컷오버하려면 --force 파라미터를 사용하세요. 하지만 이 파라미터를 사용하면 Memorystore for Valkey가 소스 인스턴스의 모든 데이터를 대상 인스턴스에 복제하지 못할 수도 있습니다.

마이그레이션이 성공적으로 완료되었는지 확인하려면 다음과 같이 gcloud memorystore instances describe 명령어를 사용합니다.

gcloud memorystore instances describe INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID

state 매개변수 옆에 MIGRATED 상태가 표시되는지 확인합니다.

중요: 마이그레이션을 완료한 후 모든 트래픽이 대상 인스턴스를 가리키도록 애플리케이션의 구성 파일을 업데이트합니다.

REST

마이그레이션을 완료하려면 다음 REST API 명령어를 사용합니다.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

• PROJECT_ID: 대상 인스턴스가 포함된 Google Cloud 프로젝트의 ID입니다.
• REGION_ID: 이 인스턴스가 있는 리전의 ID입니다.
• INSTANCE_ID: 인스턴스의 ID입니다.

• FORCE_BOOLEAN: 선택사항입니다. 이 매개변수는 Memorystore for Valkey가 마이그레이션을 즉시 완료하도록 강제할지 여부를 결정합니다.

  • 이 매개변수를 true로 설정하면 Memorystore for Valkey가 마이그레이션을 즉시 완료하므로 애플리케이션 트래픽을 대상 인스턴스로 컷오버할 수 있습니다. 하지만 Memorystore for Valkey가 소스 인스턴스의 모든 데이터를 대상 인스턴스에 복제하지 못할 수도 있습니다.
  • 이 파라미터를 false로 설정하면 Memorystore for Valkey가 마이그레이션을 완료할 때까지 소스 인스턴스의 모든 데이터를 대상 인스턴스에 복제합니다.

HTTP 메서드 및 URL:

POST https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID:finishMigration

JSON 요청 본문:

{
  "force": FORCE_BOOLEAN
}

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하거나 gcloud CLI에 자동으로 로그인하는 Cloud Shell을 사용하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID:finishMigration"

PowerShell(Windows)

참고: 다음 명령어는 gcloud init 또는 gcloud auth login을 실행하여 사용자 계정으로 gcloud CLI에 로그인했다고 가정합니다. gcloud auth list를 실행하면 현재 활성 계정을 확인할 수 있습니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://memorystore.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID:finishMigration" | Select-Object -Expand Content

다음과 비슷한 JSON 응답이 표시됩니다.

{
  "name": "projects/PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.memorystore.v1.OperationMetadata",
    "createTime": "2026-10-26T20:00:00.000000000Z",
    "target": "projects/PROJECT_ID/locations/REGION_ID/instances/INSTANCE_ID",
    "verb": "finishMigration",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}