[Kubernetes] 윈도우 환경 kubectl 설치 및 설정하기

시작하기 전에

클러스터의 마이너(minor) 버전 차이 내에 있는 kubectl 버전을 사용해야 한다.

예를 들어, v1.29 클라이언트는 v1.28, v1.29, v1.30의 컨트롤 플레인과 연동될 수 있다. 호환되는 최신 버전의 kubectl을 사용하면 예기치 않은 문제를 피할 수 있다

 

• 쿠버네티스 버전 : v1.24.9
• → kubectl 버전 : v1.24.1 을 설치하겠다

 

kubectl 설치 방법

다음과 같은 2가지 방법으로 윈도우에 kubectl을 설치할 수 있는데, 필자는 첫번째 방법으로 진행해보겠다.

1. 윈도우에서 curl을 사용하여 kubectl 바이너리 설치
2. Chocolatey, Scoop, 또는 winget을 사용하여 윈도우에 설치

 

kubectl 설치

• 최신 패치 릴리즈 버전은 1.29 다운로드 바로 받거나, : kubectl 1.29.1
• 다음 curl 명령어를 사용하여 다운로드 받는다

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

 

내가 사용하려는 kubernetes 환경에 맞는 버전을 선택한 것이니, 각자에게 맞는 버전으로 설치하면 될 것 같다.

 

오류

C:\Users\1194366\Downloads>curl.exe -LO "https://dl.k8s.io/release/v1.24.1/bin/windows/amd64/kubectl.exe"
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
  0     0    0     0    0     0      0      0 --:--:-- --:--:-- --:--:--     0
curl: (35) schannel: next InitializeSecurityContext failed: Unknown error (0x80092012) - 해당 함수에서 인증서에 대한 파 기 여부를 검사하지 못했습니다.

• 위와 같은 오류가 발생할 경우 다음과 같이 입력해준다

curl.exe -LO "https://dl.k8s.io/release/v1.24.1/bin/windows/amd64/kubectl.exe" --ssl-no-revoke

C:\Users\1194366\Downloads>curl.exe -LO "https://dl.k8s.io/release/v1.24.1/bin/windows/amd64/kubectl.exe" --ssl-no-revoke
  % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                 Dload  Upload   Total   Spent    Left  Speed
100   138  100   138    0     0    435      0 --:--:-- --:--:-- --:--:--   442
100 44.1M  100 44.1M    0     0  38.4M      0  0:00:01  0:00:01 --:--:-- 67.5M

 

다운로드한 kubectl 버전 확인

kubectl version --client

C:\Users\1194366\Downloads>kubectl version --client
WARNING: This version information is deprecated and will be replaced with the output from kubectl version --short.  Use --output=yaml|json to get the full version.
Client Version: version.Info{Major:"1", Minor:"24", GitVersion:"v1.24.1", GitCommit:"3ddd0f45aa91e2f30c70734b175631bec5b5825a", GitTreeState:"clean", BuildDate:"2022-05-24T12:26:19Z", GoVersion:"go1.18.2", Compiler:"gc", Platform:"windows/amd64"}
Kustomize Version: v4.5.4

 

버전에 대한 상세 정보 확인

kubectl version --client --output=yaml

C:\Users\1194366\Downloads>kubectl version --client --output=yaml
clientVersion:
  buildDate: "2022-05-24T12:26:19Z"
  compiler: gc
  gitCommit: 3ddd0f45aa91e2f30c70734b175631bec5b5825a
  gitTreeState: clean
  gitVersion: v1.24.1
  goVersion: go1.18.2
  major: "1"
  minor: "24"
  platform: windows/amd64
kustomizeVersion: v4.5.4

 

 

 

kubectl 환경변수 설정

• 일단, 다운로드 받은 kubectl.exe 파일을 C:\kubernetes 경로에 위치할 수 있도록 했다.
• 고급 시스템 설정 - 환경 변수의 시스템 변수 Path 편집 클릭
• 찾아보기 - kubernetes.exe 위치 경로 선택하여 추가

 

 

kubectl 명령어 테스트

 

 

 

참고

• 윈도우에 kubectl 설치 및 설정