kubectl 설치 - Amazon EKS

kubectl 설치

Kubernetes는 클러스터 API 서버와 통신하기 위해 kubectl이라는 명령줄 유틸리티를 사용합니다. 많은 운영 체제 패키지 관리자에서 kubectl 이진 파일을 제공하며, 흔히 이 방법이 수동 다운로드 및 설치 프로세스보다 훨씬 쉽습니다. 해당 운영 체제 또는 패키지 관리자에 대한 Kubernetes 문서의 지침에 따라 설치할 수 있습니다.

이 주제는 MacOS, Linux 및 Windows 운영 체제용 Amazon EKS 판매 kubectl 이진 파일을 다운로드하고 설치하는 데 도움이 됩니다. 사용 중인 운영 체제의 탭 이름을 선택합니다. 이러한 바이너리는 업스트림 커뮤니티 버전과 동일하며, Amazon EKS 또는 AWS에 고유한 것이 아닙니다.

참고

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

kubectl을 설치하려는 운영 체제의 이름이 있는 탭을 선택합니다.

macOS

macOS에 kubectl를 설치하려면

  1. Amazon S3에서 클러스터의 Kubernetes 버전에 대해 Amazon EKS 판매 kubectl 이진 파일을 다운로드합니다.

    • Kubernetes 1.21:

      curl -o kubectl  https://amazon-eks.s3-us-west-2.amazonaws.com/1.21.2/2021-07-05/bin/darwin/amd64/kubectl

    • Kubernetes 1.20:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.20.4/2021-04-12/bin/darwin/amd64/kubectl

    • Kubernetes 1.19:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.19.6/2021-01-05/bin/darwin/amd64/kubectl

    • Kubernetes 1.18:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/darwin/amd64/kubectl

    • Kubernetes 1.17:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/darwin/amd64/kubectl

    • Kubernetes 1.16:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.16.15/2020-11-02/bin/darwin/amd64/kubectl

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

    1. 클러스터의 Kubernetes 버전에 맞는 macOS용 SHA-256 합계를 다운로드합니다.

      • Kubernetes 1.21:

        curl -o kubectl.sha256 https://amazon-eks.s3-us-west-2.amazonaws.com/1.21.2/2021-07-05/bin/darwin/amd64/kubectl.sha256

      • Kubernetes 1.20:

        curl -o kubectl.sha256 https://amazon-eks.s3-us-west-2.amazonaws.com/1.20.4/2021-04-12/bin/darwin/amd64/kubectl.sha256

      • Kubernetes 1.19:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.19.6/2021-01-05/bin/darwin/amd64/kubectl.sha256

      • Kubernetes 1.18:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/darwin/amd64/kubectl.sha256

      • Kubernetes 1.17:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/darwin/amd64/kubectl.sha256

      • Kubernetes 1.16:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.16.15/2020-11-02/bin/darwin/amd64/kubectl.sha256

    2. 다운로드한 이진 파일에 대해 SHA-256 합계를 확인합니다.

      openssl sha1 -sha256 kubectl

    3. 명령 출력에 생성된 SHA-256 합계를 다운로드한 SHA-256 파일과 비교합니다. 두 값이 일치해야 합니다.

  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=$PATH:$HOME/bin' >> ~/.bash_profile

  6. kubectl을 설치한 이후 다음 명령을 사용하여 버전을 확인할 수 있습니다. 

    kubectl version --short --client
Linux

Linux에서 kubectl을 설치하려면

  1. Amazon S3에서 클러스터의 Kubernetes 버전에 대해 Amazon EKS 판매 kubectl 이진 파일을 다운로드합니다. Arm 버전을 다운로드하려면 명령을 실행하기 전에 amd64를 arm64로 변경합니다.

    • Kubernetes 1.21:

      curl -o kubectl https://amazon-eks.s3-us-west-2.amazonaws.com/1.21.2/2021-07-05/bin/linux/amd64/kubectl

    • Kubernetes 1.20:

      curl -o kubectl https://amazon-eks.s3-us-west-2.amazonaws.com/1.20.4/2021-04-12/bin/linux/amd64/kubectl

    • Kubernetes 1.19:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.19.6/2021-01-05/bin/linux/amd64/kubectl

    • Kubernetes 1.18:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/linux/amd64/kubectl

    • Kubernetes 1.17:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/linux/amd64/kubectl

    • Kubernetes 1.16:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.16.15/2020-11-02/bin/linux/amd64/kubectl

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

    1. 클러스터의 Kubernetes 버전에 대해 Linux용 SHA-256 합계를 다운로드합니다. Arm 버전을 다운로드하려면 명령을 실행하기 전에 <amd64>를 arm64로 변경합니다.

      • Kubernetes 1.21:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.21.2/2021-07-05/bin/linux/amd64/kubectl.sha256

      • Kubernetes 1.20:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.20.4/2021-04-12/bin/linux/amd64/kubectl.sha256

      • Kubernetes 1.19:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.19.6/2021-01-05/bin/linux/amd64/kubectl.sha256

      • Kubernetes 1.18:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/linux/amd64/kubectl.sha256

      • Kubernetes 1.17:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/linux/amd64/kubectl.sha256

      • Kubernetes 1.16:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.16.15/2020-11-02/bin/linux/amd64/kubectl.sha256

    2. 다운로드한 이진 파일에 대해 SHA-256 합계를 확인합니다.

      openssl sha1 -sha256 kubectl

    3. 명령 출력에 생성된 SHA-256 합계를 다운로드한 SHA-256 파일과 비교합니다. 두 값이 일치해야 합니다.

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

    chmod +x ./kubectl

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

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

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

    참고

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

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

  6. kubectl을 설치한 이후 다음 명령을 사용하여 버전을 확인할 수 있습니다. 

    kubectl version --short --client
Windows

Windows에 kubectl를 설치하려면

  1. PowerShell 터미널을 엽니다.

  2. Amazon S3에서 클러스터의 Kubernetes 버전에 대해 Amazon EKS 판매 kubectl 이진 파일을 다운로드합니다.

    • Kubernetes 1.21:

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.21.2/2021-07-05/bin/windows/amd64/kubectl.exe

    • Kubernetes 1.20:

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.20.4/2021-04-12/bin/windows/amd64/kubectl.exe

    • Kubernetes 1.19:

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.19.6/2021-01-05/bin/windows/amd64/kubectl.exe

    • Kubernetes 1.18:

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/windows/amd64/kubectl.exe

    • Kubernetes 1.17:

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/windows/amd64/kubectl.exe

    • Kubernetes 1.16:

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.16.15/2020-11-02/bin/windows/amd64/kubectl.exe

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

    1. 클러스터의 Kubernetes 버전에 대해 Windows용 SHA-256 합계를 다운로드합니다.

      • Kubernetes 1.21:

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.21.2/2021-07-05/bin/windows/amd64/kubectl.exe.sha256

      • Kubernetes 1.20:

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.20.4/2021-04-12/bin/windows/amd64/kubectl.exe.sha256

      • Kubernetes 1.19:

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.19.6/2021-01-05/bin/windows/amd64/kubectl.exe.sha256

      • Kubernetes 1.18:

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/windows/amd64/kubectl.exe.sha256

      • Kubernetes 1.17:

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/windows/amd64/kubectl.exe.sha256

      • Kubernetes 1.16:

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.16.15/2020-11-02/bin/windows/amd64/kubectl.exe.sha256

    2. 다운로드한 이진 파일에 대해 SHA-256 합계를 확인합니다.

      Get-FileHash kubectl.exe

    3. 명령 출력에 생성된 SHA-256 합계를 다운로드한 SHA-256 파일과 비교합니다. PowerShell 출력은 대문자이지만 이 두 가지는 일치해야 합니다.

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

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

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

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

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

  5. kubectl을 설치한 이후 다음 명령을 사용하여 버전을 확인할 수 있습니다. 

    kubectl version --short --client