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
를 설치하려면-
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
-
-
(선택 사항) 해당 바이너리의 SHA-256 합계를 사용하여 다운로드한 바이너리를 확인합니다.
-
클러스터의 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
-
-
다운로드한 이진 파일에 대해 SHA-256 합계를 확인합니다.
openssl sha1 -sha256 kubectl
-
명령 출력에 생성된 SHA-256 합계를 다운로드한 SHA-256 파일과 비교합니다. 두 값이 일치해야 합니다.
-
-
바이너리에 실행 권한을 적용합니다.
chmod +x ./kubectl
-
바이너리를
PATH
의 폴더에 복사합니다.kubectl
버전이 이미 설치된 경우$HOME/bin/kubectl
을 생성하고$HOME/bin
이$PATH
로 시작하도록 해야 합니다.mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH
-
(선택 사항) 셸 초기화 파일에
$HOME/bin
경로를 추가하면 셸을 열 때 구성됩니다.echo 'export PATH=$PATH:$HOME/bin' >> ~/.bash_profile
-
kubectl
을 설치한 이후 다음 명령을 사용하여 버전을 확인할 수 있습니다.kubectl version --short --client
-
- Linux
-
Linux에서
kubectl
을 설치하려면-
하드웨어 플랫폼용 명령을 사용하여 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/linux/amd64/kubectl
curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.21.2/2021-07-05/bin/linux/arm64/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
curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.20.4/2021-04-12/bin/linux/arm64/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
curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.19.6/2021-01-05/bin/linux/arm64/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
curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/linux/arm64/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
curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/linux/arm64/kubectl
-
-
(선택 사항) 해당 바이너리의 SHA-256 합계를 사용하여 다운로드한 바이너리를 확인합니다.
-
하드웨어 플랫폼용 명령을 사용하여 Linux용 클러스터의 Kubernetes 버전에 대한 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/linux/amd64/kubectl.sha256
curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.21.2/2021-07-05/bin/linux/arm64/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
curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.20.4/2021-04-12/bin/linux/arm64/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
curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.19.6/2021-01-05/bin/linux/arm64/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
curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/linux/arm64/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
curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/linux/arm64/kubectl.sha256
-
-
다운로드한 이진 파일에 대해 SHA-256 합계를 확인합니다.
openssl sha1 -sha256 kubectl
-
명령 출력에 생성된 SHA-256 합계를 다운로드한 SHA-256 파일과 비교합니다. 두 값이 일치해야 합니다.
-
-
바이너리에 실행 권한을 적용합니다.
chmod +x ./kubectl
-
바이너리를
PATH
의 폴더에 복사합니다.kubectl
버전이 이미 설치된 경우$HOME/bin/kubectl
을 생성하고$HOME/bin
이$PATH
로 시작하도록 해야 합니다.mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$PATH:$HOME/bin
-
(선택 사항) 셸 초기화 파일에
$HOME/bin
경로를 추가하면 셸을 열 때 구성됩니다.참고 이 단계에는 Bash 셸을 사용한다고 가정합니다. 다른 셸을 사용하는 경우, 특정 셸 초기화 파일을 사용하도록 명령을 변경하십시오.
echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc
-
kubectl
을 설치한 이후 다음 명령을 사용하여 버전을 확인할 수 있습니다.kubectl version --short --client
-
- Windows
-
Windows에
kubectl
를 설치하려면-
PowerShell 터미널을 엽니다.
-
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
-
-
(선택 사항) 해당 바이너리의 SHA-256 합계를 사용하여 다운로드한 바이너리를 확인합니다.
-
클러스터의 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
-
-
다운로드한 이진 파일에 대해 SHA-256 합계를 확인합니다.
Get-FileHash kubectl.exe
-
명령 출력에 생성된 SHA-256 합계를 다운로드한 SHA-256 파일과 비교합니다. PowerShell 출력은 대문자이지만 이 두 가지는 일치해야 합니다.
-
-
바이너리를
PATH
의 폴더에 복사합니다. PATH에 명령줄 유틸리티에 사용하는 기존 디렉터리가 있으면 해당 디렉터리로 이진 파일을 복사하십시오. 그렇지 않은 경우 다음 단계를 완료합니다.-
C:\bin
과 같이, 명령줄 이진 파일용 새 디렉터리를 생성합니다. -
kubectl.exe
이진 파일을 새 디렉터리로 복사합니다. -
사용자 또는 시스템 PATH 환경 변수를 편집하여 PATH에 새 디렉터리를 추가합니다.
-
PowerShell 터미널을 닫고 새 PATH 변수를 가져오기 위해 새 터미널을 엽니다.
-
-
kubectl
을 설치한 이후 다음 명령을 사용하여 버전을 확인할 수 있습니다.kubectl version --short --client
-