AWS 설명서 » Amazon EKS » 사용 설명서 » 클러스터 인증 관리 » kubectl 설치

kubectl 설치

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

이 주제는 MacOS, Linux 및 Windows 운영 체제용 Amazon EKS 판매 kubectl 이진 파일을 다운로드하고 설치하는 데 도움이 됩니다.

참고

Amazon EKS 클러스터 제어 플레인과 마이너 버전이 하나 정도 다른 kubectl 버전을 사용해야 합니다. 예를 들어, 1.11 kubectl 클라이언트는 Kubernetes 1.10, 1.11 및 1.12 클러스터로 작업해야 합니다.

macOSLinuxWindows

macOS

macOS에 kubectl를 설치하려면

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

   • Kubernetes 1.12:

     curl -o kubectl https://amazon-eks.s3-us-west-2.amazonaws.com/1.12.9/2019-06-21/bin/darwin/amd64/kubectl

   • Kubernetes 1.11:

     curl -o kubectl https://amazon-eks.s3-us-west-2.amazonaws.com/1.11.10/2019-06-21/bin/darwin/amd64/kubectl

   • Kubernetes 1.10:

     curl -o kubectl https://amazon-eks.s3-us-west-2.amazonaws.com/1.10.13/2019-06-21/bin/darwin/amd64/kubectl

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

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

      • Kubernetes 1.12:

        curl -o kubectl.sha256 https://amazon-eks.s3-us-west-2.amazonaws.com/1.12.9/2019-06-21/bin/darwin/amd64/kubectl.sha256

      • Kubernetes 1.11:

        curl -o kubectl.sha256 https://amazon-eks.s3-us-west-2.amazonaws.com/1.11.10/2019-06-21/bin/darwin/amd64/kubectl.sha256

      • Kubernetes 1.10:

        curl -o kubectl.sha256 https://amazon-eks.s3-us-west-2.amazonaws.com/1.10.13/2019-06-21/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=$HOME/bin:$PATH' >> ~/.bash_profile

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

   kubectl version --short --client

Linux

Linux에 kubectl을 설치하려면

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

   • Kubernetes 1.12:

     curl -o kubectl https://amazon-eks.s3-us-west-2.amazonaws.com/1.12.9/2019-06-21/bin/linux/amd64/kubectl

   • Kubernetes 1.11:

     curl -o kubectl https://amazon-eks.s3-us-west-2.amazonaws.com/1.11.10/2019-06-21/bin/linux/amd64/kubectl

   • Kubernetes 1.10:

     curl -o kubectl https://amazon-eks.s3-us-west-2.amazonaws.com/1.10.13/2019-06-21/bin/linux/amd64/kubectl

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

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

      • Kubernetes 1.12:

        curl -o kubectl.sha256 https://amazon-eks.s3-us-west-2.amazonaws.com/1.12.9/2019-06-21/bin/linux/amd64/kubectl.sha256

      • Kubernetes 1.11:

        curl -o kubectl.sha256 https://amazon-eks.s3-us-west-2.amazonaws.com/1.11.10/2019-06-21/bin/linux/amd64/kubectl.sha256

      • Kubernetes 1.10:

        curl -o kubectl.sha256 https://amazon-eks.s3-us-west-2.amazonaws.com/1.10.13/2019-06-21/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=$HOME/bin:$PATH

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

   참고

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

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

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

   kubectl version --short --client

Windows

Windows에 kubectl을 설치하려면

1. PowerShell 터미널을 엽니다.

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

   • Kubernetes 1.12:

     curl -o kubectl.exe https://amazon-eks.s3-us-west-2.amazonaws.com/1.12.9/2019-06-21/bin/windows/amd64/kubectl.exe

   • Kubernetes 1.11:

     curl -o kubectl.exe https://amazon-eks.s3-us-west-2.amazonaws.com/1.11.10/2019-06-21/bin/windows/amd64/kubectl.exe

   • Kubernetes 1.10:

     curl -o kubectl.exe https://amazon-eks.s3-us-west-2.amazonaws.com/1.10.13/2019-06-21/bin/windows/amd64/kubectl.exe

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

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

      • Kubernetes 1.12:

        curl -o kubectl.exe.sha256 https://amazon-eks.s3-us-west-2.amazonaws.com/1.12.9/2019-06-21/bin/windows/amd64/kubectl.exe.sha256

      • Kubernetes 1.11:

        curl -o kubectl.exe.sha256 https://amazon-eks.s3-us-west-2.amazonaws.com/1.11.10/2019-06-21/bin/windows/amd64/kubectl.exe.sha256

      • Kubernetes 1.10:

        curl -o kubectl.exe.sha256 https://amazon-eks.s3-us-west-2.amazonaws.com/1.10.13/2019-06-21/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