macOS에 kubectl 설치하기

macOS에 kubectl 설치하기

출처: 문서

본문

시작하기 전에

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

macOS에 kubectl 설치

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

• macOS에 kubectl 설치
  • curl로 macOS에 kubectl 바이너리 설치
  • macOS에서 Homebrew로 설치
  • macOS에서 Macports로 설치
• kubectl 구성 확인
• 선택적인 kubectl 구성과 플러그인
  • 셸 자동 완성 활성화
  • kubectl convert 플러그인 설치

curl로 macOS에 kubectl 바이너리 설치

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

   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl"
   

   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl"
   

   특정 버전을 다운로드하려면 명령의 $(curl -L -s https://dl.k8s.io/release/stable.txt) 부분을 특정 버전으로 바꿔요.

   예를 들어 Intel macOS에 v1.37을 다운로드하려면:

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

   Apple Silicon의 macOS라면:

   curl -LO "https://dl.k8s.io/release/v1.37.0/bin/darwin/arm64/kubectl"
   

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

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

   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl.sha256"
   

   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl.sha256"
   

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

   echo "$(cat kubectl.sha256)  kubectl" | shasum -a 256 --check
   

   유효하다면 출력은:

   kubectl: OK
   

   검증이 실패하면 shasum은 0이 아닌 상태로 종료되고 다음과 비슷한 출력을 보여줘요:

   kubectl: FAILED
   shasum: WARNING: 1 computed checksum did NOT match
   

   같은 버전의 바이너리와 체크섬을 다운로드해야 해요.

3. kubectl 바이너리를 실행 가능하게 만든다.

   chmod +x ./kubectl
   

4. kubectl 바이너리를 시스템 PATH의 파일 위치로 옮긴다.

   sudo mv ./kubectl /usr/local/bin/kubectl
   sudo chown root: /usr/local/bin/kubectl
   

   /usr/local/bin이 PATH 환경 변수에 있는지 확인해야 해요.

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

   kubectl version --client
   

   또는 상세 보기를 위해:

   kubectl version --client --output=yaml
   

6. kubectl을 설치·검증한 후 체크섬 파일을 삭제한다:

   rm kubectl.sha256
   

macOS에서 Homebrew로 설치

macOS에서 Homebrew 패키지 관리자를 사용한다면 Homebrew로 kubectl을 설치할 수 있어요.

1. 설치 명령을 실행한다:

   brew install kubectl
   

   또는

   brew install kubernetes-cli
   

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

   kubectl version --client
   

macOS에서 Macports로 설치

macOS에서 Macports 패키지 관리자를 사용한다면 Macports로 kubectl을 설치할 수 있어요.

1. 설치 명령을 실행한다:

   sudo port selfupdate
   sudo port install kubectl
   

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

   kubectl version --client
   

kubectl 구성 확인

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

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

셸 자동 완성 활성화

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

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

kuberc 구성

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

kubectl convert 플러그인 설치

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

   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl-convert"
   

   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl-convert"
   

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

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

   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl-convert.sha256"
   

   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl-convert.sha256"
   

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

   echo "$(cat kubectl-convert.sha256)  kubectl-convert" | shasum -a 256 --check
   

   유효하다면 출력은:

   kubectl-convert: OK
   

   검증이 실패하면 shasum은 0이 아닌 상태로 종료되고 다음과 비슷한 출력을 보여줘요:

   kubectl-convert: FAILED
   shasum: WARNING: 1 computed checksum did NOT match
   

   같은 버전의 바이너리와 체크섬을 다운로드해야 해요.

3. kubectl-convert 바이너리를 실행 가능하게 만든다

   chmod +x ./kubectl-convert
   

4. kubectl-convert 바이너리를 시스템 PATH의 파일 위치로 옮긴다.

   sudo mv ./kubectl-convert /usr/local/bin/kubectl-convert
   sudo chown root: /usr/local/bin/kubectl-convert
   

   /usr/local/bin이 PATH 환경 변수에 있는지 확인해야 해요.

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

   kubectl convert --help
   

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

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

   rm kubectl-convert kubectl-convert.sha256
   

macOS에서 kubectl 제거하기

kubectl을 설치한 방법에 따라 다음 방법 중 하나를 사용해요.

명령줄로 kubectl 제거

1. 시스템에서 kubectl 바이너리를 찾는다:

   which kubectl
   

2. kubectl 바이너리를 제거한다:

   sudo rm <path>
   

   <path>를 이전 단계의 kubectl 바이너리 경로로 바꿔요. 예를 들어 sudo rm /usr/local/bin/kubectl.

homebrew로 kubectl 제거

Homebrew로 kubectl을 설치했다면 다음 명령을 실행해요:

brew remove kubectl

더 알아보기 (Learn more)

• kubectl 참조
• kubectl 접근 구성