콘솔에 로그인
Amazon EKS
사용 설명서

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

kubectl 설치

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

이 주제는 MacOS, Linux 및 Windows 운영 체제용 Amazon EKS 판매 kubectl 바이너리를 다운로드하고 설치하는 데 도움이 됩니다.

MacOS

이 섹션은 MacOS 클라이언트용 kubectl 설치에 도움이 됩니다.

MacOS에 kubectl을 설치하려면

  1. Amazon S3에서 Amazon EKS 판매 kubectl 바이너리를 다운로드합니다. 

    curl -o kubectl https://amazon-eks.s3-us-west-2.amazonaws.com/1.11.5/2018-12-06/bin/darwin/amd64/kubectl

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

    1. MacOS용 SHA-256 합계 다운로드:

      curl -o kubectl.sha256 https://amazon-eks.s3-us-west-2.amazonaws.com/1.11.5/2018-12-06/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 $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 클라이언트용 kubectl 설치에 도움이 됩니다.

Linux에 kubectl을 설치하려면

  1. Amazon S3에서 Amazon EKS 판매 kubectl 바이너리를 다운로드합니다. 

    curl -o kubectl https://amazon-eks.s3-us-west-2.amazonaws.com/1.11.5/2018-12-06/bin/linux/amd64/kubectl

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

    1. Linux용 SHA-256 합계 다운로드:

      curl -o kubectl.sha256 https://amazon-eks.s3-us-west-2.amazonaws.com/1.11.5/2018-12-06/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 $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가 설치된

이 섹션은 PowerShell을 이용한 Windows 클라이언트용 kubectl 설치에 도움이 됩니다.

Windows에서 kubectl을 설치하려면

  1. PowerShell 터미널을 엽니다.

  2. Amazon S3에서 Amazon EKS 판매 kubectl 바이너리를 다운로드합니다. 

    curl -o kubectl.exe https://amazon-eks.s3-us-west-2.amazonaws.com/1.11.5/2018-12-06/bin/windows/amd64/kubectl.exe

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

    1. Windows용 SHA-256 합계 다운로드:

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

이 페이지에서: