기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon DocumentDB 글로벌 클러스터의 개요
## 글로벌 클러스터란 무엇입니까?
글로벌 클러스터는 1개의 기본 리전과 최대 10개의 읽기 전용 보조 리전으로 구성됩니다. 쓰기 작업을 기본 영역의 기본 클러스터에 직접 발급하고 Amazon DocumentDB는 전용 인프라를 사용하여 자동으로 보조 영역에 데이터를 복제합니다. 지연 시간은 일반적으로 1초 미만입니다.
## 글로벌 클러스터는 어떻게 유용할까요?
+ **리전 범위 운영 중단에서 복구** - 리전 전체의 운영 중단 시 보조 클러스터 중 하나를 몇 분 이내에 기본 클러스터로 승격할 수 있으며, 일반적인 Recovery Time Objective(RTO)는 1분 이내입니다. Recovery Point Objective(RPO)는 일반적으로 초 단위로 측정되지만, 장애 발생 시 네트워크를 통한 스토리지 복제 지연에 따라 달라집니다.
+ **로컬 대기 시간을 가진 글로벌 읽기 **- 전 세계에 사무실이 있는 경우 글로벌 클러스터를 사용하여 주요 정보 소스를 기본 영역에서 업데이트할 수 있습니다. 다른 리전에 있는 사무실은 로컬 대기 시간을 사용하여 해당 리전의 정보에 액세스할 수 있습니다.
+ **확장성 보조 클러스터** - 보조 영역에 읽기 전용 인스턴스 확장성을 더 추가하여 보조 클러스터를 확장하고 규모를 조정할 수 있습니다. 보조 클러스터는 읽기 전용이므로 단일 클러스터에 대한 일반적인 제한인 15개가 아닌 최대 16개의 읽기 전용 복제본 인스턴스를 지원할 수 있습니다.
+ **일차적 클러스터에서 이차 클러스터로 빠른 복제** - 글로벌 클러스터에서 수행하는 복제는 기본 데이터베이스 클러스터에 대한 성능 영향이 거의 없습니다. DB 인스턴스의 리소스는 애플리케이션 읽기/쓰기 워크로드 처리 전용입니다.
## 글로벌 클러스터의 현재 한계는 무엇입니까?
+ Amazon DocumentDB v3.6에서는 글로벌 클러스터가 지원되지 않습니다.
+ 글로벌 클러스터는 db.t3, db.t4g 및 db.r4를 제외한 모든 인스턴스 유형에서 지원됩니다.
+ 글로벌 클러스터는 남아메리카(상파울루), 유럽(밀라노), 중국(베이징), 중국(닝샤) 리전에서 사용할 수 없습니다.
+ 리전이 다른 엔진 버전에 있는 경우에는 전환 및 글로벌 장애 조치가 지원되지 않습니다. 엔진 버전 불일치가 있는 경우 수동 장애 조치가 지원됩니다.
+ 기본 클러스터만 쓰기 작업을 수행합니다. 쓰기 작업을 수행하는 클라이언트는 기본 클러스터의 DB 클러스터 엔드포인트에 연결합니다.
+ 클러스터에는 10개의 보조 리전 및 1개의 기본 리전이 있을 수 있습니다.
+ 보조 클러스터는 중지할 수 없습니다. 기본 클러스터에 보조 클러스터가 연결되어 있는 경우 기본 클러스터를 중지할 수 없습니다. 보조 클러스터가 없는 리전 클러스터만 중지할 수 있습니다.
+ 보조 클러스터에 연결된 복제본은 특정 상황에서 다시 시작될 수 있습니다. 기본 영역의 인스턴스가 재시작되거나 장애 조치가 이뤄지는 경우, 보조 영역의 복제본도 재시작됩니다. 그러면 모든 복제본이 주 데이터베이스 클러스터의 작성자 인스턴스와 다시 동기화될 때까지 클러스터를 사용할 수 없습니다. 이는 예상된 동작입니다. 기본 클러스터를 변경하기 전에 글로벌 클러스터에 미치는 영향을 이해해야 합니다.
+ 보조 클러스터에서는 변경 스트림을 사용할 수 없습니다.
**Topics**
+ [
## 글로벌 클러스터란 무엇입니까?
](#w2aac33b9b3)
+ [
## 글로벌 클러스터는 어떻게 유용할까요?
](#w2aac33b9b5)
+ [
## 글로벌 클러스터의 현재 한계는 무엇입니까?
](#w2aac33b9b7)
+ [빠른 시작 설명서](global-clusters.get-started.md)
+ [글로벌 클러스터 관리](global-clusters.manage.md)
+ [글로벌 클러스터 연결](global-clusters-connect.md)
+ [글로벌 클러스터 모니터링](global-clusters-monitor.md)
+ [재해 복구](global-clusters-disaster-recovery.md)
# 빠른 시작 설명서: 글로벌 클러스터
**Topics**
+ [구성](#global-clusters.config)
+ [글로벌 클러스터 생성](#global-clusters-create)
+ [글로벌 클러스터에 리전 추가](#global-clusters.add-region)
+ [스냅샷 사용](#global-clusters.snapshot)
## 구성
Amazon DocumentDB 글로벌 클러스터는 2개 이상에 걸쳐 있습니다 AWS 리전. 기본 리전은 기본(라이터) 인스턴스 1개와 복제본 인스턴스 최대 15개로 구성된 클러스터를 지원하는 반면, 보조 리전은 최대 16개의 복제본 인스턴스로 구성된 읽기 전용 클러스터를 실행합니다. 글로벌 클러스터에는 최대 5개의 보조 리전이 있을 수 있습니다. 이 표에는 글로벌 클러스터에서 허용되는 최대 클러스터, 인스턴스 및 복제본이 나열됩니다.
| 설명 | 기본 AWS 리전 | 보조 AWS 리전 |
| --- | --- | --- |
| 클러스터 | 1 | 5(최대) |
| 라이터 인스턴스 | 1 | 0 |
| 클러스터당 읽기 전용 인스턴스(Amazon DocumentDB 복제본) | 15(최대) | 16(최대) |
| 읽기 전용 인스턴스(최대 허용, 지정된 보조 리전 수) | 15 - s | s = 총 보조 수 AWS 리전 |
클러스터의 특정 요구 사항은 다음과 같습니다.
+ **데이터베이스 인스턴스 클래스 요구 사항** - `db.r5` 및 `db.r6g` 인스턴스 클래스만 사용할 수 있습니다.
+ **AWS 리전 요구 사항** - 기본 클러스터는 한 리전에 있어야 하며, 하나 이상의 보조 클러스터는 동일한 계정의 다른 리전에 있어야 합니다. 보조(읽기 전용) 클러스터를 최대 5개까지 생성할 수 있으며 각 클러스터는 서로 다른 리전에 위치해야 합니다. 즉, 두 클러스터가 동일한 리전에 있을 수 없습니다.
+ **이름 설정 요구 사항** - 개별 클러스터에 선택하는 이름은 모든 리전에서 고유해야 합니다. 다른 리전에 있더라도 다른 클러스터에는 동일한 이름을 사용할 수 없습니다.
## Amazon DocumentDB 글로벌 클러스터 생성
첫 번째 글로벌 클러스터를 구축할 준비가 되셨나요? 이 섹션에서는 다음 지침에 따라 AWS Management Console 또는를 사용하여 새 데이터베이스 클러스터 및 인스턴스로 새 글로벌 클러스터 AWS CLI 를 생성하는 방법을 설명합니다.
### 사용 AWS Management Console
1. 에서 **Amazon DocumentDB**로 AWS Management Console이동합니다.
1. Amazon DocumentDB 콘솔로 이동하면 **클러스터**를 선택합니다.
![\[Amazon DocumentDB 콘솔의 클러스터 페이지입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png)
1. **생성(Create)**을 선택합니다.
![\[클러스터 테이블의 오른쪽 상단에 표시된 생성 버튼입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-create.png)
1. **Amazon DocumentDB 클러스터 생성** 양식의 **구성** 섹션을 적절히 작성하세요.
+ **클러스터 식별자** - 이 인스턴스의 고유 식별자를 입력하거나 Amazon DocumentDB가 클러스터 식별자를 기반으로 인스턴스 식별자를 제공하도록 허용할 수 있습니다.
+ 엔진 버전: **4.0.0** 선택
+ 인스턴스 클래스: **db.r5.large**를 선택합니다.
+ 인스턴스 수에 **3**을 선택합니다.
![\[Amazon DocumentDB 클러스터를 생성하기 위한 구성 옵션 양식입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/quick-start/create-config.png)
1. **인증** 섹션에서 마스터 사용자 이름과 마스터 비밀번호를 입력합니다.
![\[새 Amazon DocumentDB 클러스터의 마스터 사용자 이름과 암호를 지정하는 인증 양식입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/quick-start/create-auth.png)
1. **고급 설정 표시**를 선택합니다.
![\[취소 및 클러스터 생성 버튼 옆에 있는 고급 설정 토글 버튼을 표시합니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/quick-start/show-advanced.png)
1. **네트워크 설정** 섹션에서:
+ **가상 프라이빗 클라우드(VPC)** 및 **서브넷 그룹**의 기본 옵션을 유지합니다.
![\[VPC, 서브넷 그룹 및 VPC 보안 그룹 옵션을 보여주는 네트워크 설정 양식입니다. VPC 및 서브넷 그룹 필드에는 기본 옵션이 선택되어 있습니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-1.png)
+ **VPC 보안 그룹**의 경우 **기본 VPC**가 이미 추가되어 있어야 합니다.
![\[기본 VPC가 이미 추가되었음을 보여주는 네트워크 설정 양식입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-2.png)
+ `DocDB`를 **VPC 보안 그룹** 필드에 입력하고 **DocDB-인바운드(VFC)**를 선택합니다.
![\[VPC 보안 그룹 드롭다운 메뉴에서 선택한 DocDB-인바운드 VFC입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/quick-start/inbound-vfc.png)
1. **클러스터 옵션** 및 **저장 중 암호화**의 경우 기본 선택 사항을 그대로 유지합니다.
![\[클러스터 옵션 및 기본 옵션이 선택된 저장 중 암호화 양식입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-1.png)
1. **백업** 및 **로그 내보내기**의 경우 기본 선택 사항을 그대로 유지합니다.
![\[백업 및 로그는 기본 옵션이 선택된 양식을 내보냅니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-2.png)
1. **유지 관리**, **태그** 및 **삭제 보호**의 경우 기본 선택 사항을 그대로 유지합니다.
![\[기본 옵션이 선택된 유지 관리, 태그 및 삭제 보호 양식입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-3.png)
1. 이제 **클러스터 생성** 버튼을 클릭합니다.
![\[클러스터 생성 프로세스가 끝나면 클러스터 생성 버튼이 표시됩니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/quick-start/create-cluster.png)
### 사용 AWS CLI
Amazon DocumentDB 리전 클러스터를 생성하려면 [create-global-cluster AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/create-global-cluster.html)를 호출합니다. 다음 AWS CLI 명령은 라는 Amazon DocumentDB 클러스터를 생성합니다`global-cluster-id`. 삭제 방지에 대한 자세한 내용은 [Amazon DocumentDB 클러스터 삭제](db-cluster-delete.md)을(를) 참조하세요.
또한 `--engine-version`은 기본적으로 최신 주요 엔진 버전으로 설정되는 선택적 매개변수입니다. 현재 기본 엔진 버전은 입니다`5.0.0`(참고: Amazon DocumentDB 8.0을 사용할 수 있지만 로 명시적으로 지정해야 함`8.0.0`). 새 주요 엔진 버전이 출시되면 최신 주요 엔진 버전을 반영하도록 `--engine-version`의 주요 엔진 버전이 업데이트됩니다. 따라서 프로덕션 워크로드, 특히 스크립팅, 자동화 또는 CloudFormation 템플릿에 의존하는 워크로드의 경우를 의도한 메이저 버전`--engine-version`에 명시적으로 지정하는 것이 좋습니다.
`db-subnet-group-name` 또는 `vpc-security-group-id`이(가) 지정되지 않은 경우 Amazon DocumentDB는 해당 리전에 대해 기본 서브넷 그룹과 Amazon VPC 보안 그룹을 사용합니다.
다음 예제에서는 자신의 정보로 각각의 *사용자 입력 자리 표시자*를 바꿉니다.
Linux, macOS 또는 Unix의 경우:
```
aws docdb create-db-cluster \
--global-cluster-identifier global-cluster-id \
--source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
```
Windows의 경우:
```
aws docdb create-db-cluster ^
--global-cluster-identifier global-cluster-id ^
--source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
```
이 작업의 출력은 다음과 같습니다(JSON 형식).
```
{
"DBCluster": {
"StorageEncrypted": false,
"DBClusterMembers": [],
"Engine": "docdb",
"DeletionProtection" : "enabled",
"ClusterCreateTime": "2018-11-26T17:15:19.885Z",
"DBSubnetGroup": "default",
"EngineVersion": "4.0.0",
"MasterUsername": "masteruser",
"BackupRetentionPeriod": 1,
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:cluster-id",
"DBClusterIdentifier": "cluster-id",
"MultiAZ": false,
"DBClusterParameterGroup": "default.docdb4.0",
"PreferredBackupWindow": "09:12-09:42",
"DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY",
"PreferredMaintenanceWindow": "tue:04:17-tue:04:47",
"Port": 27017,
"Status": "creating",
"ReaderEndpoint": "cluster-id.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com",
"AssociatedRoles": [],
"HostedZoneId": "ZNKXTT8WH85VW",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"AvailabilityZones": [
"us-east-1a",
"us-east-1c",
"us-east-1e"
],
"Endpoint": "cluster-id.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com"
}
}
```
클러스터를 생성하는 데 몇 분 정도 걸립니다. AWS Management Console 또는를 사용하여 클러스터의 상태를 AWS CLI 모니터링할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 클러스터 상태 모니터링](monitoring_docdb-cluster_status.md) 단원을 참조하십시오.
**중요**
AWS CLI 를 사용하여 Amazon DocumentDB 리전 클러스터를 생성하면 인스턴스가 생성되지 않습니다. 따라서 기본 인스턴스와 필요한 복제 인스턴스를 명시적으로 생성해야 합니다. 콘솔 또는를 사용하여 인스턴스 AWS CLI 를 생성할 수 있습니다. 자세한 내용은 Amazon DocumentDB API 참조에서 [클러스터에 Amazon DocumentDB 인스턴스 추가](db-instance-add.md) 및 [CreateDBCluster](API_CreateDBCluster.md)을 참조하세요.
리전 클러스터를 사용할 수 있게 되면 [Amazon DocumentDB 글로벌 클러스터 AWS 리전 에 추가](#global-clusters.add-region) 지침에 따라 다른 리전에 보조 클러스터를 추가할 수 있습니다. 리전을 추가하면 리전 클러스터가 기본 클러스터가 되고 선택한 리전에 새 보조 클러스터가 생깁니다.
## Amazon DocumentDB 글로벌 클러스터 AWS 리전 에 추가
글로벌 클러스터에는 기본 클러스터와 다른 리전에 하나 이상의 보조 클러스터가 필요하며 보조 클러스터를 5개까지 추가할 수 있습니다. 추가하는 각 보조 클러스터에 대해 기본 클러스터에 허용되는 복제본 수를 하나씩 줄여야 한다는 점에 유의하세요. 예를 들어 글로벌 클러스터에 5개의 보조 리전이 있는 경우 기본 클러스터에는 15개가 아닌 10개의 복제본만 있을 수 있습니다. 자세한 내용은 [Amazon DocumentDB 글로벌 클러스터의 구성 요구 사항](https://docs.aws.amazon.com/documentdb/latest/developerguide/global-clusters.get-started.html#global-clusters.config)을 참조하세요.
### 사용 AWS Management Console
1. 에 로그인 AWS Management Console 하고 Amazon DocumentDB 콘솔을 엽니다.
1. 탐색 창에서 **클러스터**를 선택합니다.
![\[Amazon DocumentDB 콘솔의 클러스터 페이지입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png)
1. 보조 클러스터를 추가할 클러스터를 선택합니다. 클러스터가 `Available`인지 확인합니다.
![\[mydocdbglobalcluster가 강조 표시되고 사용 가능한 상태를 보여주는 리전 및 글로벌 클러스터 목록입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster-2.png)
1. **작업**의 드롭다운 목록을 선택한 다음 **리전 추가**를 선택합니다.
![\[클러스터 인터페이스의 작업 드롭다운에는 리전 추가 옵션이 표시됩니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region.png)
1. ** AWS 리전추가** 페이지에서 보조 리전을 선택합니다. 동일한 글로벌 데이터베이스에 대해 보조 DB 클러스터가 이미 있는 리전을 선택할 수 없다는 점에 유의하세요. 또한 이는 기본 클러스터와 동일한 리전이 될 수 없습니다. 이 리전을 처음 추가하는 경우 선택한 글로벌 클러스터 식별자도 지정해야 합니다.
![\[AWS 리전 양식 추가의 드롭다운 메뉴를 사용하여 보조 리전을 선택합니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region-2.png)
1. 새 리전에서 보조 클러스터에 대한 나머지 필드를 완료합니다. 이후 **클러스터 생성**을 선택합니다. 리전 추가를 완료하면 AWS Management Console의 **클러스터** 목록에서 볼 수 있습니다.
![\[구성 양식, 시간당 예상 비용 및 클러스터 생성 버튼을 표시하여 클러스터에 리전을 추가하는 최종 단계입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/quick-start/select-add-region.png)
### 사용 AWS CLI
+ `create-db-cluster` CLI 명령을 글로벌 클러스터의 이름 `(--global-cluster-identifier)`과 함께 사용합니다. 기타 명령 파라미터에서 다음을 수행합니다.
+ 에서 기본 리전 AWS 리전 과 다른을 `--region`선택합니다.
+ `--engine` 및 `--engine-version` 파라미터의 구체적인 값을 선택합니다.
+ 암호화된 클러스터의 경우 기본를 암호화를 `--source-region` 위한 AWS 리전 로 지정합니다.
다음 예제에서는 새 Amazon DocumentDB 클러스터를 생성하여 글로벌 클러스터에 읽기 전용 보조 클러스터로 연결합니다. 마지막 단계에서 인스턴스가 새 클러스터에 추가됩니다.
다음 예제에서는 자신의 정보로 각각의 *사용자 입력 자리 표시자*를 바꿉니다.
Linux, macOS 또는 Unix의 경우:
```
aws docdb --region secondary-region-id \
create-db-cluster \
--db-cluster-identifier cluster-id \
--global-cluster-identifier global-cluster-id \
--engine-version version \
--engine docdb
aws docdb --region secondary-region-id \
create-db-instance \
--db-cluster-identifier cluster-id \
--global-cluster-identifier global-cluster-id \
--engine-version version \
--engine docdb
```
Windows의 경우:
```
aws docdb --region secondary-region-id ^
create-db-cluster ^
--db-cluster-identifier cluster-id ^
--global-cluster-identifier global-cluster-id ^
--engine-version version ^
--engine docdb
aws docdb --region secondary-region-id ^
create-db-instance ^
--db-cluster-identifier cluster-id ^
--global-cluster-identifier global-cluster-id ^
--engine-version version ^
--engine docdb
```
## Amazon DocumentDB 글로벌 클러스터에 스냅샷 사용
Amazon DocumentDB 클러스터의 스냅샷을 복원하여 글로벌 클러스터의 시작점으로 사용할 수 있습니다. 이렇게 하려면 스냅샷을 복원하고 새 클러스터를 생성해야 합니다. 이는 글로벌 클러스터의 기본 클러스터 역할을 합니다. 그런 다음 복원된 클러스터에 다른 리전을 추가하여 글로벌 클러스터로 변환할 수 있습니다.
# Amazon DocumentDB 글로벌 클러스터 관리
글로벌 클러스터를 구성하는 개별 클러스터에서 대부분의 관리 작업을 수행할 수 있습니다. 콘솔의 **데이터베이스** 페이지에서 **관련 리소스 그룹화**를 선택하면, 연결된 글로벌 클러스터 아래에 그룹화된 기본 클러스터와 보조 클러스터를 볼 수 있습니다.
글로벌 클러스터의 **구성** 탭에는 클러스터가 실행 중인 AWS 리전 , 버전 및 글로벌 클러스터 식별자가 표시됩니다.
**Topics**
+ [글로벌 클러스터 수정](#global-clusters.modify)
+ [파라미터 수정](#global-clusters.modify-parameters)
+ [글로벌 클러스터 제거](#global-clusters.remove)
+ [글로벌 클러스터 삭제](#global-clusters.delete)
+ [헤드리스 클러스터](#global-clusters.headless)
## Amazon DocumentDB 글로벌 클러스터 수정
의 **클러스터** 페이지에는 모든 글로벌 클러스터가 AWS Management Console 나열되며 각 클러스터의 기본 클러스터와 보조 클러스터가 표시됩니다. 글로벌 클러스터에는 고유한 구성 설정이 있습니다. 특히, 기본 및 보조 클러스터와 관련된 리전이 있습니다.
글로벌 클러스터를 변경하면 변경 사항을 취소 할 수 있는 기회가 제공됩니다.
계속을 선택하면 변경 사항이 승인됩니다.
## 파라미터 Amazon DocumentDB 글로벌 클러스터 수정
글로벌 클러스터 내에서 각 클러스터에 대해 클러스터 파라미터 그룹을 별도로 구성할 수 있습니다. 대부분의 파라미터는 다른 종류의 Amazon DocumentDB 클러스터와 동일하게 작동합니다. 전역 데이터베이스의 모든 클러스터 간에 설정을 일관성 있게 유지하는 것이 좋습니다. 이렇게 하면 보조 클러스터를 기본 클러스터로 승격하는 경우에 예상치 못한 동작 변경을 방지할 수 있습니다.
예를 들면 다른 클러스터가 기본 클러스터로 대신 사용되는 경우 일관되지 않은 동작을 방지하려면 시간대와 문자 세트에 대해 동일한 설정을 사용합니다.
## Amazon DocumentDB 글로벌 클러스터에서 클러스터 분리
글로벌 클러스터에서 클러스터를 제거해야 하는 상황은 여러 가지가 있습니다. 예를 들어, 기본 클러스터가 성능이 저하되거나 격리된 경우 글로벌 클러스터에서 클러스터를 제거할 수 있습니다. 그런 다음, 프로비저닝된 독립형 클러스터가 되어, 새로운 글로벌 클러스터를 생성하는 데 사용할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 글로벌 클러스터에 대한 수동 장애 조치 수행](global-clusters-disaster-recovery.md#manual-failover)를 참조하세요.
더 이상 필요하지 않은 글로벌 클러스터를 삭제하고자 하기 때문에 클러스터를 제거하고 싶을 수도 있습니다. 연결된 모든 클러스터를 분리하고 기본 클러스터를 마지막으로 남겨둘 때까지는 글로벌 클러스터를 삭제할 수 없습니다. 자세한 내용은 [Amazon DocumentDB 글로벌 클러스터에서 클러스터 제거](#global-clusters.delete) 단원을 참조하십시오.
**참고**
클러스터가 글로벌 클러스터에서 분리되면, 더 이상 기본 클러스터와 동기화되지 않습니다. 완전한 읽기/쓰기 기능을 갖춘 프로비저닝된 독립형 클러스터가 됩니다. 또한 Amazon DocumentDB 콘솔에 더이상 표시되지 않습니다. 콘솔에서 클러스터가 위치한 지역을 선택한 경우에만 볼 수 있습니다.
AWS Management Console AWS CLI, 또는 RDS API를 사용하여 글로벌 클러스터에서 클러스터를 제거할 수 있습니다.
------
#### [ Using the AWS Management Console ]
1. 에 로그인 AWS Management Console 하고 Amazon DocumentDB 콘솔로 이동합니다.
1. 왼쪽 측면의 탐색 창에서 **클러스터**를 선택합니다.
![\[이미지: 기존 클러스터 링크 및 해당 인스턴스 링크의 목록을 보여주는 클러스터 탐색 상자입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/choose-cluster.png)
1. 모든 보조 클러스터를 볼 수 있도록 글로벌 클러스터를 확장하세요. 제거하려는 보조 클러스터를 선택합니다. **작업**을 선택하고 드롭다운 메뉴에서 **글로벌에서 제거**를 선택합니다.
![\[이미지: 기존 보조 클러스터를 선택하고 '글로벌에서 제거' 작업을 강조 표시하는 클러스터 탐색 상자입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/remove-global.png)
1. 보조 클러스터를 글로벌 클러스터에서 분리할지 확인하는 메시지가 표시됩니다. 글로벌 클러스터에서 클러스터를 제거하려면 **제거 및 승격**을 선택합니다.
![\[이미지: 제거 및 승격 프롬프트입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/remove-promote.png)
클러스터는 더 이상 보조 클러스터로 사용되지 않으며 더 이상 기본 클러스터와 동기화되지 않습니다. 완전한 읽기/쓰기 기능을 갖춘 독립형 클러스터입니다.
보조 클러스터를 모두 제거하거나 삭제한 후 동일한 방식으로 기본 클러스터를 제거할 수 있습니다. 모든 보조 클러스터를 제거해야 기본 클러스터를 글로벌 클러스터에서 분리 또는 제거할 수 있습니다. 글로벌 클러스터는 0 리전 및 AZ가 있는 클러스터 목록에 남아 있을 수 있습니다. 이 글로벌 클러스터를 더 이상 사용하지 않을 경우 삭제할 수 있습니다.
------
#### [ Using the AWS CLI ]
글로벌 클러스터에서 클러스터를 제거하려면 `remove-from-global-cluster` CLI 명령 및 다음 파라미터를 실행합니다.
+ `--global-cluster-identifier` - 글로벌 클러스터의 이름(식별자)입니다.
+ `--db-cluster-identifier` - 글로벌 클러스터에서 제거할 각 클러스터의 이름입니다.
다음 명령은 글로벌 클러스터에서 보조 클러스터를 제거한 후 기본 클러스터를 제거합니다.
Linux, macOS 또는 Unix의 경우:
```
aws docdb --region secondary_region \
remove-from-global-cluster \
--db-cluster-identifier secondary_cluster_ARN \
--global-cluster-identifier global_cluster_id
aws docdb --region primary_region \
remove-from-global-cluster \
--db-cluster-identifier primary_cluster_ARN \
--global-cluster-identifier global_cluster_id
```
글로벌 클러스터의 각 보조 리전에 대해 `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN` 명령을 반복합니다.
Windows의 경우:
```
aws docdb --region secondary_region ^
remove-from-global-cluster ^
--db-cluster-identifier secondary_cluster_ARN ^
--global-cluster-identifier global_cluster_id
aws docdb --region primary_region ^
remove-from-global-cluster ^
--db-cluster-identifier primary_cluster_ARN ^
--global-cluster-identifier global_cluster_id
```
글로벌 클러스터의 각 보조 리전에 대해 `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN` 명령을 반복합니다.
------
## Amazon DocumentDB 글로벌 클러스터에서 클러스터 제거
글로벌 클러스터를 삭제하려면 다음을 수행합니다.
+ 글로벌 클러스터에서 모든 보조 클러스터를 제거합니다. 각 클러스터는 독립형 클러스터가 됩니다. 이전 [Amazon DocumentDB 글로벌 클러스터에서 클러스터 분리](#global-clusters.remove) 섹션을 참조하세요.
+ 각 독립형 클러스터에서 모든 복제본을 삭제합니다.
+ 글로벌 클러스터에서 기본 클러스터를 제거합니다. 이 클러스터는 독립형 클러스터가 됩니다.
+ 기본 클러스터에서 먼저 모든 복제본을 삭제한 다음 기본 인스턴스를 삭제합니다. 새로 독립 실행형 클러스터에서 기본 인스턴스를 삭제하면 일반적으로 클러스터와 글로벌 클러스터 모두가 제거됩니다.
------
#### [ Using the AWS Management Console ]
1. 에 로그인 AWS Management Console 하고 Amazon DocumentDB 콘솔로 이동합니다.
1. **클러스터**를 선택하고 삭제할 글로벌 클러스터를 찾습니다.
![\[이미지: 기존 클러스터 링크 및 해당 인스턴스 링크의 목록을 보여주는 클러스터 탐색 상자입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/choose-cluster.png)
1. 글로벌 클러스터를 선택한 상태에서 **작업** 메뉴에서 **삭제**를 선택합니다.
![\[이미지: 글로벌 클러스터 선택을 표시하고 '삭제' 작업을 강조 표시하는 클러스터 탐색 상자입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/global-clusters/delete-cluster.png)
글로벌 클러스터에서 다른 모든 클러스터가 제거되었는지 확인합니다. 글로벌 클러스터에는 0 리전, AZ와 0 클러스터 크기가 표시되어야 합니다. 글로벌 클러스터에 클러스터가 포함되어 있으면 삭제할 수 없습니다. 먼저 이전 단계인 **[Amazon DocumentDB 글로벌 클러스터에서 클러스터 분리](#global-clusters.remove)**의 지침을 따라야 합니다.
------
#### [ Using the AWS CLI ]
글로벌 클러스터를 삭제하려면 다음 예제와 같이 AWS 리전 의 이름과 글로벌 클러스터 식별자를 사용하여 `delete-global-cluster` CLI 명령을 실행합니다.
Linux, macOS, Unix의 경우:
```
aws docdb --region primary_region delete-global-cluster \
--global-cluster-identifier global_cluster_id
```
Windows의 경우:
```
aws docdb --region primary_region delete-global-cluster ^
--global-cluster-identifier global_cluster_id
```
------
## 보조 리전에 헤드리스 Amazon DocumentDB 클러스터 생성
Amazon DocumentDB 글로벌 클러스터에는 기본 클러스터 AWS 리전 와 다른에 하나 이상의 보조 클러스터가 필요하지만 보조 클러스터에 헤드리스 구성을 사용할 수 있습니다. 헤드리스 세컨더리 Amazon DocumentDB 클러스터는 인스턴스가 없는 클러스터입니다. 이 유형의 구성은 글로벌 클러스터에 대한 비용을 줄일 수 있습니다. Amazon DocumentDB 클러스터에서는 컴퓨팅과 스토리지가 분리되어 있습니다. 인스턴스가 없으면 컴퓨팅 요금이 청구되지 않고 스토리지 요금만 청구됩니다. 올바르게 설정되면, 헤드리스 보조 스토리지 볼륨이 기본 클러스터와 동기화 상태를 유지합니다.
Amazon DocumentDB 글로벌 클러스터를 생성할 때 보통 때처럼 보조 클러스터를 추가합니다. 그러나 프라이머리 클러스터가 보조 클러스터로 복제되기 시작한 후에는 보조 클러스터에서 읽기 전용 DB 인스턴스를 삭제합니다. 이 보조 클러스터에는 더 이상 인스턴스가 없기 때문에 “헤드리스”로 간주됩니다. 그러나 스토리지 볼륨은 기본 Amazon DocumentDB 클러스터와 동기화 상태를 유지합니다.
**중요**
15분 이상 지역 전반의 장애를 견딜 수 있는 고객에게만 헤드리스 클러스터를 사용하는 것이 좋습니다. 헤드리스 보조 클러스터로 지역 전반의 장애를 복구하려면 장애 조치 후 사용자가 새 인스턴스를 만들어야 하기 때문입니다. 새 인스턴스를 사용할 수 있게 되려면 약 10\$115분 정도 걸릴 수 있습니다.
### 글로벌 클러스터에 헤드리스 보조 클러스터를 추가하는 방법
1. 에 로그인 AWS Management Console 하고 [Amazon DocumentDB 콘솔](https://console.aws.amazon.com/rds/)을 엽니다.
1. 왼쪽 측면의 탐색 창에서 **클러스터**를 선택합니다.
1. 보조 클러스터가 필요한 글로벌 클러스터를 선택합니다. 기본 클러스터가 `Available`인지 확인합니다.
1. **작업**에서 **리전 추가**를 선택합니다.
1. **리전 추가** 페이지에서 보조 리전을 선택합니다.
**참고**
동일한 글로벌 클러스터에 대해 보조 클러스터가 이미 있는 리전을 선택할 수 없습니다. 또한 이는 기본 클러스터와 동일한 리전이 될 수 없습니다.
1. 새 리전에서 보조 클러스터에 대한 나머지 필드를 완료합니다. 이 옵션은 클러스터 인스턴스와 동일한 구성 옵션입니다.
1. 리전을 추가합니다. 글로벌 클러스터에 리전 추가를 완료하면 AWS Management Console의 `Clusters`에서 글로벌 클러스터의 목록에서 볼 수 있습니다.
1. AWS Management Console 또는를 사용하여 계속하기 전에 보조 클러스터와 해당 리더 인스턴스의 상태를 확인합니다 AWS CLI. 다음은 AWS CLI을 사용하는 경우의 샘플 명령입니다.
```
$ aws docdb describe-db-clusters --db-cluster-identifier secondary-cluster-id --query '*[].[Status]' --output text
```
새로 추가된 보조 클러스터의 상태가 생성에서 사용 가능으로 변경되려면 몇 분 정도 걸릴 수 있습니다. 클러스터를 사용할 수 있게 되면 리더 인스턴스를 삭제할 수 있습니다.
1. 보조 클러스터에서 리더 인스턴스를 선택한 후 **삭제**를 선택합니다.
1. 리더 인스턴스를 삭제한 후 보조 클러스터는 글로벌 클러스터의 일부로 남습니다. 데이터와 연결되지 않아야 합니다.
**참고**
이러한 중단이 발생할 경우 이 헤드리스 세컨더리 Amazon DocumentDB 클러스터를 사용하여 기본 리전의 계획되지 않은 중단으로부터 Amazon DocumentDB 글로벌 클러스터를 수동으로 복구할 수 있습니다.
# Amazon DocumentDB 글로벌 클러스터에 연결
글로벌 클러스터에 연결하는 방법은 클러스터에 쓸 것인지 클러스터에서 읽을 것인지에 따라 달라집니다:
+ 읽기 전용 요청 또는 쿼리의 경우 자신의 AWS 리전에 있는 Aurora 클러스터 리더 엔드포인트에 연결합니다.
+ 데이터 조작 언어(DML) 또는 데이터 정의 언어(DDL) 설명문을 실행하려면 기본 클러스터용 클러스터 엔드포인트에 연결합니다. 이 엔드포인트는 애플리케이션 AWS 리전 과 다른에 있을 수 있습니다.
콘솔에서 글로벌 클러스터를 볼 때 해당 모든 클러스터와 연결된 모든 범용 엔드포인트를 볼 수 있습니다.
글로벌 클러스터에 연결하는 방법은 데이터베이스에 쓸 것인지 데이터베이스에서 읽을 것인지에 따라 달라집니다. 기본 영역에서 제공할 DDL, DML 및 읽기 작업의 경우 기본 클러스터에 연결해야 합니다. 읽기 환경설정이 `secondaryPreferred=true`인 클러스터 엔드포인트를 복제본 세트 모드로 사용하여 기본 클러스터에 연결하는 것이 좋습니다. 그러면 쓰기 트래픽이 기본 클러스터의 작성자 인스턴스로 라우팅되고 읽기 트래픽이 기본 클러스터의 복제본 인스턴스로 라우팅됩니다.
교차 리전의 경우 트래픽만 읽으며 보조 클러스터 중 하나에 연결해야 합니다. 복제본 세트 모드에서 클러스터 엔드포인트를 사용하여 보조 클러스터에 연결하는 것이 좋습니다. 모든 인스턴스는 읽기 전용 복제본 인스턴스이므로 읽기 환경설정을 지정할 필요가 없습니다. 대기 시간을 최소화하려면 해당 리전 또는 가장 가까운 리전에 있는 판독기 엔드포인트를 선택합니다.
# Amazon DocumentDB 글로벌 클러스터 모니터링
Amazon DocumentDB(MongoDB 호환)는 CloudWatch와 통합되므로 클러스터에 대한 운영 지표를 수집하고 분석할 수 있습니다. CloudWatch 콘솔, Amazon DocumentDB 콘솔, AWS Command Line Interface (AWS CLI) 또는 CloudWatch API를 사용하여 이러한 지표를 모니터링할 수 있습니다.
글로벌 클러스터를 모니터링하려면 다음 CloudWatch 지표를 사용합니다.
| 지표 | 설명 |
| --- | --- |
| GlobalClusterReplicatedWriteIO | 5분 간격으로 AWS 리전보고된 기본의 클러스터 볼륨에서 보조 AWS 리전 의 클러스터 볼륨으로 복제된 청구된 쓰기 I/O 작업의 평균 수입니다. 각 보조 리전에 복제되는 ReplicatedWriteIOs 횟수는 기본 리전에서 VolumeWriteIOPs 수행한 리전 내 복제 수와 동일합니다. |
| GlobalClusterDataTransferBytes | 기본 클러스터에서 보조 클러스터로 전송 AWS 리전 된 데이터의 양은 바이트 단위로 AWS 리전측정됩니다. |
| GlobalClusterReplicationLag | 기본 클러스터의에서 보조 클러스터의 로 변경 이벤트를 복제 AWS 리전 할 때 밀리초 단위의 지연 시간 AWS 리전 |
이러한 지표를 보는 방법에 대한 자세한 내용은 [CloudWatch 데이터 보기](https://docs.aws.amazon.com/documentdb/latest/developerguide/cloud_watch.html#cloud_watch-view_data)를 참조하십시오.
# 재해 복구 및 Amazon DocumentDB 글로벌 클러스터
**Topics**
+ [
## Amazon DocumentDB 글로벌 클러스터에 대한 관리형 장애 조치 수행
](#managed-failover)
+ [
## Amazon DocumentDB 글로벌 클러스터에 대한 수동 장애 조치 수행
](#manual-failover)
+ [
## Amazon DocumentDB 글로벌 클러스터에 대한 전환 수행
](#global-cluster-switchover)
+ [
## 글로벌 클러스터 전환 또는 장애 조치 차단 해제
](#unblocking-gc-so-fo)
글로벌 클러스터를 활용하여 리전 장애와 같은 재해로부터 신속하게 복구할 수 있습니다. 재해 복구는 일반적으로 RTO 및 RPO 값을 사용하여 측정됩니다.
+ **(Recovery Time Objective(RTO)** – 재해 발생 후 시스템이 정상 작동 상태로 돌아가는 데 걸리는 시간입니다. 즉 RTO는 가동 중지 시간을 측정합니다. 글로벌 클러스터의 경우 몇 분 안에 RTO를 수행합니다.
+ **Recovery Point Objective(RPO)** – 손실될 수 있는 데이터의 양입니다(시간으로 측정). 글로벌 클러스터의 경우 일반적으로 RPO는 초 단위로 측정됩니다.
+ 계획되지 않은 중단에서 복구하려면 글로벌 클러스터의 보조 클러스터 중 하나에 대해 리전 간 장애 조치를 수행할 수 있습니다. 글로벌 클러스터에 여러 개의 보조 리전이 있다면 기본으로 승격하려는 모든 보조 리전의 연결을 해제해야 합니다. 그런 다음 보조 영역 중 하나를 새 기본 영역 AWS 리전으로 승격합니다. 마지막으로 다른 보조 영역 각각에 새 클러스터를 생성하고 해당 클러스터를 글로벌 클러스터에 연결합니다.
## Amazon DocumentDB 글로벌 클러스터에 대한 관리형 장애 조치 수행
이 접근 방식은 실제 리전별 재해 이벤트 또는 전체 서비스 수준 중단이 발생하는 경우 비즈니스 연속성을 유지하기 위해 개발되었습니다.
관리형 장애 조치 중에, Amazon DocumentDB 글로벌 클러스터의 기존 복제 토폴로지가 유지되는 동안 기본 클러스터는 선택한 보조 리전으로 장애 조치됩니다. 선택한 보조 클러스터에서는 읽기 전용 노드 중 하나가 전체 라이터 상태로 승격됩니다. 이 단계를 통해 클러스터는 기본 클러스터의 역할을 맡게 됩니다. 클러스터가 새 역할을 맡는 동안에는 데이터베이스를 일시적으로 사용할 수 없습니다. 이 보조 클러스터가 새 기본 클러스터가 되면 기존 기본 클러스터에서 선택한 보조 클러스터로 복제되지 않은 데이터는 누락될 수 있습니다. 이전 기본 볼륨은 스냅샷에 복제되지 않은 데이터가 보존되도록 새 기본 볼륨과 동기화하기 전에 스냅샷을 찍으려고 최선의 노력을 기울입니다.
**참고**
기본 및 모든 보조 클러스터에 있는 엔진 버전이 동일한 경우 Amazon DocumentDB 글로벌 클러스터에서 관리형 리전 간 클러스터 장애 조치만 수행할 수 있습니다. 엔진 버전이 호환되지 않는 경우 [Amazon DocumentDB 글로벌 클러스터에 대한 수동 장애 조치 수행](#manual-failover)에 나온 단계에 따라 수동으로 장애 조치를 수행할 수 있습니다.
리전의 엔진 버전이 일치하지 않으면 장애 조치가 차단됩니다. 보류 중인 업그레이드가 있는지 확인하고 이를 적용하여 모든 리전의 엔진 버전이 일치하고 글로벌 클러스터 장애 조치가 차단 해제되었는지 확인하세요. 자세한 내용은 [글로벌 클러스터 전환 또는 장애 조치 차단 해제](#unblocking-gc-so-fo) 단원을 참조하십시오.
데이터 손실을 최소화하려면 이 기능을 사용하기 전에 다음을 수행하는 것이 좋습니다.
+ 애플리케이션을 오프라인으로 전환하여 쓰기가 Amazon DocumentDB 글로벌 클러스터의 기본 클러스터로 전송되는 경우를 방지합니다.
+ 모든 Amazon DocumentDB 보조 클러스터의 지연 시간을 확인합니다. 복제 지연이 가장 적게 소요되는 보조 리전을 선택하면 현재 장애가 발생한 기본 리전에서 데이터 손실을 최소화할 수 있습니다. Amazon CloudWatch에서 `GlobalClusterReplicationLag` 지표를 확인하여 글로벌 클러스터의 모든 Amazon DocumentDB 보조 클러스터에 대한 지연 시간을 확인합니다. 이 지표를 통해 보조 클러스터가 기본 DB 클러스터에 비해 얼마나 뒤처져 있는지(밀리초 단위) 알 수 있습니다.
Amazon DocumentDB용 CloudWatch 지표에 대한 자세한 내용은 [Amazon DocumentDB 지표](cloud_watch.md#cloud_watch-metrics_list) 섹션을 참조하세요.
관리형 장애 조치 중에, 선택한 보조 DB 클러스터가 기본 클러스터처럼 새 역할로 승격됩니다. 하지만 기본 클러스터의 다양한 구성 옵션은 상속되지 않습니다. 구성이 일치하지 않으면 성능 문제, 워크로드 비호환성, 기타 비정상적인 동작이 발생할 수 있습니다. 이러한 문제를 방지하려면, 다음에 대해 Amazon DocumentDB 글로벌 클러스터 간의 차이점을 해결하는 것이 좋습니다.
+ **필요한 경우 새 기본에 대한 Amazon DocumentDB 클러스터 파라미터 그룹 구성** — Amazon DocumentDB 글로벌 클러스터의 각 클러스터에 대해 Amazon DocumentDB 클러스터 파라미터 그룹을 개별적으로 구성할 수 있습니다. 즉, 보조 클러스터가 기본 클러스터 역할을 맡도록 승격되면 보조 클러스터의 파라미터 그룹이 기본 클러스터와 다르게 구성될 수 있습니다. 그런 경우, 승격된 보조 클러스터의 파라미터 그룹을 기본 클러스터의 설정에 맞게 수정합니다. 자세한 방법은 [Amazon DocumentDB 클러스터 파라미터 그룹 수정](cluster_parameter_groups-modify.md)을 참조하세요.
+ **Amazon CloudWatch Events 및 경보 등의 모니터링 도구 및 옵션 구성** — 승격된 클러스터를 글로벌 클러스터에 필요한 것과 동일한 로깅 기능, 경보 등으로 구성합니다. 파라미터 그룹과 마찬가지로, 이러한 기능에 대한 구성은 장애 조치 프로세스 중에 기본 클러스터에서 상속되지 않습니다. 복제 지연과 같은 일부 CloudWatch 지표는 보조 리전에서만 사용할 수 있습니다. 따라서 장애 조치로 인해 해당 지표를 보고 경보를 설정하는 방법이 달라짐에 따라 사전 정의된 대시보드를 변경해야 할 수도 있습니다. Amazon DocumentDB 클러스터 및 모니터링에 대한 자세한 내용은 [Amazon DocumentDB 모니터링](monitoring_docdb.md) 섹션을 참조하세요.
일반적으로 선택한 보조 클러스터는 1분 이내에 기본 역할을 맡게 됩니다. 새 기본 리전의 라이터 노드를 사용할 수 있게 되면 애플리케이션을 노드에 연결하고 워크로드를 재개할 수 있습니다. Amazon DocumentDB에서 새 기본 클러스터가 승격되고 난 후, 모든 추가 보조 리전 클러스터가 자동으로 재구축됩니다.
Amazon DocumentDB 글로벌 클러스터는 비동기식 복제를 사용하므로 보조 리전마다 복제 지연 시간이 다를 수 있습니다. Amazon DocumentDB는 이러한 보조 리전을 재구축하여 새로운 기본 리전 클러스터와 정확히 동일한 시점의 데이터를 확보하도록 지원합니다. 전체 재구축 작업에 소요되는 시간은 스토리지 볼륨의 크기와 리전 간 거리에 따라 몇 분에서 몇 시간이 걸릴 수 있습니다. 보조 리전 클러스터의 재구축이 새 기본 리전에서 완료되면 읽기 권한으로 액세스할 수 있습니다. 새 기본 라이터가 승격되어 사용 가능해지면 새 기본 리전의 클러스터에서 Amazon DocumentDB 글로벌 클러스터의 읽기 및 쓰기 작업을 처리할 수 있습니다.
글로벌 클러스터의 기존 토폴로지를 복원하기 위해 Amazon DocumentDB는 기존 기본 리전의 가용성을 모니터링합니다. 해당 리전이 정상이고 다시 사용 가능한 상태가 되면 Amazon DocumentDB는 자동으로 글로벌 클러스터에 보조 리전으로 다시 추가합니다. Amazon DocumentDB는 장애가 발생하는 시점에 기존 스토리지 볼륨의 스냅샷을 만들고자 시도한 후, 기존 기본 리전에 새 스토리지 볼륨을 생성합니다. 이렇게 하면 누락된 데이터를 복구하는 데 사용할 수 있습니다. 이 작업이 성공하면 Amazon DocumentDB는 AWS Management Console의 스냅샷 섹션에 'rds:docdb-unplanned-global-failover-name-of-old-primary-DB-cluster-timestamp'라는 이름으로 이 스냅샷을 배치합니다. 또한 이 스냅샷은 `DescribeDBClusterSnapshots` API 작업에서 반환된 정보에 나열되어 있으니 해당 위치에서 확인할 수 있습니다.
**참고**
기존 스토리지 볼륨의 스냅샷은 시스템 스냅샷으로, 기존 기본 클러스터에 구성된 백업 보존 기간이 적용됩니다. 보존 기간 이후에도 이 스냅샷을 보존하려면 스냅샷을 복사하여 수동 스냅샷으로 저장할 수 있습니다. 요금 등 스냅샷 복사에 대해 자세히 알아보려면 [클러스터 스냅샷 복사](backup_restore-copy_cluster_snapshot.md#backup_restore-copy_a_cluster_snapshot) 단원을 참조하세요.
기존 토폴로지가 복원된 후 비즈니스 및 워크로드에 가장 적합한 시점에 전환 작업을 수행하여 글로벌 클러스터를 기존의 기본 리전으로 장애 복구할 수 있습니다. 이렇게 하려면 [Amazon DocumentDB 글로벌 클러스터에 대한 전환 수행](#global-cluster-switchover) 단원의 절차를 따르세요.
AWS CLI, 또는 Amazon DocumentDB API를 사용하여 Amazon DocumentDB 글로벌 클러스터 AWS Management Console를 장애 조치할 수 있습니다.
------
#### [ Using the AWS Management Console ]
**Amazon DocumentDB 글로벌 클러스터에서 관리형 장애 조치 수행**
1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다.
1. 탐색 창에서 **클러스터**를 선택합니다.
1. 장애 조치하려는 Amazon DocumentDB 글로벌 클러스터를 찾아 선택합니다.
![\[이미지: 전역 클러스터가 선택된 클러스터 테이블입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/failover-cluster-table.png)
1. **작업** 메뉴에서 **전환 또는 장애 조치**를 선택합니다.
1. 나타나는 대화 상자에서 **장애 조치**를 선택한 다음 **새 기본 클러스터** 필드 드롭다운 목록에서 보조 클러스터를 선택합니다.
![\[이미지: 글로벌 클러스터 전환 또는 장애 조치 대화 상자입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/switch-fail-confirm.png)
1. 마지막 필드에 ‘확인’을 입력합니다. 그 다음 **확인**을 선택합니다.
기본 클러스터의 상태가 ‘**장애 조치 중**’으로 변경됩니다. 이 조건은 약 1분이 소요됩니다. 이 시간 동안 새 기본 클러스터의 상태는 ‘**수정 중...**’으로 표시됩니다. 새 기본이 승격되면 ‘**사용 가능**’이 표시되고 읽기 및 쓰기 트랜잭션을 제공할 수 있습니다. 이전 기본을 포함한 보조 리전은 새 기본과 재동기화되는 동안 ‘**재동기화 중...**’을 표시합니다. 새 기본과 마찬가지로 상태가 ‘**사용 가능**’으로 변경된 후에만 트랜잭션을 제공할 수 있습니다.
1. 완료되면 원래 기본 클러스터가 보조 클러스터가 됩니다. 선택한 보조 클러스터가 기본 클러스터가 됩니다.
![\[이미지: 새 기본 클러스터를 보여주는 클러스터 테이블입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/failover-complete.png)
------
#### [ Using the AWS CLI ]
**Amazon DocumentDB 글로벌 클러스터에서 관리형 장애 조치 수행**
[https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-global-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-global-cluster.html) CLI 명령을 실행하여 Amazon DocumentDB 글로벌 클러스터를 장애 조치합니다. 명령을 사용하여 다음 옵션에 대한 값을 전달합니다.
+ `--region`
+ `--global-cluster-identifier`
+ `--target-db-cluster-identifier`
+ `--allow-data-loss`
다음 예제에서는 각각의 *사용자 입력 자리 표시자*를 자신의 클러스터 정보로 바꿉니다.
Linux, macOS, Unix의 경우:
```
aws docdb failover-global-cluster \
--region region_of_selected_secondary \
--global-cluster-identifier global_cluster_id \
--target-db-cluster-identifier arn_of_secondary_to_promote \
--allow-data-loss
```
Windows의 경우:
```
aws docdb failover-global-cluster ^
--region region_of_selected_secondary ^
--global-cluster-identifier global_cluster_id ^
--target-db-cluster-identifier arn_of_secondary_to_promote ^
--allow-data-loss
```
------
## Amazon DocumentDB 글로벌 클러스터에 대한 수동 장애 조치 수행
한의 전체 클러스터를 사용할 수 없게 AWS 리전 되면 글로벌 클러스터의 다른 클러스터를 읽기/쓰기 기능으로 승격할 수 있습니다.
다른 AWS 리전 의 클러스터가 기본 클러스터로 더 적합한 경우 글로벌 클러스터 장애 조치 메커니즘을 수동으로 활성화할 수 있습니다. 예를 들어 보조 클러스터 중 하나의 용량을 늘린 후 이 클러스터를 기본 클러스터로 승격할 수 있습니다. 또는 간의 활동 균형이 변경될 AWS 리전 수 있으므로 기본 클러스터를 다른 로 전환하면 쓰기 작업의 지연 시간이 줄어들 AWS 리전 수 있습니다.
다음 절차에서는 Amazon DocumentDB 글로벌 클러스터의 보조 클러스터 중 하나를 승격하기 위해 수행할 작업을 설명합니다.
보조 클러스터를 승격하려면:
1. 중단 AWS 리전 시의 기본 클러스터에 대한 DML 문 및 기타 쓰기 작업 실행을 중지합니다.
1. 새 기본 클러스터로 사용할 보조 클러스터를 식별 AWS 리전 합니다. 글로벌 클러스터 AWS 리전 에 보조 클러스터가 두 개(또는 그 이상) 있는 경우 지연 시간이 가장 짧은 보조 클러스터를 선택합니다.
1. 선택한 보조 클러스터를 글로벌 클러스터에서 분리합니다.
글로벌 클러스터에서 보조 클러스터를 제거하면 기본 클러스터에서 이 보조 클러스터로의 복제가 즉시 중지되고 전체 읽기/쓰기 기능을 갖춘 독립 실행형 프로비저닝 클러스터로 승격됩니다. 정전이 발생한 리전의 주 클러스터와 관련된 다른 보조 클러스터는 여전히 사용할 수 있으며 애플리케이션의 호출을 수락할 수 있습니다. 클러스터는 리소스도 소비합니다. 글로벌 클러스터를 다시 생성하는 중이므로 분할 브레인 및 기타 문제를 방지하려면 다음 단계에서 새 글로벌 클러스터를 생성하기 전에 다른 보조 클러스터를 제거하십시오.
분리 단계에 대한 자세한 내용은 [Amazon DocumentDB 글로벌 클러스터에서 클러스터 분리](global-clusters.manage.md#global-clusters.remove) 섹션을 참조하십시오.
1. 이 클러스터는 다음 단계에서 영역을 추가하기 시작하면 새 글로벌 클러스터의 기본 클러스터가 됩니다.
1. 클러스터에 AWS 리전 를 추가합니다. 이렇게 하면 기본 클러스터에서 보조 클러스터로의 복제 프로세스가 시작됩니다.
1. 필요에 AWS 리전 따라를 추가하여 애플리케이션을 지원하는 데 필요한 토폴로지를 다시 생성합니다. 글로벌 클러스터에 있는 클러스터 간의 데이터 불일치(분할 뇌 문제)를 방지하기 위해 이러한 변경 전, 변경 중 및 변경 후에 애플리케이션 쓰기가 올바른 클러스터로 전송되는지 확인합니다.
1. 운영 중단이 해결되고 원본 AWS 리전 을 다시 기본 클러스터로 할당할 준비가 되면 동일한 단계를 반대로 수행합니다.
1. 글로벌 데이터베이스에서 보조 클러스터 중 하나를 제거합니다. 이렇게 하면 읽기/쓰기 트래픽을 처리할 수 있습니다.
1. 모든 쓰기 트래픽을 원래 AWS 리전의 기본 클러스터로 리디렉션합니다.
1. AWS 리전 를 추가하여 이전 AWS 리전 과 동일한에 하나 이상의 보조 클러스터를 설정합니다.
Amazon DocumentDB 글로벌 클러스터는 AWS SDKs 사용하여 관리할 수 있으므로 재해 복구 및 비즈니스 연속성 계획 사용 사례에 대한 글로벌 클러스터 장애 조치 프로세스를 자동화하는 솔루션을 생성할 수 있습니다. 이러한 솔루션 중 하나는 Apache 2.0 라이센스에 따라 고객이 사용할 수 있도록 제공되며 [여기](https://github.com/awslabs/amazon-documentdb-tools/tree/master/global-clusters-automation)에 있는 툴 저장소에서 액세스할 수 있습니다. 이 솔루션은 엔드포인트 관리를 위해 Amazon Route 53를 활용하고 적절한 이벤트를 기반으로 트리거할 수 있는 AWS Lambda 함수를 제공합니다.
## Amazon DocumentDB 글로벌 클러스터에 대한 전환 수행
전환을 사용하면 기본 클러스터의 리전을 정기적으로 변경할 수 있습니다. 이 접근 방식은 운영 유지 관리 및 기타 계획된 운영 절차 등 제어된 시나리오를 대상으로 개발되었습니다.
전환은 일반적으로 3가지의 경우에 사용됩니다.
+ 특정 산업에서 필요로 하는 '리전별 순환' 요구 사항을 살펴봅니다. 예를 들어 금융 서비스 규정에 따라 재해 복구 절차가 정기적으로 실행되도록 보장하려면 Tier-0 시스템을 몇 개월 동안 다른 리전으로 전환해야 할 수 있습니다.
+ 여러 리전의 'follow-the-sun' 애플리케이션을 살펴봅니다. 각기 다른 시간대 전반에서 업무 시간을 기준으로 여러 리전별로 지연 시간이 짧은 쓰기 기능을 제공하고자 하는 기업을 예로 들 수 있습니다.
+ 데이터 손실 제로의 방법이며, 장애 조치 후 기존의 기본 리전으로 페일백하는 데 유용합니다.
**참고**
전환은 정상 Amazon DocumentDB 글로벌 클러스터에서 사용하도록 설계되었습니다. 예상치 못한 중단이 발생한 상태에서 복구하려면 [Amazon DocumentDB 글로벌 클러스터에 대한 수동 장애 조치 수행](#manual-failover) 단원에 나온 적절한 절차를 따르세요.
전환을 수행하려면 모든 보조 리전이 기본 리전과 정확히 동일한 엔진 버전을 실행해야 합니다. 리전의 엔진 버전이 일치하지 않으면 전환이 차단됩니다. 보류 중인 업그레이드가 있는지 확인하고 이를 적용하여 모든 리전의 엔진 버전이 일치하고 글로벌 클러스터 전환이 차단 해제되었는지 확인하세요. 자세한 내용은 [글로벌 클러스터 전환 또는 장애 조치 차단 해제](#unblocking-gc-so-fo) 단원을 참조하십시오.
전환 중에, Amazon DocumentDB에서는 글로벌 클러스터의 기존 복제 토폴로지가 유지되는 동안 기본 클러스터를 선택한 보조 리전으로 전환합니다. Amazon DocumentDB는 모든 보조 리전 클러스터가 기본 리전 클러스터와 완전히 동기화될 때까지 기다린 다음, 전환 프로세스를 시작합니다. 그러면 기본 리전의 DB 클러스터가 읽기 전용 상태가 되고, 선택한 보조 클러스터는 읽기 전용 노드 중 하나를 전체 라이터 상태로 승격시킵니다. 이 노드를 라이터로 승격시키면 보조 클러스터가 기본 클러스터의 역할을 맡을 수 있습니다. 프로세스 시작 시 모든 보조 클러스터가 기본 클러스터와 동기화되었으므로, 새로운 기본 클러스터는 데이터 손실 없이 Amazon DocumentDB 글로벌 클러스터에 대한 작업을 계속합니다. 기본 클러스터와 선택한 보조 클러스터가 새 역할을 맡으므로 데이터베이스를 잠시 사용할 수 없습니다.
애플리케이션 가용성을 최적화하려면 이 기능을 사용하기 전에 다음 작업을 수행하는 것이 좋습니다.
+ 사용량이 적은 시간이나 기본 클러스터에 대한 쓰기가 최소인 시간에 이 작업을 수행합니다.
+ 애플리케이션을 오프라인으로 전환하여 쓰기가 Amazon DocumentDB 글로벌 클러스터의 기본 클러스터로 전송되는 경우를 방지합니다.
+ Amazon CloudWatch에서 `GlobalClusterReplicationLag` 지표를 확인하여 글로벌 클러스터의 모든 Amazon DocumentDB 보조 클러스터에 대한 지연 시간을 확인합니다. 이 지표는 보조 DB 클러스터가 기본 DB 클러스터에 비해 얼마나 뒤처져 있는지(밀리초 단위)를 보여 줍니다. 이 값은 Amazon DocumentDB가 전환을 완료하는 데 걸리는 시간에 직접적으로 비례합니다. 따라서 지연 값이 클수록 전환 시간이 더 오래 걸립니다.
Amazon DocumentDB용 CloudWatch 지표에 대한 자세한 내용은 [Amazon DocumentDB 지표](cloud_watch.md#cloud_watch-metrics_list) 섹션을 참조하세요.
전환 중에, 선택한 보조 DB 클러스터가 기본 DB 클러스터처럼 새 역할로 승격됩니다. 하지만 기본 DB 클러스터의 다양한 구성 옵션은 상속되지 않습니다. 구성이 일치하지 않으면 성능 문제, 워크로드 비호환성, 기타 비정상적인 동작이 발생할 수 있습니다. 이러한 문제를 방지하려면, 다음에 대해 Amazon DocumentDB 글로벌 클러스터 간의 차이점을 해결하는 것이 좋습니다.
+ **필요한 경우 새 기본에 대한 Amazon DocumentDB 클러스터 파라미터 그룹 구성** — Amazon DocumentDB 글로벌 클러스터의 각 클러스터에 대해 Amazon DocumentDB 클러스터 파라미터 그룹을 개별적으로 구성할 수 있습니다. 즉, 보조 DB 클러스터가 기본 클러스터 역할을 맡도록 승격되면 보조 클러스터의 파라미터 그룹이 기본 클러스터와 다르게 구성될 수 있습니다. 그런 경우, 승격된 보조 DB 클러스터의 파라미터 그룹을 기본 클러스터의 설정에 맞게 수정합니다. 자세한 방법은 [Amazon DocumentDB 클러스터 파라미터 그룹 관리](cluster_parameter_groups.md) 단원을 참조하십시오.
+ **Amazon CloudWatch Events 및 경보 등의 모니터링 도구 및 옵션 구성** — 승격된 클러스터를 글로벌 클러스터에 필요한 것과 동일한 로깅 기능, 경보 등으로 구성합니다. 파라미터 그룹과 마찬가지로, 이러한 기능에 대한 구성은 전환 프로세스 중에 기본 클러스터에서 상속되지 않습니다. 복제 지연과 같은 일부 CloudWatch 지표는 기본 리전에서만 사용할 수 있습니다. 따라서 전환으로 인해 해당 지표를 보고 경보를 설정하는 방법이 달라짐에 따라 사전 정의된 대시보드를 변경해야 할 수도 있습니다. 자세한 내용은 [Amazon DocumentDB 모니터링](monitoring_docdb.md) 단원을 참조하십시오.
**참고**
일반적으로 역할 전환에는 최대 몇 분이 걸릴 수 있습니다.
전환 프로세스가 완료되면 승격된 Amazon DocumentDB 클러스터에서 글로벌 클러스터에 대한 쓰기 작업을 처리할 수 있습니다.
AWS Management Console 또는 AWS CLI를 사용하여 Amazon DocumentDB 글로벌 클러스터를 전환할 수 있습니다.
------
#### [ Using the AWS Management Console ]
**Amazon DocumentDB 글로벌 클러스터에서 전환 수행**
1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다.
1. 탐색 창에서 **클러스터**를 선택합니다.
1. 전환하려는 Amazon DocumentDB 글로벌 클러스터를 찾아 선택합니다.
![\[이미지: 전역 클러스터가 선택된 클러스터 테이블입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/switchover-cluster-table.png)
1. **작업** 메뉴에서 **전환 또는 장애 조치**를 선택합니다.
1. 나타나는 대화 상자에서 **전환**을 선택한 다음 **새 기본 클러스터** 필드 드롭다운 목록에서 보조 클러스터를 선택합니다.
![\[이미지: 보조 클러스터가 선택된 클러스터 전환 대화 상자입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/switch-fail-confirm-2.png)
1. **확인**을 선택합니다.
기본 클러스터의 상태가 ‘**전환**’으로 변경됩니다. 이 조건은 약 3분이 소요됩니다. 이 시간 동안 모든 리전 클러스터의 상태는 '**수정 중...**'으로 표시됩니다. 리전이 동기화되고 새 프라이머리가 승격되면 모든 상태 필드에 대해 ‘**사용 가능**’이 표시되고 트랜잭션을 제공할 수 있습니다.
1. 완료되면 원래 기본 클러스터가 보조 클러스터가 됩니다. 선택한 보조 클러스터가 기본 클러스터가 됩니다.
![\[이미지: 새 기본 클러스터를 보여주는 클러스터 테이블입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/failover-complete.png)
------
#### [ Using the AWS CLI ]
**Amazon DocumentDB 글로벌 클러스터에서 전환 수행**
[https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/switchover-global-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/switchover-global-cluster.html) CLI 명령을 실행하여 Amazon DocumentDB 글로벌 클러스터를 전환합니다. 명령을 사용하여 다음 옵션에 대한 값을 전달합니다.
+ `--region`
+ `--global-cluster-identifier`
+ `--target-db-cluster-identifier`
다음 예제에서는 각각의 *사용자 입력 자리 표시자*를 자신의 클러스터 정보로 바꿉니다.
Linux, macOS, Unix의 경우:
```
aws docdb switchover-global-cluster \
--region region_of_primary \
--global-cluster-identifier global_cluster_id \
--target-db-cluster-identifier arn_of_secondary_to_promote
```
Windows의 경우:
```
aws docdb switchover-global-cluster ^
--region region_of_primary ^
--global-cluster-identifier global_cluster_id ^
--target-db-cluster-identifier arn_of_secondary_to_promote
```
------
## 글로벌 클러스터 전환 또는 장애 조치 차단 해제
글로벌 클러스터에 있는 모든 리전 클러스터의 엔진 버전이 동일하지 않은 경우 글로벌 클러스터 전환 및 장애 조치가 차단됩니다. 버전이 일치하지 않으면 전환 또는 장애 조치를 호출할 때 지정된 대상 DB 클러스터가 소스 DB 클러스터와 다른 패치 수준의 엔진 버전을 실행하고 있습니다라는 오류가 응답으로 표시될 수 있습니다. 글로벌 클러스터를 정상 상태로 유지하기 위해 최신 업데이트를 실행하려면 정기적으로 최신 엔진 버전을 적용하는 것이 좋습니다.
이 오류를 해결하려면 먼저 모든 보조 리전을 업데이트한 다음 보류 중인 유지 관리 작업 항목을 적용하여 기본 리전을 동일한 엔진 버전으로 업데이트하세요. 보류 중인 유지 관리 작업 항목을 보고 필요한 변경 사항을 적용하여 문제를 해결하려면 다음 탭 중 하나의 지침을 수행합니다.
------
#### [ Using the AWS Management Console ]
글로벌 클러스터 전환 또는 장애 조치를 차단 해제하려면 클러스터에 대해 보류 중인 유지 관리 작업이 있는지 확인하고 해당 작업을 적용해야 합니다. 다음 단계에 따라 유지 관리 작업을 보고 적용합니다.
1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다.
1. 탐색 창에서 **클러스터**를 선택합니다.
1. **클러스터** 테이블의 **클러스터 식별자** 열에서 글로벌 클러스터를 찾습니다. 글로벌 클러스터에서 지정된 글로벌 클러스터의 각 보조 클러스터와 기본 클러스터를 기록하고 각각에 대해 다음 단계를 수행합니다.
1. 각 보조 클러스터의 경우:
1. 클러스터에 업데이트가 있는 경우 **유지 관리** 열에 **사용 가능**, **필수** 또는 **다음 창**의 단어로 표시됩니다.
1. 조치를 취하려면 클러스터를 선택하여 세부 정보를 표시한 후 **유지 관리 및 백업**을 선택하십시오. 그러면 **대기 중인 유지 관리** 항목이 표시됩니다.
1. **설명**에서 ‘새 유지 관리 업데이트를 사용할 수 있음’을 나타내는 경우 해당 업데이트를 선택한 다음 **지금 적용**을 선택합니다.
1. 기본 클러스터의 경우:
1. 클러스터에 업데이트가 있는 경우 **유지 관리** 열에 **사용 가능**, **필수** 또는 **다음 창**의 단어로 표시됩니다.
1. 조치를 취하려면 클러스터를 선택하여 세부 정보를 표시한 후 **유지 관리 및 백업**을 선택하십시오. 그러면 **대기 중인 유지 관리** 항목이 표시됩니다.
1. **설명**에서 ‘새 유지 관리 업데이트를 사용할 수 있음’을 나타내는 경우 해당 업데이트를 선택한 다음 **지금 적용**을 선택합니다.
------
#### [ Using the AWS CLI ]
글로벌 클러스터 전환 또는 장애 조치를 차단 해제하려면 클러스터에 대해 보류 중인 유지 관리 작업이 있는지 확인하고 해당 작업을 적용해야 합니다. 다음 단계에 따라 보조 클러스터에서 먼저 유지 관리 작업을 보고 적용한 다음 글로벌 클러스터의 기본 클러스터에서 유지 관리 작업을 보고 적용합니다.
1. 각 보조 리전의 리전 클러스터에서 먼저 다음을 실행한 다음 기본 리전의 리전 클러스터에서 다음을 실행합니다.
1. `--resource-identifier` 옵션과 함께 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html) CLI 명령을 실행하여 Amazon DocumentDB 리전 클러스터에 사용할 수 있는 유지 관리 작업이 있는지 확인합니다.
다음 예제에서는 각각의 *사용자 입력 자리 표시자*를 자신의 클러스터 정보로 바꿉니다.
Linux, macOS, Unix의 경우:
```
aws docdb describe-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15
```
Windows의 경우:
```
aws docdb describe-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15
```
다음과 비슷한 결과가 반환됩니다.
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"CurrentApplyDate": "2025-04-11T03:01:00Z",
"Description": "db-version-upgrade",
"ForcedApplyDate": "2025-06-18T03:01:00Z",
"AutoAppliedAfterDate": "2025-05-11T03:01:00Z"
"OptInStatus": "pending"
}
]
}
]
}
```
1. 유지 관리 작업이 필요한 경우 다음 옵션을 사용하여 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html) CLI 명령을 실행합니다.
+ `--resource-identifier`
+ `--apply-action`
+ `--opt-in-type`
+ `--region`
다음 예제에서는 각각의 *사용자 입력 자리 표시자*를 자신의 클러스터 정보로 바꿉니다.
Linux, macOS, Unix의 경우:
```
aws docdb apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 \
--apply-action system-update \
--opt-in-type immediate \
--region us-east-1
```
Windows의 경우:
```
aws docdb apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 ^
--apply-action system-update ^
--opt-in-type immediate ^
--region us-east-1
```
1. 유지 관리 작업이 완료되면 [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html) 명령을 다시 실행하여 클러스터에 보류 중인 다른 작업이 없는지 확인합니다.
원하는 결과는 다음과 같습니다.
```
{
"PendingMaintenanceActions": []
}
```
------
#### [ Using the Amazon DocumentDB API ]
글로벌 클러스터 전환 또는 장애 조치를 차단 해제하려면 클러스터에 대해 보류 중인 유지 관리 작업이 있는지 확인하고 해당 작업을 적용해야 합니다. 다음 API를 사용하여 유지 관리 작업을 보고 적용합니다.
1. 각 보조 리전의 리전 클러스터에서 먼저 다음을 실행한 다음 기본 리전의 리전 클러스터에서 다음을 실행합니다.
1. [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_PendingMaintenanceAction.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_PendingMaintenanceAction.html) API를 호출하여 Amazon DocumentDB 글로벌 클러스터에 사용할 수 있는 유지 관리 작업이 있는지 확인합니다.
1. [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ApplyPendingMaintenanceAction.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ApplyPendingMaintenanceAction.html) API를 호출하여 변경 사항을 적용합니다.
------