기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon DocumentDB 클러스터 관리 Amazon DocumentDB 클러스터를 관리하려면 적절한 Amazon DocumentDB 컨트롤 플레인 권한을 가진 IAM 정책이 있어야 합니다. 이러한 권한은 클러스터와 인스턴스를 생성, 수정 및 삭제하도록 허용합니다. `AmazonDocDBFullAccess` 정책은 Amazon DocumentDB 클러스터를 관리하는 데 필요한 모든 권한을 제공합니다. 다음 주제에서는 Amazon DocumentDB 클러스터로 작업할 때 클러스터 생성, 삭제, 수정, 연결, 보기 등과 같은 다양한 작업을 수행하는 방법을 보여줍니다. **Topics** + [클러스터 이해](db-clusters-understanding.md) + [클러스터 설정](db-cluster-parameters.md) + [클러스터 스토리지 구성](db-cluster-storage-configs.md) + [클러스터 상태 확인](db-cluster-status.md) + [클러스터 수명 주기](db-cluster-life-cycle.md) + [클러스터 조정](db-cluster-manage-performance.md) + [클러스터에 대한 볼륨 복제](db-cluster-cloning.md) + [클러스터의 내결함성 이해](db-cluster-fault-tolerance.md) # 클러스터 이해 Amazon DocumentDB에서는 컴퓨팅과 스토리지를 구분하고, 데이터 복제 및 백업을 클러스터 볼륨으로 오프로드합니다. 클러스터 볼륨은 가용 영역 3곳에 6가지 방식으로 데이터를 복제하는 내구성이 뛰어나고 안정적인 고가용성 스토리지 계층을 제공합니다. 복제본은 높은 데이터 가용성을 확보하고 읽기 확장이 가능합니다. 각 클러스터를 최대 15개의 복제본으로 스케일 업할 수 있습니다. | 명사 | 설명 | API 작업(동사) | | --- | --- | --- | | Cluster | 하나 이상의 인스턴스와 이 인스턴스의 데이터를 관리하는 클러스터 스토리지 볼륨으로 구성됩니다. | `create-db-cluster` `delete-db-cluster` `describe-db-clusters` `modify-db-cluster` | | Instance | 클러스터 스토리지 볼륨에 대한 데이터 읽기 및 쓰기는 인스턴스를 통해 수행됩니다. 지정된 클러스터에는 기본 인스턴스와 복제본의 2가지 인스턴스가 있습니다. 클러스터는 항상 기본 인스턴스 하나와 0\$115개의 복제본을 가질 수 있습니다. | `create-db-instance` `delete-db-instance` `describe-db-instances` `modify-db-instance` `describe-orderable-db-instance-options` `reboot-db-instance` | | 클러스터 볼륨 | 3개의 가용 영역을 모두 아우르는 가상 데이터베이스 스토리지 볼륨으로서, 각 가용 영역에는 클러스터 데이터의 사본이 2개 있습니다. | 해당 사항 없음 | | 기본 인스턴스 | 읽기 및 쓰기 작업을 모두 지원하고, 클러스터 볼륨의 모든 데이터 수정을 실행합니다. 클러스터마다 기본 인스턴스가 하나씩 있습니다. | 해당 사항 없음 | | 복제본 인스턴스 | 읽기 연산만 지원합니다. 각 Amazon DocumentDB 클러스터는 기본 인스턴스에 더해 최대 15개의 복제 인스턴스를 포함할 수 있습니다. 복제본이 여러 개 있으면 읽기 워크로드가 분산됩니다. 복제본을 별도의 가용 영역에 두어 데이터베이스 가용성을 높일 수도 있습니다. | 해당 사항 없음 | | 클러스터 엔드포인트 | 클러스터의 현재 기본 인스턴스에 연결되는 Amazon DocumentDB 클러스터 엔드포인트입니다. 각 Amazon DocumentDB 클러스터에는 클러스터 엔드포인트 하나와 기본 인스턴스 하나가 있습니다. | 해당 사항 없음 | | 리더 엔드포인트 | 클러스터에서 사용할 수 있는 복제본 중 하나에 연결되는 Amazon DocumentDB 클러스터 엔드포인트입니다. 각 Amazon DocumentDB 클러스터에는 리더 엔드포인트가 1개씩 있습니다. 복제본이 하나 이상이면 리더 엔드포인트는 각 연결 요청을 Amazon DocumentDB 복제본 중 하나로 전달합니다. | 해당 사항 없음 | | 인스턴스 엔드포인트 | 특정 인스턴스에 연결되는 Amazon DocumentDB 클러스터의 인스턴스 엔드포인트입니다. 클러스터의 인스턴스에는 인스턴스 유형에 상관없이 각각 고유한 인스턴스 엔드포인트가 있습니다. | 해당 사항 없음 | # Amazon DocumentDB 클러스터 설정 클러스터를 생성 또는 수정할 때는 생성 후 수정할 수 없는 파라미터와 수정 가능한 파라미터를 이해하는 것이 중요합니다. 다음 표에는 한 클러스터에 적용되는 모든 설정 또는 파라미터가 나와 있습니다. 표에 나와 있듯이 일부 파라미터는 수정할 수 있고 다른 파라미터는 수정할 수 없습니다. **참고** 이러한 설정을 Amazon DocumentDB 클러스터 파라미터 그룹 및 해당 파라미터와 혼동해서는 안 됩니다. 클러스터 파라미터 그룹에 대한 자세한 내용은 [Amazon DocumentDB 클러스터 파라미터 그룹 관리](cluster_parameter_groups.md) 섹션을 참조하세요. | 파라미터 | 수정 가능 | 참고 | | --- | --- | --- | | DBClusterIdentifier | 예 | 명명 제약 조건: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/db-cluster-parameters.html) | | Engine | 아니요 | docdb여야 합니다. | | BackupRetentionPeriod | 예 | 1\$135일 사이여야 합니다. | | DBClusterParameterGroupName | 예 | 명명 제약 조건: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/db-cluster-parameters.html) | | DBSubnetGroupName | 아니요 | 클러스터가 생성된 이후에는 클러스터의 서브넷을 수정할 수 없습니다. | | EngineVersion | 아니요 | 값은 5.0.0 (기본값)4.0.0, 또는 3.6.0일 수 있습니다. | | KmsKeyId | 아니요 | 클러스터를 암호화하기로 선택한 경우 클러스터를 암호화하는 데 사용한 AWS KMS 키를 변경할 수 없습니다. | | MasterUsername | 아니요 | 클러스터가 생성된 이후에는 `MasterUsername`을 수정할 수 없습니다. 명명 제약 조건: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/db-cluster-parameters.html) | | MasterUserPassword | 예 | 제약 조건: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/db-cluster-parameters.html) | | Port | 예 | 포트 번호는 클러스터의 모든 인스턴스에 적용됩니다. | | PreferredBackupWindow | 예 | | | PreferredMaintenanceWindow | 예 | | | StorageEncrypted | 아니요 | 클러스터를 암호화하도록 선택한 경우 암호를 해제할 수 없습니다. | | StorageType | 예 | DB 클러스터의 스토리지 유형: 표준(`standard`) 또는 I/O 최적화(`iopt1`). 기본값: `standard` 이 파라미터는 `CreateDBCluster` 및 `ModifyDBCluster` 항목을 사용하여 구성할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 클러스터 스토리지 구성](db-cluster-storage-configs.md) 단원을 참조하십시오. | | Tags | 예 | | | VpcSecurityGroupIds | 아니요 | 클러스터를 만든 후에는 클러스터가 상주하는 VPC를 수정할 수 없습니다. | # Amazon DocumentDB 클러스터 스토리지 구성 Amazon DocumentDB 5.0부터 인스턴스 기반 클러스터는 다음의 두 가지 스토리지 구성 유형을 지원합니다. + **Amazon DocumentDB 표준 스토리지**: I/O 소비가 낮거나 중간 수준인 고객을 위해 설계되었습니다. I/O 비용이 총 Amazon DocumentDB 클러스터의 25% 미만일 것으로 예상되는 경우 이러한 선택이 적합할 수 있습니다. Amazon DocumentDB 표준 스토리지 구성을 사용하면 인스턴스 및 스토리지 요금 외에도 요청당 지불 I/O 기준으로 요금이 청구됩니다. 즉, 사용량에 따라 주기별로 청구가 달라질 수 있습니다. 이 구성은 애플리케이션의 변화하는 I/O 수요에 맞게 조정됩니다. + **Amazon DocumentDB I/O 최적화 스토리지**: 가격 예측 가능성을 우선시하거나 I/O 집약적 애플리케이션을 사용하는 고객을 위해 설계되었습니다. I/O 최적화 구성은 I/O 집약적 워크로드를 사용하는 고객에게 향상된 성능, 향상된 처리량 및 감소된 지연 시간을 제공합니다. I/O 비용이 총 Amazon DocumentDB 클러스터 비용의 25%를 초과할 것으로 예상되는 경우 이 옵션은 향상된 가격 성능을 제공합니다. Amazon DocumentDB I/O 최적화 스토리지 구성을 사용하면 I/O 작업에 따른 요금이 부과되지 않으므로 각 결제 주기마다 비용을 예측 가능하도록 보장해 줍니다. 구성은 성능을 개선하면서 비용을 안정화합니다. 30일마다 한 번씩 기존 데이터베이스 클러스터를 Amazon DocumentDB I/O 최적화 스토리지로 전환할 수 있습니다. 언제든지 Amazon DocumentDB 표준 스토리지로 다시 전환할 수 있습니다. 스토리지 구성을 I/O 최적화로 수정하는 다음 날짜는 AWS Management Console 클러스터의 구성 페이지에서 AWS CLI 또는를 통해 `describe-db-clusters` 명령을 사용하여 추적할 수 있습니다. Amazon DocumentDB I/O 최적화 구성을 포함한 새 데이터베이스 클러스터를 생성하거나 [AWS Management Console](https://console.aws.amazon.com/docdb/)에서 몇 번의 클릭, [AWS Command Line Interface (AWS CLI)](https://aws.amazon.com/cli/)에서 단일 파라미터 변경 또는 [AWS SDK](https://aws.amazon.com/developer/tools/)를 통해 기존 데이터베이스 클러스터를 변환할 수 있습니다. 스토리지 구성을 수정하는 동안 또는 수정한 후에 필요한 인스턴스의 가동 중지 시간이나 재부팅은 없습니다. ![\[이미지: Amazon DocumentDB 표준과 최적화된 스토리지의 차이점을 설명하는 표입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/io-diagram-1.png) ## I/O 최적화 클러스터 생성 ------ #### [ Using the AWS Management Console ] AWS Management Console을 사용하여 I/O 최적화 클러스터를 생성하거나 수정합니다. 1. Amazon DocumentDB 관리 콘솔의 **클러스터** 에서 클러스터 **생성** 또는 선택을 선택하고 **작업**을 선택한 다음 **수정**을 선택합니다. 1. 새 클러스터를 생성하는 경우 **클러스터 유형** 섹션에서 **인스턴스 기반 클러스터**를 선택해야 합니다(기본 옵션). ![\[이미지: 클러스터 유형 옵션의 콘솔 화면 캡처입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/create-cluster/cc-type.png) 1. **구성** 섹션의 **클러스터 스토리지 구성**에서 **Amazon DocumentDB I/O 최적화**를 선택합니다. ![\[이미지: 클러스터 스토리지 구성 옵션의 콘솔 화면 캡처입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/storage-config-1.png) 1. 클러스터 생성 또는 수정을 완료하고 **클러스터 생성** 또는 **클러스터 수정**을 선택합니다. 전체 클러스터 생성 프로세스는 [를 사용하여 클러스터 및 기본 인스턴스 생성 AWS Management Console](db-cluster-create.md#db-cluster-create-con) 항목을 참조하세요. 전체 클러스터 수정 프로세스는 [Amazon DocumentDB 클러스터 수정](db-cluster-modify.md) 항목을 참조하세요. ------ #### [ Using the AWS CLI ] AWS CLI를 사용하여 I/O 최적화 클러스터를 생성합니다. 다음 예에서는 자신의 정보로 각각의 *사용자 입력 자리 표시자*를 바꿉니다. Linux, macOS, Unix의 경우: ``` aws docdb create-db-cluster \ --db-cluster-identifier sample-cluster \ --engine docdb \ --engine-version 5.0.0 \ --storage-type iopt1 \ --deletion-protection \ --master-username username \ --master-user-password password ``` Windows의 경우: ``` aws docdb create-db-cluster ^ --db-cluster-identifier sample-cluster ^ --engine docdb ^ --engine-version 5.0.0 ^ --storage-type iopt1 ^ --deletion-protection ^ --master-username username ^ --master-user-password password ``` ------ ## 스토리지 구성을 결정하기 위한 비용 분석 Amazon DocumentDB를 사용하면 보유한 모든 데이터베이스 클러스터에 대한 스토리지 구성을 유연하게 선택할 수 있습니다. 표준 및 I/O 최적화 간에 클러스터를 올바르게 할당하기 위해 Amazon DocumentDB 비용을 클러스터별로 추적할 수 있습니다. 이렇게 하려면 기존 클러스터에 태그를 추가하고, [AWS 결제 및 비용 관리 대시보드](https://aws.amazon.com/pricing/)에서 비용 할당 태그 지정을 활성화하고, [AWS Cost Explorer Service](https://aws.amazon.com/aws-cost-management/aws-cost-explorer/)에서 지정된 클러스터에 대한 비용을 분석할 수 있습니다. 비용 분석에 대한 자세한 내용은 블로그 [비용 할당 태그 사용](https://aws.amazon.com/blogs/database/using-cost-allocation-tags-with-amazon-documentdb-with-mongodb-compatibility/)을 참조하세요. # 클러스터 상태 확인 AWS Management Console 또는를 사용하여 클러스터의 상태를 확인할 수 있습니다 AWS CLI. ------ #### [ Using the AWS Management Console ] 다음 절차에 따라를 사용하여 Amazon DocumentDB 클러스터의 상태를 확인합니다. AWS Management Console 1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다. 1. 탐색 창에서 **클러스터**를 선택합니다. 1. **클러스터 식별자** 열에서 원하는 클러스터의 이름을 찾습니다. 그런 다음 클러스터의 상태를 찾으려면 아래와 같이 **상태** 열에 대한 해당 행을 읽습니다. ![\[활성 상태를 보여주는 sample-cluster가 있는 클러스터 페이지의 스크린샷\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/db-cluster-status-con.png) ------ #### [ Using the AWS CLI ] `describe-db-clusters` 작업에 따라 AWS CLI를 사용하여 Amazon DocumentDB 클러스터의 상태를 확인합니다. 다음 코드는 `sample-cluster` 클러스터의 상태를 찾습니다. Linux, macOS 또는 Unix의 경우: ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterIdentifier,Status]' ``` Windows의 경우: ``` aws docdb describe-db-clusters ^ --db-cluster-identifier sample-cluster ^ --query 'DBClusters[*].[DBClusterIdentifier,Status]' ``` 이 작업의 출력은 다음과 같습니다(JSON 형식). ``` [ [ "sample-cluster", "available" ] ] ``` ------ # Amazon DocumentDB 클러스터 수명 주기 Amazon DocumentDB 클러스터의 수명 주기는 클러스터 생성, 설명, 수정, 삭제로 구성되어 있습니다. 이 섹션에서는 이러한 프로세스를 완료하는 방법에 관해 설명합니다. **Topics** + [클러스터 생성](db-cluster-create.md) + [클러스터 설명](db-cluster-view-details.md) + [클러스터 수정](db-cluster-modify.md) + [대기 중인 유지 관리 확인](db-cluster-determine-pending-maintenance.md) + [클러스터 엔진 버전 패치 업데이트](db-cluster-version-upgrade.md) + [클러스터 중지 및 시작](db-cluster-stop-start.md) + [클러스터 삭제](db-cluster-delete.md) # Amazon DocumentDB 클러스터 생성 Amazon DocumentDB 클러스터는 인스턴스와 해당 클러스터의 데이터를 나타내는 클러스터 볼륨으로 구성됩니다. 클러스터 볼륨은 3개의 가용 영역에서 단일 가상 볼륨으로 6개의 방법으로 복제됩니다. 클러스터에는 기본 인스턴스와 옵션으로 최대 15개의 복제 인스턴스가 포함됩니다. 다음 섹션에서는 AWS Management Console 또는를 사용하여 Amazon DocumentDB 클러스터를 생성하는 방법을 보여줍니다 AWS CLI. 그런 다음 해당 클러스터에 대한 복제 인스턴스를 추가할 수 있습니다. 콘솔을 사용하여 Amazon DocumentDB 클러스터를 생성하면 기본 인스턴스가 자동으로 동시에 생성됩니다. AWS CLI 를 사용하여 Amazon DocumentDB 클러스터를 생성하는 경우 클러스터의 상태를 *사용할 수* 있게 되면 해당 클러스터의 기본 인스턴스를 생성해야 합니다. ## 사전 조건 다음은 Amazon DocumentDB 클러스터를 생성할 때 필요한 사전 조건입니다. 이 없는 경우 다음 단계를 AWS 계정완료하여 생성합니다. **에 가입하려면 AWS 계정** 1. [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup)을 엽니다. 1. 온라인 지시 사항을 따르세요. 등록 절차 중 전화 또는 텍스트 메시지를 받고 전화 키패드로 확인 코드를 입력하는 과정이 있습니다. 에 가입하면 AWS 계정*AWS 계정 루트 사용자*이 생성됩니다. 루트 사용자에게는 계정의 모든 AWS 서비스 및 리소스에 액세스할 권한이 있습니다. 보안 모범 사례는 사용자에게 관리 액세스 권한을 할당하고, 루트 사용자만 사용하여 [루트 사용자 액세스 권한이 필요한 작업](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks)을 수행하는 것입니다. ### VPC 사전 조건 Amazon DocumentDB 클러스터는 Amazon Virtual Private Cloud(Amazon VPC)에서만 생성할 수 있습니다. Amazon DocumentDB 클러스터에서 Amazon VPC를 사용하려면 2개 이상의 가용 영역마다 VPC에 서브넷이 1개 이상 있어야 합니다. 가용 영역에 클러스터 인스턴스를 배포하면 어쩌다가 가용 영역에 장애가 발생해도 클러스터에서 인스턴스를 사용할 수 있습니다. ### 서브넷 사전 조건 Amazon DocumentDB 클러스터를 생성하는 경우 VPC와 VPC 내 해당 서브넷 그룹을 선택해야 클러스터를 시작할 수 있습니다. 서브넷은 인스턴스를 시작하기 위해 사용할 가용 영역과 해당 가용 영역 내 IP 범위를 결정합니다. 설명을 위해 *서브넷*과 *가용 영역*이라는 용어가 혼용됩니다. 서브넷 그룹은 이름이 지정된 서브넷의 집합(또는 가용 영역)입니다. 서브넷 그룹을 통해 Amazon DocumentDB 인스턴스를 시작하는 데 사용할 가용 영역을 지정할 수 있습니다. 예를 들어, 인스턴스가 3개인 클러스터에서 고가용성을 위해 각 인스턴스를 별도의 가용 영역에 프로비저닝하는 것이 좋습니다. 이렇게 하면 가용 영역 하나가 작동이 안 되는 경우 인스턴스 하나만 영향을 받게 됩니다. Amazon DocumentDB 인스턴스는 현재 최대 3개의 가용 영역에 프로비저닝할 수 있습니다. 서브넷 그룹에 서브넷이 3개 이상 있는 경우에도 Amazon DocumentDB 클러스터 생성에는 그 중 3개만 사용할 수 있습니다. 따라서 서브넷 그룹을 생성할 때 인스턴스 배포에 사용하려는 서브넷을 3개만 선택하는 것이 좋습니다. 미국 동부(버지니아 북부)에서 서브넷 그룹에는 6개의 서브넷(또는 가용 영역)이 있을 수 있습니다. 그러나 Amazon DocumentDB 클러스터가 프로비저닝되면 Amazon DocumentDB에서는 가용 영역 중 3개를 선택하여 인스턴스 프로비저닝에 사용합니다. 예를 들어, 클러스터를 생성할 때 Amazon DocumentDB에서 가용 영역\$11A, 1B 및 1C\$1를 선택한다고 가정하겠습니다. 가용 영역\$11D\$1에 인스턴스를 생성하려고 하면 API 직접 호출이 실패합니다. 하지만 특정 가용 영역을 지정하지 않고 인스턴스를 생성하기로 선택하면 Amazon DocumentDB가 사용자를 대신하여 가용 영역을 선택합니다. Amazon DocumentDB는 알고리즘을 사용하여 가용 영역 전체에 걸쳐 인스턴스의 부하를 분산하므로 고가용성을 확보할 수 있습니다. 예를 들어, 인스턴스 3개가 프로비저닝되면 이러한 인스턴스가 기본적으로 가용 영역 1개에 모두 프로비저닝되지 않고 가용 영역 3개에 프로비저닝됩니다. **권장 사항:** + 특별한 사유가 없으면 항상 서브넷 그룹 서브넷을 3개 생성합니다. 이렇게 하면 인스턴스가 3개 이상인 클러스터의 경우 인스턴스가 가용 영역 3개에 프로비저닝되므로 더 높은 가용성을 달성할 수 있습니다. + 고가용성을 달성하려면 항상 여러 가용 영역에 인스턴스를 분산시킵니다. 가용 영역 1개에 클러스터의 모든 인스턴스를 배치하지 마세요. + 장애 조치 이벤트는 언제든지 발생할 수 있으므로 기본 인스턴스나 복제본 인스턴스가 항상 특정 가용 영역에 있다고 가정해서는 안 됩니다. ### 추가 사전 조건 다음은 Amazon DocumentDB 클러스터를 생성할 때 필요한 기타 사전 요구 사항입니다. + AWS Identity and Access Management (IAM) 자격 증명을 AWS 사용하여에 연결하는 경우 IAM 계정에 Amazon DocumentDB 작업을 수행하는 데 필요한 권한을 부여하는 IAM 정책이 있어야 합니다. IAM 계정을 사용하여 Amazon DocumentDB 콘솔에 액세스하는 경우 먼저 IAM 계정으로 AWS Management Console 에 로그인해야 합니다. [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb)에서 Amazon DocumentDB 콘솔로 이동합니다. + 클러스터의 구성 파라미터를 사용자 지정하려면 클러스터 파라미터 그룹과 파라미터 그룹을 필요한 파라미터 설정으로 지정해야 합니다. 클러스터 파라미터 그룹 또는 파라미터 그룹의 생성 또는 수정에 대한 자세한 내용은 [Amazon DocumentDB 클러스터 파라미터 그룹 관리](cluster_parameter_groups.md) 섹션을 참조하세요. + 클러스터에 지정할 TCP/IP 포트 번호를 결정해야 합니다. 일부 기업에서는 방화벽이 Amazon DocumentDB에 대한 기본 포트 연결을 차단하는 경우도 있습니다. 이처럼 기업 방화벽이 기본 포트를 차단할 경우 클러스터에 다른 포트를 선택해야 합니다. 클러스터의 인스턴스는 모두 동일한 포트를 사용합니다. ## 를 사용하여 클러스터 및 기본 인스턴스 생성 AWS Management Console 다음 절차에서는 콘솔을 사용하여 인스턴스가 1개 이상인 Amazon DocumentDB 클러스터를 시작하는 방법을 설명합니다. ### 클러스터 생성: 기본 설정 사용 **를 사용하여 기본 설정을 사용하여 인스턴스가 있는 클러스터를 생성하려면 AWS Management Console** 1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다. 1. 미국 동부(버지니아 북부) 리전 AWS 리전 이외의에서 클러스터를 생성하려면 콘솔의 오른쪽 상단 섹션에 있는 목록에서 리전을 선택합니다. 1. 탐색 창에서 **클러스터**를 선택한 다음 **생성**을 선택합니다. **작은 정보** 화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-menu-icon.png))을 선택합니다. 1. **Amazon DocumentDB 클러스터 생성 페이지**에서 **구성** 창을 작성합니다. 1. **클러스터 식별자** - Amazon DocumentDB 제공 이름을 수락하거나 **sample-cluster**와 같은 클러스터 이름을 입력합니다. 클러스터 명명 제약 조건: + 길이는 [1-63]개의 글자, 숫자 또는 하이픈입니다. + 첫 번째 문자는 글자이어야 합니다. + 하이픈으로 끝나거나 하이픈이 2개 연속으로 포함되어서는 안 됩니다. + 리전별로 Amazon RDS, Neptune 및 Amazon DocumentDB의 모든 클러스터 AWS 계정에 대해 고유해야 합니다. 1. **엔진 버전** - 기본 엔진 버전인 5.0.0을 수락하거나 선택적으로 8.0.0, 4.0.0 또는 3.6.0을 선택합니다. 1. **인스턴스 클래스** - 기본값 `db.r5.large`를 수락하거나 목록에서 원하는 인스턴스 클래스를 선택합니다. 1. **인스턴스 수** - 목록에서 이 클러스터로 생성하려는 인스턴스 수를 선택합니다. 첫 번째 인스턴스는 기본 인스턴스이며, 그 외 다른 모든 인스턴스는 읽기 전용 복제본 인스턴스입니다. 나중에 필요하면 인스턴트를 추가하거나 삭제할 수 있습니다. 기본적으로 Amazon DocumentDB 클러스터는 세 개의 인스턴트를 시작합니다(기본 한 개, 복제본 두 개). 1. **클러스터 스토리지 구성** 섹션을 완료합니다. **Amazon DocumentDB Standard**(기본값) 또는 **Amazon DocumentDB I/O 최적화**를 선택합니다. 자세한 내용은 [Amazon DocumentDB 클러스터 스토리지 구성](db-cluster-storage-configs.md) 단원을 참조하십시오. 1. **인증** 창을 작성합니다. 1. **사용자 이름** - 기본 사용자의 이름을 입력합니다. 클러스터에 로그인하려면 기본 사용자 이름을 사용해야 합니다. 기본 사용자 이름 지정 시 제약 조건: + 길이는 [1-63]자의 영숫자 문자입니다. + 첫 번째 문자는 글자이어야 합니다. + 데이터베이스 엔진에 포함된 단어는 사용할 수 없습니다. 1. 다음 암호 옵션 중 하나를 선택합니다. + **관리형 AWS Secrets Manager**- 기본 사용자 암호를 자동으로 관리 AWS Secrets Manager 하려면이 옵션을 선택합니다. 이 옵션을 선택하는 경우 자체 키를 생성하거나 Secrets Manager가 생성하는 키를 사용하여 KMS 키를 구성합니다. + **자체 관리** - 기본 사용자 암호를 자체 관리하려면 이 옵션을 선택합니다. 이 옵션을 선택하는 경우 기본 사용자의 암호를 입력한 다음 확인합니다. 클러스터에 로그인하려면 기본 사용자의 암호를 사용해야 합니다. 암호 제약: + 길이는 [8-100]자의 인쇄 가능한 ASCII 문자입니다. + 다음을 제외한 인쇄 가능한 ASCII 문자를 사용할 수 있습니다. + **/**(슬래시) + **"**(큰 따옴표) + **@**(at 기호) 1. 화면 하단에서 다음 중 하나를 선택합니다. + 지금 클러스터를 생성하려면 **클러스터 생성**을 선택합니다. + 클러스터를 생성하지 않으려면 않으려면 **취소**를 선택합니다. + 생성 전 클러스터를 추가로 구성하려면 **추가 구성 표시**를 선택한 후 [클러스터 생성: 추가 구성](#db-cluster-create-con-additional-configs)에서 계속 진행합니다. **추가 구성** 섹션에 포함된 구성은 다음과 같습니다. + **네트워크 설정** - 기본값은 `default` VPC 보안 그룹의 사용입니다. + **클러스터 옵션** - 기본값은 포트 27017과 기본 파라미터 그룹을 사용하는 것입니다. + **암호화** - 기본값은 `(default) aws/rds` 키를 사용한 암호화 활성화입니다. **중요** 클러스터가 암호화되면 암호화를 해제할 수 없습니다. + **백업** - 기본값은 백업을 1일 동안 유지하며 Amazon DocumentDB에서 백업 기간을 선택하는 것입니다. + **로그 내보내기** - 기본값은 감사 로그를 CloudWatch 로그로 내보내지 않는 것입니다. + **유지 관리** - 기본값은 Amazon DocumentDB에서 유지 관리 기간을 선택하는 것입니다. + **삭제 방지** - 실수로 인한 삭제로부터 클러스터를 보호합니다. 콘솔을 사용해 생성된 클러스터의 기본값이 *활성화*됩니다. 지금 기본 설정을 수락해도 나중에 클러스터를 수정하여 대부분을 변경할 수 있습니다. 1. 클러스터의 보안 그룹에 대해 인바운드 연결을 활성화합니다. 클러스터의 기본 설정을 변경하지 않은 경우, 특정 리전의 기본 VPC에 대해 기본 보안 그룹을 사용하는 클러스터를 생성합니다. Amazon DocumentDB에 연결하려면 클러스터의 보안 그룹에 대해 포트 27017(또는 사용자가 선택한 포트)에서 인바운드 연결을 활성화해야 합니다. **클러스터의 보안 그룹에 대해 인바운드 연결을 추가하려면** 1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) Amazon EC2 콘솔을 엽니다. 1. 기본 창의 **리소스** 섹션에서 **보안 그룹**을 선택합니다. ![\[이미지: 보안 그룹 링크 옵션을 강조 표시하는 리소스 목록입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-ec2-security-groups.png) 1. 보안 그룹 목록에서 클러스터 생성 시 사용한 보안 그룹을 찾고(*기본값* 보안 그룹일 확률이 높음) 보안 그룹 이름 왼쪽의 상자를 선택합니다. ![\[이미지: 상자가 선택된 하나의 보안 그룹을 강조 표시하는 보안 그룹 목록입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-ec2-default-sg.png) 1. **작업** 메뉴에서 **인바운드 규칙 편집**을 선택한 다음 규칙 제약을 선택 또는 입력합니다. 1. **유형** - 목록에서 네트워크 트래픽에 개방할 프로토콜을 선택합니다. 1. **프로토콜** - 목록에서 프로토콜 유형을 선택합니다. 1. **포트 범위** - 사용자 지정 규칙에 대해 포트 번호나 포트 범위를 입력합니다. 포트 번호 또는 범위에는 클러스터를 생성할 때 지정한 포트가 포함됩니다(기본값: 27017). 1. **소스** - 인스턴스에 도달 가능한 트래픽을 지정합니다. 목록에서 트래픽 소스를 선택합니다. **사용자 지정**을 선택하는 경우, 단일 IP 주소나 IP 주소 범위를 CIDR 표기법으로 지정합니다(예: 203.0.113.5/32). 1. **설명** - 이 규칙에 대한 설명을 입력합니다. 1. 규칙 만들기가 끝나면 **저장**을 선택합니다. ### 클러스터 생성: 추가 구성 클러스터에 대한 기본 설정을 수락하면 다음 단계를 건너뛰고 **클러스터 생성**을 선택할 수 있습니다. 1. **네트워크 설정** 창을 작성합니다. ![\[네트워크 설정 창 및 네트워크 설정 구성 단계를 보여주는 스크린샷\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/create-db-cluster-console-network-settings.png) 1. **가상 프라이빗 클라우드(VPC)** - 목록에서 이 클러스터를 시작할 Amazon VPC를 선택합니다. 1. **서브넷 그룹** - 목록에서 이 클러스터에 사용할 서브넷 그룹을 선택합니다. 1. **VPC 보안 그룹** - 목록에서 이 클러스터에 사용할 VPC 보안 그룹을 선택합니다. 1. **클러스터 옵션** 창을 작성합니다. ![\[클러스터 설정을 구성하는 단계가 포함된 클러스터 옵션 창을 보여주는 스크린샷\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/create-db-cluster-console-cluster-options.png) 1. **데이터베이스 포트** - 위, 아래 화살표를 사용해 애플리케이션과 인스턴스 연결에 사용할 TCP/IP 포트를 설정합니다. 1. **클러스터 파라미터 그룹** - 파라미터 그룹 목록에서 이 클러스터에 사용할 클러스터 파라미터 그룹을 선택합니다. 1. **암호화** 창을 작성합니다. ![\[클러스터에 대한 암호화를 구성하는 단계를 보여주는 암호화 창의 스크린샷\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/encrypt-at-rest.png) 1. **유휴 암호화** - 다음 중 하나를 선택합니다. + **암호화 활성** - 기본 설정입니다. 모든 저장 데이터는 암호화됩니다. 데이터 암호화를 선택하면 해당 작업을 실행 취소할 수 없습니다. + **암호화 비활성** - 데이터가 암호화되지 않습니다. 1. **AWS KMS 키** - 데이터를 암호화하는 경우에만 사용할 수 있습니다. 목록에서 이 클러스터에 있는 데이터 암호화에 사용할 키를 선택합니다. 기본값은 `(default) aws/rds`입니다. **키 ARN 입력**을 선택하면 해당 키의 Amazon 리소스 이름(ARN)을 입력해야 합니다. 1. **백업** 창을 작성합니다. ![\[클러스터 백업 기간을 구성하는 단계를 보여주는 백업 창의 스크린샷\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/create-db-cluster-console-backup.png) 1. **백업 보존 기간** - 목록에서 이 클러스터의 자동 백업을 삭제하지 않고 유지하는 일 수를 선택합니다. 1. **백업 기간** - Amazon DocumentDB에서 이 클러스터를 백업하는 일별 시간과 기간을 설정합니다. 1. **시작 시간** - 첫 번째 목록에서 자동 백업 시작 시간(UTC)을 선택합니다. 두 번째 목록에서 자동 백업 시작 시간의 분을 선택합니다. 1. **기간** - 목록에서 자동 백업 생성에 할당된 시간 수를 선택합니다. 1. CloudWatch Logs로 내보내려는 로그 유형을 선택하여 **로그 내보내기** 창을 완성하세요. ![\[클러스터의 DML 로깅을 구성하는 단계를 보여주는 로그 내보내기 창의 스크린샷\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/create-db-cluster-console-log-exports.png) + **감사 로그** - Amazon CloudWatch Logs에 감사 로그 내보내기를 활성화하려면 이 옵션을 선택합니다. **감사 로그**를 선택하는 경우 클러스터의 사용자 지정 파라미터 그룹에서 `audit_logs`를 활성화해야 합니다. 자세한 내용은 [Amazon DocumentDB 이벤트 감사](event-auditing.md) 섹션을 참조하십시오. + **프로파일러 로그** - 작업 프로파일러 로그를 Amazon CloudWatch Logs로 내보내려면 이 옵션을 선택합니다. **프로파일러 로그**를 선택하는 경우 클러스터의 사용자 지정 파라미터 그룹에서 다음 파라미터도 수정해야 합니다. + `profiler` - `enabled`로 설정합니다. + `profiler_threshold_ms` - 작업 프로파일링에 대한 임계값을 설정하려면 값 `[0-INT_MAX]`로 설정합니다. + `profiler_sampling_rate` - 프로파일링할 느린 작업 비율을 설정하려면 값 `[0.0-1.0]`으로 설정합니다. 자세한 내용은 [Amazon DocumentDB 작업 프로파일링](profiling.md) 섹션을 참조하십시오. 1. **유지 관리** 창을 작성합니다. ![\[클러스터의 유지 관리 기간을 구성하는 단계를 보여주는 유지 관리 창의 스크린샷\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/create-db-cluster-console-maintenance.png) 1. 다음 중 하나를 선택합니다. + **선택 창** - 클러스터에 대한 유지 관리를 수행할 Amazon DocumentDB에 대한 요일, UTC 시작 시간 및 기간을 지정할 수 있습니다. 1. **시작일** - 목록에서 클러스터 유지 관리를 시작할 요일을 선택합니다. 1. **시작 시간** - 목록에서 유지 관리를 시작할 시간과 분(UTC)을 선택합니다. 1. **기간** - 목록에서 클러스터 유지 관리에 할당할 시간의 양을 선택합니다. 유지 관리 작업을 특정 시간에 끝내지 못하면 특정 시간이 지나도 완료될 때까지 유지 관리 프로세스가 계속 진행됩니다. + **기본 설정 없음** - Amazon DocumentDB에서 유지 관리를 수행할 요일, 시작 시간 및 기간을 선택합니다. 1. 이 클러스터에 하나 이상의 태그를 추가하려면 **태그** 창을 작성합니다. ![\[선택한 삭제 방지 활성화 확인란의 스크린샷.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/create-db-cluster-console-tags.png) 클러스터에 추가하려는 각 태그에 대해 다음 단계를 반복합니다. 클러스터 하나에 최대 10개까지 추가할 수 있습니다. 1. **태그 추가**를 선택합니다. 1. 태그의 **키**를 입력합니다. 1. 선택적으로 태그의 **값**을 입력합니다. 태그를 제거하려면 **태그 제거**를 선택합니다. 1. 콘솔을 사용하여 클러스터를 생성할 때 기본적으로 **삭제 방지**가 활성화됩니다. 삭제 방지를 비활성화하려면 **삭제 방지 활성화**를 선택 취소합니다. 삭제 방지를 활성화하면 클러스터가 삭제되지 않도록 방지합니다. 삭제 방지된 클러스터를 삭제하려면 먼저 클러스터를 수정하여 삭제 방지를 비활성화해야 합니다. ![\[선택한 삭제 방지 활성화 확인란의 스크린샷.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/create-db-cluster-console-deletion-protection.png) 삭제 방지에 대한 자세한 내용은 [Amazon DocumentDB 클러스터 삭제](db-cluster-delete.md) 섹션을 참조하세요. 1. 클러스터를 생성하려면 **클러스터 생성**을 선택합니다. 그렇지 않은 경우 **취소**를 선택합니다. ## 를 사용하여 클러스터 생성 AWS CLI 다음 절차에서는를 사용하여 Amazon DocumentDB 클러스터를 AWS CLI 시작하고 Amazon DocumentDB 복제본을 생성하는 방법을 설명합니다. **파라미터** + **--db-cluster-identifier** - 필수입니다. 이 클러스터를 식별하는 소문자 문자열입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/db-cluster-create.html) + **--engine** - 필수입니다. **docdb**여야 합니다. + **--deletion-protection \$1 --no-deletion-protection** - 선택 사항. 삭제 방지를 활성화하면 클러스터가 삭제되지 않도록 방지합니다. 를 사용할 때 기본 설정은 삭제 방지 AWS CLI기능을 비활성화하는 것입니다. 삭제 방지에 대한 자세한 내용은 [Amazon DocumentDB 클러스터 삭제](db-cluster-delete.md) 섹션을 참조하세요. + **--storage-type standard \$1 iopt1** - 선택 사항. 기본값: **standard**. 클러스터 스토리지 구성입니다. 유효한 값은 `standard` (표준) 또는 `iopt1` (I/O 최적화)입니다. + **--master-username** - 필수입니다. 사용자 인증에 사용되는 사용자 이름입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/db-cluster-create.html) + **--master-user-password** - 선택 사항. 사용자 인증에 사용되는 사용자 암호입니다. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/db-cluster-create.html) + **--manage-master-user-password** - 선택 사항. Amazon DocumentDB가 Secrets Manager에서 마스터 사용자 암호를 생성하고 해당 수명 주기 동안 이를 관리합니다. 추가 파라미터는 [CreateDBCluster](API_CreateDBCluster.md) 섹션을 참조하세요. **를 사용하여 Amazon DocumentDB 클러스터를 시작하려면 AWS CLI** Amazon DocumentDB 클러스터를 생성하려면를 호출합니다`create-db-cluster` AWS CLI. 다음 AWS CLI 명령은 삭제 방지가 활성화된 라는 Amazon DocumentDB 클러스터`sample-cluster`를 생성합니다. 삭제 방지에 대한 자세한 내용은 [Amazon DocumentDB 클러스터 삭제](db-cluster-delete.md)을(를) 참조하세요. 또한 `--engine-version`은 기본적으로 최신 주요 엔진 버전으로 설정되는 선택적 매개변수입니다. 현재 기본 엔진 버전은 5.0.0입니다(참고: Amazon DocumentDB 8.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 \ --db-cluster-identifier sample-cluster \ --engine docdb \ --engine-version 5.0.0 \ --deletion-protection \ --master-username masteruser \ --master-user-password password ``` Windows의 경우: ``` aws docdb create-db-cluster ^ --db-cluster-identifier sample-cluster ^ --engine docdb ^ --engine-version 5.0.0 ^ --deletion-protection ^ --master-username masteruser ^ --master-user-password password ``` 이 작업의 출력은 다음과 같습니다(JSON 형식). ``` { "DBCluster": { "StorageEncrypted": false, "DBClusterMembers": [], "Engine": "docdb", "DeletionProtection" : "enabled", "ClusterCreateTime": "2018-11-26T17:15:19.885Z", "DBSubnetGroup": "default", "EngineVersion": "5.0.0", "MasterUsername": "masteruser", "BackupRetentionPeriod": 1, "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "DBClusterIdentifier": "sample-cluster", "MultiAZ": false, "DBClusterParameterGroup": "default.docdb5.0", "PreferredBackupWindow": "09:12-09:42", "DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY", "PreferredMaintenanceWindow": "tue:04:17-tue:04:47", "Port": 27017, "Status": "creating", "ReaderEndpoint": "sample-cluster.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": "sample-cluster.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 인스턴스 추가](db-instance-add.md) 단원을 참조하십시오. 자세한 내용은 *Amazon DocumentDB API 참조*의 [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CreateDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_CreateDBCluster.html) 섹션을 참조하세요. # Amazon DocumentDB 클러스터에 대한 설명 Amazon DocumentDB Management Console 또는 AWS CLI 를 사용하여 Amazon DocumentDB 클러스터와 관련된 연결 엔드포인트, 보안 그룹, VPCs 및 파라미터 그룹과 같은 세부 정보를 볼 수 있습니다. 자세한 내용은 다음을 참조하세요. + [Amazon DocumentDB 클러스터 상태 모니터링](monitoring_docdb-cluster_status.md) + [클러스터 엔드포인트 찾기](db-cluster-endpoints-find.md) ------ #### [ 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. 탐색 창에서 **클러스터**를 선택합니다. **작은 정보** 화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-menu-icon.png))을 선택합니다. 1. 클러스터 목록에서 세부 정보를 보려는 클러스터의 이름을 선택합니다. 클러스터에 대한 정보는 다음과 같은 그룹으로 구성됩니다. + **요약** - 엔진 버전, 클러스터 상태, 보류 중인 유지 관리 및 파라미터 그룹의 상태를 포함하여 클러스터에 대한 일반 정보입니다. + **연결 및 보안** - **연결** 섹션에는 mongo 쉘 또는 애플리케이션을 사용하여 이 클러스터에 연결할 연결 엔드포인트가 나열됩니다. **보안 그룹** 섹션에는 이 클러스터와 연결된 보안 그룹과 해당 VPC ID 및 설명이 나열됩니다. + **구성** - **클러스터 세부 정보** 섹션에는 클러스터의 Amazon 리소스 이름(ARN), 엔드포인트 및 파라미터 그룹을 포함하여 클러스터에 대한 세부 정보가 나열됩니다. 또한 클러스터의 백업 정보, 유지 관리 세부 정보, 보안 및 네트워크 설정이 나열됩니다. **클러스터 인스턴스** 섹션에는 각 인스턴스의 역할 및 클러스터 파라미터 그룹 상태와 함께 이 클러스터에 속하는 인스턴스가 나열됩니다. + **모니터링** - 이 클러스터의 Amazon CloudWatch Logs 측정치. 자세한 내용은 [CloudWatch를 사용하여 Amazon DocumentDB 모니터링](cloud_watch.md) 섹션을 참조하십시오. + **이벤트 및 태그** - **최근 이벤트** 섹션에는 이 클러스터의 최근 이벤트가 나열됩니다. Amazon DocumentDB에서는 클러스터, 인스턴스, 스냅샷, 보안 그룹 및 클러스터 파라미터 그룹과 관련된 이벤트 레코드를 유지합니다. 이 정보에는 각 이벤트와 연결된 날짜, 시간 및 메시지가 포함됩니다. **태그** 섹션에는 이 클러스터에 연결된 태그가 나열됩니다. ------ #### [ Using the AWS CLI ] 를 사용하여 Amazon DocumentDB 클러스터의 세부 정보를 보려면 아래 예제와 같이 `describe-db-clusters` 명령을 AWS CLI사용합니다. 자세한 내용은 *Amazon DocumentDB 리소스 관리 API 참조*에서 [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusters.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_DescribeDBClusters.html) 섹션을 참조하세요. **참고** 클러스터 및 인스턴스 수명주기 관리와 같은 특정 관리 기능의 경우 Amazon DocumentDB는 Amazon RDS와 공유하는 운영 기술을 활용합니다. `filterName=engine,Values=docdb` 필터 파라미터는 Amazon DocumentDB 클러스터만 반환합니다. **Example** **예 1: 모든 Amazon DocumentDB 클러스터를 나열합니다.** 다음 AWS CLI 코드는 리전의 모든 Amazon DocumentDB 클러스터에 대한 세부 정보를 나열합니다. ``` aws docdb describe-db-clusters --filter Name=engine,Values=docdb ``` 이 작업의 출력은 다음과 같이 표시됩니다. ``` { "DBClusters": [ { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-1", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... }, { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-2", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... }, { "AvailabilityZones": [ "us-east-1c", "us-east-1b", "us-east-1a" ], "BackupRetentionPeriod": 1, "DBClusterIdentifier": "sample-cluster-3", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", ... } ] } ``` **Example** **예 2: 지정된 Amazon DocumentDB 클러스터에 대한 모든 세부 정보 나열** 다음 AWS CLI 코드는 클러스터에 대한 세부 정보를 나열합니다`sample-cluster`. Linux, macOS, Unix의 경우: ``` aws docdb describe-db-clusters \ --filter Name=engine,Values=docdb \ --db-cluster-identifier sample-cluster ``` Windows의 경우: ``` aws docdb describe-db-clusters ^ --filter Name=engine,Values=docdb ^ --db-cluster-identifier sample-cluster ``` 이 작업의 출력은 다음과 같이 표시됩니다. ``` { "DBClusters": [ { "AllocatedStorage": 1, "AvailabilityZones": [ "us-east-1c", "us-east-1a", "us-east-1d" ], "BackupRetentionPeriod": 2, "DBClusterIdentifier": "sample-cluster", "DBClusterParameterGroup": "sample-parameter-group", "DBSubnetGroup": "default", "Status": "available", "EarliestRestorableTime": "2023-11-07T22:34:08.148000+00:00", "Endpoint": "sample-cluster.node.us-east-1.amazon.com", "ReaderEndpoint": "sample-cluster.node.us-east-1.amazon.com", "MultiAZ": false, "Engine": "docdb", "EngineVersion": "5.0.0", "LatestRestorableTime": "2023-11-10T07:21:16.772000+00:00", "Port": 27017, "MasterUsername": "chimeraAdmin", "PreferredBackupWindow": "22:22-22:52", "PreferredMaintenanceWindow": "sun:03:01-sun:03:31", "ReadReplicaIdentifiers": [], "DBClusterMembers": [ { "DBInstanceIdentifier": "sample-instance-1", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, { "DBInstanceIdentifier": "sample-instance-2", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, ], "VpcSecurityGroups": [ { "VpcSecurityGroupId": "sg-9084c2ec", "Status": "active" } ], "HostedZoneId": "Z06853723JYKYBXTJ49RB", "StorageEncrypted": false, "DbClusterResourceId": "cluster-T4LGLANHVAPGQYYULWUDKLVQL4", "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "AssociatedRoles": [], "IAMDatabaseAuthenticationEnabled": false, "ClusterCreateTime": "2023-11-06T18:05:41.568000+00:00", "EngineMode": "provisioned", "DeletionProtection": false, "HttpEndpointEnabled": false, "CopyTagsToSnapshot": false, "CrossAccountClone": false, "DomainMemberships": [], "TagList": [], "StorageType": "iopt1", "AutoMinorVersionUpgrade": false, "NetworkType": "IPV4", "IOOptimizedNextAllowedModificationTime": "2023-12-07T18:05:41.580000+00:00" } ] } ``` **Example** **예 3: Amazon DocumentDB 클러스터에 대한 특정 세부 정보 나열** 를 사용하여 클러스터 세부 정보의 하위 집합을 나열하려면 `describe-db-clusters` 작업을 나열할 클러스터 멤버를 `--query` 지정하는를 AWS CLI추가합니다. `--db-cluster-identifier` 파라미터는 세부 정보를 표시할 특정 클러스터의 식별자입니다. 쿼리에 대한 자세한 내용은 *AWS Command Line Interface 사용 설명서*의 [`--query` 옵션을 사용하여 출력을 필터링하는 방법](https://docs.aws.amazon.com/cli/latest/userguide/cli-usage-output.html#controlling-output-filter)을 참조하세요. 다음 예제에서는 Amazon DocumentDB 클러스터의 인스턴스를 나열합니다. Linux, macOS, Unix의 경우: ``` aws docdb describe-db-clusters \ --filter Name=engine,Values=docdb \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterMembers]' ``` Windows의 경우: ``` aws docdb describe-db-clusters ^ --filter Name=engine,Values=docdb ^ --db-cluster-identifier sample-cluster ^ --query 'DBClusters[*].[DBClusterMembers]' ``` 이 작업의 출력은 다음과 같이 표시됩니다. ``` [ [ [ { "DBInstanceIdentifier": "sample-instance-1", "IsClusterWriter": true, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 }, { "DBInstanceIdentifier": "sample-instance-2", "IsClusterWriter": false, "DBClusterParameterGroupStatus": "in-sync", "PromotionTier": 1 } ] ] ] ``` ------ # Amazon DocumentDB 클러스터 수정 클러스터를 수정하려면 클러스터가 *사용 가능* 상태에 있어야 합니다. 중지된 클러스터는 수정할 수 없습니다. 클러스터가 중지된 경우, 먼저 클러스터를 시작하고 클러스터가 *사용 가능*하게 될 때까지 기다린 다음 원하는 대로 수정합니다. 자세한 내용은 [Amazon DocumentDB 클러스터 중지 및 시작](db-cluster-stop-start.md) 섹션을 참조하십시오. ------ #### [ Using the AWS Management Console ] 다음 절차에 따라 콘솔을 사용하여 특정 Amazon DocumentDB 클러스터를 수정합니다. **Amazon DocumentDB 클러스터를 수정하려면** 1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다. 1. 탐색 창에서 **클러스터**를 선택합니다. **작은 정보** 화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-menu-icon.png))을 선택합니다. 1. 클러스터 이름 왼쪽에 있는 버튼을 선택하여 수정할 클러스터를 지정합니다. 1. **작업**을 선택한 후 **수정**을 선택합니다. 1. **클러스터 수정: ** 창에서 원하는 항목을 변경합니다. 다음 영역에서 변경할 수 있습니다. + **클러스터 사양** - 클러스터의 이름, 보안 그룹 및 자격 증명 관리입니다. + **클러스터 스토리지 구성** - 클러스터의 데이터 스토리지 모드입니다. 표준 구성과 I/O 최적화 구성 중에서 선택합니다. + **클러스터 옵션** - 클러스터의 포트 및 파라미터 그룹. + **백업** - 클러스터의 백업 보존 기간 및 백업 기간. + **로그 내보내기** - 감사 또는 프로파일러 로그 내보내기 활성화 또는 비활성화. + **유지 관리** - 클러스터의 유지 관리 기간 설정. + **삭제 방지** - 클러스터에서 삭제 방지 활성화 또는 비활성화. 삭제 방지 기능은 기본적으로 활성화됩니다. 1. 작업을 마쳤으면 **계속**을 선택하여 변경 사항의 요약을 확인합니다. 1. 변경 사항이 만족스러우면 **클러스터 수정**을 선택하여 클러스터를 수정할 수 있습니다. 또는 **뒤로** 또는 **취소**를 선택하여 각각 변경 사항을 편집하거나 취소할 수 있습니다. 변경 사항을 적용하는 데 몇 분 정도 걸립니다. *사용 가능* 상태인 경우에만 클러스터를 사용할 수 있습니다. 콘솔 또는 AWS CLI를 사용하여 클러스터의 상태를 모니터링할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 클러스터 상태 모니터링](monitoring_docdb-cluster_status.md) 단원을 참조하십시오. ------ #### [ Using the AWS CLI ] `modify-db-cluster` 작업에 따라 AWS CLI를 사용하여 지정된 클러스터를 수정합니다. 자세한 내용은 *Amazon DocumentDB API 참조*의 [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ModifyDBCluster.html) 섹션을 참조하세요. **파라미터** + **--db-cluster-identifier** - 필수입니다. 수정하려는 Amazon DocumentDB 클러스터의 식별자입니다. + **--backup-retention-period** - 선택 사항. 자동 백업이 보존되는 일수입니다. 유효한 값은 1–35입니다. + **--storage-type** - 선택 사항. 클러스터 스토리지 구성입니다. 유효한 값은 `standard` (표준) 또는 `iopt1` (I/O 최적화)입니다. + **--db-cluster-parameter-group-name** - 선택 사항. 클러스터에 사용할 클러스터 파라미터 그룹의 이름입니다. + **--manage-master-user-password** - 선택 사항. Amazon DocumentDB가 Secrets Manager에서 마스터 사용자 암호를 생성하고 해당 수명 주기 동안 이를 관리합니다. + **--rotate-master-user-password** - 선택 사항. Secrets Manager는 기존 보안 암호에 대한 새 보안 암호 버전을 생성합니다. 새 버전의 보안 암호에는 새 기본 사용자 암호가 포함됩니다. Amazon RDSAurora는 새 보안 암호 버전의 암호와 일치하도록 클러스터의 기본 사용자 암호를 변경합니다. 기본 암호를 교체할 때 **--apply-immediately** 옵션을 지정해야 합니다. + **--master-user-password** - 선택 사항. 기본 데이터베이스 사용자의 새 암호입니다. 암호 제약: + 길이는 [8-100]자의 인쇄 가능한 ASCII 문자입니다. + 다음을 제외한 인쇄 가능한 ASCII 문자를 사용할 수 있습니다. + **/**(슬래시) + **"**(큰 따옴표) + **@**(at 기호) + **--new-db-cluster-identifier** - 선택 사항. 클러스터의 이름을 변경할 때 클러스터의 새 클러스터 식별자입니다. 이 값은 소문자 문자열로 저장됩니다. 명명 제약 조건: + 길이는 [1\$163] 글자, 숫자 또는 하이픈입니다. + 첫 번째 문자는 글자이어야 합니다. + 하이픈으로 끝나거나 하이픈이 2개 연속으로 포함되어서는 안 됩니다. + 리전별로 Amazon RDS, Amazon Neptune 및 Amazon DocumentDB의 모든 클러스터 AWS 계정에 대해 고유해야 합니다. + **--preferred-backup-window** - 선택 사항. 자동 백업이 생성되는 일별 시간 범위를 UTC(협정 세계시)로 표시합니다. + 형식: `hh24:mm-hh24:mm` + **--preferred-maintenance-window** - 선택 사항. 시스템 유지 관리를 실행할 수 있는 주 단위 시간 범위(UTC)입니다. + 형식: `ddd:hh24:mm-ddd:hh24:mm` + 유효한 요일: `Sun`, `Mon`, `Tue`, `Wed`, `Thu`, `Fri`, `Sat` + **--deletion-protection** 또는 **--no-deletion-protection** - 선택 사항. 이 클러스터에서 삭제 방지를 활성화해야 하는지 여부. 삭제 방지는 삭제 방지를 비활성화하도록 클러스터를 수정할 때까지 실수로 클러스터가 삭제되는 것을 방지합니다. 자세한 내용은 [Amazon DocumentDB 클러스터 삭제](db-cluster-delete.md) 섹션을 참조하십시오. + **--apply-immediately** 또는 **--no-apply-immediately** - `--apply-immediately`를 사용하여 즉시 변경합니다. `--no-apply-immediately`를 사용하여 클러스터의 다음 유지 관리 기간에 변경합니다. **Example** 다음 코드는 클러스터 `sample-cluster`에 대한 백업 보존 기간을 변경합니다. Linux, macOS, Unix의 경우: ``` aws docdb modify-db-cluster \ --db-cluster-identifier sample-cluster \ --apply-immediately \ --backup-retention-period 7 ``` Windows의 경우: ``` aws docdb modify-db-cluster ^ --db-cluster-identifier sample-cluster ^ --apply-immediately ^ --backup-retention-period 7 ``` 이 작업의 출력은 다음과 같이 표시됩니다. ``` { "DBCluster": { "BackupRetentionPeriod": 7, "DbClusterResourceId": "cluster-VDP53QEWST7YHM36TTXOPJT5YE", "Status": "available", "DBClusterMembers": [ { "PromotionTier": 1, "DBClusterParameterGroupStatus": "in-sync", "DBInstanceIdentifier": "sample-cluster-instance", "IsClusterWriter": true } ], "ReadReplicaIdentifiers": [], "AvailabilityZones": [ "us-east-1b", "us-east-1c", "us-east-1a" ], "ReaderEndpoint": "sample-cluster.cluster-ro-ctevjxdlur57.us-east-1.rds.amazonaws.com", "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "PreferredMaintenanceWindow": "sat:09:51-sat:10:21", "EarliestRestorableTime": "2018-06-17T00:06:19.374Z", "StorageEncrypted": false, "MultiAZ": false, "AssociatedRoles": [], "MasterUsername": "", "DBClusterIdentifier": "sample-cluster", "VpcSecurityGroups": [ { "Status": "active", "VpcSecurityGroupId": "sg-77186e0d" } ], "HostedZoneId": "Z2SUY0A1719RZT", "LatestRestorableTime": "2018-06-18T21:17:05.737Z", "AllocatedStorage": 1, "Port": 27017, "Engine": "docdb", "DBClusterParameterGroup": "default.docdb3.4", "Endpoint": "sample-cluster.cluster-ctevjxdlur57.us-east-1.rds.amazonaws.com", "DBSubnetGroup": "default", "PreferredBackupWindow": "00:00-00:30", "EngineVersion": "3.4", "ClusterCreateTime": "2018-06-06T19:25:47.991Z", "IAMDatabaseAuthenticationEnabled": false } } ``` 변경 사항을 적용하는 데 몇 분 정도 걸립니다. *사용 가능* 상태인 경우에만 클러스터를 사용할 수 있습니다. 콘솔 또는 AWS CLI를 사용하여 클러스터의 상태를 모니터링할 수 있습니다. 자세한 내용은 [Amazon DocumentDB 클러스터 상태 모니터링](monitoring_docdb-cluster_status.md) 단원을 참조하십시오. ------ # 대기 중인 유지 관리 확인 대기 중인 클러스터 유지 관리가 있는지 확인하여 최신 Amazon DocumentDB 엔진 버전을 사용 중인지 확인할 수 있습니다. ------ #### [ Using the AWS Management Console ] AWS Management Console 를 사용하여 클러스터에 보류 중인 유지 관리가 있는지 확인할 수 있습니다. 1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다. 1. 탐색 창에서 **클러스터**를 선택합니다. **작은 정보** 화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-menu-icon.png))을 선택합니다. 1. **유지 관리** 열을 찾아 클러스터에 대기 중인 유지 관리가 있는지 확인합니다. ![\[Amazon DocumentDB 클러스터 유지 관리 필드가 표시된 콘솔 스크린샷.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-cluster-pending-maintenance.png) **없음**은 클러스터가 최신 엔진 버전을 실행 중임을 나타냅니다. **사용 가능**은 클러스터에 대기 중인 유지 관리가 있음을 나타냅니다. 즉, 엔진 업그레이드가 필요할 수도 있습니다. 1. 클러스터에 대기 중인 유지 관리가 있을 경우 [클러스터의 엔진 버전에 대한 패치 업데이트 수행](db-cluster-version-upgrade.md)의 단계를 진행합니다. ------ #### [ Using the AWS CLI ] AWS CLI 를 사용하여 다음 파라미터와 함께 `describe-pending-maintenance-actions` 작업을 사용하여 클러스터에 최신 엔진 버전이 있는지 확인할 수 있습니다. **파라미터** + **--resource-identifier** - 선택 사항. 리소스(클러스터)의 ARN입니다. 이 파라미터를 생략하면 모든 클러스터의 대기 중인 유지 관리 작업이 나열됩니다. + **--region** - 선택 사항. 이 작업을 실행하려는 AWS 리전입니다. 예: `us-east-1`. **Example** Linux, macOS, Unix의 경우: ``` aws docdb describe-pending-maintenance-actions \ --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster \ --region us-east-1 ``` Windows의 경우: ``` aws docdb describe-pending-maintenance-actions ^ --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^ --region us-east-1 ``` 이 작업의 출력은 다음과 같이 표시됩니다. ``` { "PendingMaintenanceActions": [ { "ResourceIdentifier": "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster", "PendingMaintenanceActionDetails": [ { "Description": "New feature", "Action": "db-upgrade", "ForcedApplyDate": "2019-02-25T21:46:00Z", "AutoAppliedAfterDate": "2019-02-25T07:41:00Z", "CurrentApplyDate": "2019-02-25T07:41:00Z" } ] } ] } ``` 클러스터에 대기 중인 유지 관리가 있을 경우 [클러스터의 엔진 버전에 대한 패치 업데이트 수행](db-cluster-version-upgrade.md)의 단계를 진행합니다. ------ # 클러스터의 엔진 버전에 대한 패치 업데이트 수행 이 섹션에서는 AWS Management Console 또는를 사용하여 패치 업데이트를 배포하는 방법을 설명합니다 AWS CLI. 패치 업데이트는 동일한 엔진 버전 내의 업데이트입니다(예: 3.6 엔진 버전을 최신 3.6 엔진 버전으로 업데이트). 즉시 업데이트하거나 클러스터의 다음 유지 관리 기간에 업그레이드할 수 있습니다. 엔진 업데이트가 필요한지 확인하려면 [대기 중인 유지 관리 확인](db-cluster-determine-pending-maintenance.md) 섹션을 참조하세요. 업데이트를 적용할 때 클러스터에 약간의 가동 중지 시간이 발생할 수 있다는 점에 유의하세요. **참고** 메이저 엔진 버전에서 다른 버전으로 업그레이드(예: 3.6에서 5.0으로)하려는 경우 [Amazon DocumentDB 인플레이스 주요 버전 업그레이드](docdb-mvu.md) 또는 [를 사용하여 Amazon DocumentDB 클러스터 업그레이드 AWS Database Migration Service](docdb-migration.versions.md)을(를) 참조하세요. 전체 메이저 버전 업그레이드는 docdb 5.0만 대상 엔진 버전으로 지원합니다. 클러스터의 엔진 버전에 대한 최신 패치 업데이트를 받으려면 다음과 같은 두 가지 구성 요구 사항이 있습니다. + 클러스터의 상태가 *사용 가능*이어야 합니다. + 클러스터가 이전 엔진 버전을 실행하고 있어야 합니다. ------ #### [ Using the AWS Management Console ] 다음 절차는 콘솔을 사용하여 클러스터의 엔진 버전에 패치 업데이트를 적용하는 것입니다. 즉시 업데이트하거나 클러스터의 다음 유지 관리 기간 중 업그레이드할 수 있습니다. 1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다. 1. 탐색 창에서 **클러스터**를 선택합니다. 클러스터 목록에서 업그레이드할 클러스터 왼쪽에 있는 버튼을 선택합니다. 클러스터의 상태가 *사용 가능*이어야 합니다. **작은 정보** 화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-menu-icon.png))을 선택합니다. 1. **작업** 메뉴에서 다음 옵션 중 하나를 선택합니다. 이러한 메뉴 옵션은 선택한 클러스터가 최신 엔진 버전을 실행하고 있지 않은 경우에만 선택할 수 있습니다. ![\[이미지: Amazon DocumentDB 업그레이드 조치\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-upgrade-action.png) + **지금 업그레이드** - 업그레이드 프로세스를 즉시 시작합니다. 클러스터가 최신 엔진 버전으로 업그레이드하는 동안에는 클러스터가 잠시 오프라인 상태가 됩니다. + **다음에 업그레이드** - 클러스터의 다음 유지 관리 기간 중에 업그레이드 프로세스를 시작합니다. 클러스터가 최신 엔진 버전으로 업그레이드되는 동안에는 클러스터가 잠시 오프라인 상태가 됩니다. 1. 확인 창이 열리면 다음 중 하나를 선택합니다. + **업그레이드** - 이전 단계에서 선택한 일정에 따라 클러스터를 최신 엔진 버전으로 업그레이드하려면 선택합니다. + **취소** - 클러스터의 엔진 업그레이드를 취소하고 클러스터의 현재 엔진 버전으로 계속하려면 선택합니다. ------ #### [ Using the AWS CLI ] 다음 파라미터와 함께 AWS CLI 및 `apply-pending-maintenance-action` 작업을 사용하여 클러스터에 패치 업데이트를 적용할 수 있습니다. **파라미터** + **--resource-identifier** - 필수입니다. 업그레이드할 Amazon DocumentDB 클러스터의 ARN입니다. + **--apply-action** - 필수입니다. 다음과 같은 값이 허용됩니다. 클러스터 엔진 버전을 업그레이드하려면 `db-upgrade`를 사용합니다. + **db-upgrade** + **system-update** + **--opt-in-type** - 필수입니다. 다음과 같은 값이 허용됩니다. + `immediate` - 유지 관리 작업을 즉시 적용합니다. + `next-maintenance` - 다음 유지 관리 기간 중에 유지 관리 작업을 적용합니다. + `undo-opt-in` - 기존 `next-maintenance` 옵트인 요청을 취소합니다. **Example** 다음은 `sample-cluster`의 엔진 버전을 버전 4.0.0으로 패치 업데이트하는 예입니다. Linux, macOS, Unix의 경우: ``` aws docdb apply-pending-maintenance-action \ --resource-identifier arn:aws:rds:us-east-1:123456789012\:cluster:sample-cluster \ --apply-action db-upgrade \ --opt-in-type immediate ``` Windows의 경우: ``` aws docdb apply-pending-maintenance-action ^ --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^ --apply-action db-upgrade ^ --opt-in-type immediate ``` 이 작업의 출력은 다음과 같습니다. ``` { "ResourcePendingMaintenanceActions": { "ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38", "PendingMaintenanceActionDetails": [ { "CurrentApplyDate": "2019-02-20T20:57:06.904Z", "Description": "Bug fixes", "ForcedApplyDate": "2019-02-25T21:46:00Z", "OptInStatus": "immediate", "Action": "db-upgrade", "AutoAppliedAfterDate": "2019-02-25T07:41:00Z" } ] } } ``` ------ # Amazon DocumentDB 클러스터 중지 및 시작 Amazon DocumentDB 클러스터를 중지하고 시작하면 개발 및 테스트 환경 비용을 관리하는 데 도움이 됩니다. 필요하지 않을 경우 Amazon DocumentDB를 사용할 때마다 클러스터 및 인스턴스를 생성하고 삭제하는 대신 클러스터의 모든 인스턴스를 일시적으로 중지할 수 있습니다. 그런 다음 테스트를 재개할 때 다시 시작할 수 있습니다. **Topics** + [클러스터의 중지 및 시작 개요](#db-cluster-stop-start-overview) + [중지된 클러스터에서 수행할 수 있는 작업](#db-cluster-stopped-operations) ## 클러스터의 중지 및 시작 개요 Amazon DocumentDB 클러스터가 필요하지 않은 기간에는 이 클러스터의 모든 인스턴스를 한번에 중지할 수 있습니다. 그런 다음 사용해야 할 때는 언제든지 클러스터를 다시 시작할 수 있습니다. 시작 및 중지를 사용하면 개발, 테스트 또는 연속 가용성을 필요로 하지 않는 유사한 활동에 사용되는 클러스터의 설정 및 해제 프로세스가 간소화됩니다. 클러스터에 있는 인스턴스 수에 관계없이 단일 작업 AWS CLI 으로 AWS Management Console 또는를 사용하여 클러스터를 중지하고 시작할 수 있습니다. 클러스터가 중지되는 동안 클러스터 스토리지 볼륨은 변경되지 않습니다. 지정된 보존 기간 내에는 스토리지, 수동 스냅샷 및 자동 백업 스토리지에 대한 비용만 청구됩니다. 인스턴스 시간에 대해서는 요금이 부과되지 않습니다 Amazon DocumentDB는 필요한 유지 관리 업데이트에 뒤처지지 않도록 7일 후에 클러스터를 자동으로 시작합니다. 7일 후에 클러스터가 시작되면 클러스터의 인스턴스 비용이 다시 청구됩니다. 클러스터가 중지된 동안에는 쿼리하려면 인스턴스가 사용 가능한 상태여야 하므로 스토리지 볼륨을 쿼리할 수 없습니다. 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. 탐색 창에서 **클러스터**를 선택합니다. **작은 정보** 화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-menu-icon.png))을 선택합니다. 1. 클러스터 목록에서 중지하거나 시작하려는 클러스터 이름의 왼쪽에 있는 버튼을 선택합니다. 1. **작업**을 선택한 다음 클러스터에서 수행하려는 작업을 선택합니다. + 클러스터를 중지하고 다음 작업을 수행합니다. 1. **중지**를 선택합니다. ![\[이미지: 클러스터 중지\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/db-cluster-stop.png) 중지 작업은 장애 조치 메커니즘 활성화를 피하기 위해 복제본 인스턴스를 먼저 중지한 후 기본 인스턴스를 중지합니다. 1. 확인 대화 상자에서 **클러스터 중지**를 선택하여 클러스터 중지를 확인하거나, 클러스터를 계속 실행하려면 **취소**를 선택합니다. ![\[이미지: 클러스터 시작\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/db-cluster-stop-confirm.png) + 클러스터를 시작하려면 클러스터가 중지된 상태에서 **시작**을 선택합니다. ![\[이미지: 클러스터 시작\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/db-cluster-start.png) 1. 클러스터 및 인스턴스 상태를 모니터링합니다. 클러스터를 시작한 경우 클러스터 및 해당 인스턴스를 *사용 가능*할 때 클러스터 사용을 다시 시작할 수 있습니다. 자세한 내용은 [클러스터 상태 확인](db-cluster-status.md) 섹션을 참조하십시오. ![\[이미지: 클러스터 중지 및 시작 상태\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/db-cluster-stop-start-status.png) ------ #### [ Using the AWS CLI ] 다음 코드 예제에서는 사용 가능한 상태인 하나 이상의 인스턴스가 있는 클러스터를 중지하거나, 중지된 클러스터를 시작하는 방법을 보여 줍니다. 를 사용하여 사용 가능한 인스턴스가 하나 이상인 클러스터를 중지하려면 `stop-db-cluster` 작업을 AWS CLI사용합니다. 중지된 클러스터를 시작하려면 `start-db-cluster` 작업을 사용합니다. 두 작업은 `--db-cluster-identifier` 파라미터를 사용합니다. **파라미터:** + **--db-cluster-identifier** - 필수입니다. 중지하거나 시작할 클러스터의 이름. **Example -를 사용하여 클러스터를 중지하려면 AWS CLI** 다음 코드는 클러스터 `sample-cluster`를 중지합니다. 클러스터에는 사용 가능한 상태인 인스턴스가 하나 이상 있어야 합니다. Linux, macOS, Unix의 경우: ``` aws docdb stop-db-cluster \ --db-cluster-identifier sample-cluster ``` Windows의 경우: ``` aws docdb stop-db-cluster ^ --db-cluster-identifier sample-cluster ``` **Example -를 사용하여 클러스터를 시작하려면 AWS CLI** 다음 코드는 클러스터 `sample-cluster`를 시작합니다. 클러스터는 현재 중지된 상태여야 합니다. Linux, macOS, Unix의 경우: ``` aws docdb start-db-cluster \ --db-cluster-identifier sample-cluster ``` Windows의 경우: ``` aws docdb start-db-cluster ^ --db-cluster-identifier sample-cluster ``` ------ ## 중지된 클러스터에서 수행할 수 있는 작업 Amazon DocumentDB 클러스터가 중지되어 있는 동안, 지정된 자동 백업 보존 기간 내에서 원하는 시점으로 특정 시점 복원을 수행할 수 있습니다. 특정 시점으로 복원에 대한 세부 정보는 [특정 시점으로 복원](backup_restore-point_in_time_recovery.md) 섹션을 참조하세요. 클러스터가 중지되는 동안 Amazon DocumentDB 클러스터의 구성 또는 해당 인스턴스를 수정할 수 없습니다. 또한 클러스터에서 인스턴스를 추가 또는 제거할 수 없으며, 연결된 인스턴스가 있는 경우에도 클러스터를 삭제할 수 없습니다. 이러한 관리 작업을 수행하기 전에 클러스터를 시작해야 합니다. Amazon DocumentDB는 다시 시작한 후에만 중지된 클러스터에 예약 유지 관리를 적용합니다. 7일 후에 Amazon DocumentDB는 중지된 클러스터를 자동으로 시작하므로 유지 관리 상태에서 너무 늦어지지 않습니다. 클러스터가 다시 시작되면 클러스터의 인스턴스 비용이 다시 청구됩니다. 클러스터가 중지되는 동안 Amazon DocumentDB는 자동화된 백업을 수행하지 않으며 백업 보존 기간도 연장하지 않습니다. # Amazon DocumentDB 클러스터 삭제 AWS Management Console 또는를 사용하여 Amazon DocumentDB 클러스터를 삭제할 수 있습니다 AWS CLI. 클러스터를 삭제하려면 클러스터가 *사용 가능한* 상태여야 하며 클러스터와 연결된 인스턴스가 없어야 합니다. 클러스터가 중지된 경우, 먼저 클러스터를 시작하고 클러스터가 *사용 가능*하게 될 때까지 기다린 다음 클러스터를 삭제합니다. 자세한 내용은 [Amazon DocumentDB 클러스터 중지 및 시작](db-cluster-stop-start.md) 섹션을 참조하십시오. ## 삭제 방지 실수로 인한 삭제로부터 클러스터를 보호하려면 *삭제 방지*를 활성화할 수 있습니다. 콘솔을 사용하여 클러스터를 생성할 때 기본적으로 삭제 방지가 활성화됩니다. 하지만 AWS CLI를 사용하여 클러스터를 생성하는 경우 삭제 방지가 기본적으로 비활성화됩니다. Amazon DocumentDB는 콘솔 또는 AWS CLI중 어느 곳에서 삭제 작업을 수행하든 간에 클러스터에 대한 삭제 방지를 강제 시행합니다. 삭제 방지가 활성화되어 있으면 클러스터를 삭제할 수 없습니다. 삭제 방지가 활성화된 클러스터를 삭제하려면 먼저 클러스터를 수정하고 삭제 방지를 비활성화해야 합니다. 삭제 방지가 활성화된 클러스터가 있는 콘솔을 사용할 경우 클러스터의 마지막 인스턴스를 삭제하면 클러스터도 삭제되므로 해당 인스턴스를 삭제할 수 없습니다. AWS CLI를 사용하여 삭제 방지된 클러스터의 마지막 인스턴스를 삭제할 수 있습니다. 하지만 클러스터 자체는 여전히 존재하고 데이터는 보존됩니다. 클러스터의 새 인스턴스를 생성하여 데이터에 액세스할 수 있습니다. 삭제 방지 활성화 및 비활성화에 대한 자세한 내용은 다음을 참조하세요. + [Amazon DocumentDB 클러스터 생성](db-cluster-create.md) + [Amazon DocumentDB 클러스터 수정](db-cluster-modify.md) ------ #### [ Using the AWS Management Console ] 를 사용하여 클러스터를 삭제하려면 AWS Management Console삭제 방지 기능을 비활성화해야 합니다. **클러스터에 대해 삭제 방지를 활성화했는지 여부를 확인하려면 다음과 같이 하세요.** 1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다. 1. 탐색 창에서 **클러스터**를 선택합니다. **작은 정보** 화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘(![\[Hamburger menu icon with three horizontal lines.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/docdb-menu-icon.png))을 선택합니다. 1. 참고로 클러스터 탐색 상자의 **클러스터 식별자** 열에는 클러스터와 인스턴스가 모두 표시됩니다. 인스턴스는 아래 스크린샷과 마찬가지로 클러스터 아래에 나열됩니다. ![\[이미지: 기존 클러스터 링크 및 해당 인스턴스 링크의 목록을 보여주는 클러스터 탐색 상자입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/clusters.png) 1. 클러스터의 이름을 선택하고 **구성** 탭을 선택합니다. **클러스터 세부 정보** 섹션에서 **삭제 보호**를 찾습니다. 삭제 방지가 활성화된 경우 클러스터를 수정하여 삭제 방지를 비활성화합니다. 클러스터 수정에 대한 자세한 내용은 [Amazon DocumentDB 클러스터 수정](db-cluster-modify.md) 섹션을 참조하세요. **삭제 방지**가 비활성화된 후에는 클러스터를 삭제할 수 있습니다. **클러스터를 삭제하려면 다음과 같이 하세요.** 1. 탐색 창에서 **클러스터**를 선택합니다. 1. **클러스터 식별자** 열 아래에 나열된 인스턴스를 확인하여 클러스터에 인스턴스가 있는지 확인합니다. 클러스터를 삭제하려면 모든 인스턴스를 삭제해야 합니다. 자세한 내용은 [Amazon DocumentDB 인스턴스 삭제](db-instance-delete.md) 섹션을 참조하십시오. 1. 클러스터에 인스턴스가 있는지 여부에 따라 다음 단계 중 하나를 수행합니다. + 클러스터에 인스턴스가 없는 경우 클러스터 이름 왼쪽에 있는 단추를 선택하고 **작업**을 선택합니다. 드롭다운 메뉴에서 **삭제**를 선택합니다. ** 삭제** 대화 상자를 완료한 다음 **삭제**를 선택합니다. + 클러스터에 인스턴스가 하나 이상 있는 경우 다음을 수행합니다. 1. 탐색 창에서 **클러스터**를 선택합니다. 1. 클러스터 이름 왼쪽에 있는 확인란을 선택하여 클러스터의 각 인스턴스를 삭제합니다. **작업**을 선택한 후 **삭제**를 선택합니다. ** 삭제** 대화 상자를 완료한 다음 **삭제**를 선택합니다. 마지막 인스턴스를 삭제할 경우 클러스터도 삭제됩니다. 인스턴스 삭제에 대한 자세한 내용은 [Amazon DocumentDB 인스턴스 삭제](db-instance-delete.md) 섹션을 참조하세요. 클러스터를 삭제하는 데 몇 분 정도 걸립니다. 클러스터 상태를 모니터링하려면 [Amazon DocumentDB 클러스터 상태 모니터링](monitoring_docdb-cluster_status.md) 섹션을 참조하세요. ------ #### [ Using the AWS CLI ] 인스턴스가 연결되어 있는 클러스터를 삭제할 수 없습니다. 클러스터와 연결된 인스턴스를 확인하려면 `describe-db-clusters` 명령을 실행하고 클러스터의 모든 인스턴스를 삭제합니다. 그런 다음 필요한 경우 클러스터에서 삭제 방지를 비활성화하고 마지막으로 클러스터를 삭제합니다. 1. **먼저 클러스터의 모든 인스턴스를 삭제합니다.** 삭제해야 할 인스턴스를 결정하려면 다음 명령을 실행합니다. ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterIdentifier,DBClusterMembers[*].DBInstanceIdentifier]' ``` 이 작업의 출력은 다음과 같습니다(JSON 형식). ``` [ [ "sample-cluster", [ "sample-instance-1", "sample-instance-2" ] ] ] ``` 삭제하려는 클러스터에 인스턴스가 있는 경우 아래와 같이 인스턴스를 삭제합니다. ``` aws docdb delete-db-instance \ --db-instance-identifier sample-instance ``` 1. **다음으로 삭제 방지를 비활성화합니다.** AWS CLI 를 사용하여 클러스터의 모든 인스턴스를 삭제해도 클러스터는 삭제되지 않습니다. 클러스터를 삭제해야 하더라도 삭제 방지가 비활성화된 경우에만 삭제할 수 있습니다. 클러스터에 삭제 방지가 활성화되었는지 확인하려면 다음 명령을 실행합니다. **작은 정보** 모든 Amazon DocumentDB 클러스터의 삭제 방지 상태를 보려면 `--db-cluster-identifier` 파라미터를 생략합니다. ``` aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterIdentifier,DeletionProtection]' ``` 이 작업의 출력은 다음과 같이 표시됩니다. ``` [ [ "sample-cluster", "true" ] ] ``` 클러스터에 삭제 방지가 활성화된 경우 클러스터를 수정하여 삭제 방지를 비활성화합니다. 클러스터에서 삭제 방지를 비활성화하려면 다음 명령을 실행합니다. ``` aws docdb modify-db-cluster \ --db-cluster-identifier sample-cluster \ --no-deletion-protection \ --apply-immediately ``` 1. **마지막으로 클러스터를 삭제합니다.** 삭제 방지가 비활성화된 후에는 클러스터를 삭제할 수 있습니다. 클러스터를 삭제하려면 다음 파라미터와 함께 `delete-db-cluster` 작업을 사용합니다. + **--db-cluster-identifier** - 필수입니다. 삭제하려는 클러스터의 식별자입니다. + **--final-db-snapshot-identifier** - 선택 사항. 최종 스냅샷을 원하는 경우 최종 스냅샷의 이름과 함께 이 파라미터를 포함해야 합니다. `--final-db-snapshot-identifier` 또는 `--skip-final-snapshot`를 포함시켜야 합니다. 명명 제약 조건: + 길이는 [1\$163] 글자, 숫자 또는 하이픈입니다. + 첫 번째 문자는 글자이어야 합니다. + 하이픈으로 끝나거나 하이픈이 2개 연속으로 포함되어서는 안 됩니다. + 리전별로 Amazon RDS, Amazon Neptune 및 Amazon DocumentDB의 모든 클러스터 AWS 계정에 대해 고유해야 합니다. + **--skip-final-snapshot** - 선택 사항. 클러스터를 삭제하기 전에 최종 스냅샷을 생성하지 않으려는 경우에만 이 파라미터를 사용하세요. 기본 설정은 최종 스냅샷을 생성하는 것입니다. `--final-db-snapshot-identifier` 또는 `--skip-final-snapshot`를 포함시켜야 합니다. 다음 AWS CLI 코드는 최종 스냅샷이 `sample-cluster` 있는 클러스터를 삭제합니다. 클러스터와 연결된 인스턴스가 있거나 삭제 방지가 활성화된 경우 작업이 실패합니다. **Example** Linux, macOS, Unix의 경우: ``` aws docdb delete-db-cluster \ --db-cluster-identifier sample-cluster \ --final-db-snapshot-identifier sample-cluster-final-snapshot ``` Windows의 경우: ``` aws docdb delete-db-cluster ^ --db-cluster-identifier sample-cluster ^ --final-db-snapshot-identifier sample-cluster-final-snapshot ``` **Example** 다음 AWS CLI 코드는 최종 스냅샷을 생성`sample-cluster`하지 않고 클러스터를 삭제합니다. Linux, macOS, Unix의 경우: ``` aws docdb delete-db-cluster \ --db-cluster-identifier sample-cluster \ --skip-final-snapshot ``` Windows의 경우: ``` aws docdb delete-db-cluster ^ --db-cluster-identifier sample-cluster ^ --skip-final-snapshot ``` `delete-db-cluster` 연산은 삭제하려는 클러스터를 출력합니다. 클러스터를 삭제하는 데 몇 분 정도 걸립니다. 클러스터 상태를 모니터링하려면 [클러스터 상태 모니터링](monitoring_docdb-cluster_status.md) 섹션을 참조하세요. ------ # Amazon DocumentDB 클러스터 규모 조정 Amazon DocumentDB를 사용하면 필요에 따라 클러스터의 스토리지와 컴퓨팅을 조정할 수 있습니다. 이 섹션에서는 스토리지 조정, 인스턴스 조정 및 읽기 조정을 사용하여 Amazon DocumentDB 클러스터 및 인스턴스의 성능 및 확장을 관리하는 방법을 설명합니다. **Topics** + [스토리지 조정](#db-cluster-manage-scaling-storage) + [인스턴스 조정](#db-cluster-manage-scaling-instance) + [읽기 확장](#db-cluster-manage-scaling-reads) + [쓰기 조정](#db-cluster-manage-scaling-writes) ## 스토리지 조정 Amazon DocumentDB 스토리지는 클러스터 볼륨에 저장된 데이터에 따라 자동 조정됩니다. 데이터가 증가하면 클러스터 볼륨 스토리지도 최대 128TiB까지 10GiB씩 확장됩니다. ## 인스턴스 조정 필요에 따라 클러스터의 인스턴스마다 인스턴스 클래스를 수정하여 Amazon DocumentDB 클러스터의 크기를 조정할 수 있습니다. Amazon DocumentDB는 Amazon DocumentDB에 최적화된 여러 인스턴스 클래스를 지원합니다. 자세한 내용은 [Amazon DocumentDB 인스턴스 수정](db-instance-modify.md) 섹션을 참조하십시오. ## 읽기 확장 클러스터에서 Amazon DocumentDB 복제본을 최대 15개까지 생성하여 Amazon DocumentDB 클러스터에 대한 읽기 확장이 가능합니다. 각 Amazon DocumentDB 복제본은 복제본 지연을 최소화하여 클러스터 볼륨에서 동일한 데이터를 반환합니다. 일반적으로 이 지연 시간은 기본 인스턴스가 업데이트를 적용한 후 100밀리초 미만입니다. 읽기 트래픽이 증가하면 Amazon DocumentDB 복제본을 추가 생성하여 직접 연결함으로써 클러스터의 읽기 부하를 분산시키는 것도 가능합니다. Amazon DocumentDB 복제본의 인스턴스 클래스가 기본 인스턴스의 DB 인스턴스 클래스와 같을 필요는 없습니다. 자세한 내용은 [클러스터에 Amazon DocumentDB 인스턴스 추가](db-instance-add.md) 섹션을 참조하십시오. Amazon DocumentDB로 스케일을 읽으려면 드라이버의 내장된 읽기 기본 설정 기능을 사용하여 복제본 세트로 클러스터에 연결하고 읽기를 복제본 인스턴스에 배포하는 것이 좋습니다. 자세한 내용은 [Amazon DocumentDB에 복제본 세트로 연결](connect-to-replica-set.md) 섹션을 참조하세요. ## 쓰기 조정 클러스터의 기본 인스턴스 크기를 늘려 Amazon DocumentDB 클러스터의 쓰기 용량을 확장할 수 있습니다. 이 섹션에서는 필요에 따라 클러스터의 기본 인스턴스를 확장하는 두 가지 방법을 설명합니다. 첫 번째 옵션은 애플리케이션에 미치는 영향을 최소화하도록 노력하지만 더 많은 단계를 완료해야 합니다. 두 번째 옵션은 단계가 적어 더 간단하지만 애플리케이션에 더 많은 잠재적 영향을 미칠 수 있다는 단점이 있습니다. 애플리케이션에 따라 둘 중에서 더 적합한 방법을 선택할 수 있습니다. 사용 가능한 인스턴스 크기 및 비용에 대한 자세한 내용은 [Amazon DocumentDB 요금](https://aws.amazon.com/documentdb/pricing/) 페이지를 참조하세요. 1. **고가용성 및 성능 최적화** - [복제본 집합 모드](connect-to-replica-set.md)로 클러스터에 연결하는 경우(권장) 기본 인스턴스를 확장할 때 다음 프로세스를 사용하여 애플리케이션에 미치는 영향을 최소화할 수 있습니다. 이 방법을 사용하면 클러스터가 필요한 고가용성 수준 이상으로 유지되며 읽기 조정 대상이 현재 위치에서 업데이트되지 않고 인스턴스로 클러스터에 추가되므로 영향이 최소화됩니다. 1. 클러스터에 더 큰 인스턴스 유형의 복제본을 하나 이상 추가합니다([클러스터에 Amazon DocumentDB 인스턴스 추가](db-instance-add.md) 참조). 모든 복제본은 기본 인스턴스와 동일하거나 더 큰 인스턴스 유형인 것이 좋습니다. 이렇게 하면 더 작은 인스턴스 유형으로 장애 조치되어 쓰기 성능이 의도치 않게 저하되는 것을 방지할 수 있습니다. 대부분의 고객의 경우 클러스터의 인스턴스 수를 일시적으로 두 배로 늘린 다음 확장이 완료된 후 더 작은 복제본을 제거해야 합니다. 1. 모든 새 복제본의 장애 조치 계층을 우선 순위 0으로 설정하여 더 작은 인스턴스 유형의 복제본이 가장 높은 장애 조치 우선 순위를 갖도록 합니다. 자세한 내용은 [장애 조치 대상 제어](failover.md#failover-target_control) 섹션을 참조하십시오. 1. 수동 장애 조치를 시작합니다. 그러면 새 복제본 중 하나가 기본 인스턴스로 승격됩니다. 자세한 내용은 [장애 조치 테스트](failover.md#failover-testing) 섹션을 참조하십시오. **참고** 이렇게 하면 클러스터에 약 30초의 가동 중지 시간이 발생합니다. 이에 맞춰 계획을 세우세요. 1. 새 기본 인스턴스보다 작은 인스턴스 유형의 모든 복제본을 클러스터에서 제거합니다. 1. 모든 인스턴스의 장애 조치 계층을 동일한 우선 순위로 다시 설정합니다(일반적으로 다시 1로 설정됨). 예를 들어 현재 3개의 `r5.large` 인스턴스(하나의 기본 인스턴스와 두 개의 복제본)가 포함된 클러스터가 있고 `r5.xlarge` 인스턴스 유형으로 확장하려는 경우, 먼저 클러스터에 `r5.xlarge` 복제본 인스턴스 3개를 추가하고 새 `r5.xlarge` 복제본의 장애 조치 계층을 0으로 설정한 다음 수동 장애 조치를 시작합니다(애플리케이션에 30초 정도의 가동 중지 시간이 발생함). 장애 조치가 완료된 후 클러스터에서 3개의 `r5.large` 인스턴스를 모두 제거하면 클러스터가 `r5.xlarge` 인스턴스로 확장됩니다. 비용을 최적화할 수 있도록 Amazon DocumentDB 인스턴스 요금은 인스턴스 생성, 수정 또는 삭제 같은 청구 가능한 상태 변경에 따라 1초 단위로 청구되며 최소 10분의 요금이 부과됩니다. 자세한 내용은 모범 사례 설명서의 [비용 최적화](best_practices.md#best_practices-cost_optimization) 섹션을 참조하세요. 1. **단순성을 위한 최적화** - 이 접근 방식은 단순성을 위해 최적화됩니다. 클러스터를 확장하거나 축소하지는 않지만 일시적으로 읽기 용량을 줄일 수 있습니다. 복제본의 인스턴스 클래스를 변경하면 해당 인스턴스가 몇 초에서 30초 미만으로 짧은 기간 동안 요청을 처리하지 못할 수 있습니다. [복제본 세트 모드](connect-to-replica-set.md)(권장)로 클러스터에 연결하는 경우 조정 작업 중에 읽기 용량이 복제본 1개만큼 줄어듭니다(예: 3노드 클러스터의 경우 66%, 4노드 클러스터의 경우 75% 용량 등). 1. 클러스터의 복제본 인스턴스 중 하나를 확장합니다. 자세한 내용은 [인스턴스 클래스 관리](db-instance-classes.md) 섹션을 참조하십시오. 1. 인스턴스를 사용할 수 있을 때까지 기다리세요([Amazon DocumentDB 인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 참조). **참고** 이렇게 하면 클러스터에 약 30초의 가동 중지 시간이 발생합니다. 이에 맞춰 계획을 세우세요. 1. 모든 복제본 인스턴스가 하나씩 확장될 때까지 1단계와 2단계를 계속 실행합니다. 1. 수동 장애 조치 시작. 이렇게 하면 복제본 중 한 개가 기본 인스턴스로 승격됩니다. 자세한 내용은 [Amazon DocumentDB 장애 조치](failover.md) 섹션을 참조하십시오. **참고** 이로 인해 클러스터에 최대 30초의 가동 중지 시간이 발생하지만 대개 그보다 시간이 덜 걸립니다. 이에 맞춰 계획을 세우세요. 1. 이전의 기본(지금은 복제본) 인스턴스를 확장하세요. # Amazon DocumentDB 클러스터에 대한 볼륨 복제 Amazon DocumentDB 복제를 사용하면 동일한 Amazon DocumentDB 클러스터 볼륨을 사용하고 원본과 동일한 데이터를 갖는 새 클러스터를 생성할 수 있습니다. 이 프로세스는 빠르고 비용 효율적으로 진행되도록 설계되었습니다. 연결된 데이터 볼륨이 있는 새 클러스터를 *복제본*이라고 합니다. 복제본 생성은 스냅샷 복원과 같은 다른 기술을 사용하여 데이터를 물리적으로 복사하는 것보다 빠르고 공간 효율적입니다. Amazon DocumentDB는 프로비저닝된 Amazon DocumentDB 클러스터에서 Amazon DocumentDB 프로비저닝된 복제본을 생성할 수 있도록 지원합니다. 소스와 다른 배포 구성을 사용하여 복제를 생성하면 소스 Amazon DocumentDB 엔진의 최신 버전을 사용하여 복제본이 생성됩니다. Amazon DocumentDB 클러스터에서 복제본을 생성하면 소스 Amazon DocumentDB 클러스터를 소유한 것과 동일한 계정인 AWS 계정에 복제본이 생성됩니다. **Topics** + [Amazon DocumentDB 복제 개요](#db-cloning-overview) + [Amazon DocumentDB 복제의 제한](#db-cloning-limitations) + [Amazon DocumentDB 복제의 작동 방식](#db-how-db-cloning-works) + [Amazon DocumentDB 복제본 생성](#db-creating-db-clone) ## Amazon DocumentDB 복제 개요 Amazon DocumentDB는 *기록 중 복사(Copy-on-Write) 프로토콜*을 사용하여 복제본을 생성합니다. 이 메커니즘은 최소한의 추가 공간을 사용하여 초기 복제를 만듭니다. 복제가 처음 생성되면 Amazon DocumentDB는 소스 DB 클러스터와 새로운(복제된) Amazon DocumentDB 클러스터에서 사용하는 데이터의 단일 복사본을 유지합니다. 소스 Amazon DocumentDB 클러스터 또는 Amazon DocumentDB 클러스터 복제가 Amazon DocumentDB 스토리지 볼륨의 데이터를 변경한 경우에만 추가 스토리지가 할당됩니다. 기록 중 복사(Copy-on-Write) 프로토콜에 대한 자세한 내용은 [Amazon DocumentDB 복제의 작동 방식](#db-how-db-cloning-works) 섹션을 참조하세요. Amazon DocumentDB 복제 작업은 데이터 손상 위험 없이 프로덕션 데이터를 사용하여 테스트 환경을 신속하게 설정하는 데 특히 유용합니다. 다음과 같은 여러 유형의 애플리케이션에 복제본을 사용할 수 있습니다. + 잠재적 변경 사항(예: 스키마 변경 및 파라미터 그룹 변경)을 실험하여 모든 영향을 평가합니다. + 데이터 내보내기 또는 복제본에서 분석 쿼리 실행과 같은 워크로드 집약적인 작업을 수행하는 경우 + 개발, 테스트 또는 기타 용도로 프로덕션 DB 클러스터의 복사본을 생성합니다. 동일한 Amazon DocumentDB 클러스터에서 둘 이상의 복제본을 생성할 수 있습니다. 다른 복제본에서 여러 복제본을 생성할 수도 있습니다. Amazon DocumentDB 복제본을 생성한 후 Amazon DocumentDB 인스턴스를 원본 Amazon DocumentDB 클러스터와 다르게 구성할 수 있습니다. 예를 들어 소스 프로덕션 Amazon DocumentDB 클러스터와 동일한 고가용성 요구 사항을 충족하기 위해 개발 목적으로 복제본이 필요하지 않을 수 있습니다. 이 경우 Amazon DocumentDB 클러스터에서 사용하는 여러 DB 인스턴스가 아닌 단일 Amazon DocumentDB 인스턴스로 복제본을 구성할 수 있습니다. 복제본을 테스트, 개발 또는 다른 용도로 사용한 후 삭제할 수 있습니다. ## Amazon DocumentDB 복제의 제한 Amazon DocumentDB 복제는 다음과 같은 제한 사항이 있습니다. + AWS 리전에서 허용하는 최대 DB 클러스터 개수까지 원하는 만큼 복제본을 생성할 수 있습니다. 그러나 15개의 복제본을 생성한 후에는 다음 복제가 전체 복제본이 됩니다. 시점 복구와 같은 복제 작업이 수행됩니다. + 소스 Amazon DocumentDB 클러스터와 다른 AWS 리전에서는 복제본을 생성할 수 없습니다. + DB 인스턴스가 없는 Amazon DocumentDB 클러스터에서 복제본을 생성할 수 없습니다. 하나 이상의 DB 인스턴스가 있는 Amazon DocumentDB 클러스터만 복제할 수 있습니다. + 복제본을 Amazon DocumentDB 클러스터의 가상 프라이빗 클라우드(VPC)와 다른 가상 프라이빗 클라우드(VPC)에 생성할 수 있습니다. 이렇게 하면 VPC의 서브넷을 동일한 가용 영역에 매핑해야 합니다. ## Amazon DocumentDB 복제의 작동 방식 Amazon DocumentDB 복제는 Amazon DocumentDB 클러스터의 스토리지 계층에서 작동합니다. 이는 Amazon DocumentDB 스토리지 볼륨을 지원하는 기본 내구 미디어 측면에서 빠르고 공간 효율적인 *기록 중 복사(copy-on-write)* 프로토콜을 사용합니다. Amazon DocumentDB 클러스터 볼륨에 대한 자세한 내용은 [Amazon DocumentDB 클러스터 관리](db-clusters.md)에서 확인할 수 있습니다. **Topics** + [기록 중 복사(copy-on-write) 이해](#db-copy-on-write-protocol) + [원본 클러스터 볼륨 삭제](#db-deleting-source-cluster-volume) ### 기록 중 복사(copy-on-write) 이해 Amazon DocumentDB 클러스터는 기본 Amazon DocumentDB 스토리지 볼륨의 페이지에 데이터를 저장합니다. 예를 들어, 다음 다이어그램에서 데이터 페이지(1, 2, 3, 4)가 네 개인 Amazon DocumentDB 클러스터(A)를 찾을 수 있습니다. 복제본 B가 Amazon DocumentDB 클러스터에서 생성된다고 가정해 보겠습니다. 복제본이 생성되면 데이터가 복사되지 않습니다. 대신 복제본은 소스 Amazon DocumentDB 클러스터와 동일한 페이지 집합을 가리킵니다. ![\[소스 클러스터 A 및 복제본 B에 대해 4개의 페이지가 포함된 Amazon DocumentDB 클러스터 볼륨\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-1.png) 복제본이 생성되면 일반적으로 추가 스토리지가 필요하지 않습니다. 기록 중 복사(copy-on-write) 프로토콜은 물리적 스토리지 미디어에서 소스 세그먼트와 동일한 세그먼트를 사용합니다. 소스 세그먼트의 용량이 전체 복제본 세그먼트에 충분하지 않은 경우에만 추가 스토리지가 필요합니다. 이 경우 소스 세그먼트는 다른 물리적 디바이스로 복사됩니다. 다음 다이어그램에서는 앞에서와 같이 동일한 클러스터 A와 해당 복제본 B를 사용하여 작동하는 기록 중 복사(copy-on-write) 프로토콜의 예를 찾을 수 있습니다. Amazon DocumentDB 클러스터(A)를 변경하여 페이지 1에 보관된 데이터가 변경된다고 가정해 보겠습니다. Amazon DocumentDB는 원본 페이지 1에 기록하는 대신 새 페이지 1[A]을 생성합니다. 클러스터(A)에 대한 Amazon DocumentDB 클러스터 볼륨은 이제 페이지 1[A], 2, 3, 4를 가리키고 복제본(B)은 여전히 원본 페이지를 참조합니다. ![\[Amazon DocumentDB 소스 DB 클러스터 볼륨과 해당 복제본 모두 변경 사항이 있습니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-2.png) 복제본에서 스토리지 볼륨의 페이지 4가 변경됩니다. Amazon DocumentDB는 원본 페이지 4에 기록하는 대신 새 페이지 4[B]를 생성합니다. 이제 복제본은 페이지 1, 2, 3 및 페이지 4[B]를 가리키고 클러스터(A)는 계속해서 1[A], 2, 3 및 4를 가리킵니다. ![\[Amazon DocumentDB 소스 DB 클러스터 볼륨과 해당 복제본 모두 변경 사항이 있습니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/db-cloning-copy-on-write-protocol-3.png) 시간이 경과하여 소스 Amazon DocumentDB 클러스터 볼륨과 복제본 모두가 변경될 경우 변경 사항을 캡처하고 저장하기 위해 점점 더 많은 스토리지가 필요합니다. ### 원본 클러스터 볼륨 삭제 하나 이상의 복제본이 연결된 소스 클러스터 볼륨을 삭제해도 복제본은 영향을 받지 않습니다. 복제본은 이전에 원본 클러스터 볼륨이 소유하던 페이지를 계속 가리킵니다. ## Amazon DocumentDB 복제본 생성 소스 Amazon DocumentDB 클러스터와 동일한 AWS 계정에 복제본을 생성할 수 있습니다. 이렇게 하려면 AWS Management Console 또는 AWS CLI 및 다음 절차를 사용할 수 있습니다. Amazon DocumentDB 복제를 사용하면 프로비저닝된 Amazon DocumentDB 클러스터에서 프로비저닝된 Amazon DocumentDB 클러스터 복제본을 생성할 수 있습니다. ------ #### [ Using the AWS Management Console ] 다음 절차에서는 AWS Management Console을 사용하여 Amazon DocumentDB 클러스터를 복제하는 방법에 대해 설명합니다. Amazon DocumentDB 인스턴스 하나가 있는 Amazon DocumentDB 클러스터에서 AWS Management Console 결과를 사용하여 복제본을 생성합니다. 이 지침은 복제본을 생성하는 계정과 동일한 AWS 계정이 소유한 DB 클러스터에 적용됩니다. DB 클러스터는 Amazon DocumentDB에서 교차 AWS 계정 복제가 지원되지 않으므로 동일한 계정이 소유해야 합니다. **를 사용하여 AWS 계정이 소유한 DB 클러스터의 복제본을 생성하려면 AWS Management Console** 1. 에 로그인 AWS Management Console하고 [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) Amazon DocumentDB 콘솔을 엽니다. 1. 탐색 창에서 **클러스터**를 선택합니다. 1. 목록에서 Amazon DocumentDB 클러스터를 선택하고 **작업**에서 **복제본 생성**을 선택합니다. ![\[Amazon DocumentDB 클러스터를 선택하여 복제본 생성을 시작합니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/db-cloning-create-clone-1.png) **클러스터 식별자**, **인스턴스 클래스**, 그리고 Amazon DocumentDB 클러스터 복제본에 대한 기타 옵션을 구성할 수 있는 복제본 생성 페이지가 열립니다. 1. **설정** 섹션에서 다음을 수행합니다. 1. **클러스터 식별자**에 복제된 Amazon DocumentDB 클러스터에 부여할 이름을 입력합니다. 1. **인스턴스 구성**의 경우 복제된 Amazon DocumentDB 클러스터에 적합한 **인스턴스 클래스**를 선택합니다. ![\[복제본 생성은 Amazon DocumentDB 클러스터를 선택하고 DB 인스턴스 크기를 지정하는 것으로 시작됩니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/db-cloning-create-clone-2.png) 1. **네트워크 설정**에서 사용 사례에 맞는 **서브넷 그룹**과 관련 VPC 보안 그룹을 선택합니다. 1. **저장 시 암호화**의 경우 소스 클러스터(복제 중인 클러스터) 에 암호화가 활성화되어 있는 경우 복제된 클러스터에도 암호화가 활성화되어 있어야 합니다. 이 시나리오가 사실인 경우 **암호화 사용** 옵션은 회색으로 표시(사용 안 함)되지만 **암호화 사용** 옵션은 선택됩니다. 반대로 소스 클러스터에 암호화가 활성화되어 있지 않은 경우 **암호화 활성화** 옵션을 사용할 수 있으며 암호화를 활성화하거나 비활성화하도록 선택할 수 있습니다. ![\[Amazon DocumentDB 클러스터 복제본에 대한 네트워크 및 암호화 설정을 지정합니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/db-cloning-create-clone-3-nw-encryption.png) 1. 내보낼 로그 유형(선택 사항)을 선택하고, 클러스터에 연결하는 데 사용되는 특정 포트를 입력하고, 클러스터를 실수로 삭제하지 않도록 보호(기본적으로 활성화됨)하여 새 클러스터 복제본 구성을 완료합니다. ![\[내보낼 로그 유형, 클러스터에 연결하는 데 사용되는 특정 포트, 실수로 클러스터를 삭제하는 경우 보호 양식 등을 선택적으로 선택하여 새 복제 구성을 완료합니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/db-cloning-create-clone-4-log-options-del-prot-b.png) 1. Amazon DocumentDB 클러스터 복제본에 대한 모든 설정을 입력합니다. Amazon DocumentDB 클러스터 및 인스턴스 설정에 대한 자세한 내용은 [Amazon DocumentDB 클러스터 관리](db-clusters.md) 섹션에서 참조하세요. 1. **복제본 생성**을 선택하여 선택한 Amazon DocumentDB 클러스터의 Amazon DocumentDB 복제본을 시작합니다. 복제본이 생성되면 복제본은 콘솔의 **데이터베이스** 섹션에 다른 Amazon DocumentDB 클러스터와 함께 나열되고 현재 상태가 표시됩니다. 상태가 **사용 가능**이면 복제본을 사용할 준비가 된 것입니다. ------ #### [ Using the AWS CLI ] AWS CLI 를 사용하여 Amazon DocumentDB 클러스터를 복제하려면 몇 가지 단계가 필요합니다. 사용하는 `restore-db-cluster-to-point-in-time` AWS CLI 명령은 Amazon DocumentDB 인스턴스가 0개인 빈 Amazon DocumentDB 클러스터를 생성합니다. 즉, 명령은 Amazon DocumentDB 클러스터만 복원하고, 해당 클러스터의 DB 인스턴스는 복원하지 않습니다. 복제본이 사용 가능한 후에 별도로 이 작업을 수행합니다. 프로세스의 두 단계는 다음과 같습니다. 1. [restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html) CLI 명령을 사용하여 복제본을 생성합니다. 이 명령과 함께 사용하는 파라미터는 생성 중인 빈 Amazon DocumentDB 클러스터(복제본)의 용량 유형 및 기타 세부 정보를 제어합니다. 1. [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) CLI 명령을 사용하여 복제본에 대한 Amazon DocumentDB 인스턴스를 생성하여 복원된 Amazon DocumentDB 클러스터에서 Amazon DocumentDB 인스턴스를 다시 생성합니다. 다음 명령은 AWS CLI 가 AWS 리전을 기본값으로 설정한다고 가정합니다. 이 방식을 사용하면 각 명령에서 `--region` 이름을 전달하지 않아도 됩니다. 자세한 내용은 [AWS CLI구성](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) 섹션을 참조하세요. 다음 각 CLI 명령에서 `--region`을 지정할 수도 있습니다. **Topics** **복제본 생성** `[restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html)` CLI 명령으로 전달하는 특정 파라미터는 다양합니다. 전달하는 항목은 생성하려는 복제본 유형에 따라 다릅니다. 다음 절차를 사용하여 프로비저닝된 Amazon DocumentDB 클러스터에서 프로비저닝된 Amazon DocumentDB 복제본을 생성할 수 있습니다. **소스 Amazon DocumentDB 클러스터와 동일한 엔진 모드의 복제본을 생성하려면** + `[restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html)` CLI 명령을 사용하여 다음 파라미터에 대한 값을 지정합니다. + `--db-cluster-identifier` - 복제본에 대해 의미 있는 이름을 선택합니다. 복제본의 이름을 지정할 때 [restore-db-cluster-to-point-in-time](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-to-point-in-time.html) CLI 명령을 사용합니다. + `--restore-type` – `copy-on-write`을(를) 사용하여 소스 DB 클러스터의 복제본을 생성합니다. 이 파라미터가 없으면 `restore-db-cluster-to-point-in-time`은 복제본을 생성하는 대신 Amazon DocumentDB 클러스터를 복원합니다. `restore-type` 기본값은 `full-copy`입니다. + `--source-db-cluster-identifier` - 복제할 소스 Amazon DocumentDB 클러스터의 이름을 사용합니다. + `--use-latest-restorable-time` - 이 값은 복제본에 대해 복원 가능한 최신 볼륨 데이터를 가리킵니다. 이 매개변수는 필수 `restore-type copy-on-write` 매개변수이지만 `restore-to-time parameter`를 함께 사용할 수는 없습니다. 다음 예제에서는 `my-source-cluster`라는 이름의 클러스터에서 `my-clone`라는 이름의 복제본을 생성합니다. Linux, macOS 또는 Unix의 경우: ``` aws docdb restore-db-cluster-to-point-in-time \ --source-db-cluster-identifier my-source-cluster \ --db-cluster-identifier my-clone \ --restore-type copy-on-write \ --use-latest-restorable-time ``` Windows의 경우: ``` aws docdb restore-db-cluster-to-point-in-time ^ --source-db-cluster-identifier my-source-cluster ^ --db-cluster-identifier my-clone ^ --restore-type copy-on-write ^ --use-latest-restorable-time ``` 이 명령은 복제본의 세부 사항을 포함하는 JSON 객체를 반환합니다. 복제본에 대한 DB 인스턴스를 생성하기 전에 복제된 DB 클러스터를 사용할 수 있는지 확인합니다. 자세한 내용은 아래의 상태 확인 및 복제본 세부 정보 가져오기를 참조하세요. **상태 확인 및 복제본 세부 정보 가져오기** 다음 명령을 사용하여 새로 생성된 빈 DB 클러스터의 상태를 확인할 수 있습니다. ``` $ aws docdb describe-db-clusters --db-cluster-identifier my-clone --query '*[].[Status]' --output text ``` 또는 다음 AWS CLI 쿼리를 사용하여 복제본의 DB 인스턴스를 생성하는 데 필요한 상태 및 기타 값을 얻을 수 있습니다. Linux, macOS, Unix의 경우: ``` aws docdb describe-db-clusters --db-cluster-identifier my-clone \ --query '*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}' ``` Windows의 경우: ``` aws docdb describe-db-clusters --db-cluster-identifier my-clone ^ --query "*[].{Status:Status,Engine:Engine,EngineVersion:EngineVersion}" ``` 이 쿼리는 다음과 비슷한 출력을 반환합니다. ``` [ { "Status": "available", "Engine": "docdb", "EngineVersion": "4.0.0", } ] ``` **복제본을 위한 Amazon DocumentDB 인스턴스 생성** [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html) CLI 명령을 사용하여 복제본에 대한 DB 인스턴스를 생성하세요. `--db-instance-class` 파라미터는 프로비저닝된 Amazon DocumentDB 클러스터에만 사용됩니다. Linux, macOS, Unix의 경우: ``` aws docdb create-db-instance \ --db-instance-identifier my-new-db \ --db-cluster-identifier my-clone \ --db-instance-class db.r5.4xlarge \ --engine docdb ``` Windows의 경우: ``` aws docdb create-db-instance ^ --db-instance-identifier my-new-db ^ --db-cluster-identifier my-clone ^ --db-instance-class db.r5.4xlarge ^ --engine docdb ``` **복제본에 사용할 파라미터** 다음 표에는 `restore-db-cluster-to-point-in-time`에서 Amazon DocumentDB 클러스터를 복제하는 데 사용되는 다양한 파라미터가 요약되어 있습니다. | 파라미터 | 설명 | | --- | --- | | ---source-db-cluster-identifier | 복제할 소스 Amazon DocumentDB 클러스터의 이름을 사용합니다. | | --db-cluster-identifier | 복제본에 대해 의미 있는 이름을 선택합니다. ` restore-db-cluster-to-point-in-time` 명령으로 복제본의 이름을 지정합니다. 그런 다음 이 이름을 `create-db-instance` 명령으로 전달합니다. | | --restore-type | `copy-on-write`를 `--restore-type`로 지정하여 소스 Amazon DocumentDB 클러스터를 복원하는 대신 소스 DB 클러스터의 복제본을 생성합니다. | | --use-latest-restorable-time | 이 값은 복제본에 대해 복원 가능한 최신 볼륨 데이터를 가리킵니다. | ------ # Amazon DocumentDB 클러스터 내결함성에 대한 이해 Amazon DocumentDB 클러스터는 내결함성을 고려하여 설계되었습니다. 각 클러스터의 볼륨은 단일의 여러 가용 영역에 걸쳐 있으며 AWS 리전각 가용 영역에는 클러스터의 볼륨 데이터 사본이 포함됩니다. 이 기능은 가용 영역 한 곳에서 결함이 발생하더라도 클러스터가 잠시 서비스가 중단될 뿐 전혀 데이터 손실 없이 결함을 견딜 수 있음을 의미합니다. 클러스터의 기본 인스턴스에 결함이 발생하면 Amazon DocumentDB가 다음 두 가지 방법 중 하나를 사용하여 자동으로 새 기본 인스턴스로 장애 조치를 수행합니다. + 기존 Amazon DocumentDB 복제본을 각 복제본의 프로모션 티어 설정에 따라 선택된 새 기본 인스턴스로 승격한 다음 이전 기본 인스턴스의 대체 인스턴스를 생성합니다. 복제본 인스턴스로의 페일오버는 보통 30초도 걸리지 않습니다. 이 기간 동안에는 읽기 및 쓰기 작업이 잠시 중단될 수 있습니다. 클러스터의 가용성을 높이려면 최소 하나 이상의 Amazon DocumentDB 복제본을 둘 이상의 서로 다른 가용 영역에서 생성하는 것이 좋습니다. + 새로운 기본 인스턴스를 생성합니다. 이는 클러스터에 복제 인스턴스가 없는 경우에만 발생하며 완료하는 데 몇 분 정도 걸릴 수 있습니다. 클러스터에 Amazon DocumentDB 복제본이 하나 이상인 경우에는 장애가 발생하더라도 Amazon DocumentDB 복제본이 기본 인스턴스로 승격됩니다. 이 실패 이벤트로 인해 예외적으로 실패하는 읽기 및 쓰기 작업 동안 짧은 중단이 발생합니다. 하지만, 일반적인 서비스 복구 시간은 120초 미만이지만 대부분 60초 미만에 복원됩니다. 클러스터의 가용성을 높이려면 최소 하나 이상의 Amazon DocumentDB 복제본을 둘 이상의 서로 다른 가용 영역에서 생성하는 것이 좋습니다. 각 복제본에 우선 순위를 지정하여 장애 이후 기본 인스턴스로 승격할 Amazon DocumentDB 복제본 순서를 사용자 지정할 수 있습니다. 우선 순위 범위는 가장 높은 값인 0부터 가장 낮은 값인 15까지입니다. 기본 인스턴스에 결함이 발생하면 우선 순위가 가장 높은 Amazon DocumentDB 복제본을 새로운 기본 인스턴스로 승격시킵니다. Amazon DocumentDB 복제본의 우선 순위는 언제든지 수정할 수 있습니다. 우선 순위 수정으로 인해 장애 조치가 트리거되지는 않습니다. `modify-db-instance` 연산을 `--promotion-tier` 파라미터와 함께 사용할 수 있습니다. 인스턴스의 장애 조치 우선 순위를 사용자 지정하는 방법에 대한 자세한 내용은 [Amazon DocumentDB 장애 조치](failover.md) 섹션을 참조하세요. 둘 이상의 Amazon DocumentDB 복제본이 동일한 우선 순위를 공유하여 승격 계층을 만들 수도 있습니다. 둘 이상의 Amazon DocumentDB 복제본이 동일한 우선 순위를 공유하면 크기가 가장 큰 복제본이 기본 복제본으로 승격됩니다. 둘 이상의 Amazon DocumentDB 복제본이 동일한 우선 순위와 크기를 공유하면 동일한 승격 티어에서 임의의 복제본이 승격됩니다. 클러스터에 Amazon DocumentDB 복제본이 포함되어 있지 않으면 기본 인스턴스가 실패 이벤트 중에 다시 생성됩니다. 이 실패 이벤트로 인해 예외적으로 실패하는 읽기 및 쓰기 작업 동안 중단이 발생합니다. 새로운 기본 인스턴스가 생성도면 서비스도 복구되지만 보통 10분 미만의 시간이 걸립니다. Amazon DocumentDB 복제본을 기본 인스턴스로 승격시키는 것이 기본 인스턴스를 새로 생성하는 것보다 훨씬 빠릅니다.