이 페이지에서는 보조 클러스터를 만들고 작업하여 리전 간 복제를 사용하는 방법을 설명합니다.
리전 간 복제에 관한 개념적 개요는 리전 간 복제 정보를 참고하세요.
시작하기 전에
- 사용 중인 Google Cloud 프로젝트에 AlloyDB에 액세스할 수 있는 권한이 있어야 합니다.
- 사용 중인 Google Cloud 프로젝트에 다음 IAM 역할 중 하나가 있어야 합니다.
roles/alloydb.admin(AlloyDB 관리자가 사전 정의한 IAM 역할)roles/owner(소유자 기본 IAM 역할)roles/editor(편집자 기본 IAM 역할)
이러한 역할이 없는 경우 조직 관리자에게 문의하여 액세스 권한을 요청하세요.
보조 클러스터 만들기
보조 클러스터를 만들면 AlloyDB는 특정 시점 복구(PITR) 및 백업 구성을 비롯한 일부 기본 클러스터 구성을 복사하여 보조 클러스터에 적용합니다. AlloyDB는 기본 클러스터에 읽기 풀 인스턴스가 몇 개 있든 관계없이 보조 클러스터를 만든 후에는 보조 클러스터에 읽기 풀 인스턴스를 추가하지 않습니다.
보조 클러스터를 만든 후 기본 클러스터 구성을 업데이트하면 보조 클러스터에서 변경사항을 사용할 수 없습니다. 하지만 기본 클러스터에서 사용할 수 있는 최신 구성을 보조 클러스터에 수동으로 업데이트할 수 있습니다.
AlloyDB 보조 클러스터 및 보조 인스턴스를 만들려면 다음 단계를 따르세요.
콘솔
Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.
리소스 이름 열에서 클러스터를 클릭합니다.
개요 페이지에서 보조 클러스터 만들기를 클릭합니다.
보조 클러스터를 구성합니다.
- 클러스터 ID 필드에 보조 클러스터의 리소스 ID를 입력합니다.
- 기본 클러스터 리전과 다른 보조 클러스터 리전을 선택합니다.
- 보조 클러스터를 암호화할 암호화 방법으로 기본 Google 관리 암호화 또는 고객 관리 키 (CMEK)를 선택합니다.
CMEK 키를 사용하여 이 클러스터를 암호화하려면 다음 단계를 따르세요.
- 고급 암호화 옵션을 클릭합니다.
- 고객 관리 암호화 키(CMEK)를 선택합니다.
표시되는 메뉴에서 고객 관리 키를 선택합니다.
Google Cloud 콘솔은 이 목록을 새 클러스터와 동일한Google Cloud 프로젝트 및 리전 내 키로 제한합니다.
이 목록에 없는 키를 사용하려면 다음 단계를 따르세요.
- 키가 표시되지 않나요? 키 리소스 이름을 입력합니다.
- 키 리소스 이름 필드에 리소스 이름을 입력합니다.
- 저장을 클릭합니다.
- 계속을 클릭합니다.
AlloyDB에서 CMEK 키를 사용하려면 몇 가지 추가 설정이 필요합니다. 자세한 내용은 CMEK 사용을 참고하세요.
연결된 기본 인스턴스가 CMEK 키로 암호화된 경우 보조 클러스터도 CMEK 키로 암호화해야 합니다.
보조 인스턴스를 구성합니다.
- 인스턴스 ID 필드에 보조 인스턴스의 리소스 ID를 입력합니다. 리소스 ID는 클러스터 내에서 고유해야 합니다.
클러스터 만들기를 클릭합니다.
gcloud
gcloud CLI를 사용하려면 Google Cloud CLI를 설치 및 초기화하거나 Cloud Shell을 사용합니다.
gcloud alloydb clusters create-secondary 명령어를 사용합니다.
gcloud alloydb clusters create-secondary SECONDARY_CLUSTER_ID \ --region=REGION_ID \ --primary-cluster=projects/PROJECT_ID/locations/LOCATION_ID/clusters/ PRIMARY_CLUSTER_ID \gcloud alloydb instances create-secondary SECONDARY_INSTANCE_ID \ --cluster=SECONDARY_CLUSTER_ID \ --region=REGION_ID
다음을 바꿉니다.
SECONDARY_CLUSTER_ID: 만들려는 보조 클러스터의 ID입니다.SECONDARY_INSTANCE_ID: 만들려는 보조 인스턴스의 ID입니다.REGION_ID: 보조 클러스터의 리전 ID입니다(예:us-central1).PROJECT_ID: 보조 클러스터 프로젝트의 ID입니다.LOCATION_ID: 기본 클러스터가 있는 위치입니다(예:us-central1).PRIMARY_CLUSTER_ID: 보조 클러스터가 연결된 기본 클러스터의 ID입니다.SECONDARY_CLUSTER_ID: 보조 인스턴스가 연결된 보조 클러스터의 ID입니다.ALLOWED_PROJECT(선택사항): 인스턴스에 대한 액세스를 허용하려는 프로젝트 ID 또는 프로젝트 번호를 쉼표로 구분한 목록입니다(예:my-project-1,12345,my-project-n). 클러스터에서 인스턴스에 연결하는 방법으로 Private Service Connect를 사용하는 경우 허용되는 프로젝트 또는 번호 목록을 설정해야 합니다.--no-enable-automated-backup(선택사항): 보조 클러스터에서 자동 백업 생성을 사용 중지합니다.
Private Service Connect 지원 보조 클러스터 및 인스턴스를 만들려면 클러스터를 만들 때 --enable-private-service-connect 플래그를 추가하고 --allowed-psc-projects 플래그를 추가하여 인스턴스에 대한 액세스를 허용하려는 프로젝트 ID 또는 프로젝트 번호의 쉼표로 구분된 목록을 설정합니다(예: my-project-1, 12345,my-project-n).
gcloud alloydb clusters create-secondary SECONDARY_CLUSTER_ID \ --region=REGION_ID \ --primary-cluster=projects/PROJECT_ID/locations/LOCATION_ID/clusters/ PRIMARY_CLUSTER_ID \ --enable-private-service-connectgcloud alloydb instances create-secondary SECONDARY_INSTANCE_ID \ --cluster=SECONDARY_CLUSTER_ID \ --region=REGION_ID \ --allowed-psc-projects=ALLOWED_PROJECT_LIST
다음을 바꿉니다.
ALLOWED_PROJECT(선택사항): 인스턴스에 대한 액세스를 허용하려는 프로젝트 ID 또는 프로젝트 번호를 쉼표로 구분한 목록입니다(예:my-project-1,12345,my-project-n). 클러스터에서 인스턴스에 연결하는 방법으로 Private Service Connect를 사용하는 경우 허용되는 프로젝트 또는 번호 목록을 설정해야 합니다.
공개 IP 지원 클러스터의 보조 인스턴스를 만들려면 --assign-inbound-public-ip=ASSIGN_IPV4 매개변수를 추가합니다.
gcloud alloydb instances create-secondary SECONDARY_INSTANCE_ID \
--cluster=SECONDARY_CLUSTER_ID \
--region=REGION_ID \
--assign-inbound-public-ip=ASSIGN_IPV4원하는 경우 64.233.160.0/16와 같은 CIDR 블록의 쉼표로 구분된 목록을 --authorized-external-networks 매개변수에 전달하여 인스턴스에 승인된 외부 네트워크를 설정할 수 있습니다.
보조 클러스터 보기
AlloyDB 보조 클러스터에 관한 자세한 정보를 보려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.
리소스 이름 열에서 보조 클러스터를 클릭합니다.
개요 페이지에서 보조 클러스터에 관한 모든 세부정보를 확인합니다.
보조 인스턴스 업데이트
보조 인스턴스를 업데이트하여 데이터베이스 플래그를 추가, 수정 또는 삭제할 수 있습니다. 보조 인스턴스의 머신 유형을 확장할 수도 있습니다.
보조 인스턴스에서 데이터베이스 플래그 구성
데이터베이스 플래그를 추가, 수정 또는 삭제하려면 다음 단계를 완료하세요.
콘솔
Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.
리소스 이름 열에서 수정할 보조 클러스터를 클릭합니다.
개요 페이지에서 클러스터의 인스턴스로 이동하여 보조 인스턴스를 선택한 다음 보조 수정을 클릭합니다.
인스턴스에서 데이터베이스 플래그를 추가, 수정 또는 삭제하려면 다음 단계를 따르세요.
신고 추가
- 인스턴스에 데이터베이스 플래그를 추가하려면 플래그 추가를 클릭합니다.
- 새 데이터베이스 플래그 목록에서 플래그를 선택합니다.
- 플래그 값을 제공합니다.
- 완료를 클릭합니다.
플래그 수정
- 인스턴스에 있는 데이터베이스 플래그를 수정하려면 데이터베이스 플래그를 펼치고 데이터베이스 플래그 수정 섹션에서 기존 플래그의 값을 수정합니다.
- 완료를 클릭합니다.
플래그 삭제하기
- 인스턴스에서 데이터베이스 플래그를 삭제하려면 플래그를 선택하고 삭제 아이콘을 클릭합니다.
- 완료를 클릭합니다.
보조 업데이트를 클릭합니다.
gcloud
gcloud alloydb instances update 명령어를 사용하여 보조 인스턴스의 데이터베이스 플래그를 변경합니다.
gcloud alloydb instances update SECONDARY_INSTANCE_ID \
--database-flags FLAGS_LIST \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_ID다음을 바꿉니다.
SECONDARY_INSTANCE_ID: 보조 인스턴스의 ID입니다.FLAGS_LIST: 하나 이상의 데이터베이스 플래그 사양을 쉼표로 구분한 목록입니다. 각 사양은 플래그 이름, 등호 (=) 및 플래그에 할당할 값으로 구성됩니다. 값을 가지지 않는 데이터베이스 플래그의 경우 플래그 이름 뒤에 등호 (=)를 지정합니다.REGION_ID: 보조 인스턴스가 배치된 리전입니다(예:us-central1).CLUSTER_ID: 보조 인스턴스가 배치된 클러스터의 ID입니다.PROJECT_ID: 보조 클러스터가 배치된 프로젝트의 ID입니다.
보조 인스턴스의 머신 유형 확장
보조 인스턴스의 머신 유형을 확장하려면 다음 단계를 완료하세요.
콘솔
Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.
리소스 이름 열에서 수정할 보조 클러스터를 클릭합니다.
개요 페이지에서 클러스터의 인스턴스 섹션으로 이동하여 보조 수정을 클릭합니다.
페이지에 클러스터 상태가 유지보수로 보고되는 경우에는 이 작업을 사용할 수 없습니다. 상태가 준비됨으로 변경되면 액션을 다시 사용할 수 있습니다.
머신 유형을 선택합니다.
보조 업데이트를 클릭합니다.
gcloud
gcloud alloydb instances
update 명령어를 사용하여 보조 인스턴스의 머신 유형을 변경합니다.
gcloud alloydb instances update SECONDARY_INSTANCE_ID \
--cpu-count=CPU_COUNT \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_ID다음을 바꿉니다.
SECONDARY_INSTANCE_ID: 업데이트하려는 보조 인스턴스의 ID입니다.CPU_COUNT: 인스턴스에 사용할 vCPU 수입니다. 유효한 값으로 다음이 포함되어 있습니다.2(vCPU 2개, RAM 16GB)4(vCPU 4개, RAM 32GB)8(vCPU 8개, RAM 64GB)16(vCPU 16개, RAM 128GB)32(vCPU 32개, RAM 256GB)64(vCPU 64개, RAM 512GB)
REGION_ID: 인스턴스가 배치된 리전입니다.
CLUSTER_ID: 인스턴스가 배치된 클러스터의 ID입니다.
PROJECT_ID: 클러스터가 배치된 프로젝트의 ID입니다.
명령어가 invalid cluster state MAINTENANCE 문구가 포함된 오류 메시지를 반환하면 클러스터에 일상적인 유지보수가 진행 중인 것입니다. 이렇게 하면 인스턴스 재구성이 일시적으로 허용되지 않습니다. 클러스터가 READY 상태로 돌아온 후 명령어를 다시 실행합니다.
클러스터 상태를 확인하려면 클러스터 세부정보 보기를 참고하세요.
보조 클러스터에 읽기 풀 인스턴스 추가
보조 클러스터에 읽기 풀 인스턴스를 추가하려면 다음 단계를 따르세요.
Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.
리소스 이름 열에서 읽기 풀 인스턴스를 추가할 보조 클러스터를 클릭합니다.
개요 페이지에서 클러스터의 인스턴스 섹션으로 이동하여 읽기 풀 추가를 클릭합니다.
읽기 풀 인스턴스를 구성합니다.
- 읽기 풀 인스턴스 ID 필드에 읽기 풀 인스턴스의 ID를 입력합니다.
- 노드 수 필드에 노드 수를 입력합니다. 읽기 풀 인스턴스의 노드 수가 인스턴스의 전반적인 컴퓨팅 용량을 결정합니다. 클러스터의 모든 읽기 풀 인스턴스에는 최대 20개의 노드를 보유할 수 있습니다.
- 머신 유형을 선택합니다.
선택사항: 인스턴스에 맞춤 플래그를 설정합니다. 각 플래그에 대해 다음을 실행합니다.
- 플래그 추가를 클릭합니다.
- 새 데이터베이스 플래그 목록에서 플래그를 선택합니다.
- 플래그 값을 제공합니다.
- 완료를 클릭합니다.
읽기 풀 추가를 클릭합니다.
보조 클러스터 승격
보조 클러스터를 승격하기 전에 다음 단계를 수행하여 보조 클러스터에 기본 클러스터에서 수신된 모든 트랜잭션이 적용되었는지 확인합니다.
- 기본 클러스터에 대한 모든 쓰기를 중지합니다.
다음 단계를 완료하여 보조 클러스터의 복제 상태를 확인합니다.
Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.
클러스터 목록에서 승격하려는 보조 클러스터의 이름을 클릭합니다.
클러스터 세부정보 페이지에서 모니터링을 클릭합니다.
Monitoring 목록에서 보조 인스턴스를 선택합니다. 목록에 보조: INSTANCE_NAME로 표시됩니다.
측정항목 목록에서 기본 인스턴스의 복제 지연 차트를 찾습니다.
차트에 최소 지연이 표시되는지 확인합니다.
지연 값은
0이 가장 좋습니다. 지연 시간이0보다 크면 기본 클러스터에서 이미 커밋된 일부 최근 트랜잭션이 손실될 위험이 있지만 보조 클러스터를 승격할 수 있습니다.측정항목 목록에서 복제 상태 차트를 찾습니다.
차트에 표시된 모든 노드의 값이
streaming인지 확인합니다.
보조 클러스터를 기본 클러스터로 승격하려면 다음 단계를 따르세요.
콘솔
Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.
리소스 이름 열에서 기본 클러스터로 승격할 보조 클러스터를 클릭합니다.
개요 페이지에서 클러스터 승격을 클릭합니다.
대화상자가 표시되면 보조 클러스터 ID를 입력하여 클러스터를 승격할지 확인합니다.
승격을 클릭합니다.
클러스터가 프로모션되면 개요 페이지의 유형: 보조 클러스터 (가용성 높음) 필드가 유형: 읽기 풀 가용성 높음으로 업데이트됩니다.
gcloud
gcloud alloydb clusters promote 명령어를 사용합니다.
gcloud alloydb clusters promote SECONDARY_CLUSTER_ID \
--region=REGION_ID \
--project=PROJECT_ID \다음을 바꿉니다.
SECONDARY_CLUSTER_ID: 승격하려는 보조 클러스터의 ID입니다.REGION_ID: 보조 클러스터의 리전 ID입니다(예:us-central1).PROJECT_ID: 보조 클러스터 프로젝트의 ID입니다.
전환 수행
전환을 수행하기 전에 기본 인스턴스와 보조 인스턴스가 속한 두 리전이 모두 온라인 상태이고 인스턴스가 정상 상태인지 확인합니다. 자세한 내용은 AlloyDB 시스템 통계 대시보드를 사용하여 인스턴스 모니터링을 참고하세요.
gcloud alloydb clusters
switchover 명령어를 사용합니다.
gcloud alloydb clusters switchover SECONDARY_CLUSTER_ID \
--region=REGION_ID \
--project=PROJECT_ID \다음을 바꿉니다.
SECONDARY_CLUSTER_ID: 승격하려는 보조 클러스터의 ID입니다.REGION_ID: 보조 클러스터의 리전 ID입니다(예:us-central1).PROJECT_ID: 보조 클러스터 프로젝트의 ID입니다.