클러스터에 Amazon DocumentDB 인스턴스 추가

Using the AWS Management Console

다음 절차에 따라 콘솔을 사용하여 클러스터에 대한 Amazon DocumentDB 인스턴스를 생성할 수 있습니다.

에 AWS Management Console 로그인하고 https://console.aws.amazon.com/docdb 에서 Amazon DocumentDB 콘솔을 엽니다.
탐색 창에서 클러스터를 선택합니다.

작은 정보
화면 왼쪽에 탐색 창이 표시되지 않으면 페이지 왼쪽 상단 모서리에서 메뉴 아이콘()을 선택합니다.
인스턴스를 추가할 클러스터를 선택하려면 클러스터의 이름 왼쪽에 있는 버튼을 선택합니다.
작업을 선택한 다음 Add instance(인스턴스 추가)를 선택합니다.
다음 항목에 인스턴스 추가: <cluster-name> 페이지에서 클러스터에 추가하려는 각 인스턴스에 대해 다음 단계를 반복 실행합니다. 최대 15개까지 가능합니다.
1. 인스턴스 식별자— 이 인스턴스의 고유 식별자를 입력하거나 Amazon DocumentDB가 클러스터 식별자를 기반으로 인스턴스 식별자를 제공하도록 허용할 수 있습니다.
  
  인스턴스 명명 제약 조건:
  - 길이는 [1—63] 문자, 숫자 또는 하이픈입니다.
  - 첫 번째 문자는 글자이어야 합니다.
  - 하이픈으로 끝나거나 하이픈이 2개 연속으로 이어져서는 안 됩니다.
  - Amazon RDS, Neptune 및 Amazon DocumentDB의 모든 인스턴스에 대해 지역별로 고유해야 합니다. AWS 계정
2. 인스턴스 클래스 — 드롭다운 목록에서 이 인스턴스에 대해 원하는 인스턴스 유형을 선택합니다.
3. 승격 계층 - 드롭다운 목록에서 인스턴스의 승격 계층을 선택하거나 선호 없음을 선택하여 Amazon DocumentDB가 인스턴스의 승격 계층을 설정할 수 있도록 합니다. 번호가 낮을수록 우선 순위가 높습니다. 자세한 내용은 장애 조치 대상 제어 단원을 참조하십시오.
4. 더 많은 인스턴스를 추가하려면 추가 인스턴스 추가를 선택하고 a, b, c 단계를 반복합니다.
작업을 완료합니다.
- 클러스터에 인스턴스를 추가하려면 생성을 선택합니다.
- 작업을 취소하려면 취소를 선택합니다.

인스턴스를 생성하는 데 몇 분 정도 걸립니다. 콘솔을 사용하거나 인스턴스 상태를 볼 수 있습니다. AWS CLI 자세한 설명은 인스턴스 상태 모니터링 섹션을 참조하세요.

Using the AWS CLI

다음 파라미터와 함께 create-db-instance AWS CLI 작업을 사용하여 클러스터의 기본 인스턴스를 생성합니다.

--db-instance-class — 필수입니다. 인스턴스의 컴퓨팅 및 메모리 용량(예: db.m4.large)입니다. 모든 AWS 리전에서 모든 인스턴스 클래스를 사용할 수 있는 것은 아닙니다.
--db-instance-identifier — 필수입니다. 인스턴스를 식별하는 문자열입니다.

인스턴스 명명 제약:
- 길이는 [1—63] 문자, 숫자 또는 하이픈입니다.
- 첫 번째 문자는 글자이어야 합니다.
- 하이픈으로 끝나거나 하이픈이 2개 연속으로 이어져서는 안 됩니다.
- Amazon RDS, Neptune 및 Amazon DocumentDB의 모든 인스턴스에 대해 지역별로 고유해야 합니다. AWS 계정
--engine — 필수입니다. docdb여야 합니다.
--availability-zone — 선택 사항. 이 인스턴스를 생성할 가용 영역입니다. 다른 가용 영역에서 인스턴스를 찾아서 내결함성을 높이려면 이 파라미터를 사용합니다. 자세한 내용은 Amazon DocumentDB 고가용성 및 복제 단원을 참조하십시오.
--promotion-tier — 선택 사항. 이 인스턴스의 장애 조치 우선 순위 계층입니다. 0~15 사이여야 하며, 숫자가 작을수록 우선 순위가 높습니다. 자세한 내용은 장애 조치 대상 제어 단원을 참조하십시오.

먼저 인스턴스를 생성할 수 있는 가용 영역을 결정합니다.

인스턴스를 생성하기 전에 사용 가능 영역을 지정하려면 다음 명령을 실행하여 Amazon DocumentDB 클러스터에 사용할 수 있는 가능 영역을 결정합니다.

Linux, macOS, Unix의 경우:


aws docdb describe-db-clusters \
       --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'

Windows의 경우:


aws docdb describe-db-clusters ^
       --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'

이 작업의 출력은 다음과 같이 표시됩니다.


[
    [
        "sample-cluster",
        [
            "us-east-1c",
            "us-east-1b",
            "us-east-1a"
        ]
    ]
]

둘째, 리전에서 생성할 수 있는 인스턴스 클래스를 확인합니다.

리전에서 사용 가능한 인스턴스 클래스를 확인하려면 다음 명령을 실행합니다. 출력에서 Amazon DocumentDB 클러스터에 추가할 인스턴스의 인스턴스 클래스를 선택합니다.

Linux, macOS, Unix의 경우:
```
aws docdb describe-orderable-db-instance-options \
        --engine docdb \
        --query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
Windows의 경우:
```
aws docdb describe-orderable-db-instance-options ^
        --engine docdb ^
        --query 'OrderableDBInstanceOptions[*].DBInstanceClass'
```
이 작업의 출력은 다음과 같이 표시됩니다.
```
[
    "db.r5.16xlarge",
    "db.r5.2xlarge",
    "db.r5.4xlarge",
    "db.r5.8xlarge",
    "db.r5.large",
    "db.r5.xlarge"
]
```

마지막으로, Amazon DocumentDB 클러스터에 인스턴스를 추가합니다.

인스턴스를 Amazon DocumentDB 클러스터에 추가하려면 다음 명령을 실행합니다..

Linux, macOS, Unix의 경우:


aws docdb create-db-instance \
       --db-cluster-identifier sample-cluster \
       --db-instance-identifier sample-instance-2 \
       --availability-zone us-east-1b \
       --promotion-tier 2 \
       --db-instance-class db.r5.xlarge \
       --engine docdb

Windows의 경우:


aws docdb create-db-instance ^
       --db-cluster-identifier sample-cluster ^
       --db-instance-identifier sample-instance-2 ^
       --availability-zone us-east-1b ^
       --promotion-tier 2 ^
       --db-instance-class db.r5.xlarge ^
       --engine docdb

이 작업의 출력은 다음과 같이 표시됩니다.


{
    "DBInstance": {
        "DBInstanceIdentifier": "sample-instance-2",
        "DBInstanceClass": "db.r5.xlarge",
        "Engine": "docdb",
        "DBInstanceStatus": "creating",
        "PreferredBackupWindow": "02:00-02:30",
        "BackupRetentionPeriod": 1,
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-abcd0123",
                "Status": "active"
            }
        ],
        "AvailabilityZone": "us-east-1b",
        "DBSubnetGroup": {
            "DBSubnetGroupName": "default",
            "DBSubnetGroupDescription": "default",
            "VpcId": "vpc-6242c31a",
            "SubnetGroupStatus": "Complete",
            "Subnets": [
                {
                    "SubnetIdentifier": "subnet-abcd0123",
                    "SubnetAvailabilityZone": {
                        "Name": "us-west-2a"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-wxyz0123",
                    "SubnetAvailabilityZone": {
                        "Name": "us-west-2b"
                    },
                    "SubnetStatus": "Active"
                }
            ]
        },
        "PreferredMaintenanceWindow": "sun:11:35-sun:12:05",
        "PendingModifiedValues": {},
        "EngineVersion": "3.6.0",
        "AutoMinorVersionUpgrade": true,
        "PubliclyAccessible": false,
        "DBClusterIdentifier": "sample-cluster",
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:<accountID>:key/sample-key",
        "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
        "CACertificateIdentifier": "rds-ca-2019",
        "PromotionTier": 2,
        "DBInstanceArn": "arn:aws:rds:us-east-1:<accountID>:db:sample-instance-2"
    }
}

인스턴스를 생성하는 데 몇 분 정도 걸립니다. 콘솔을 사용하거나 인스턴스 상태를 볼 수 있습니다. AWS CLI 자세한 설명은 Amazon DocumentDB 인스턴스 상태 모니터링 섹션을 참조하세요.

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

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

문서 규칙

인스턴스 라이프사이클

인스턴스 설명

클러스터에 Amazon DocumentDB 인스턴스 추가

작은 정보