# Amazon ECS 관리형 인스턴스용 클러스터 생성
<a name="create-cluster-managed-instances"></a>

클러스터를 생성하여 태스크와 서비스가 실행되는 인프라를 정의합니다.

Amazon ECS 관리형 인스턴스용 클러스터를 생성하면 Amazon ECS는 기본 구성으로 관리형 인스턴스 용량 공급자를 자동 생성합니다. 이 용량 공급자는 워크로드에 가장 비용 최적화된 인스턴스 유형을 선택합니다. 특정 인스턴스 속성 또는 유형이 필요한 경우 사용자 지정 용량 공급자를 생성할 수도 있습니다.

클러스터를 최대한 쉽게 만들 수 있도록 콘솔에는 여러 선택에 대한 기본 선택 항목이 있습니다.
+ AWS Cloud Map에서 클러스터와 이름이 동일한 기본 네임스페이스를 생성합니다. 네임스페이스를 사용하면 클러스터에서 생성한 서비스를 추가 구성 없이 네임스페이스의 다른 서비스에 연결할 수 있습니다.

  자세한 내용은 [Amazon ECS 서비스 상호 연결](interconnecting-services.md) 섹션을 참조하세요.

다음 옵션을 수정할 수 있습니다.
+ 클러스터와 연결된 기본 네임스페이스를 변경합니다.

  네임스페이스를 사용하면 클러스터에서 생성한 서비스를 추가 구성 없이 네임스페이스의 다른 서비스에 연결할 수 있습니다. 기본 네임스페이스는 클러스터 이름과 동일합니다. 자세한 내용은 [Amazon ECS 서비스 상호 연결](interconnecting-services.md) 섹션을 참조하세요.
+ 관리형 스토리지에 AWS KMS 키를 할당합니다. 키 생성 방법에 대한 자세한 내용은 *AWS Key Management Service 사용 설명서*의 [KMS 키 생성](https://docs.aws.amazon.com/kms/latest/developerguide/create-keys.html)을 참조하세요.
+ 클러스터를 식별하는 데 도움이 되는 태그를 추가합니다.

## 사전 조건
<a name="create-cluster-managed-instances-prerequisites"></a>

시작하기 전에 먼저 [Amazon ECS 사용 설정](get-set-up-for-amazon-ecs.md) 단계를 완료하고 적절한 IAM 권한을 할당했는지 확인합니다. 자세한 내용은 [Amazon ECS 클러스터 예제](security_iam_id-based-policy-examples.md#IAM_cluster_policies) 섹션을 참조하세요.

클러스터를 생성하는 사용자에게는 `iam:CreateServiceLinkedRole`의 추가 권한이 있어야 합니다.

`instanceRequirements`를 지정하지 않으면 Amazon ECS는 태스크 정의 요구 사항에 따라 가장 비용 최적화된 인스턴스 유형을 자동으로 선택합니다. 특정 인스턴스 속성 또는 유형을 사용하려면 `instanceRequirements`를 사용하여 용량 공급자를 생성합니다.

인스턴스를 선택하는 방법을 이해합니다. 자세한 내용은 [Amazon ECS 관리형 인스턴스에 대한 인스턴스 선택 모범 사례](managed-instances-instance-selection-best-practices.md) 섹션을 참조하세요.

Amazon ECS 관리형 인스턴스에 필요한 IAM 역할이 있습니다. 여기에는 다음이 포함됩니다.
+ **인프라 역할** - Amazon ECS가 사용자를 대신해 AWS 서비스를 직접 호출하여 Amazon ECS 관리형 인스턴스 인프라를 관리하도록 허용합니다.

  자세한 내용은 [Amazon ECS 인프라 IAM 역할](infrastructure_IAM_role.md) 섹션을 참조하세요.
+ **인스턴스 프로파일** - 관리형 인스턴스에서 실행되는 Amazon ECS 컨테이너 에이전트 및 Docker 대몬에 대한 권한을 제공합니다.

  자세한 내용은 [Amazon ECS 관리형 인스턴스의 인스턴스 프로파일](managed-instances-instance-profile.md) 섹션을 참조하세요.

## 콘솔 절차
<a name="create-cluster-managed-instances-console"></a>

**새 클러스터 생성(Amazon ECS 콘솔)**

1. [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2)에서 콘솔을 엽니다.

1. 탐색 모음에서 사용할 리전을 선택합니다.

1. 탐색 창에서 **클러스터**를 선택합니다.

1. **클러스터(Clusters)** 페이지에서 **클러스터 생성(Create cluster)**을 선택합니다.

1. **클러스터 구성**에서 다음을 구성합니다.
   + **클러스터 이름**에 고유한 이름을 입력합니다.

     이름은 최대 255자(대/소문자), 숫자 및 하이픈을 포함할 수 있습니다.
   + (선택 사항) 서비스 연결에 사용되는 네임스페이스를 클러스터 이름과 다르게 하려면 **네임스페이스**에 고유한 이름을 입력합니다.

1. **사용자 지정 용량 공급자**에서 다음을 수행합니다.
   + **EC2 용량을 얻는 방법 선택**에서 **Amazon ECS 관리형 인스턴스**를 선택하세요.
   + 인스턴스 프로파일에서 인스턴스 프로파일 유형을 선택하세요.
   + 인프라 역할에서 인프라 역할을 선택합니다.
   + 사용자 지정 용량 공급자를 사용하려면 **인스턴스 선택**에서 **사용자 지정 사용**을 선택하세요. 그런 다음 각 속성에 대해 **속성 값**을 입력하세요.

1. (선택 사항) Container Insights를 사용하고 **모니터링**을 확장한 후에 다음 옵션 중 하나를 선택합니다.
   + 권장되는 관찰성이 향상된 Container Insights를 사용하려면 **관찰성이 향상된 Container Insights**를 선택합니다.
   + Container Insights를 사용하려면 **Container Insights**를 선택합니다.

1. (선택 사항) 관리형 스토리지의 데이터를 암호화합니다. **암호화**에서 **관리형 스토리지**에 관리형 스토리지 데이터를 암호화하는 데 사용할 AWS KMS 키의 ARN을 입력합니다.

1. (선택 사항) 클러스터를 식별하려면 **태그(Tags)**를 펼친 다음, 태그를 구성합니다.

   [태그 추가] **태그 추가(Add tag)**를 선택하고 다음을 수행합니다.
   + **키(Key)**에 키 이름을 입력합니다.
   + **값**에 키 값을 입력합니다.

1. **생성(Create)**을 선택합니다.

## AWS CLI 절차
<a name="create-cluster-managed-instances-cli"></a>

AWS CLI를 사용하여 Amazon ECS 관리형 인스턴스용 클러스터를 생성할 수 있습니다. AWS CLI의 최신 버전을 사용합니다. 최신 버전으로 업그레이드하는 방법에 대한 자세한 내용은 [AWS CLI 최신 버전의 설치 또는 업데이트](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)를 참조하세요.

**참고**  
듀얼 스택 서비스 엔드포인트를 사용하면 AWS AWS CLI, SDK 및 Amazon ECS API에서 IPv4 및 IPv6 모두를 통해 Amazon ECS와 상호 작용할 수 있습니다. 자세한 내용은 [Amazon ECS 듀얼 스택 엔드포인트 사용](dual-stack-endpoint.md) 섹션을 참조하세요.

**새로운 클러스터를 생성하는 방법(AWS CLI)**

1. 다음 명령을 사용하여 고유한 이름의 클러스터를 생성하세요.

   ```
   aws ecs create-cluster --cluster-name {{managed-instances-cluster}}
   ```

   출력:

   ```
   {
       "cluster": {
           "status": "ACTIVE", 
           "defaultCapacityProviderStrategy": [], 
           "statistics": [], 
           "capacityProviders": [], 
           "tags": [], 
           "clusterName": "managed-instances-cluster", 
           "settings": [
               {
                   "name": "containerInsights", 
                   "value": "disabled"
               }
           ], 
           "registeredContainerInstancesCount": 0, 
           "pendingTasksCount": 0, 
           "runningTasksCount": 0, 
           "activeServicesCount": 0, 
           "clusterArn": "arn:aws:ecs:{{region}}:{{aws_account_id}}:cluster/managed-instances-cluster"
       }
   }
   ```

1. (선택 사항) 클러스터에 대한 향상된 관찰성으로 Container Insights를 활성화하려면 다음 명령을 사용하세요.

   ```
   aws ecs put-account-setting --name containerInsights --value enhanced
   ```

1. (선택 사항) 클러스터에 태그를 추가하려면 다음 명령을 사용하세요.

   ```
   aws ecs tag-resource --resource-arn arn:aws:ecs:{{region}}:{{aws_account_id}}:cluster/{{managed-instances-cluster}} --tags key={{Environment}},value={{Production}}
   ```

## 다음 단계
<a name="cluster-next-steps-managed-instances"></a>

Amazon ECS 관리형 인스턴스에 대한 태스크 정의를 생성하세요. 자세한 내용은 [콘솔을 사용하여 Amazon ECS 작업 정의 생성](create-task-definition.md) 섹션을 참조하세요.

애플리케이션을 독립 실행형 태스크 또는 서비스의 일부로 실행합니다. 자세한 내용은 다음을 참조하세요.
+ [애플리케이션을 Amazon ECS 태스크로 실행](standalone-task-create.md)
+ [Amazon ECS 롤링 업데이트 배포 생성](create-service-console-v2.md)