기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 클러스터에 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. **다음 항목에 인스턴스 추가: ** 페이지에서 클러스터에 추가하려는 각 인스턴스에 대해 다음 단계를 반복 실행합니다. 최대 15개까지 가능합니다.
1. **인스턴스 식별자** - 이 인스턴스의 고유 식별자를 입력하거나 Amazon DocumentDB가 클러스터 식별자를 기반으로 인스턴스 식별자를 제공하도록 허용할 수 있습니다.
인스턴스 명명 제약 조건:
+ 길이는 [1-63] 문자, 숫자 또는 하이픈입니다.
+ 첫 번째 문자는 글자이어야 합니다.
+ 하이픈으로 끝나거나 하이픈이 2개 연속으로 포함되어서는 안 됩니다.
+ 리전별로 Amazon RDS, Neptune 및 Amazon DocumentDB의 모든 인스턴스 AWS 계정에 대해 고유해야 합니다.
1. **인스턴스 클래스** - 드롭다운 목록에서 이 인스턴스에 대해 원하는 인스턴스 유형을 선택합니다.
1. **승격 계층** - 드롭다운 목록에서 인스턴스의 승격 계층을 선택하거나 *선호 없음*을 선택하여 Amazon DocumentDB가 인스턴스의 승격 계층을 설정할 수 있도록 합니다. 번호가 낮을수록 우선 순위가 높습니다. 자세한 내용은 [장애 조치 대상 제어](failover.md#failover-target_control) 섹션을 참조하십시오.
1. 더 많은 인스턴스를 추가하려면 **추가 인스턴스 추가**를 선택하고 a, b, c 단계를 반복합니다.
1. 작업을 완료합니다.
+ 클러스터에 인스턴스를 추가하려면 **생성**을 선택합니다.
+ 작업을 취소하려면 **취소**를 선택합니다.
인스턴스를 생성하는 데 몇 분 정도 걸립니다. 콘솔 또는 AWS CLI 를 사용하여 인스턴스의 상태를 볼 수 있습니다. 자세한 내용은 [인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 단원을 참조하십시오.
------
#### [ 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 고가용성 및 복제](replication.md) 섹션을 참조하십시오.
+ **--promotion-tier** - 선택 사항. 이 인스턴스의 장애 조치 우선 순위 계층입니다. 0\$115 사이여야 하며, 숫자가 작을수록 우선 순위가 높습니다. 자세한 내용은 [장애 조치 대상 제어](failover.md#failover-target_control) 섹션을 참조하십시오.
1. **먼저 인스턴스를 생성할 수 있는 가용 영역을 결정합니다.**
인스턴스를 생성하기 전에 사용 가능 영역을 지정하려면 다음 명령을 실행하여 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"
]
]
]
```
1. **둘째, 리전에서 생성할 수 있는 인스턴스 클래스를 확인합니다.**
리전에서 사용 가능한 인스턴스 클래스를 확인하려면 다음 명령을 실행합니다. 출력에서 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"
]
```
1. **마지막으로, 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::key/sample-key",
"DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"CACertificateIdentifier": "rds-ca-2019",
"PromotionTier": 2,
"DBInstanceArn": "arn:aws:rds:us-east-1::db:sample-instance-2"
}
}
```
인스턴스를 생성하는 데 몇 분 정도 걸립니다. 콘솔 또는 AWS CLI 를 사용하여 인스턴스의 상태를 볼 수 있습니다. 자세한 내용은 [Amazon DocumentDB 인스턴스 상태 모니터링](monitoring_docdb-instance_status.md) 단원을 참조하십시오.
------