ElastiCache for Valkey or ElastiCache for Redis OSS 클러스터의 클러스터 모드를 변경하려면 어떻게 해야 합니까?

간략한 설명

참고: 클러스터 모드 구성을 클러스터 모드 미사용에서 클러스터 모드 사용으로만 변경할 수 있습니다. 클러스터 모드를 변경한 후에는 구성을 되돌릴 수 없습니다.

전제 조건:

• 클러스터의 데이터베이스 0에만 키가 있어야 합니다.
• 애플리케이션은 클러스터 프로토콜과 구성 엔드포인트를 사용할 수 있는 Valkey 또는 Redis OSS 클라이언트를 사용해야 합니다.
• 클러스터의 경우 자동 장애 조치를 설정하고 1개 이상의 복제본이 있어야 합니다.
• 마이그레이션하려면 클러스터에 Valkey 7.2 이상 또는 Redis OSS 7.0 이상의 엔진 버전이 있어야 합니다. 자세한 내용은 클러스터 모드 수정을 참조하십시오.

클러스터 모드를 클러스터 모드 미사용에서 클러스터 모드 사용으로 업데이트하려면 다음 작업을 완료하십시오.

1. 클러스터 모드를 클러스터 모드 미사용에서 호환으로 업데이트합니다.
2. 클러스터 모드를 호환에서 클러스터 모드 사용으로 업데이트합니다.

참고: 이 마이그레이션 프로세스 도중 클러스터는 계속해서 사용할 수 있습니다.

해결 방법

호환 모드로 전환하기 전에 cluster-enabled 파라미터를 yes로 설정해야 합니다. 기본 파라미터 그룹을 사용하는 경우 ElastiCache for Valkey 및 ElastiCache for Redis OSS에서 기본 파라미터 그룹을 선택합니다. 이 기본 파라미터 그룹은 cluster-enabled 구성이 yes로 설정되어 있으므로 별도의 조치를 취할 필요가 없습니다.

참고: 사용자 지정 파라미터 그룹을 사용하는 경우 클러스터를 수정할 때 새 파라미터 그룹을 선택하십시오. 또는 cluster-enabled 파라미터가 yes로 설정된 동일한 엔진 패밀리에 대해 새 파라미터 그룹을 만듭니다.

클러스터 모드를 클러스터 모드 미사용에서 호환으로 업데이트

참고: AWS Command Line Interface(AWS CLI) 명령을 실행할 때 오류가 발생하면 AWS CLI의 오류 해결을 참조하십시오. 또한 최신 AWS CLI 버전을 사용하고 있는지 확인하십시오.

호환 모드에서 ElastiCache는 단일 샤드를 배포하여 노드를 사용합니다. 이 구성을 통해 클라이언트 애플리케이션은 두 프로토콜 중 하나를 사용하여 클러스터와 통신할 수 있습니다.

다음 단계를 완료합니다.

1. ElastiCache 콘솔을 엽니다.
2. 탐색 창에서 리소스 유형을 선택하고, 클러스터를 선택합니다.
3. 수정을 선택합니다.
4. 클러스터 모드에서 호환을 선택합니다.
5. (선택 사항) cluster-enabled가 yes로 설정된 사용자 지정 파라미터 그룹을 선택합니다.
   참고: 기본 파라미터 그룹을 사용하는 경우 별도의 조치가 필요하지 않습니다.
6. 변경 사항 미리 보기를 선택하고, 변경 사항 저장을 선택합니다.

AWS CLI를 사용하여 클러스터를 수정하려면 modify-replication-group 명령을 실행하고 cluster-mode 파라미터를 compatible로 업데이트합니다.

예시:

aws elasticache modify-replication-group \
    --replication-group-id test-cluster \
    --cluster-mode compatible  \
    --apply-immediately

참고: 위 예시에서 test-cluster를 클러스터 이름으로 바꾸십시오. 자세한 내용은 복제 그룹 수정을 참조하십시오.

클러스터 모드를 호환으로 변경하면 생성된 구성 엔드포인트를 사용하여 애플리케이션에서 클러스터 모드 사용 연결을 테스트할 수 있습니다. 또한 기본 엔드포인트와 리더 엔드포인트를 사용하여 클러스터에 대한 기존 클러스터 모드 미사용 연결을 서비스할 수 있습니다.

호환 모드에서 클러스터 모드를 미사용으로 되돌리고 기존 구성을 유지할 수도 있습니다.

클러스터 모드를 호환에서 클러스터 모드 사용으로 업데이트

모든 Valkey 또는 Redis OSS 클라이언트를 클러스터 모드 사용으로 마이그레이션하면 클라이언트 애플리케이션이 클러스터를 인식하게 됩니다. 이 상태에서 클러스터 모드 파라미터를 enabled로 설정할 수 있습니다.

다음 단계를 완료합니다.

1. ElastiCache 콘솔을 엽니다.
2. 탐색 창에서 리소스 유형을 선택하고, 클러스터를 선택합니다.
3. 수정을 선택합니다.
4. 클러스터 모드에서 사용을 선택합니다.
5. 변경 사항 미리 보기를 선택하고, 변경 사항 저장을 선택합니다.

AWS CLI를 사용하여 클러스터를 수정하려면 modify-replication-group 명령을 실행하고 cluster-mode 파라미터를 enabled로 설정합니다.

예시:

aws elasticache modify-replication-group \
    --replication-group-id test-cluster \
    --cluster-mode enabled  \
    --apply-immediately

참고: 위 예시에서 test-cluster를 클러스터 이름으로 바꾸십시오.

클러스터 모드 변경이 완료되면 클러스터 엔드포인트도 변경됩니다. 더 이상 기본 엔드포인트 또는 리더 엔드포인트가 없으므로 새 구성 엔드포인트로 애플리케이션을 업데이트해야 합니다.

참고: 클라이언트 문서를 검토하여 (클러스터 모드 사용) 클러스터와의 상호 작용을 지원하도록 클라이언트를 구성하는 것이 좋습니다. 자세한 내용은 Valkey 웹사이트의 클러스터 사양을 참조하십시오.

관련 정보

복제: Valkey 및 Redis OSS 클러스터 모드 미사용 대 사용

모범 사례: Redis 클라이언트 및 Amazon ElastiCache for Redis