리전 간 복제 사용

참고: 보조 인스턴스를 만들려면 인스턴스를 배치할 리전에 서비스 네트워크 정책이 있어야 합니다. 서비스 네트워크 정책에 대한 자세한 내용은 네트워킹을 참고하세요.

이 페이지에서는 보조 인스턴스를 생성하고 관리하여 리전 간 복제를 사용하는 방법을 설명합니다.

리전 간 복제의 개념 개요는 리전 간 복제 정보를 참고하세요.

보조 인스턴스 만들기

보조 인스턴스를 만들면 Memorystore for Valkey가 기본 인스턴스의 일부 설정을 복사하여 보조 인스턴스 설정으로 적용합니다. 자세한 내용은 인스턴스 설정을 참고하세요.

Google Cloud 콘솔 또는 Google Cloud CLI를 사용하여 Memorystore for Valkey에 보조 인스턴스를 만들 수 있습니다.

콘솔

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

   Memorystore for Valkey

2. 기본 인스턴스를 클릭합니다. 기본 인스턴스는 생성 중인 보조 인스턴스의 상위 인스턴스입니다.

   참고: Memorystore for Valkey는 계단식 복제본을 지원하지 않으므로 보조 인스턴스를 클릭하지 마세요. 또한 기본 인스턴스에는 보조 인스턴스가 두 개까지만 있을 수 있으므로 보조 인스턴스가 이미 두 개 있는 기본 인스턴스는 클릭하지 마세요.

   기본 인스턴스가 표시되지 않으면 인스턴스를 만듭니다. 만든 후에는 클릭할 수 있습니다.

3. 측면 패널에서 보조 인스턴스 탭을 클릭합니다.

4. 보조 인스턴스 추가를 클릭합니다.

5. 보조 인스턴스 추가 창에서 다음을 변경합니다.

   1. 인스턴스 ID 필드에 생성 중인 보조 인스턴스의 ID를 입력합니다. ID는 1~63자(영문 기준)여야 하며 소문자, 숫자, 하이픈만 사용해야 합니다. 소문자로 시작하고 소문자나 숫자로 끝나야 하며 해당 리전에서 고유해야 합니다.

   2. 리전 메뉴에서 보조 인스턴스를 배치할 리전을 선택합니다.

   3. 영역 가용성 섹션에서 다음 옵션 중 하나를 선택합니다.

      • Memorystore for Valkey가 인스턴스를 만드는 리전의 3개 영역에 인스턴스의 모든 샤드와 복제본을 분산하려면 멀티 영역 옵션을 선택합니다.

        예를 들어 선택한 리전이 us-central1이고 다중 영역 옵션을 선택하면 Memorystore for Valkey가 인스턴스의 샤드와 복제본을 us-central1-a, us-central1-b,
        us-central1-c 영역에 분산합니다. 영역 장애가 발생할 경우 인스턴스의 노드가 복제본으로 장애 조치됩니다.

      • 인스턴스의 모든 샤드와 복제본이 Memorystore for Valkey가 인스턴스를 만드는 리전의 한 영역에 있도록 하려면 단일 영역 옵션을 선택한 다음 영역 메뉴에서 영역을 선택합니다.

        단일 영역을 사용하면 네트워크 비용이 절감됩니다. 하지만 영역 장애가 발생할 경우 장애 조치가 수행되지 않습니다.

   4. 복제본 메뉴에서 인스턴스의 복제본 수 (샤드당)를 선택합니다. 복제본은 0개, 1개 또는 2개일 수 있습니다.

   5. 네트워크 메뉴에서 인스턴스의 네트워크를 선택합니다. Memorystore for Valkey의 네트워킹에 대한 자세한 내용은 네트워킹을 참고하세요.

6. 보조 인스턴스 추가를 클릭합니다.

gcloud

참고: gcloud CLI를 설치한 경우 gcloud components update를 실행하여 최신 버전이 설치되어 있는지 확인합니다. Memorystore for Valkey의 교차 리전 복제를 관리하려면 gcloud CLI 버전 488.0.0 이상이 필요합니다.

보조 인스턴스를 만들려면 gcloud memorystore instances create 명령어를 사용합니다.

gcloud memorystore instances create INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--cross-instance-replication-config-role=secondary \
--psc-auto-connections=network=NETWORK,projectId=PROJECT_ID \
--primary-instance=PRIMARY_INSTANCE_PATH

다음을 바꿉니다.

• INSTANCE_ID: 만들려는 보조 인스턴스의 ID입니다. ID는 1~63자(영문 기준)여야 하며 소문자, 숫자, 하이픈만 사용해야 합니다. 소문자로 시작하고 소문자나 숫자로 끝나야 하며 해당 리전에서 고유해야 합니다.
• PROJECT_ID: 보조 인스턴스를 만들 프로젝트의 ID입니다. 기본 인스턴스가 있는 프로젝트와 동일한 프로젝트입니다.
• REGION_ID: 보조 인스턴스를 배치할 리전의 ID입니다.
• NETWORK: 인스턴스를 만드는 데 사용된 네트워크입니다. projects/NETWORK_PROJECT_ID/global/networks/NETWORK_ID 형식을 사용해야 합니다. 네트워크 ID는 서비스 연결 정책에서 사용하는 네트워크 ID와 일치해야 합니다. 그렇지 않으면 보조 인스턴스를 만들 수 없습니다.
• PRIMARY_INSTANCE_PATH: 기본 인스턴스의 경로입니다. 예를 들면 projects/my-project/locations/us-central1/instances/my-primary-instance입니다. 보조 인스턴스가 아닌 한 프로젝트의 모든 인스턴스를 기본 인스턴스로 선택할 수 있습니다.

예를 들면 다음과 같습니다.

gcloud memorystore instances create my-secondary-instance \
--project=my-project \
--location=us-central1 \
--cross-instance-replication-config-role=secondary \
--psc-auto-connections=network=projects/my-project/global/networks/default,projectId=my-project \
--primary-instance=projects/my-project/locations/us-central1/instances/my-primary-instance

보조 인스턴스 보기

Google Cloud 콘솔 또는 Google Cloud CLI를 사용하여 보조 인스턴스에 관한 요약 정보를 볼 수 있습니다.

콘솔

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

   Memorystore for Valkey

2. 기본 인스턴스 옆에 있는 확장 화살표를 클릭합니다. 이 인스턴스는 정보를 보려는 보조 인스턴스의 상위 인스턴스입니다.

3. 보조 인스턴스를 클릭합니다. 인스턴스에 관한 요약 정보가 표시됩니다.

gcloud

복제 그룹의 기본 인스턴스와 보조 인스턴스를 나열하는 멤버십 필드를 비롯한 보조 인스턴스에 관한 정보를 보려면 gcloud memorystore instances describe 명령어를 사용합니다.

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

다음을 바꿉니다.

• INSTANCE_ID: 보조 인스턴스의 ID
• PROJECT_ID: 보조 인스턴스가 포함된 프로젝트의 ID
• REGION_ID: 보조 인스턴스가 있는 리전의 ID

전환 수행

전환을 사용하면 재해 복구 목적으로 보조 인스턴스를 기본 인스턴스로 승격하여 기본 인스턴스와 보조 인스턴스의 역할을 반대로 지정할 수 있습니다. 자세한 내용은 리전 간 복제 정보를 참고하세요.

Google Cloud 콘솔 또는 Google Cloud CLI를 사용하여 전환을 수행할 수 있습니다.

참고: 전환을 수행하기 전에 기본 인스턴스와 보조 인스턴스 전환을 위한 권장사항의 안내를 따르세요. 이 안내를 사용하면 애플리케이션이 작성한 쓰기를 추적하고 적절한 인스턴스로 쓰기를 전송할 수 있습니다.

콘솔

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

   Memorystore for Valkey

2. 기본 인스턴스 옆에 있는 확장 화살표를 클릭합니다. 이 인스턴스는 전환하려는 보조 인스턴스의 상위 인스턴스입니다.

3. 보조 인스턴스를 클릭합니다.

4. 기본으로 승격을 클릭합니다.

5. 보조 인스턴스를 기본 인스턴스로 승격하시겠어요? 대화상자에서 보조 인스턴스의 ID를 입력한 후 승격을 클릭합니다.

전환이 완료되면 애플리케이션을 새 기본 인스턴스에 다시 연결해야 합니다.

gcloud

스위치오버를 실행하려면 gcloud memorystore instances update 명령어를 사용합니다.

gcloud memorystore instances update INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--clear-primary-instance \
--cross-instance-replication-config-role=primary \
--cross-instance-replication-config-secondary-instances=[instance=SECONDARY_INSTANCE_PATH]

다음을 바꿉니다.

• INSTANCE_ID: 전환을 실행하여 기본 인스턴스로 승격할 보조 인스턴스의 ID입니다.
• PROJECT_ID: 보조 인스턴스가 포함된 프로젝트의 ID입니다.
• REGION_ID: 보조 인스턴스가 있는 리전의 ID입니다.

• SECONDARY_INSTANCE_PATH: 보조 인스턴스의 경로입니다. 예를 들면 projects/my-project/locations/us-central1/instances/my-secondary-instance입니다.

  보조 인스턴스가 여러 개인 경우 각 인스턴스를 쉼표로 구분합니다. 예를 들면 [instance=projects/my-project/locations/us-central1/instances/my-first-secondary-instance,instance=projects/my-project/locations/europe-west1/instances/my-second-secondary-instance]입니다.

my-project 프로젝트에 포함된 인스턴스가 다음과 같다고 가정해 보겠습니다.

• instance-1: 이 기본 인스턴스는 us-east1 리전에 있습니다.
• instance-2: 이 보조 인스턴스는 asia-east1 리전에 있습니다.
• instance-3: 이 보조 인스턴스는 southamerica-east1 리전에 있습니다.

instance-2이 새 기본 인스턴스가 되고 instance-1이 보조 인스턴스가 되도록 instance-1과 instance-2의 역할을 반대로 지정하려고 합니다.

이렇게 하려면 다음 코드를 사용하세요.

gcloud memorystore instances update instance-2 \
--project=my-project \
--location=asia-east1 \
--clear-primary-instance \
--cross-instance-replication-config-role=primary \
--cross-instance-replication-config-secondary-instances=[instance=projects/my-project/locations/us-east1/instances/instance-1,instance=projects/my-project/locations/southamerica-east1/instances/instance-3]

전환이 완료되면 애플리케이션을 새 기본 인스턴스에 다시 연결해야 합니다.

보조 인스턴스 분리

기본 인스턴스에서 하나 이상의 보조 인스턴스를 분리하면 읽기와 쓰기 모두를 허용하는 완전히 작동하는 독립 인스턴스가 됩니다. 자세한 내용은 교차 리전 복제를 관리하는 방법을 참고하세요.

Google Cloud 콘솔 또는 Google Cloud CLI를 사용하여 보조 인스턴스를 분리할 수 있습니다.

보조 인스턴스 분리

이 섹션에서는 보조 인스턴스를 기본 인스턴스에서 분리하는 방법을 설명합니다.

콘솔

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

   Memorystore for Valkey

2. 기본 인스턴스를 클릭합니다. 기본 인스턴스에서 분리할 보조 인스턴스의 상위입니다.

3. 측면 패널에서 보조 인스턴스 탭을 클릭합니다.

4. 기본 인스턴스에서 분리할 보조 인스턴스의 ID 옆에 있는 체크박스를 선택합니다.

5. 기본에서 분리를 클릭합니다.

6. 보조 인스턴스를 분리하시겠습니까? 대화상자에서 보조 인스턴스의 ID를 입력한 후 분리를 클릭합니다.

gcloud

보조 인스턴스를 분리하려면 gcloud memorystore instances update 명령어를 사용합니다.

gcloud memorystore instances update INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--cross-instance-replication-config-role=none \
--clear-primary-instance

다음을 바꿉니다.

• INSTANCE_ID: 분리하려는 보조 인스턴스의 ID
• PROJECT_ID: 보조 인스턴스가 포함된 프로젝트의 ID
• REGION_ID: 보조 인스턴스가 있는 리전

여러 보조 인스턴스 분리

이 섹션에서는 기본 인스턴스에서 여러 보조 인스턴스를 분리하는 방법을 설명합니다. 이 섹션의 절차를 사용하여 사용할 수 없는 보조 인스턴스를 기본 인스턴스에서 분리할 수도 있습니다.

콘솔

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

   Memorystore for Valkey

2. 기본 인스턴스를 클릭합니다. 기본 인스턴스에서 분리할 보조 인스턴스의 상위 항목입니다.

3. 측면 패널에서 보조 인스턴스 탭을 클릭합니다.

4. 기본 인스턴스에서 분리할 보조 인스턴스의 ID 옆에 있는 체크박스를 선택합니다.

5. 기본에서 분리를 클릭합니다.

6. 보조 인스턴스를 분리하시겠어요? 대화상자에서 다음을 수행합니다.

   1. 보조 인스턴스의 ID를 입력합니다. ID를 구분하려면 쉼표를 사용합니다.

   2. 분리를 클릭합니다.

gcloud

여러 보조 인스턴스를 분리하려면 gcloud memorystore instances update 명령어를 사용합니다.

gcloud memorystore instances update PRIMARY_INSTANCE_ID \
--project=PROJECT_ID \
--location=PRIMARY_INSTANCE_REGION_ID \
--remove-cross-instance-replication-config-secondary-instances=[instance=SECONDARY_INSTANCES] \
--cross-instance-replication-config-role=none

다음을 바꿉니다.

• PRIMARY_INSTANCE_ID: 기본 인스턴스의 ID입니다.
• PROJECT_ID: 보조 인스턴스가 포함된 프로젝트의 ID입니다.
• PRIMARY_INSTANCE_REGION_ID: 기본 인스턴스가 있는 리전의 ID입니다.
• SECONDARY_INSTANCES: 분리할 보조 인스턴스입니다. 인스턴스 ID를 구분하려면 쉼표를 사용합니다. 각 보조 인스턴스는 projects/PROJECT_ID/locations/SECONDARY_INSTANCE_REGION_ID/instances/INSTANCE_ID 형식을 따라야 합니다.

예를 들면 다음과 같습니다.

gcloud memorystore instances update my-primary-instance \
--project=my-project \
--location=us-central1 \
--remove-cross-instance-replication-config-secondary-instances=[instance=projects/my-project/locations/us-west4/instances/my-secondary-instance-1,instance=projects/my-project/locations/asia-southeast2/instances/my-secondary-instance-2] \
--cross-instance-replication-config-role=none

참고: --cross-instance-replication-config-role=none 코드 줄은 선택사항입니다. 기본 인스턴스에서 모든 보조 인스턴스를 분리하려면 이 코드를 사용해야 합니다. 따라서 기본 인스턴스는 독립 인스턴스가 됩니다.

분리하지 않을 인스턴스 목록을 지정하여 보조 인스턴스를 기본 인스턴스에서 분리할 수도 있습니다. 이 목록에 포함되지 않은 인스턴스는 Memorystore for Valkey에서 분리됩니다.

다음과 같은 보조 인스턴스가 있다고 가정해 보겠습니다.

• instance-1: 이 인스턴스는 us-east1 리전에 있습니다.
• instance-2: 이 인스턴스는 asia-east1 리전에 있습니다.

my-primary-instance에서 두 보조 인스턴스를 모두 분리하려고 합니다. 이 기본 인스턴스는 us-central1 리전에 있으며 my-project 프로젝트에 포함되어 있습니다.

보조 인스턴스를 분리하려면 다음 코드를 사용하세요.

gcloud memorystore instances update my-primary-instance \
--project=my-project \
--location=us-central1 \
--cross-instance-replication-config-secondary-instances=[]
--cross-instance-replication-config-role=none

이 예시에서는 null [] 값이 --cross-instance-replication-config-secondary-instances 매개변수에 할당되므로 Memorystore for Valkey가 기본 인스턴스에서 모든 보조 인스턴스를 분리합니다.

인스턴스 설정 업데이트

이 섹션에서는 인스턴스 설정을 업데이트할 수 있는 링크를 제공합니다. 인스턴스 설정을 업데이트하는 프로세스는 기본 인스턴스 또는 보조 인스턴스에서 설정을 변경하는지에 따라 다릅니다. 설정을 업데이트하는 방법에 관한 자세한 내용은 인스턴스 설정을 참고하세요.

기본 인스턴스에서 설정 업데이트

기본 인스턴스에서 다음 설정을 변경해야 합니다. 이렇게 하면 Memorystore for Valkey가 변경사항을 보조 인스턴스와 동기화합니다.

• 인스턴스 용량 확장
• 인스턴스 구성
• 인스턴스 삭제 방지
• 인스턴스의 지속성 관리

보조 인스턴스에서 설정 업데이트

보조 인스턴스에서 다음 설정을 변경해야 합니다.

• 인스턴스가 단일 영역인지 멀티 영역인지 구성
• 인스턴스의 복제본 수 확장
• 인스턴스의 유지보수 기간 설정

교차 리전 복제를 사용하는 인스턴스 삭제

이 섹션에서는 리전 간 복제를 사용하는 기본 인스턴스와 보조 인스턴스를 삭제하는 방법을 설명합니다.

기본 인스턴스 삭제

기본 인스턴스를 삭제하려면 다음 단계를 따르세요.

1. 모든 보조 인스턴스를 분리하거나 삭제합니다.
2. 기본 인스턴스를 삭제하려면 인스턴스 삭제의 안내를 따르세요.

실수로 삭제되지 않도록 기본 인스턴스와 보조 인스턴스를 동시에 삭제할 수 없습니다.

보조 인스턴스 삭제

보조 인스턴스를 삭제하려면 인스턴스 삭제의 안내를 따르세요. 인스턴스 ID의 경우 보조 인스턴스의 ID를 사용합니다.