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

# Eksctl 설치 옵션
<a name="installation"></a>

 `eksctl`는 아래 설명과 같이 공식 릴리스에서 설치할 수 있습니다. 공식 GitHub 릴리스`eksctl`에서만를 설치하는 것이 좋습니다. 타사 설치 프로그램을 사용하기로 선택할 수 있지만 AWS는 이러한 설치 방법을 유지 관리하거나 지원하지 않습니다. 재량에 따라 사용합니다.

## 사전 조건
<a name="_prerequisite"></a>

AWS API 자격 증명을 구성해야 합니다. AWS CLI 또는 기타 도구(kops, Terraform 등)에 사용할 수 있는 것으로 충분합니다. [`~/.aws/credentials` 파일](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html) 또는 [환경 변수를](https://docs.aws.amazon.com/cli/latest/userguide/cli-environment.html) 사용할 수 있습니다. 자세한 내용은 [AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-environment.html) 참조를 참조하세요.

또한에 [Kubernetes용 AWS IAM Authenticator ](https://github.com/kubernetes-sigs/aws-iam-authenticator) 명령(`aws-iam-authenticator`또는 `aws eks get-token` (AWS CLI 버전 1.16.156 이상에서 사용 가능)이 필요합니다`PATH`.

EKS 클러스터 생성에 사용되는 IAM 계정에는 이러한 최소 액세스 수준이 있어야 합니다.


| AWS 서비스 | 액세스 레벨 | 
| --- | --- | 
|  CloudFormation  |  전체 액세스  | 
|  EC2  |   **전체:** Tagging **Limited:** List, Read, Write  | 
|  EC2 Auto Scaling  |   **제한:** 목록, 쓰기  | 
|  EKS  |  전체 액세스  | 
|  IAM  |   **제한:** 목록, 읽기, 쓰기, 권한 관리  | 
|  Systems Manager  |   **제한:** 목록, 읽기  | 

## Unix의 경우
<a name="_for_unix"></a>

최신 릴리스를 다운로드하려면 다음을 실행합니다.

```
# for ARM systems, set ARCH to: `arm64`, `armv6` or `armv7`
ARCH=amd64
PLATFORM=$(uname -s)_$ARCH

curl -sLO "https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_$PLATFORM.tar.gz"

# (Optional) Verify checksum
curl -sL "https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_checksums.txt" | grep $PLATFORM | sha256sum --check

tar -xzf eksctl_$PLATFORM.tar.gz -C /tmp && rm eksctl_$PLATFORM.tar.gz

sudo install -m 0755 /tmp/eksctl /usr/local/bin && rm /tmp/eksctl
```

## Windows의 경우
<a name="_for_windows"></a>

직접 다운로드(최신 릴리스):
+  [AMD64/x86\$164](https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_windows_amd64.zip) 
+  [ARMv6](https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_windows_armv6.zip) 
+  [ARMv7](https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_windows_armv7.zip) 
+  [ARM64](https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_windows_arm64.zip) 

`PATH` 변수의 폴더에 아카이브의 압축을 풀어야 합니다.

필요에 따라 체크섬을 확인합니다.

1. 체크섬 파일 다운로드: [최신](https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_checksums.txt) 

1. 명령 프롬프트를 사용하여 `CertUtil`의 출력을 다운로드한 체크섬 파일과 수동으로 비교합니다.

   ```
     REM Replace amd64 with armv6, armv7 or arm64
     CertUtil -hashfile eksctl_Windows_amd64.zip SHA256
   ```

1. PowerShell을 사용하여 `-eq` 연산자를 사용하여 확인을 자동화하여 `True` 또는 `False` 결과를 가져옵니다.

   ```
   # Replace amd64 with armv6, armv7 or arm64
    (Get-FileHash -Algorithm SHA256 .\eksctl_Windows_amd64.zip).Hash -eq ((Get-Content .\eksctl_checksums.txt) -match 'eksctl_Windows_amd64.zip' -split ' ')[0]
   ```

### Git Bash 사용:
<a name="_using_git_bash"></a>

```
# for ARM systems, set ARCH to: `arm64`, `armv6` or `armv7`
ARCH=amd64
PLATFORM=windows_$ARCH

curl -sLO "https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_$PLATFORM.zip"

# (Optional) Verify checksum
curl -sL "https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_checksums.txt" | grep $PLATFORM | sha256sum --check

unzip eksctl_$PLATFORM.zip -d $HOME/bin

rm eksctl_$PLATFORM.zip
```

`eksctl` 실행 파일은 Git Bash`$PATH`의에 `$HOME/bin`있는에 배치됩니다.

## Homebrew
<a name="_homebrew"></a>

Homebrew를 사용하여 MacOS 및 Linux에 소프트웨어를 설치할 수 있습니다.

AWS는 eksctl을 포함한 Homebrew 탭을 유지합니다.

Homebrew 탭에 대한 자세한 내용은 [Github의 프로젝트](https://github.com/aws/homebrew-tap)와 eksctl용 [Homebrew 공식](https://github.com/aws/homebrew-tap/blob/master/Formula/eksctl.rb)을 참조하세요.

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

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

1. AWS 탭 추가

   ```
   brew tap aws/tap
   ```

1. eksctl 설치

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

## Docker
<a name="_docker"></a>

릴리스 및 RC마다 컨테이너 이미지가 ECR 리포지토리 로 푸시됩니다`public.ecr.aws/eksctl/eksctl`. [ECR 퍼블릭 갤러리 - eksctl](https://gallery.ecr.aws/eksctl/eksctl)에서 사용에 대해 자세히 알아봅니다. 예:

```
docker run --rm -it public.ecr.aws/eksctl/eksctl version
```

## 쉘 완료
<a name="_shell_completion"></a>

### Bash
<a name="_bash"></a>

bash 완성을 활성화하려면 다음을 실행하거나 `~/.bashrc` 또는에 넣습니다`~/.profile`.

```
. <(eksctl completion bash)
```

### Zsh
<a name="_zsh"></a>

zsh를 완료하려면 다음을 실행합니다.

```
mkdir -p ~/.zsh/completion/
eksctl completion zsh > ~/.zsh/completion/_eksctl
```

및는에 `~/.zshrc`다음을 입력합니다.

```
fpath=($fpath ~/.zsh/completion)
```

oh-my-zsh와 같은 배포를 실행하지 않는 경우 먼저 자동 완성을 활성화해야 할 수 있습니다(그리고 이를 영구화`~/.zshrc`하려면를 입력해야 할 수 있습니다).

```
autoload -U compinit
compinit
```

### 어류
<a name="_fish"></a>

아래 명령은 물고기 자동 완성에 사용할 수 있습니다.

```
mkdir -p ~/.config/fish/completions
eksctl completion fish > ~/.config/fish/completions/eksctl.fish
```

### Powershell
<a name="_powershell"></a>

아래 명령을 참조하여 설정할 수 있습니다. 경로는 시스템 설정에 따라 다를 수 있습니다.

```
eksctl completion powershell > C:\Users\Documents\WindowsPowerShell\Scripts\eksctl.ps1
```

## 업데이트
<a name="_updates"></a>

**중요**  
eksctl을 직접 다운로드하여 설치하는 경우(패키지 관리자를 사용하지 않음) 수동으로 업데이트해야 합니다.