Windows에 kubectl 설치하기

Windows에 kubectl 설치하기

출처: 문서

본문

시작하기 전에

클러스터와 minor 버전 차이가 하나 이내인 kubectl 버전을 사용해야 해요. 예를 들어 v1.37 클라이언트는 v1.36, v1.37, v1.38 컨트롤 플레인과 통신할 수 있습니다. 최신 호환 버전의 kubectl을 사용하면 예상치 못한 문제를 피하는 데 도움이 됩니다.

Windows에 kubectl 설치

Windows에서 kubectl을 설치하는 다음 방법이 있어요:

• Windows에 kubectl 바이너리 설치 (직접 다운로드 또는 curl로)
• Windows에서 Chocolatey, Scoop, winget으로 설치

Windows에 kubectl 바이너리 설치 (직접 다운로드 또는 curl로)

1. Windows 장치에 kubectl을 설치하는 두 가지 옵션이 있어요

   • 직접 다운로드:

     Kubernetes 릴리스 페이지를 방문해 특정 아키텍처용 최신 v1.37 패치 릴리스 바이너리를 직접 다운로드한다. 아키텍처(예: amd64, arm64 등)에 맞는 올바른 바이너리를 선택해야 한다.

   • curl 사용:

     curl이 설치되어 있다면 이 명령을 사용한다:

     curl.exe -LO "https://dl.k8s.io/release/v1.37.0/bin/windows/amd64/kubectl.exe"
     

   최신 안정 버전을 알아보려면(예: 스크립트용) https://dl.k8s.io/release/stable.txt를 확인해요.

2. 바이너리를 검증한다 (선택 사항)

   kubectl 체크섬 파일을 다운로드한다:

   curl.exe -LO "https://dl.k8s.io/v1.37.0/bin/windows/amd64/kubectl.exe.sha256"
   

   kubectl 바이너리를 체크섬 파일에 대해 검증한다:

   • Command Prompt로 CertUtil 출력을 다운로드한 체크섬 파일과 수동 비교:

     CertUtil -hashfile kubectl.exe SHA256
     type kubectl.exe.sha256
     

   • PowerShell로 -eq 연산자를 사용해 True·False 결과를 얻는 자동 검증:

      $(Get-FileHash -Algorithm SHA256 .\kubectl.exe).Hash -eq $(Get-Content .\kubectl.exe.sha256)
     

3. kubectl 바이너리 폴더를 PATH 환경 변수에 추가하거나 앞에 둔다.

4. kubectl의 버전이 다운로드한 것과 같은지 테스트한다:

   kubectl version --client
   

   또는 상세 보기를 위해:

   kubectl version --client --output=yaml
   

Docker Desktop for Windows는 자체 버전의 kubectl을 PATH에 추가해요. Docker Desktop을 이전에 설치했다면 PATH 항목을 Docker Desktop 설치기가 추가한 것보다 앞에 두거나, Docker Desktop의 kubectl을 제거해야 할 수 있습니다.

Windows에서 Chocolatey, Scoop, winget으로 설치

1. Windows에 kubectl을 설치하려면 Chocolatey 패키지 관리자, Scoop 명령줄 설치기, 또는 winget 패키지 관리자를 사용할 수 있어요.

   choco install kubernetes-cli
   

   scoop install kubectl
   

   winget install -e --id Kubernetes.kubectl
   

2. 설치한 버전이 최신인지 테스트한다:

   kubectl version --client
   

3. 홈 디렉토리로 이동한다:

   # If you're using cmd.exe, run: cd %USERPROFILE%
   cd ~
   

4. .kube 디렉토리를 만든다:

   mkdir .kube
   

5. 방금 만든 .kube 디렉토리로 이동한다:

   cd .kube
   

6. kubectl이 원격 쿠버네티스 클러스터를 사용하도록 구성한다:

   New-Item config -type file
   

메모장 같은 원하는 텍스트 편집기로 config 파일을 편집해요.

kubectl 구성 확인

kubectl이 동작하는지 확인하는 방법은 kubectl 접근 구성을 참고하세요.

선택적인 kubectl 구성과 플러그인

셸 자동 완성 활성화

kubectl은 Bash, Zsh, Fish, PowerShell에 대한 자동 완성을 제공하며, 입력을 많이 줄여줘요.

아래는 PowerShell에 대한 자동 완성을 설정하는 절차입니다.

kuberc 구성

자세한 내용은 kuberc를 참고하세요.

kubectl convert 플러그인 설치

1. 최신 릴리스를 명령으로 다운로드한다:

   curl.exe -LO "https://dl.k8s.io/release/v1.37.0/bin/windows/amd64/kubectl-convert.exe"
   

2. 바이너리를 검증한다 (선택 사항).

   kubectl-convert 체크섬 파일을 다운로드한다:

   curl.exe -LO "https://dl.k8s.io/v1.37.0/bin/windows/amd64/kubectl-convert.exe.sha256"
   

   kubectl-convert 바이너리를 체크섬 파일에 대해 검증한다:

   • Command Prompt로 CertUtil 출력을 다운로드한 체크섬 파일과 수동 비교:

     CertUtil -hashfile kubectl-convert.exe SHA256
     type kubectl-convert.exe.sha256
     

   • PowerShell로 -eq 연산자를 사용해 True·False 결과를 얻는 자동 검증:

     $($(CertUtil -hashfile .\kubectl-convert.exe SHA256)[1] -replace " ", "") -eq $(type .\kubectl-convert.exe.sha256)
     

3. kubectl-convert 바이너리 폴더를 PATH 환경 변수에 추가하거나 앞에 둔다.

4. 플러그인이 성공적으로 설치되었는지 확인한다.

   kubectl convert --help
   

   오류가 보이지 않으면 플러그인이 성공적으로 설치된 것입니다.

5. 플러그인 설치 후 설치 파일을 정리한다:

   del kubectl-convert.exe
   del kubectl-convert.exe.sha256
   

더 알아보기 (Learn more)

• kubectl 참조
• kubectl 접근 구성