기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 를 사용하여 프로비저닝된 Amazon MSK 클러스터 생성 AWS CLI
<a name="create-cluster-cli"></a>

****

1. 다음 JSON을 복사하여 파일에 저장합니다. 파일 이름을 `brokernodegroupinfo.json`으로 지정합니다. JSON의 서브넷 ID를 서브넷에 해당하는 값으로 바꿉니다. 이러한 서브넷은 서로 다른 가용 영역에 있어야 합니다. *"Security-Group-ID"*를 클라이언트 VPC의 하나 이상의 보안 그룹 ID로 바꿉니다. 이 보안 그룹과 연결된 클라이언트는 클러스터에 액세스할 수 있습니다. 사용자와 공유된 보안 그룹을 지정할 경우 사용자가 해당 보안 그룹에 대한 권한이 있어야 합니다. 특히, `ec2:DescribeSecurityGroups` 권한이 필요합니다. 예제는 [Amazon EC2: 특정 VPC와 연결된 Amazon EC2 보안 그룹을 콘솔에서 프로그래밍 방식으로 관리할 수 있도록 허용](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_examples_ec2_securitygroups-vpc.html)을 참조하세요. 마지막으로가 AWS CLI 설치된 컴퓨터에 업데이트된 JSON 파일을 저장합니다.

   ```
   {
     "InstanceType": "kafka.m5.large",
     "ClientSubnets": [
       "Subnet-1-ID",
       "Subnet-2-ID"
     ],
     "SecurityGroups": [
       "Security-Group-ID"
     ]
   }
   ```
**중요**  
Express 브로커의 경우 3개의 서로 다른 가용 영역에 3개의 서브넷이 필요합니다. 또한 스토리지 관련 속성을 정의할 필요가 없습니다.  
미국 서부(캘리포니아 북부) 리전의 Standard 브로커의 경우, 서로 다른 두 가용 영역에 두 개의 서브넷이 필요합니다. Amazon MSK를 사용할 수 있는 다른 모든 리전에서는 2개 또는 3개의 서브넷을 지정할 수 있습니다. 모든 서브넷은 서로 다른 가용 영역에 있어야 합니다. 클러스터를 생성하면 Amazon MSK는 지정한 서브넷에 브로커 노드를 균등하게 분배합니다.

1. `brokernodegroupinfo.json` 파일을 저장한 디렉터리에서 다음 AWS CLI 명령을 실행하여 *"Your-Cluster-Name"*을 원하는 이름으로 바꿉니다. *"Monitoring-Level"*에 대해 `DEFAULT`, `PER_BROKER` 또는 `PER_TOPIC_PER_BROKER`, 세 값 중 하나를 지정할 수 있습니다. 이러한 세 가지 모니터링 수준에 대한 자세한 내용은 [Amazon MSK 프로비저닝된 클러스터 모니터링](monitoring.md) 단원을 참조하십시오. `enhanced-monitoring` 파라미터는 선택 항목입니다. `create-cluster` 명령에서 지정하지 않으면 `DEFAULT` 모니터링 수준이 적용됩니다.

   ```
   aws kafka create-cluster --cluster-name "Your-Cluster-Name" --broker-node-group-info file://brokernodegroupinfo.json --kafka-version "2.8.1" --number-of-broker-nodes 3 --enhanced-monitoring "Monitoring-Level"
   ```

   명령의 출력은 다음 JSON과 같습니다.

   ```
   {
       "ClusterArn": "...",
       "ClusterName": "AWSKafkaTutorialCluster",
       "State": "CREATING"
   }
   ```
**참고**  
이 `create-cluster` 명령은 하나 이상의 서브넷이 지원되지 않는 가용 영역에 속한다는 오류를 반환할 수 있습니다. 이 경우 오류는 어떤 가용 영역이 지원되지 않는지 표시합니다. 지원되지 않는 가용 영역을 사용하지 않는 서브넷을 만들고, `create-cluster` 명령을 다시 시도합니다.

1. 클러스터에서 다른 작업을 수행하는 데 필요하므로 `ClusterArn` 키 값을 저장합니다.

1. 다음 명령을 실행하여 `STATE` 클러스터를 확인합니다. `STATE` 값은 Amazon MSK가 클러스터를 프로비저닝함에 따라 `CREATING`에서 `ACTIVE`으로 변경됩니다. 상태가 `ACTIVE`이면 클러스터에 연결할 수 있습니다. 클러스터 상태에 대한 자세한 내용은 [MSK 프로비저닝된 클러스터의 상태 이해](msk-cluster-states.md) 섹션을 참조하세요.

   ```
   aws kafka describe-cluster --cluster-arn <your-cluster-ARN>
   ```