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

# 자습서
<a name="tutorial"></a>

이 주제에서는 eksctl을 설치 및 구성한 다음 이를 사용하여 Amazon EKS 클러스터를 생성하는 방법을 안내합니다.

## 1단계: eksctl 설치
<a name="_step_1_install_eksctl"></a>

Linux 또는 macOS 디바이스에 최신 버전의 eksctl을 다운로드하고 설치하려면 다음 단계를 완료하세요.

 **Homebrew를 사용하여 eksctl을 설치하려면** 

1. (사전 조건) [Homebrew](https://brew.sh/)를 설치합니다.

1. AWS 탭을 추가합니다.

   ```
   brew tap aws/tap
   ```

1. eksctl 설치

   ```
   brew install aws/tap/eksctl
   ```

eksctl을 사용하기 전에 다음 구성 단계를 완료합니다.

1. 사전 조건 설치:
   +  [AWS CLI 버전 2.x 이상을 설치합니다](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html).
   + Homebrew를 사용하여 [kubectl](https://formulae.brew.sh/formula/kubernetes-cli)을 설치합니다.

     ```
     brew install kubernetes-cli
     ```

1.  환경에서 [AWS 자격 증명을 구성합니다](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html).

   ```
   aws configure
   ```

1. AWS CLI 구성을 확인합니다.

   ```
   aws sts get-caller-identity
   ```

## 2단계: 클러스터 구성 파일 생성
<a name="_step_2_create_cluster_config_file"></a>

다음 단계를 사용하여 클러스터 구성 파일을 생성합니다.

1. 라는 새 파일을 생성합니다`cluster.yaml`.

   ```
   touch cluster.yaml
   ```

1. 다음과 같은 기본 클러스터 구성을 추가합니다.

   ```
   apiVersion: eksctl.io/v1alpha5
   kind: ClusterConfig
   
   metadata:
      name: basic-cluster
      region: us-west-2
   
   nodeGroups:
      - name: ng-1
        instanceType: m5.large
        desiredCapacity: 2
        minSize: 1
        maxSize: 3
        ssh:
           allow: false
   ```

1. 구성을 사용자 지정합니다.
   + 원하는 AWS 리전`region`에 맞게를 업데이트합니다.
   + 워크로드 요구 사항에 `instanceType` 따라를 수정합니다.
   + 필요에 `maxSize` 따라 `minSize`, 및 `desiredCapacity`를 조정합니다.

1. 구성 파일을 검증합니다.

   ```
   eksctl create cluster -f cluster.yaml --dry-run
   ```

## 3단계: 클러스터 생성
<a name="_step_3_create_cluster"></a>

다음 단계에 따라 EKS 클러스터를 생성합니다.

1. 구성 파일을 사용하여 클러스터를 생성합니다.

   ```
   eksctl create cluster -f cluster.yaml
   ```

1. 클러스터가 생성될 때까지 기다립니다(일반적으로 15\$120분 소요).

1. 클러스터 생성 확인:

   ```
   eksctl get cluster
   ```

1. 새 클러스터를 사용하도록 kubectl을 구성합니다.

   ```
   aws eks update-kubeconfig --name basic-cluster --region us-west-2
   ```

1. 클러스터 연결 확인:

   ```
   kubectl get nodes
   ```

이제 클러스터를 사용할 준비가 되었습니다.

### 선택 사항: 클러스터 삭제
<a name="_optional_delete_cluster"></a>

불필요한 요금을 방지하려면 완료 시 클러스터를 삭제해야 합니다.

```
eksctl delete cluster -f cluster.yaml
```

**참고**  
클러스터를 생성하면 AWS 요금이 발생할 수 있습니다. 클러스터를 생성하기 전에 [Amazon EKS 요금을](https://aws.amazon.com/eks/pricing/) 검토해야 합니다.

## 다음 단계
<a name="_next_steps"></a>
+ 클러스터에 연결하도록 Kubectl 구성
+ 샘플 앱 배포