기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 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. 변경하려는 필드를 편집한 다음 **클러스터 수정**을 선택합니다.
**참고**
또는 **클러스터** 페이지로 이동하여 클러스터 옆의 확인란을 선택한 다음 **작업**, **수정**을 선택하여 **클러스터 수정** 대화 상자에 액세스할 수 있습니다.
------
#### [ 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 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. **모니터링** 탭을 선택합니다.
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. **"클러스터 이름" 엘라스틱 클러스터를 삭제하시겠습니까?** 대화 상자에서 **삭제**를 선택합니다.
클러스터를 삭제하는 데 몇 분 정도 걸립니다. 클러스터 상태를 모니터링하려면 [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)을 참조하십시오.
------