kubectl 및 eksctl 설정

AWS CLI가 설치되면 Kubernetes 클러스터를 생성하고 관리하기 위해 설치해야 하는 두 가지 다른 도구가 있습니다.

• kubectl: kubectl 명령줄 도구는 Kubernetes 클러스터 내의 리소스를 관리하는 데 사용할 기본 도구입니다. 이 페이지에서는 Kubernetes 클러스터의 버전과 일치하는 kubectl 바이너리를 다운로드하고 설정하는 방법을 설명합니다. kubectl 설치 또는 업데이트를 참조하세요.

• eksctl: eksctl 명령줄 도구는 AWS 클라우드 또는 온프레미스(EKS Anywhere 사용)에서 EKS 클러스터를 생성하고 해당 클러스터를 수정 및 삭제하기 위해 만들어졌습니다. eksctl 설치를 참조하세요.

kubectl 설치 또는 업데이트

이 주제는 장치에 kubectl 바이너리를 다운로드하고 설치하거나 업데이트하는 데 도움이 됩니다. 바이너리는 업스트림 커뮤니티 버전과 동일합니다. 바이너리가 Amazon EKS 또는 AWS에 고유하지 않은 경우. kubectl의 필요한 특정 버전을 구하려면 아래 단계를 사용합니다. 많은 빌더가 단순히 brew install kubectl을 실행해서 설치합니다.

참고

Amazon EKS 클러스터 제어 영역과 마이너 버전이 하나 다른 kubectl 버전을 사용해야 합니다. 예를 들어 1.31 kubectl 클라이언트는 Kubernetes 1.30, 1.31 및 1.32 클러스터에서 작업합니다.

1단계: kubectl가 설치되어 있는지 확인

디바이스에 이미 kubectl이 설치되어 있는지 확인합니다.

kubectl version --client

디바이스의 경로에 kubectl이(가) 설치되어 있는 경우, 출력 예제에는 다음과 유사한 정보가 포함돼 있습니다. 현재 설치한 버전을 최신 버전으로 업데이트하려면 다음 단계를 완료하고 현재 버전이 있는 동일한 위치에 새 버전을 설치해야 합니다.

Client Version: v1.31.X-eks-1234567

출력이 되지 않는다면 kubectl이 설치되지 않았거나 디바이스의 경로에 있는 위치에 설치되지 않은 것입니다.

2단계: 설치 또는 kubectl 업데이트

다음 운영 체제 중 하나에 kubectl을 설치하거나 업데이트합니다.

• macOS

• Linux(AMD64)

• Linux(arm64)

• Windows

참고

이 섹션에 사용된 AWS 리전에서 사용자의 AWS 리전으로 다운로드 속도가 느려지면 콘텐츠 앞에 CloudFront를 설정하는 것이 좋습니다. 자세한 내용은 기본 CloudFront 배포 시작하기를 참조하세요.

macOS

아래 단계에 따라 macOS에 kubectl을 설치합니다. 이 단계는 다음과 같습니다.

• 원하는 Kubernetes 버전의 바이너리 선택 및 다운로드

• 선택적으로 바이너리의 체크섬 확인

• 바이너리의 권한에 실행 권한을 추가

• 바이너리를 PATH의 폴더에 복사

• 선택적으로 바이너리의 디렉터리를 PATH에 추가

절차:

1. Amazon S3에서 클러스터의 Kubernetes 버전에 대한 바이너리를 다운로드합니다.

   • Kubernetes 1.33

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.0/2025-05-01/bin/darwin/amd64/kubectl

   • Kubernetes 1.32

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.3/2025-04-17/bin/darwin/amd64/kubectl

   • Kubernetes 1.31

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.7/2025-04-17/bin/darwin/amd64/kubectl

   • Kubernetes 1.30

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.11/2025-04-17/bin/darwin/amd64/kubectl

   • Kubernetes 1.29

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-04-17/bin/darwin/amd64/kubectl

   • Kubernetes 1.28

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-04-17/bin/darwin/amd64/kubectl

   • Kubernetes 1.27

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2025-01-10/bin/darwin/amd64/kubectl

   • Kubernetes 1.26

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/darwin/amd64/kubectl

2. (선택사항) 해당 바이너리의 SHA-256 체크섬을 사용하여 다운로드한 바이너리를 확인합니다.

   1. 클러스터의 Kubernetes 버전에 대한 SHA-256 체크섬을 다운로드합니다.

      • Kubernetes 1.33

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.0/2025-05-01/bin/darwin/amd64/kubectl.sha256

      • Kubernetes 1.32

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.3/2025-04-17/bin/darwin/amd64/kubectl.sha256

      • Kubernetes 1.31

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.7/2025-04-17/bin/darwin/amd64/kubectl.sha256

      • Kubernetes 1.30

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.11/2025-04-17/bin/darwin/amd64/kubectl.sha256

      • Kubernetes 1.29

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-04-17/bin/darwin/amd64/kubectl.sha256

      • Kubernetes 1.28

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-04-17/bin/darwin/amd64/kubectl.sha256

      • Kubernetes 1.27

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2025-01-10/bin/darwin/amd64/kubectl.sha256

      • Kubernetes 1.26

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/darwin/amd64/kubectl.sha256

   2. 다운로드한 바이너리에 대해 SHA-256 체크섬을 확인합니다.

      openssl sha1 -sha256 kubectl

   3. 출력에 생성된 체크섬이 다운로드한 kubectl.sha256 파일의 체크섬과 일치하는지 확인합니다.

3. 바이너리에 실행 권한을 적용합니다.

   chmod +x ./kubectl

4. 바이너리를 PATH의 폴더에 복사합니다. kubectl 버전이 이미 설치된 경우 $HOME/bin/kubectl을 생성하고 $HOME/bin이 $PATH로 시작하도록 해야 합니다.

   mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH

5. (선택사항) 셸 초기화 파일에 $HOME/bin 경로를 추가하면 셸을 열 때 구성됩니다.

   echo 'export PATH=$HOME/bin:$PATH' >> ~/.bash_profile

Linux(AMD64)

아래 단계에 따라 Linux(amd64)에 kubectl을 설치합니다. 이 단계는 다음과 같습니다.

• 원하는 Kubernetes 버전의 바이너리 선택 및 다운로드

• 선택적으로 바이너리의 체크섬 확인

• 바이너리의 권한에 실행 권한을 추가

• 바이너리를 PATH의 폴더에 복사

• 선택적으로 바이너리의 디렉터리를 PATH에 추가

절차:

1. Amazon S3에서 클러스터의 Kubernetes 버전에 대한 kubectl 바이너리를 다운로드합니다.

   • Kubernetes 1.33

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.0/2025-05-01/bin/linux/amd64/kubectl

   • Kubernetes 1.32

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.3/2025-04-17/bin/linux/amd64/kubectl

   • Kubernetes 1.31

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.7/2025-04-17/bin/linux/amd64/kubectl

   • Kubernetes 1.30

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.11/2025-04-17/bin/linux/amd64/kubectl

   • Kubernetes 1.29

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-04-17/bin/linux/amd64/kubectl

   • Kubernetes 1.28

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-04-17/bin/linux/amd64/kubectl

   • Kubernetes 1.27

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2024-12-12/bin/linux/amd64/kubectl

   • Kubernetes 1.26

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/linux/amd64/kubectl

2. (선택사항) 해당 바이너리의 SHA-256 체크섬을 사용하여 다운로드한 바이너리를 확인합니다.

   1. 디바이스의 하드웨어 플랫폼용 명령을 사용하여 Amazon S3에서 클러스터의 Kubernetes 버전에 대한 SHA-256 체크섬을 다운로드합니다.

      • Kubernetes 1.33

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.0/2025-05-01/bin/linux/amd64/kubectl.sha256

      • Kubernetes 1.32

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.3/2025-04-17/bin/linux/amd64/kubectl.sha256

      • Kubernetes 1.31

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.7/2025-04-17/bin/linux/amd64/kubectl.sha256

      • Kubernetes 1.30

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.11/2025-04-17/bin/linux/amd64/kubectl.sha256

      • Kubernetes 1.29

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-04-17/bin/linux/amd64/kubectl.sha256

      • Kubernetes 1.28

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-04-17/bin/linux/amd64/kubectl.sha256

      • Kubernetes 1.27

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2024-12-12/bin/linux/amd64/kubectl.sha256

      • Kubernetes 1.26

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/linux/amd64/kubectl.sha256

   2. 다음 명령 중 하나를 사용하여 다운로드한 바이너리의 SHA-256 체크섬을 확인합니다.

      sha256sum -c kubectl.sha256

      or

      openssl sha1 -sha256 kubectl

   3. 첫 번째의 경우 kubectl: OK가 표시되고 두 번째의 경우 출력에서 생성된 체크섬이 다운로드한 kubectl.sha256 파일의 체크섬과 일치하는지 확인할 수 있습니다.

3. 바이너리에 실행 권한을 적용합니다.

   chmod +x ./kubectl

4. 바이너리를 PATH의 폴더에 복사합니다. kubectl 버전이 이미 설치된 경우 $HOME/bin/kubectl을 생성하고 $HOME/bin이 $PATH로 시작하도록 해야 합니다.

   mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH

5. (선택사항) 셸 초기화 파일에 $HOME/bin 경로를 추가하면 셸을 열 때 구성됩니다.

   참고

   이 단계에는 Bash 셸을 사용한다고 가정합니다. 다른 셸을 사용하는 경우, 특정 셸 초기화 파일을 사용하도록 명령을 변경하세요.

   echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc

Linux(arm64)

아래 단계에 따라 Linux(arm64)에 kubectl을 설치합니다. 이 단계는 다음과 같습니다.

• 원하는 Kubernetes 버전의 바이너리 선택 및 다운로드

• 선택적으로 바이너리의 체크섬 확인

• 바이너리의 권한에 실행 권한을 추가

• 바이너리를 PATH의 폴더에 복사

• 선택적으로 바이너리의 디렉터리를 PATH에 추가

절차:

1. Amazon S3에서 클러스터의 Kubernetes 버전에 대한 kubectl 바이너리를 다운로드합니다.

2. Amazon S3에서 클러스터의 Kubernetes 버전에 대한 kubectl 바이너리를 다운로드합니다.

   • Kubernetes 1.33

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.0/2025-05-01/bin/linux/arm64/kubectl

   • Kubernetes 1.32

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.3/2025-04-17/bin/linux/arm64/kubectl

   • Kubernetes 1.31

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.7/2025-04-17/bin/linux/arm64/kubectl

   • Kubernetes 1.30

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.11/2025-04-17/bin/linux/arm64/kubectl

   • Kubernetes 1.29

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-04-17/bin/linux/arm64/kubectl

   • Kubernetes 1.28

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-04-17/bin/linux/arm64/kubectl

   • Kubernetes 1.27

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2024-12-12/bin/linux/arm64/kubectl

   • Kubernetes 1.26

     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/linux/arm64/kubectl

3. (선택사항) 해당 바이너리의 SHA-256 체크섬을 사용하여 다운로드한 바이너리를 확인합니다.

   1. 디바이스의 하드웨어 플랫폼용 명령을 사용하여 Amazon S3에서 클러스터의 Kubernetes 버전에 대한 SHA-256 체크섬을 다운로드합니다.

      • Kubernetes 1.33

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.0/2025-05-01/bin/linux/arm64/kubectl.sha256

      • Kubernetes 1.32

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.3/2025-04-17/bin/linux/arm64/kubectl.sha256

      • Kubernetes 1.31

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.7/2025-04-17/bin/linux/arm64/kubectl.sha256

      • Kubernetes 1.30

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.11/2025-04-17/bin/linux/arm64/kubectl.sha256

      • Kubernetes 1.29

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-04-17/bin/linux/arm64/kubectl.sha256

      • Kubernetes 1.28

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-04-17/bin/linux/arm64/kubectl.sha256

      • Kubernetes 1.27

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2024-12-12/bin/linux/arm64/kubectl.sha256

      • Kubernetes 1.26

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/linux/arm64/kubectl.sha256

   2. 다음 명령 중 하나를 사용하여 다운로드한 바이너리의 SHA-256 체크섬을 확인합니다.

      sha256sum -c kubectl.sha256

      or

      openssl sha1 -sha256 kubectl

   3. 첫 번째의 경우 kubectl: OK가 표시되고 두 번째의 경우 출력에서 생성된 체크섬이 다운로드한 kubectl.sha256 파일의 체크섬과 일치하는지 확인할 수 있습니다.

4. 바이너리에 실행 권한을 적용합니다.

   chmod +x ./kubectl

5. 바이너리를 PATH의 폴더에 복사합니다. kubectl 버전이 이미 설치된 경우 $HOME/bin/kubectl을 생성하고 $HOME/bin이 $PATH로 시작하도록 해야 합니다.

   mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH

6. (선택사항) 셸 초기화 파일에 $HOME/bin 경로를 추가하면 셸을 열 때 구성됩니다.

   참고

   이 단계에는 Bash 셸을 사용한다고 가정합니다. 다른 셸을 사용하는 경우, 특정 셸 초기화 파일을 사용하도록 명령을 변경하세요.

   echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc

Windows

아래 단계에 따라 Windows에 kubectl을 설치합니다. 이 단계는 다음과 같습니다.

• 원하는 Kubernetes 버전의 바이너리 선택 및 다운로드

• 선택적으로 바이너리의 체크섬 확인

• 바이너리를 PATH의 폴더에 복사

• 선택적으로 바이너리의 디렉터리를 PATH에 추가

절차:

1. PowerShell 터미널을 엽니다.

2. Amazon S3에서 클러스터의 Kubernetes 버전에 대한 kubectl 바이너리를 다운로드합니다.

   • Kubernetes 1.33

     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.0/2025-05-01/bin/windows/amd64/kubectl.exe

   • Kubernetes 1.32

     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.3/2025-04-17/bin/windows/amd64/kubectl.exe

   • Kubernetes 1.31

     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.7/2025-04-17/bin/windows/amd64/kubectl.exe

   • Kubernetes 1.30

     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.11/2025-04-17/bin/windows/amd64/kubectl.exe

   • Kubernetes 1.29

     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-04-17/bin/windows/amd64/kubectl.exe

   • Kubernetes 1.28

     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-04-17/bin/windows/amd64/kubectl.exe

   • Kubernetes 1.27

     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2024-12-12/bin/windows/amd64/kubectl.exe

   • Kubernetes 1.26

     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/windows/amd64/kubectl.exe

3. (선택사항) 해당 바이너리의 SHA-256 체크섬을 사용하여 다운로드한 바이너리를 확인합니다.

   1. 클러스터의 Windows용 Kubernetes 버전에 대한 SHA-256 체크섬을 다운로드합니다.

      • Kubernetes 1.33

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.0/2025-05-01/bin/windows/amd64/kubectl.exe.sha256

      • Kubernetes 1.32

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.3/2025-04-17/bin/windows/amd64/kubectl.exe.sha256

      • Kubernetes 1.31

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.7/2025-04-17/bin/windows/amd64/kubectl.exe.sha256

      • Kubernetes 1.30

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.11/2025-04-17/bin/windows/amd64/kubectl.exe.sha256

      • Kubernetes 1.29

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2025-04-17/bin/windows/amd64/kubectl.exe.sha256

      • Kubernetes 1.28

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.15/2025-04-17/bin/windows/amd64/kubectl.exe.sha256

      • Kubernetes 1.27

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.16/2024-12-12/bin/windows/amd64/kubectl.exe.sha256

      • Kubernetes 1.26

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-12-12/bin/windows/amd64/kubectl.exe.sha256

   2. 다운로드한 바이너리에 대해 SHA-256 체크섬을 확인합니다.

      Get-FileHash kubectl.exe

   3. 출력에 생성된 체크섬이 다운로드한 kubectl.sha256 파일의 체크섬과 일치하는지 확인합니다. PowerShell 출력은 해당하는 대문자 문자열이어야 합니다.

4. 바이너리를 PATH의 폴더에 복사합니다. PATH에 명령줄 유틸리티에 사용하는 기존 디렉터리가 있으면 해당 디렉터리로 바이너리를 복사하세요. 그렇지 않은 경우 다음 단계를 완료합니다.

   1. C:\bin과 같이, 명령줄 이진 파일용 새 디렉터리를 생성합니다.

   2. kubectl.exe 이진 파일을 새 디렉터리로 복사합니다.

   3. 사용자 또는 시스템 PATH 환경 변수를 편집하여 PATH에 새 디렉터리를 추가합니다.

   4. PowerShell 터미널을 닫고 새 PATH 변수를 가져오기 위해 새 터미널을 엽니다.

5. kubectl을 설치한 이후 버전을 확인할 수 있습니다.

   kubectl version --client

6. kubectl을 처음 설치할 때 아직 어떤 서버와도 통신이 구성되지 않았습니다. 필요에 따라 다른 절차에서 이 구성을 설명합니다. 특정 클러스터와의 통신을 위해 구성을 업데이트해야 하는 경우 다음 명령을 실행할 수 있습니다. region-code를 클러스터가 있는 AWS 리전으로 바꿉니다. my-cluster를 해당 클러스터의 이름으로 바꿉니다.

   aws eks update-kubeconfig --region region-code --name my-cluster

7. 처음 몇 글자를 입력한 후 Tab 키를 사용하여 kubectl 하위 명령을 완료할 수 있는 자동 완성 구성을 고려합니다. 자세한 내용은 Kubernetes Documentation의 Kubectl autocomplete를 참조하세요.

eksctl 설치

eksctl CLI는 EKS 클러스터 작업에 사용됩니다. 이는 많은 개별 작업을 자동화합니다. eksctl 설치에 대한 지침은 eksctl 설명서의 설치를 참조하세요. Linux의 경우 UNIX 지침을 사용합니다.

eksctl을 사용하는 경우 사용 중인 IAM 보안 주체에 Amazon EKS IAM 역할, 서비스 연결 역할, AWS CloudFormation, VPC, 관련 리소스를 사용할 수 있는 권한이 있어야 합니다. 자세한 내용은 IAM 사용 설명서의 서비스 연결 역할 사용을 참조하세요. 이 가이드의 모든 단계를 동일한 사용자로 완료해야 합니다. 현재 사용자를 확인하려면 다음 명령을 실행합니다.

aws sts get-caller-identity

다음 단계

• 빠른 시작: 웹 앱 배포 및 데이터 저장