엘라스틱 클러스터 구성 수정 엘라스틱 클러스터 모니터링 엘라스틱 클러스터 삭제

Amazon DocumentDB 탄력적 클러스터 관리

Amazon DocumentDB 엘라스틱 클러스터를 관리하려면 적절한 Amazon DocumentDB 컨트롤 플레인 권한이 있는 IAM 정책이 있어야 합니다. 이러한 권한은 클러스터를 생성, 수정 및 삭제하도록 허용합니다. Amazon DocumentDBFullAccess 정책은 Amazon DocumentDB 엘라스틱 클러스터를 관리하는 데 필요한 모든 권한을 제공합니다.

다음 항목에서는 Amazon DocumentDB 엘라스틱 클러스터로 작업할 때 다양한 작업을 수행하는 방법을 보여줍니다.

주제

엘라스틱 클러스터 구성 수정

이 섹션에서는 다음 지침과 AWS CLI 함께 AWS Management Console 또는를 사용하여 탄력적 클러스터를 수정하는 방법을 설명합니다.

클러스터를 수정하는 주된 용도는 샤드 카운트 및/또는 샤드 컴퓨팅 용량을 늘리거나 줄임으로써 샤드를 확장하는 것입니다.

Using the AWS Management Console

를 사용하여 탄력적 클러스터 구성을 수정하려면 AWS Management Console:

AWS Management Console에 로그인하고 Amazon DocumentDB 콘솔을 엽니다.
탐색 창에서 클러스터를 선택합니다.

작은 정보
화면 왼쪽에 탐색 창이 보이지 않으면 탐색 창의 왼쪽 상단 모서리에 있는 메뉴 아이콘을 선택합니다.
클러스터 식별자 열에서 수정할 클러스터의 이름을 선택합니다.
수정을 선택합니다.
변경하려는 필드를 편집한 다음 클러스터 수정을 선택합니다.

참고

또는 클러스터 페이지로 이동하여 클러스터 옆의 확인란을 선택한 다음 작업, 수정을 선택하여 클러스터 수정 대화 상자에 액세스할 수 있습니다.

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:

AWS Management Console에 로그인하고 Amazon DocumentDB 콘솔을 엽니다.
탐색 창에서 클러스터를 선택합니다.

작은 정보
화면 왼쪽에 탐색 창이 보이지 않으면 탐색 창의 왼쪽 상단 모서리에 있는 메뉴 아이콘을 선택합니다.
클러스터 식별자 열에서 모니터링할 클러스터의 이름을 선택합니다.
모니터링 탭을 선택합니다.

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을 사용하여 엘라스틱 클러스터 구성을 삭제하려면:

AWS Management Console에 로그인하고 Amazon DocumentDB 콘솔을 엽니다.
탐색 창에서 클러스터를 선택합니다.

작은 정보
화면 왼쪽에 탐색 창이 보이지 않으면 탐색 창의 왼쪽 상단 모서리에 있는 메뉴 아이콘을 선택합니다.
클러스터 목록 테이블에서 삭제할 클러스터 이름의 왼쪽에 있는 확인란을 선택한 다음 작업을 선택합니다. 드롭다운 메뉴에서 삭제를 선택합니다.
"클러스터 이름" 엘라스틱 클러스터를 삭제하시겠습니까? 대화 상자에서 삭제를 선택합니다.

클러스터를 삭제하는 데 몇 분 정도 걸립니다. 클러스터 상태를 모니터링하려면 Amazon DocumentDB 클러스터 상태 모니터링을 참조하십시오.

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 클러스터 상태 모니터링을 참조하십시오.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

모범 사례

엘라스틱 클러스터 스냅샷 관리

Amazon DocumentDB 탄력적 클러스터 관리

주제

엘라스틱 클러스터 구성 수정

작은 정보

참고

엘라스틱 클러스터 모니터링

작은 정보

엘라스틱 클러스터 삭제

작은 정보