기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Amazon DocumentDB 탄력적 클러스터 관리 Amazon DocumentDB 엘라스틱 클러스터를 관리하려면 적절한 Amazon DocumentDB 컨트롤 플레인 권한이 있는 IAM 정책이 있어야 합니다. 이러한 권한은 클러스터를 생성, 수정 및 삭제하도록 허용합니다. Amazon DocumentDBFullAccess 정책은 Amazon DocumentDB 엘라스틱 클러스터를 관리하는 데 필요한 모든 권한을 제공합니다. 다음 항목에서는 Amazon DocumentDB 엘라스틱 클러스터로 작업할 때 다양한 작업을 수행하는 방법을 보여줍니다. **Topics** + [엘라스틱 클러스터 구성 수정](#elastic-modify) + [엘라스틱 클러스터 모니터링](#elastic-monitor) + [엘라스틱 클러스터 삭제](#elastic-delete) + [엘라스틱 클러스터 스냅샷 관리](elastic-manage-snapshots.md) + [Amazon DocumentDB 탄력적 클러스터 중지 및 시작](elastic-cluster-stop-start.md) + [Amazon DocumentDB 탄력적 클러스터 유지 관리](elastic-cluster-maintenance.md) ## 엘라스틱 클러스터 구성 수정 이 섹션에서는 다음 지침에 따라 AWS Management Console 또는를 사용하여 탄력 AWS CLI 적 클러스터를 수정하는 방법을 설명합니다. 클러스터를 수정하는 주된 용도는 샤드 카운트 및/또는 샤드 컴퓨팅 용량을 늘리거나 줄임으로써 샤드를 확장하는 것입니다. ------ #### [ Using the AWS Management Console ] 를 사용하여 탄력적 클러스터 구성을 수정하려면 AWS Management Console: 1. [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)에 로그인하고 Amazon DocumentDB 콘솔을 엽니다. 1. 탐색 창에서 **클러스터**를 선택합니다. **작은 정보** 화면 왼쪽에 탐색 창이 보이지 않으면 탐색 창의 왼쪽 상단 모서리에 있는 메뉴 아이콘을 선택합니다. 1. **클러스터 식별자** 열에서 수정할 클러스터의 이름을 선택합니다. 1. **수정**을 선택합니다. 1. 변경하려는 필드를 편집한 다음 **클러스터 수정**을 선택합니다. ![\[오른쪽 하단의 클러스터 수정 버튼을 사용하여 수정할 수 있는 구성, 유지 관리, 인증 및 네트워크 설정 옵션을 보여주는 양식입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/cluster-shard-modify-3.png) **참고** 또는 **클러스터** 페이지로 이동하여 클러스터 옆의 확인란을 선택한 다음 **작업**, **수정**을 선택하여 **클러스터 수정** 대화 상자에 액세스할 수 있습니다. ------ #### [ Using the AWS CLI ] 를 사용하여 탄력적 클러스터 구성을 수정하려면 다음 파라미터와 함께 `update-cluster` 작업을 AWS CLI사용합니다. + **--cluster-arn** - 필수입니다. 수정하려는 클러스터의 ARN 식별자입니다. + **--shard-capacity** - 선택 사항. 각 샤드에 할당된 vCPU 개수입니다. 최대값은 64입니다. 허용되는 값은 2, 4, 8, 16, 32, 64입니다. + **--shard-count** - 선택 사항. 클러스터에 할당된 샤드 개수입니다. 최대 값은 32입니다. + **--shard-instance**-수 - 선택 사항입니다. 이 클러스터의 모든 샤드에 적용되는 복제본 인스턴스 수입니다. 최대 값은 16입니다. + **--auth-type** - 선택 사항. 엘라스틱 클러스터에 액세스하는 데 사용되는 암호를 가져올 위치를 결정하는 데 사용되는 인증 유형입니다. 유효한 형식은 `PLAIN_TEXT` 또는 `SECRET_ARN`입니다. + **--admin-user-password** - 선택 사항. 관리자 사용자와 연결된 암호입니다. + **--vpc-security-group-ids** - 선택 사항. 클러스터와 연결할 Amazon EC2 및 Amazon Virtual Private Cloud(Amazon VPC) 보안 그룹의 목록을 구성합니다. + **--preferred-maintenance-window** - 선택 사항. 시스템 유지보수가 수행될 수 있는 주간 시간 범위를 UTC(Universal Coordinated Time)로 구성합니다 형식은 `ddd:hh24:mi-ddd:hh24:mi`입니다. 유효한 요일(ddd): 월, 화, 수, 목, 금, 토, 일 기본값은 각 Amazon Web Services Region(아마존 웹 서비스 리전)의 8시간 블록에서 임의로 선택된 30분 창으로, 주 마다 임의의 요일에 발생합니다. 최소 30분의 시간. + **--subnet-ids** - 선택 사항. 네트워크 서브넷 ID를 구성합니다. 다음 예제에서는 자신의 정보로 각각의 *사용자 입력 자리 표시자*를 바꿉니다. Linux, macOS 또는 Unix의 경우: ``` aws docdb-elastic update-cluster \ --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \ --shard-capacity 8 \ --shard-count 4 \ --shard-instance-count 3 \ --admin-user-password testPassword \ --vpc-security-group-ids ec-65f40350 \ --subnet-ids subnet-9253c6a3, subnet-9f1b5af9 ``` Windows의 경우: ``` aws docdb-elastic update-cluster ^ --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^ --shard-capacity 8 ^ --shard-count 4 ^ --shard-instance-count 3 ^ --admin-user-password testPassword ^ --vpc-security-group-ids ec-65f40350 ^ --subnet-ids subnet-9253c6a3, subnet-9f1b5af9 ``` ------ 수정 후 엘라스틱 클러스터의 상태를 모니터링하려면 엘라스틱 클러스터 모니터링을 참조하세요. ## 엘라스틱 클러스터 모니터링 이 섹션에서는 AWS CLI 다음 지침에 따라 AWS Management Console 또는를 사용하여 탄력적 클러스터를 모니터링하는 방법을 설명합니다. ------ #### [ Using the AWS Management Console ] 를 사용하여 탄력적 클러스터 구성을 모니터링하려면 AWS Management Console: 1. [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)에 로그인하고 Amazon DocumentDB 콘솔을 엽니다. 1. 탐색 창에서 **클러스터**를 선택합니다. **작은 정보** 화면 왼쪽에 탐색 창이 보이지 않으면 탐색 창의 왼쪽 상단 모서리에 있는 메뉴 아이콘을 선택합니다. 1. **클러스터 식별자** 열에서 모니터링할 클러스터의 이름을 선택합니다. 1. **모니터링** 탭을 선택합니다. ![\[모니터링 탭에 표시된 탄력적 클러스터 요약 정보입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/cluster-shard-monitor-2.png) Amazon CloudWatch의 여러 차트가 다음과 같은 모니터링 카테고리에 대해 표시됩니다. + 리소스 사용률 + 처리량 + 운영 + 시스템 를 통해 Amazon CloudWatch에 액세스 AWS Management Console 하여 탄력적 클러스터에 대한 자체 모니터링 환경을 설정할 수도 있습니다. ------ #### [ Using the AWS CLI ] 를 사용하여 특정 탄력적 클러스터 구성을 모니터링하려면 다음 파라미터와 함께 `get-cluster` 작업을 AWS CLI사용합니다. + **--cluster-arn** - 필수입니다. 정보를 원하는 클러스터의 ARN 식별자입니다. 다음 예제에서는 자신의 정보로 각각의 *사용자 입력 자리 표시자*를 바꿉니다. Linux, macOS 또는 Unix의 경우: ``` aws docdb-elastic get-cluster \ --cluster-arn arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9 ``` Windows의 경우: ``` aws docdb-elastic get-cluster ^ --cluster-arn arn:aws:docdb:-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9 ``` 이 작업의 출력은 다음과 같이 표시됩니다. ``` "cluster": { ... "clusterArn": "arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9", "clusterEndpoint": "stretch-11-477568257630.us-east-1.docdb-elastic.amazonaws.com", "readerEndpoint": "stretch-11-477568257630-ro.us-east-1.docdb-elastic.amazonaws.com", "clusterName": "stretch-11", "shardCapacity": 2, "shardCount": 3, "shardInstanceCount: 5, "status": "ACTIVE", ... } ``` 자세한 내용은 Amazon DocumentDB 리소스 관리 API 참조에서 `DescribeClusterSnapshot` 섹션을 참조하세요. 를 사용하여 모든 탄력적 클러스터의 세부 정보를 보려면 다음 파라미터와 함께 `list-clusters` 작업을 AWS CLI사용합니다. + **--next-token** - 선택 사항. 출력 항목 수(`--max-results`)가 기본 API 호출에서 반환하는 전체 항목 수보다 적을 경우 사용자가 다음 항목 세트를 검색하기 위해 후속 명령에 전달할 수 있도록 출력에 `NextToken`이 포함됩니다. + **--max-results** - 선택 사항. 명령의 출력에서 반환되는 항목의 총 수입니다. 지정된 `max-results` 값보다 레코드 수가 많으면 페이지 매김 토큰(`next-token`)을 응답에 포함시켜 나머지 결과를 검색할 수 있도록 합니다. + 기본값: 100 + 최소: 20 최대: 100 다음 예제에서는 자신의 정보로 각각의 *사용자 입력 자리 표시자*를 바꿉니다. Linux, macOS 또는 Unix의 경우: ``` aws docdb-elastic list-clusters \ --next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== \ --max-results 2 ``` Windows의 경우: ``` aws docdb-elastic list-clusters ^ --next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== ^ --max-results 2 ``` 이 작업의 출력은 다음과 같습니다. ``` { "Clusters": [ { "ClusterIdentifier":"mycluster-1", "ClusterArn":"arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster" "Status":"available", "ClusterEndpoint":"sample-cluster.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com" } { "ClusterIdentifier":"mycluster-2", "ClusterArn":"arn:aws:docdb:us-west-2:987654321098:sharded-cluster:sample-cluster" "Status":"available", "ClusterEndpoint":"sample-cluster2.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com" } ] } ``` ------ ## 엘라스틱 클러스터 삭제 이 섹션에서는 다음 지침과 AWS CLI 함께 AWS Management Console 또는를 사용하여 탄력적 클러스터를 삭제하는 방법을 설명합니다. ------ #### [ Using the AWS Management Console ] AWS Management Console을 사용하여 엘라스틱 클러스터 구성을 삭제하려면: 1. [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)에 로그인하고 Amazon DocumentDB 콘솔을 엽니다. 1. 탐색 창에서 **클러스터**를 선택합니다. **작은 정보** 화면 왼쪽에 탐색 창이 보이지 않으면 탐색 창의 왼쪽 상단 모서리에 있는 메뉴 아이콘을 선택합니다. 1. 클러스터 목록 테이블에서 삭제할 클러스터 이름의 왼쪽에 있는 확인란을 선택한 다음 **작업**을 선택합니다. 드롭다운 메뉴에서 **삭제**를 선택합니다. 1. **"클러스터 이름" 엘라스틱 클러스터를 삭제하시겠습니까?** 대화 상자에서 **삭제**를 선택합니다. ![\[오른쪽 하단에 삭제 버튼이 있는 삭제 대화 상자입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/cluster-delete-dialog.png) 클러스터를 삭제하는 데 몇 분 정도 걸립니다. 클러스터 상태를 모니터링하려면 [Amazon DocumentDB 클러스터 상태 모니터링](https://docs.aws.amazon.com//documentdb/latest/developerguide/monitoring_docdb-cluster_status.html)을 참조하십시오. ------ #### [ Using the AWS CLI ] 를 사용하여 탄력적 클러스터를 삭제하려면 다음 파라미터와 함께 `delete-cluster` 작업을 AWS CLI사용합니다. + **--cluster-arn** - 필수입니다. 삭제하려는 클러스터의 ARN 식별자입니다. + **--no-skip-final-backup** - 선택 사항. 최종 백업을 원하는 경우, 최종 백업의 이름과 함께 이 파라미터를 포함해야 합니다. `--final-backup-identifier` 또는 `--skip-final-backup`를 포함시켜야 합니다. + **--skip-final-backup** - 선택 사항. 클러스터를 삭제하기 전에 최종 백업을 수행하지 않을 경우에만 이 파라미터를 사용합니다. 기본 설정은 최종 스냅샷을 생성하는 것입니다. 다음 AWS CLI 코드 예제에서는 ARN이 arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster이고 최종 백업이 있는 클러스터를 삭제합니다. 다음 예제에서는 자신의 정보로 각각의 *사용자 입력 자리 표시자*를 바꿉니다. Linux, macOS, Unix의 경우: ``` aws docdb-elastic delete-cluster \ --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \ --no-skip-final-backup \ --final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ``` Windows의 경우: ``` aws docdb-elastic delete-cluster ^ --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^ --no-skip-final-backup ^ --final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ``` 다음 AWS CLI 코드 예제에서는 ARN이 arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster인 클러스터를 최종 백업 없이 삭제합니다. 다음 예제에서는 자신의 정보로 각각의 *사용자 입력 자리 표시자*를 바꿉니다. Linux, macOS 또는 Unix의 경우: ``` aws docdb-elastic delete-cluster \ --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \ --skip-final-backup \ ``` Windows의 경우: ``` aws docdb-elastic delete-cluster ^ --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^ --skip-final-backup ^ ``` `delete-cluster` 작업의 출력은 삭제할 클러스터의 표시입니다. 클러스터를 삭제하는 데 몇 분 정도 걸립니다. 클러스터 상태를 모니터링하려면 [Amazon DocumentDB 클러스터 상태 모니터링](https://docs.aws.amazon.com/documentdb/latest/developerguide/monitoring_docdb-cluster_status.html)을 참조하십시오. ------ # 엘라스틱 클러스터 스냅샷 관리 수동 스냅샷은 엘라스틱 클러스터를 생성한 후에 만들 수 있습니다. 자동 백업은 탄력적 클러스터 스냅샷이 생성되는 즉시 생성됩니다. **참고** 수동 스냅샷을 생성하려면 엘라스틱 클러스터가 `Available` 상태에 있어야 합니다. 이 섹션에서는 엘라스틱 클러스터 스냅샷을 생성하고, 보고, 복원하고, 삭제하는 방법을 설명합니다. 다음 항목에서는 Amazon DocumentDB 엘라스틱 클러스터 스냅샷으로 작업할 때 다양한 작업을 수행하는 방법을 보여줍니다. **Topics** + [수동 클러스터 스냅샷 생성](#elastic-create-snapshot) + [엘라스틱 클러스터 스냅샷 보기](#elastic-view-snapshot) + [스냅샷에서 엘라스틱 클러스터 복원](#elastic-restore-snapshot) + [탄력적 클러스터 스냅샷 보기](#elastic-copy-snapshot) + [탄성 클러스터 스냅샷 삭제](#elastic-delete-snapshot) + [탄력적 클러스터 스냅샷 자동 백업 관리](#elastic-auto-snapshot) ## 수동 클러스터 스냅샷 생성 이 섹션에서는 다음 지침과 AWS CLI 함께 AWS Management Console 또는를 사용하여 수동 탄력적 클러스터 스냅샷을 생성하는 방법을 설명합니다. ------ #### [ Using the AWS Management Console ] AWS Management Console을 사용하여 수동 엘라스틱 클러스터 스냅샷을 만들려면: 1. [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)에 로그인하고 Amazon DocumentDB 콘솔을 엽니다. 1. 탐색 창에서 **스냅샷**을 선택합니다. **작은 정보** 화면 왼쪽에 탐색 창이 보이지 않으면 탐색 창의 왼쪽 상단 모서리에 있는 메뉴 아이콘을 선택합니다. 1. **스냅샷** 페이지에서 **생성**을 선택합니다. 1. **클러스터 스냅샷 생성** 페이지의 **클러스터 식별자** 필드에 있는 드롭다운 목록에서 탄력적 클러스터를 선택합니다. **스냅샷 식별자** 필드에 엘라스틱 클러스터의 고유 식별자를 입력합니다. **생성(Create)**을 선택합니다. ![\[다이어그램: 엘라스틱 클러스터 생성 스냅샷\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/elastic-create-snapshot.png) **참고** 또는 **클러스터** 페이지로 이동하여 클러스터 옆의 확인란을 선택한 다음 **작업**, **스냅샷 찍기**를 선택하여 **클러스터 스냅샷 생성** 대화 상자에 액세스할 수 있습니다. 이제 엘라스틱 클러스터 스냅샷이 프로비저닝 중입니다. 이 과정은 완료하는 데 최대 수 분 소요될 수 있습니다. **스냅샷** 목록에 상태가 `Available`로 표시될 때 스냅샷을 보고 복원할 수 있습니다. ------ #### [ Using the AWS CLI ] 를 사용하여 수동 탄력적 클러스터 스냅샷을 생성하려면 다음 파라미터와 함께 `create-cluster-snapshot` 작업을 AWS CLI사용합니다. + **--snapshot-name** - 필수입니다. 생성할 클러스터 스냅샷의 이름입니다. + **--cluster-arn** - 필수입니다. 스냅샷을 생성하고자 하는 클러스터의 ARN 식별자입니다. 다음 예제에서는 자신의 정보로 각각의 *사용자 입력 자리 표시자*를 바꿉니다. Linux, macOS 또는 Unix의 경우: ``` aws docdb-elastic create-cluster-snapshot \ --snapshot-name sample-snapshot-1 \ --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ``` Windows의 경우: ``` aws docdb-elastic create-cluster-snapshot ^ --snapshot-name sample-snapshot-1 ^ --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ``` ------ ## 엘라스틱 클러스터 스냅샷 보기 이 섹션에서는 다음 지침에 따라 AWS Management Console 또는를 사용하여 탄력 AWS CLI 적 클러스터 스냅샷 정보를 보는 방법을 설명합니다. ------ #### [ Using the AWS Management Console ] 를 사용하여 특정 탄력적 클러스터 스냅샷에 대한 정보를 보려면 AWS Management Console: 1. [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)에 로그인하고 Amazon DocumentDB 콘솔을 엽니다. 1. 탐색 창에서 **스냅샷**을 선택합니다. **작은 정보** 화면 왼쪽에 탐색 창이 보이지 않으면 탐색 창의 왼쪽 상단 모서리에 있는 메뉴 아이콘을 선택합니다. 1. **스냅샷** 페이지에서 **스냅샷 식별자** 열에 있는 이름을 클릭하여 목록에서 스냅샷을 선택합니다. 1. **세부 정보**에서 스냅샷 정보를 확인하세요. ![\[다이어그램: 엘라스틱 클러스터 보기 스냅샷\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/elastic-snapshot-view.png) ------ #### [ Using the AWS CLI ] 를 사용하여 특정 탄력적 클러스터 스냅샷에 대한 정보를 보려면 다음 파라미터와 함께 `get-cluster-snapshot` 작업을 AWS CLI사용합니다. + **--snapshot-arn** - 필수입니다. 정보를 원하는 스냅샷의 ARN 식별자입니다. 다음 예제에서는 자신의 정보로 각각의 *사용자 입력 자리 표시자*를 바꿉니다. Linux, macOS 또는 Unix의 경우: ``` aws docdb-elastic get-cluster-snapshot \ --snapshot-arn sampleResourceName ``` Windows의 경우: ``` aws docdb-elastic get-cluster-snapshot ^ --snapshot-arn sampleResourceName ``` 를 사용하여 특정 탄력적 클러스터 스냅샷에 대한 정보를 보려면 다음 파라미터와 함께 `get-cluster-snapshot` 작업을 AWS CLI사용합니다. + **--snapshot-arn** - 필수입니다. 정보를 원하는 스냅샷의 ARN 식별자입니다. 다음 예제에서는 자신의 정보로 각각의 *사용자 입력 자리 표시자*를 바꿉니다. Linux, macOS 또는 Unix의 경우: ``` aws docdb-elastic get-cluster-snapshot \ --snapshot-arn sampleResourceName ``` Windows의 경우: ``` aws docdb-elastic get-cluster-snapshot ^ --snapshot-arn sampleResourceName ``` 를 사용하여 모든 탄력적 클러스터 스냅샷에 대한 정보를 보려면 다음 파라미터와 함께 `list-cluster-snapshots` 작업을 AWS CLI사용합니다. + **--snapshot-type** - 선택 사항. 반환되는 클러스터 스냅샷의 유형입니다. 다음 값 중 하나를 지정할 수 있습니다. + `automated` - Amazon DocumentDB가 AWS 계정에 대해 자동으로 생성한 모든 클러스터 스냅샷을 반환합니다. + `manual` - AWS 계정에 대해 수동으로 생성한 모든 클러스터 스냅샷을 반환합니다. + `shared` - AWS 계정에 공유된 모든 수동 클러스터 스냅샷을 반환합니다. + `public` - 퍼블릭으로 표시된 모든 클러스터 스냅샷을 모두 반환합니다. + **--next-token** - 선택 사항. 이전의 요청에서 제공된 선택적 페이지 매김 토큰입니다. 이 파라미터를 지정한 경우, 이 토큰 이후부터 `max-results`에 지정된 값까지의 레코드만 응답에 포함됩니다. + **--max-results** - 선택 사항. 응답에 포함되는 최대 결과 수입니다. 지정된 `max-results` 값보다 레코드 수가 많으면 페이지 매김 토큰(`next-token`)을 응답에 포함시켜 나머지 결과를 검색할 수 있도록 합니다. + 기본값: 100 + 최소: 20 최대: 100 다음 예제에서는 자신의 정보로 각각의 *사용자 입력 자리 표시자*를 바꿉니다. Linux, macOS 또는 Unix의 경우: ``` aws docdb-elastic list-cluster-snapshots \ --snapshot-type value \ --next-token value \ --max-results 50 ``` Windows의 경우: ``` aws docdb-elastic list-cluster-snapshots ^ --snapshot-type value ^ --next-token value ^ --max-results 50 ``` ------ ## 스냅샷에서 엘라스틱 클러스터 복원 이 섹션에서는 AWS CLI 다음 지침에 따라 AWS Management Console 또는를 사용하여 스냅샷에서 탄력적 클러스터를 복원하는 방법을 설명합니다. ------ #### [ Using the AWS Management Console ] AWS Management Console를 사용하여 스냅샷에서 엘라스틱 클러스터 복원: 1. [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)에 로그인하고 Amazon DocumentDB 콘솔을 엽니다. 1. 탐색 창에서 **스냅샷**을 선택합니다. **작은 정보** 화면 왼쪽에 탐색 창이 보이지 않으면 탐색 창의 왼쪽 상단 모서리에 있는 메뉴 아이콘을 선택합니다. 1. **스냅샷 식별자** 열에서 클러스터 복원에 사용하려는 스냅샷 왼쪽에 있는 버튼을 선택합니다. 1. **작업**을 선택한 다음, **복원**을 선택합니다. ![\[다이어그램: 스냅샷에서 엘라스틱 클러스터 복원\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/elastic-restore-snapshot.png) 1. **스냅샷 복원** 페이지의 **클러스터 식별자** 필드에 새 클러스터의 이름을 입력합니다. **참고** 수동 스냅샷 복원의 경우 새 클러스터를 생성해야 합니다. 1. **가상 프라이빗 클라우드(VPC)** 필드에서 드롭다운 목록 중 VPC를 선택합니다. 1. **서브넷** 및 **VPC 보안** 그룹의 경우 기본값을 사용하거나 원하는 서브넷 3개와 VPC 보안 그룹 최대 3개 (최소 1개) 를 선택할 수 있습니다. 1. 클러스터 구성이 마음에 들면 **클러스터 복원**을 선택하고 클러스터가 복원되는 동안 기다립니다. ------ #### [ Using the AWS CLI ] 를 사용하여 스냅샷에서 탄력적 클러스터를 복원하려면 다음 파라미터와 함께 `restore-cluster-from-snapshot` 작업을 AWS CLI사용합니다. + **--cluster-name** - 필수입니다. 생성시 입력했거나 마지막으로 수정한 엘라스틱 클러스터의 현재 이름. + **--snapshot-arn** - 필수입니다. 클러스터를 복원하는 데 사용되는 스냅샷의 ARN 식별자입니다. + **--vpc-security-group-ids** - 선택 사항. 클러스터와 연결할 Amazon EC2 및 and Amazon Virtual Private Cloud(Amazon VPC) 보안 그룹의 목록을 구성합니다. + **--kms-key-id** - 선택 사항. 암호화된 클러스터의 KMS 키 식별자를 구성하세요. KMS 키 식별자는 AWS KMS 암호화 키의 Amazon 리소스 이름(ARN)입니다. 새 클러스터를 암호화하는 데 사용되는 KMS 암호화 키를 소유한 동일한 Amazon Web Services 계정을 사용하여 클러스터를 생성하는 경우, KMS 암호화 키에 대한 ARN 대신 KMS 키 별칭을 사용할 수 있습니다. 암호화 키가 KmsKeyId에 지정되어 있지 않고 `StorageEncrypted` 파라미터가 참이면 Amazon DocumentDB는 기본 암호화 키를 사용합니다. + **--subnet-ids** - 선택 사항. 네트워크 서브넷 ID. 다음 예제에서는 자신의 정보로 각각의 *사용자 입력 자리 표시자*를 바꿉니다. Linux, macOS, Unix의 경우: ``` aws docdb-elastic restore-cluster-from-snapshot \ --cluster-name elastic-sample-cluster \ --snapshot-arn sampleResourceName \ --vpc-security-group-ids value ec-65f40350 \ --kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \ --subnet-ids subnet-9253c6a3, subnet-9f1b5af9 ``` Windows의 경우: ``` aws docdb-elastic restore-cluster-from-snapshot ^ --cluster-name elastic-sample-cluster ^ --snapshot-arn sampleResourceName ^ --vpc-security-group-ids value ec-65f40350 ^ --kms-key-id arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^ --subnet-ids subnet-9253c6a3, subnet-9f1b5af9 ``` ------ ## 탄력적 클러스터 스냅샷 보기 Amazon DocumentDB에서는 동일한 리전 및 동일한 계정 내의 수동 및 자동 탄력적 클러스터 스냅샷을 복사할 수 있습니다. 이 섹션에서는 AWS Management Console 또는를 사용하여 탄력적 클러스터 스냅샷을 복사하는 방법을 설명합니다 AWS CLI. ------ #### [ Using the AWS Management Console ] 를 사용하여 탄력적 클러스터 스냅샷을 복사하려면 AWS Management Console: 1. [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)에 로그인하고 Amazon DocumentDB 콘솔을 엽니다. 1. 탐색 창에서 **스냅샷**을 선택합니다. **작은 정보** 화면 왼쪽에 탐색 창이 보이지 않으면 탐색 창의 왼쪽 상단 모서리에 있는 메뉴 아이콘을 선택합니다. 1. **스냅샷 식별자** 열에서 복사하려는 스냅샷 왼쪽에 있는 버튼을 선택합니다. 1. **작업**, **복사** 순으로 선택합니다. ![\[다이어그램: 탄력적 클러스터 복사 스냅샷\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/ec-copy-snapshot.png) 1. **새 스냅샷 식별자**의 경우 새 스냅샷의 이름을 입력합니다. 1. **태그 복사**에서 소스 탄력적 클러스터 스냅샷의 모든 태그를 대상 탄력적 클러스터 스냅샷으로 복사하려면 확인란을 선택합니다. 1. **암호화**에서 기본 AWS KMS 키 또는 원하는 KMS 키를 선택합니다. 두 번째 옵션을 사용하면 이미 생성한 기존 KMS 키를 선택하거나 새 키를 생성할 수 있습니다. 1. 완료되면 **스냅샷 복사**를 선택합니다. ------ #### [ Using the AWS CLI ] 를 사용하여 탄력적 클러스터 스냅샷을 복사하려면 다음 파라미터와 함께 `copy-cluster-snapshot` 작업을 AWS CLI사용합니다. + **‐‐source-db-cluster-snapshot-identifier** - 필수입니다. 복사되는 기존 탄력적 클러스터 스냅샷의 식별자. 탄력적 클러스터 스냅샷이 있어야 하며 사용 가능한 상태여야 합니다. 이 파라미터는 대소문자를 구분하지 않습니다. + **‐‐target-db-cluster-snapshot-identifier** - 필수입니다. 기존의 탄력적 클러스터 스냅샷에서 생성할 새 탄력적 클러스터 스냅샷의 식별자입니다. 이 파라미터는 대소문자를 구분하지 않습니다. 대상 스냅샷 명명 제약 조건: + 기본 스냅샷의 이름일 수 없습니다. + 길이는 [1\$163]글자, 숫자 또는 하이픈입니다. + 첫 번째 문자는 글자이어야 합니다. + 하이픈으로 끝나거나 하이픈이 2개 연속으로 포함되어서는 안 됩니다. 다음 예제에서는 자신의 정보로 각각의 *사용자 입력 자리 표시자*를 바꿉니다. Linux, macOS 또는 Unix의 경우: ``` aws docdb-elastic copy-cluster-snapshot \ ‐‐source-cluster-snapshot-arn \ ‐‐target-cluster-snapshot-name my-target-copied-snapshot ``` Windows의 경우: ``` aws docdb-elastic copy-cluster-snapshot ^ ‐‐source-cluster-snapshot-arn ^ ‐‐target-cluster-snapshot-name my-target-copied-snapshot ``` ------ ## 탄성 클러스터 스냅샷 삭제 이 섹션에서는 AWS Management Console 또는를 사용하여 탄력적 클러스터 스냅샷을 삭제하는 방법을 설명합니다 AWS CLI. ------ #### [ Using the AWS Management Console ] AWS Management Console를 사용하여 스냅샷에서 엘라스틱 클러스터 복원: 1. [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)에 로그인하고 Amazon DocumentDB 콘솔을 엽니다. 1. 탐색 창에서 **스냅샷**을 선택합니다. **작은 정보** 화면 왼쪽에 탐색 창이 보이지 않으면 탐색 창의 왼쪽 상단 모서리에 있는 메뉴 아이콘을 선택합니다. 1. **스냅샷 식별자** 열에서 클러스터 복원에 사용하려는 스냅샷 왼쪽에 있는 버튼을 선택합니다. 1. **작업**을 선택한 다음 **삭제**를 선택합니다. ![\[다이어그램: 엘라스틱 클러스터 삭제 스냅샷\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/elastic-delete-snapshot.png) 1. **"스냅샷 이름" 스냅샷 삭제** 대화 상자에서 **삭제**를 선택합니다. ------ #### [ Using the AWS CLI ] 를 사용하여 탄력적 클러스터 스냅샷을 삭제하려면 다음 파라미터와 함께 `delete-cluster-snapshot` 작업을 AWS CLI사용합니다. + **--snapshot-arn** - 필수입니다. 클러스터를 복원하는 데 사용되는 스냅샷의 ARN 식별자입니다. 다음 예제에서는 자신의 정보로 각각의 *사용자 입력 자리 표시자*를 바꿉니다. Linux, macOS, Unix의 경우: ``` aws docdb-elastic delete-cluster-snapshot \ --snapshot-arn sampleResourceName ``` Windows의 경우: ``` aws docdb-elastic delete-cluster-snapshot ^ --snapshot-arn sampleResourceName ``` ------ ## 탄력적 클러스터 스냅샷 자동 백업 관리 Amazon DocumentDB는 탄력적 클러스터의 일일 스냅샷을 생성합니다. 새 탄력적 클러스터 또는 기존 탄력적 클러스터 스냅샷 구성에서 기본 백업 기간과 백업 보존 기간을 지정할 수 있습니다. 이 섹션에서는 AWS Management Console 또는를 사용하여 탄력적 클러스터 스냅샷에서 자동 백업 파라미터를 설정하는 방법을 설명합니다 AWS CLI. ------ #### [ Using the AWS Management Console ] 를 사용하여 새 탄력적 클러스터 스냅샷에 대한 자동 백업을 설정하려면 AWS Management Console: 1. [AWS Management Console](https://console.aws.amazon.com/docdb/home?region=us-east-1)에 로그인하고 Amazon DocumentDB 콘솔을 엽니다. 1. 탐색 창에서 **클러스터**를 선택합니다. **작은 정보** 화면 왼쪽에 탐색 창이 보이지 않으면 탐색 창의 왼쪽 상단 모서리에 있는 메뉴 아이콘을 선택합니다. 1. **클러스터 식별자** 열에서 백업 설정을 변경할 클러스터 왼쪽의 버튼을 선택합니다. 1. **작업(Actions)**, **수정(Modify)**을 선택합니다. 1. **백업** 섹션에서 백업 요구 사항에 따라 필드를 편집합니다. ![\[클러스터 백업 기간을 구성하는 단계를 보여주는 백업 창의 스크린샷\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/ec-backup.png) 1. **백업 보존 기간** - 목록에서 이 클러스터의 자동 백업을 삭제하지 않고 유지하는 일 수를 선택합니다. 1. **백업 기간** - Amazon DocumentDB에서 이 클러스터를 백업하는 일별 시간과 기간을 설정합니다. 1. 백업이 생성되는 시간과 기간을 구성하려면 **창 선택**을 선택합니다. **시작 시간** - 첫 번째 목록에서 자동 백업 시작 시간(UTC)을 선택합니다. 두 번째 목록에서 자동 백업 시작 시간의 분을 선택합니다. **기간** - 목록에서 자동 백업 생성에 할당된 시간 수를 선택합니다. 1. Amazon DocumentDB가 백업이 생성되는 시간과 기간을 선택하도록 하려면 **기본 설정 없음**을 선택합니다. 1. 완료되면 **클러스터 수정**을 선택합니다. ------ #### [ Using the AWS CLI ] 를 사용하여 새 탄력적 클러스터 스냅샷에 대한 자동 백업을 설정하려면 다음 파라미터와 함께 `create-cluster-snapshot` 작업을 AWS CLI사용합니다. + **--preferred-backup-window** - 선택 사항. 자동 백업이 생성되는 일일 선호 시간 범위입니다. 기본값은 각각 8시간 블록 시간 중에서 임의로 선택한 30분 기간입니다 AWS 리전. 제약 조건: + `hh24:mi-hh24:mi` 형식이어야 합니다. + 협정 세계시(UTC)여야 합니다. + 원하는 유지 관리 기간과 충돌하지 않아야 합니다. + 30분 이상이어야 합니다. + **--backup-retention-period** - 선택 사항. 자동 백업이 보존되는 일수입니다. 기본값은 1입니다. 제약 조건: + 최소 1 이상의 값을 지정해야 합니다. + 범위는 1\$135여야 합니다. **참고** 자동 백업은 클러스터가 '활성' 상태인 경우에만 수행됩니다. **참고** `aws docdb-elastic update-cluster` 명령을 사용하여 기존 탄력적 클러스터의 `preferred-backup-window` 및 `backup-retention-period` 파라미터를 수정할 수도 있습니다. 다음은 자신의 정보를 각각의 *사용자 입력 자리 표시자*로 변경하는 예제입니다. 다음 `create-cluster` 예제에서는 자동 백업을 위한 보존 기간이 *7*일이고 기본 백업 기간이 *18:00\$118:30 UTC*인 Amazon DocumentDB 탄력적 클러스터 *샘플 클러스터*를 생성합니다. Linux, macOS, Unix의 경우: ``` aws docdb-elastic create-cluster \ --cluster-name sample-cluster \ --shard-capacity 2 \ --shard-count 2 \ --admin-user-name SampleAdmin \ --auth-type PLAIN_TEXT \ --admin-user-password SamplePass123! \ --preferred-backup-window 18:00-18:30 \ --backup-retention-period 7 ``` Windows의 경우: ``` aws docdb-elastic create-cluster ^ --cluster-name sample-cluster ^ --shard-capacity 2 ^ --shard-count 2 ^ --admin-user-name SampleAdmin ^ --auth-type PLAIN_TEXT ^ --admin-user-password SamplePass123! ^ --preferred-backup-window 18:00-18:30 ^ --backup-retention-period 7 ``` ------ # Amazon DocumentDB 탄력적 클러스터 중지 및 시작 Amazon DocumentDB 탄력적 클러스터를 중지하고 시작하면 개발 및 테스트 환경 비용을 관리하는 데 도움이 됩니다. 필요하지 않을 경우 Amazon DocumentDB를 사용할 때마다 탄력적 클러스터를 생성하고 삭제하는 대신 클러스터를 일시적으로 중지할 수 있습니다. 그런 다음 테스트를 재개할 때 다시 시작할 수 있습니다. **Topics** + [탄력적 DB 클러스터의 중지 및 시작 개요](#elastic-cluster-stop-start-overview) + [중지된 탄력적 클러스터에서 수행할 수 있는 작업](#elastic-cluster-stopped-operations) ## 탄력적 DB 클러스터의 중지 및 시작 개요 Amazon DocumentDB 탄력적 클러스터가 필요하지 않은 기간에는 이 클러스터를 중지할 수 있습니다. 그런 다음 사용해야 할 때는 언제든지 클러스터를 다시 시작할 수 있습니다. 시작 및 중지를 사용하면 개발, 테스트 또는 연속 가용성을 필요로 하지 않는 유사한 활동에 사용되는 탄력적 클러스터의 설정 및 해제 프로세스가 간소화됩니다. AWS Management Console 또는를 단일 작업 AWS CLI 으로 사용하여 탄력적 클러스터를 중지하고 시작할 수 있습니다. 탄력적 클러스터가 중지되는 동안 클러스터 스토리지 볼륨은 변경되지 않습니다. 지정된 보존 기간 내에는 스토리지, 수동 스냅샷 및 자동 백업 스토리지에 대한 비용만 청구됩니다. 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. 클러스터 목록에서 중지하거나 시작하려는 클러스터 이름의 왼쪽에 있는 버튼을 선택합니다. ![\[클러스터 이름 왼쪽에 있는 확인란이 선택된 클러스터 목록의 클러스터입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/cluster-list-ec.png) 1. **작업**을 선택한 다음 클러스터에서 수행하려는 작업을 선택합니다. + 클러스터를 중지하고 다음 작업을 수행합니다. 1. **중지**를 선택합니다. ![\[중지 옵션이 선택된 작업 드롭다운 목록입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/ec-stop.png) 1. 확인 대화 상자에서 **클러스터 중지**를 선택하여 탄력적 클러스터 중지를 확인하거나, 클러스터를 계속 실행하려면 **취소**를 선택합니다. ![\[하단에 클러스터 취소 및 중지 버튼이 있는 클러스터 중지 확인 대화 상자입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/ec-stop-confirm.png) + 클러스터를 시작하려면 클러스터가 중지된 상태에서 **시작**을 선택합니다. ![\[시작 옵션이 선택된 작업 드롭다운 목록입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/ec-start.png) 1. Elastic 클러스터의 상태를 모니터링합니다. 클러스터를 시작한 경우 클러스터를 *사용 가능*할 때 클러스터 사용을 다시 시작할 수 있습니다. 자세한 내용은 [클러스터 상태 확인](db-cluster-status.md) 단원을 참조하십시오. ![\[사용 가능한 상태와 시작 상태를 보여주는 클러스터 테이블의 상태 열입니다.\]](http://docs.aws.amazon.com/ko_kr/documentdb/latest/developerguide/images/ec-starting-status.png) ------ #### [ Using the AWS CLI ] 다음 절차에서는 활성 상태이거나 사용 가능한 상태인 탄력적 클러스터를 중지하거나, 중지된 탄력적 클러스터를 시작하는 방법을 보여 줍니다. 를 사용하여 엘라스틱 클러스터를 중지하려면 `stop-cluster` 작업을 AWS CLI사용합니다. 중지된 클러스터를 시작하려면 `start-cluster` 작업을 사용합니다. 두 작업은 `--cluster-arn` 파라미터를 사용합니다. **파라미터:** + **--cluster-arn** - 필수입니다. 중단하거나 시작하려는 탄력적 클러스터의 ARN 식별자입니다. **Example -를 사용하여 탄력적 클러스터를 중지하려면 AWS CLI** 다음은 자신의 정보를 각각의 *사용자 입력 자리 표시자*로 변경하는 예제입니다. 다음 코드는 ARN이 `arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2`인 탄력적 클러스터를 중지합니다. 탄력적 클러스터가 활성 상태거나 사용 가능 상태여야 합니다. Linux, macOS, Unix의 경우: ``` aws docdb-elastic stop-cluster \ --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ``` Windows의 경우: ``` aws docdb-elastic stop-cluster ^ --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ``` **Example -를 사용하여 탄력적 클러스터를 시작하려면 AWS CLI** 다음은 자신의 정보를 각각의 *사용자 입력 자리 표시자*로 변경하는 예제입니다. 다음 코드는 ARN이 `arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2`인 탄력적 클러스터를 시작합니다. 탄력적 클러스터는 현재 중지된 상태여야 합니다. Linux, macOS, Unix의 경우: ``` aws docdb-elastic start-cluster \ --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ``` Windows의 경우: ``` aws docdb-elastic start-cluster ^ --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ``` ------ ## 중지된 탄력적 클러스터에서 수행할 수 있는 작업 클러스터가 중지되는 동안 Amazon DocumentDB 탄력적 클러스터의 구성을 수정할 수 없습니다. 이러한 관리 작업을 수행하기 전에 클러스터를 시작해야 합니다. Amazon DocumentDB는 다시 시작한 후에만 중지된 탄력적 클러스터에 예약 유지 관리를 적용합니다. 7일 후에 Amazon DocumentDB는 중지된 탄력적 클러스터를 자동으로 시작하므로 유지 관리 상태에서 너무 늦어지지 않습니다. 탄력적 클러스터가 다시 시작되면 클러스터의 샤드 비용이 다시 청구됩니다. 탄력적 클러스터가 중지되는 동안 Amazon DocumentDB는 자동화된 백업을 수행하지 않으며 백업 보존 기간도 연장하지 않습니다. # Amazon DocumentDB 탄력적 클러스터 유지 관리 **Topics** + [보류 중인 탄력적 클러스터 유지 관리 작업 보기](#view-elastic-cluster-maintenance) + [탄력적 클러스터 엔진 업데이트](#elastic-cluster-engine-updates) + [탄력적 클러스터 운영 체제 업데이트](#elastic-cluster-os-updates) Amazon DocumentDB는 Amazon DocumentDB 탄력적 클러스터 리소스를 정기적으로 유지 관리합니다. 이러한 유지 관리에는 데이터베이스 엔진(탄력적 클러스터 유지 관리) 또는 탄력적 클러스터의 기본 운영 체제(OS 업데이트)가 포함되는 경우가 많습니다. 데이터베이스 엔진 업데이트는 필수 패치이며 데이터베이스 엔진에 대한 보안 수정, 버그 수정 및 개선 사항을 포함합니다. 대부분의 운영 체제 패치는 선택 사항이지만 한동안 패치를 적용하지 않으면 보안 태세를 유지하기 위해 패치가 필요할 수 있고 자동으로 적용될 수 있습니다. 따라서 운영 체제 업데이트는 사용 가능한 즉시 Amazon DocumentDB 탄력적 클러스터에 적용하는 것이 좋습니다. 데이터베이스 엔진 패치를 사용하려면 Amazon DocumentDB 탄력적 클러스터를 잠시 오프라인으로 전환해야 합니다. 사용 가능하게 되면 Amazon DocumentDB 탄력적 클러스터의 예정된 유지 관리 기간 동안 이러한 패치가 자동으로 적용되도록 예약됩니다. 탄력적 클러스터에는 고유한 유지 관리 기간이 있습니다. 즉시 적용되지 않도록 선택한 탄력적 클러스터 수정 사항은 유지 관리 기간에도 적용됩니다. 기본적으로 탄력적 클러스터를 생성할 때 Amazon DocumentDB가 탄력적 클러스터에 대해 유지 관리 기간을 지정합니다. 탄력적 클러스터를 생성할 때 유지 관리 기간을 선택할 수 있습니다. 또한 언제라도 비즈니스 일정 또는 절차에 맞춰 유지 관리 기간을 수정할 수 있습니다. 일반적으로 애플리케이션에 대 유지 관리의 영향을 최소화하는 유지 관리 기간을 서택하는 것이 좋습니다(예: 야간 또는 주말). ## 보류 중인 탄력적 클러스터 유지 관리 작업 보기 AWS CLI를 사용하여 유지 관리 업데이트를 탄력적 클러스터에서 사용할 수 있는지 여부를 확인할 수 있습니다. 업데이트가 있을 경우에는 다음 중 한 가지를 선택할 수 있습니다. + 현재 다음 유지 관리 기간에 예약된 유지 관리 작업을 연기합니다(OS 패치만 해당). + 유지 관리 작업을 즉시 적용합니다. + 다음 유지 관리 기간 중 시작할 유지 관리 작업을 예약합니다. + 선택한 신청 기간 중 유지 관리 작업을 시작하도록 예약합니다. 유지 관리 기간에 따라 대기 중인 작업의 시작 시기가 결정되지만 이러한 작업의 전체 실행 시간이 제한되지는 않습니다. 다음 AWS CLI 작업을 사용하여 보류 중인 유지 관리 작업을 확인합니다. 보류 중인 모든 유지 관리 작업을 나열합니다. ``` aws docdb-elastic list-pending-maintenance-actions ``` 이 작업의 출력은 다음과 같습니다(JSON 형식). ``` { 'ResourcePendingMaintenanceActions': [ { 'ResourceArn': 'string-arn', 'PendingMaintenanceActionDetails': [ { 'Action': 'ENGINE_UPDATE', 'AutoAppliedAfterDate': 'string', 'ForcedApplyDate': 'string', 'OptInStatus': 'string', 'CurrentApplyDate': 'string', 'Description': 'string' }, ] }, ], 'NextToken': 'string' } ``` 지정된 `resourceArn`에 대해 보류 중인 유지 관리 작업(있는 경우)을 가져옵니다. ``` aws docdb-elastic get-pending-maintenance-action --resource-arn string-arn ``` 이 작업의 출력은 다음과 같습니다(JSON 형식). ``` { 'ResourcePendingMaintenanceAction': { 'ResourceArn': 'string-arn', 'PendingMaintenanceActionDetails': [ { 'Action': 'ENGINE_UPDATE', 'AutoAppliedAfterDate': 'string', 'ForcedApplyDate': 'string', 'OptInStatus': 'string', 'CurrentApplyDate': 'string', 'Description': 'string' } ] } } ``` 파라미터: + `ResourceArn` - 보류 중인 유지 관리 작업이 적용되는 리소스의 Amazon DocumentDB Amazon 리소스 이름(ARN)입니다. + `Action` – 리소스에 적용 중인 보류 중인 유지 관리 작업입니다. 유효한 값: + `ENGINE_UPDATE` + `ENGINE_UPGRADE` + `SECURITY_UPDATE` + `OS_UPDATE` + `MASTER_USER_PASSWORD_UPDATE` + `AutoAppliedAfterDate` - 이 날짜 이후의 첫 번째 유지 관리 기간입니다. 이 경우 `NEXT_MAINTENANCE OPT_IN`은 무시됩니다. + `ForcedApplyDate` - 유지 관리 기간에 관계없이 적용됩니다. 이 경우 `IMMEDIATE OPT_IN`은 무시됩니다. + `OptInStatus` - 옵트인 요청의 유형을 지정하거나 옵트인 요청을 실행 취소하는 값입니다. `IMMEDIATE` 유형의 옵트인 요청은 실행 취소할 수 없습니다. 유효한 값: + `IMMEDIATE` - 유지 관리 작업을 즉시 적용합니다. + `NEXT_MAINTENANCE` - 리소스에 대한 다음 유지 관리 기간 중에 유지 관리 작업을 적용합니다. + `APPLY_ON` - 리소스의 다음 유지 관리 기간에 관계없이 지정된 적용 날짜에 유지 관리 작업을 적용합니다. + `UNDO_OPT_IN` - 기존 `NEXT_MAINTENANCE` 또는 `APPLY_ON` 옵트인 요청을 취소합니다. + `CurrentApplyDate` - opt-in-type이 `APPLY_ON`인 경우 표시됩니다. + `Description` - 유지 관리 작업에 대한 옵션 설명입니다. ## 탄력적 클러스터 엔진 업데이트 Amazon DocumentDB를 사용하여 유지 관리 작업을 적용하는 시기를 선택할 수 있습니다. AWS CLI를 사용하여 Amazon DocumentDB에서 업데이트를 적용하는 시기를 결정할 수 있습니다. 보류 중인 유지 관리 작업 적용: ``` aws docdb-elastic apply-pending-maintenance-action --resource-arn string-arn --apply-action string-enum --opt-in-type string-enum [--apply-on string-date-range] ``` 파라미터: + **--resource-arn** - 보류 중인 유지 관리 작업이 적용되는 리소스의 Amazon DocumentDB Amazon 리소스 이름(ARN)입니다. + **--apply-action** - 이 리소스에 적용할 대기 중인 유지 관리 작업입니다. 유효한 값: + `ENGINE_UPDATE` + `ENGINE_UPGRADE` + `SECURITY_UPDATE` + `OS_UPDATE` + `MASTER_USER_PASSWORD_UPDATE` + **--opt-in-type** - 옵트인 요청의 유형을 지정하거나 옵트인 요청을 실행 취소하는 값입니다. `IMMEDIATE` 유형의 옵트인 요청은 실행 취소할 수 없습니다. 유효한 값: + `IMMEDIATE` - 유지 관리 작업을 즉시 적용합니다. + `NEXT_MAINTENANCE` - 리소스에 대한 다음 유지 관리 기간 중에 유지 관리 작업을 적용합니다. + `APPLY_ON` - 리소스의 다음 유지 관리 기간에 관계없이 지정된 적용 날짜에 유지 관리 작업을 적용합니다. + `UNDO_OPT_IN` - 기존 `NEXT_MAINTENANCE` 또는 `APPLY_ON` 옵트인 요청을 취소합니다. + **[--apply-on]** - opt-in-type이 `APPLY_ON`인 경우 필수입니다. 형식: `yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm`(이 옵션은 UTC 시간을 사용합니다. 시작 시간은 최소 30분에서 최대 14일 또는 보류 중인 작업에 대한 강제 적용 날짜 중 먼저 도래하는 날짜부터 향후 언제든지 가능합니다. 시작부터 종료까지의 기간은 최소 30분에서 최대 8시간입니다.) 이 작업의 출력은 다음과 같습니다(JSON 형식). ``` { 'ResourcePendingMaintenanceAction': { 'ResourceArn': 'string-arn', 'PendingMaintenanceActionDetails': [ { 'Action': 'SECURITY_UPDATE', 'AutoAppliedAfterDate': 'string', 'ForcedApplyDate': 'string', 'OptInStatus': 'IMMEDIATE', 'CurrentApplyDate': 'string', 'Description': 'string' }, ] } } ``` 파라미터: + `ResourceArn` - 보류 중인 유지 관리 작업이 적용되는 리소스의 Amazon DocumentDB Amazon 리소스 이름(ARN)입니다. + `Action` – 리소스에 적용 중인 보류 중인 유지 관리 작업입니다. 유효한 값: + `ENGINE_UPDATE` + `ENGINE_UPGRADE` + `SECURITY_UPDATE` + `OS_UPDATE` + `MASTER_USER_PASSWORD_UPDATE` + `AutoAppliedAfterDate` - 이 날짜 이후의 첫 번째 유지 관리 기간입니다. 이 경우 `NEXT_MAINTENANCE OPT_IN`은 무시됩니다. + `ForcedApplyDate` - 유지 관리 기간에 관계없이 적용됩니다. 이 경우 `IMMEDIATE OPT_IN`은 무시됩니다. + `OptInStatus` - 옵트인 요청의 유형을 지정하거나 옵트인 요청을 실행 취소하는 값입니다. `IMMEDIATE` 유형의 옵트인 요청은 실행 취소할 수 없습니다. 유효한 값: + `IMMEDIATE` - 유지 관리 작업을 즉시 적용합니다. + `NEXT_MAINTENANCE` - 리소스에 대한 다음 유지 관리 기간 중에 유지 관리 작업을 적용합니다. + `APPLY_ON` - 리소스의 다음 유지 관리 기간에 관계없이 지정된 적용 날짜에 유지 관리 작업을 적용합니다. + `UNDO_OPT_IN` - 기존 `NEXT_MAINTENANCE` 또는 `APPLY_ON` 옵트인 요청을 취소합니다. + `CurrentApplyDate` - opt-in-type이 `APPLY_ON`인 경우 표시됩니다. + `Description` - 유지 관리 작업에 대한 옵션 설명입니다. ### 적용 날짜 각 유지 관리 작업에는 대기 중인 유지 관리 작업을 설명할 때 찾을 수 있는 적용 날짜가 있습니다. 에서 보류 중인 유지 관리 작업의 출력을 읽으면 세 AWS CLI가지 날짜가 나열됩니다. + `CurrentApplyDate` - 유지 관리 작업이 즉시 또는 다음 유지 관리 기간에 적용되는 날짜입니다. 해당 유지 관리가 선택 항목일 경우 이 값은 Null입니다. + `ForcedApplyDate` - 유지 관리가 사용자의 유지 관리 기간과 상관없이 자동으로 적용되는 날짜입니다. + `AutoAppliedAfterDate` - 유지 관리가 클러스터의 유지 관리 기간 동안 이 날짜 이후에 적용됩니다. ### 사용자가 생성한 유지 관리 작업 Amazon DocumentDB 탄력적 클러스터 사용자는 클러스터 구성에 대한 업데이트를 시작할 수 있습니다. **클러스터 기본 암호 업데이트** ``` aws docdb-elastic update-cluster --cluster-arn string-arn [--admin-user-password string] [--auth-type string-enum] [--apply-method string-enum] [--apply-on string-date-range] #... other parameters of the API that follow here are not relevant for this configuration ``` 파라미터: + **--cluster-arn** - 유지 관리 작업이 적용되는 리소스의 Amazon DocumentDB Amazon 리소스 이름(ARN)입니다. + **[--admin-user-password]** - 관리자 사용자와 연결된 암호입니다. + **[--auth-type]** - 탄력적 클러스터에 액세스하는 데 사용되는 암호를 가져올 위치를 결정하는 데 사용되는 인증 유형입니다. 유효한 형식은 `PLAIN_TEXT` 및 `SECRET_ARN`입니다. + **[--apply-method]** - 적용할 메서드 유형을 지정하는 값입니다. 허용되는 값은 `IMMEDIATE` 및 `APPLY_ON`입니다. 기본값은 `IMMEDIATE`입니다. + **[--apply-on]** - `apply-method`가 `APPLY_ON`인 경우 필수입니다. 형식: `yyyy/MM/dd HH:mm-yyyy/MM/dd HH:mm`(이 옵션은 UTC 시간을 사용합니다. 시작 시간은 최소 30분에서 최대 14일 부터 향후 언제든지 가능합니다. 시작부터 종료까지의 기간은 최소 30분에서 최대 8시간입니다.) 이 작업의 출력은 다음과 같습니다(JSON 형식). ``` { 'ResourcePendingMaintenanceAction': { 'ResourceArn': 'string-arn', 'PendingMaintenanceActionDetails': [ { 'Action': 'MASTER_USER_PASSWORD_UPDATE', 'OptInStatus': 'APPLY_ON', 'CurrentApplyDate': 'string', 'Description': 'string' }, ] } } ``` ### Amazon DocumentDB 유지 관리 윈도우 변경 유지 관리 기간은 사용률이 가장 낮은 시간에 할당되어야 하므로 수시로 변경되어야 할 수 있습니다. 시스템 변경 사항(규모 조정 스토리지 작업 변경 등)을 적용 중이고 가동 중단이 필요한 경우에만 인 이 기간 동안 탄력적 클러스터를 사용할 수 없습니다. 필수 변경 사항을 적용하는 데 필요한 최소 시간 동안만 사용이 불가능합니다. 기본값은 각 Amazon Web Services Region(아마존 웹 서비스 리전)의 8시간 블록에서 임의로 선택된 30분 창으로, 주 마다 임의의 요일에 발생합니다. 유지 관리 기간을 변경하려면 [엘라스틱 클러스터 구성 수정](elastic-managing.md#elastic-modify) 섹션을 참조하세요. ## 탄력적 클러스터 운영 체제 업데이트 Amazon DocumentDB 탄력적 클러스터에는 때때로 운영 체제 업데이트가 필요합니다. Amazon DocumentDB는 운영 체제를 최신 버전으로 업그레이드하여 데이터베이스 성능과 고객의 전반적인 보안 태세를 개선합니다. 운영 체제 업데이트는 Amazon DocumentDB 탄력적 클러스터의 클러스터 엔진 버전을 변경하지 않습니다. Amazon DocumentDB 탄력적 클러스터에 대한 대부분의 운영 체제 업데이트는 선택 사항이며 이를 적용할 설정된 날짜가 없습니다. 그러나 한동안 이러한 업데이트를 적용하지 않으면 결국 클러스터의 유지 관리 기간 동안 업데이트가 필요해지고 자동으로 적용될 수 있습니다. 이는 데이터베이스의 보안 태세를 유지하는 데 도움이 됩니다. 예기치 않은 가동 중지 시간을 방지하려면 Amazon DocumentDB 탄력적 클러스터를 사용할 수 있게 되는 즉시 운영 체제 업데이트를 적용하고 비즈니스 요구 사항에 따라 편한 시간에 클러스터 유지 관리 기간을 설정하는 것이 좋습니다.