[MacOS 환경 #1] Docker Desktop, kubectl로 쿠버네티스 연결하기

도커 desktop 설치 및 설정

도커 데스크탑 maxOS 버전 설치 후
setting에 들어가서 kubernetes를 누르면 알아서 쿠버네티스를 내려받아 단일 노드 클러스터를 실행해준다.

이 과정에서 자동으로 쿠버네티스 런타임에 필요한 모든 컨테이너 이미지를 내려받아준다.
아주 편리한 기능이다.

도커 명령행 도구 설치

쿠버네티스는 kubectl이라는 명령행 도구를 사용한다.
kubectl은 쿠버네티스 클러스터에 접속하여 쿠버네티스 API를 이용하여 클러스터를 관리하기 때문에 ,
도커 데스크톱과 K3s를 설치해도 kubectl이 함께 설치되지만, 나는 macOS 환경이기 때문에,

홈브루를 사용해야 한다.

https://kubernetes.io/docs/tasks/tools/
https://kubernetes.io/ko/docs/tasks/tools/install-kubectl-macos/
에 접속하면 윈도우나 맥에서 큐브커틀을 설치하는 방법에 대해 나와있다.

MacOS-큐브커틀 설치 방법

나는 터미널 도구를 통해 설치를 했다.
curl 명령어를 통해 설치를 진행한다.

1️⃣ kubectl 바이너리 다운로드
나는 M2기 때문에 다음과 같은 명령어를 실행하여 커틀을 다운로드했다.
(intel 환경인 경우 명령어가 다르다.)

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

2️⃣ 실행 권한 부여

chmod +x ./kubectl

3️⃣ 시스템 경로로 이동

sudo mv ./kubectl /usr/local/bin/kubectl

명령어를 실행한다.

4️⃣ 설치 확인
그 후, 잘 설치되었는지 확인하고 설치 버전을 확인하기 위해 다음과 같은 명령어를 실행해준다.

kubectl version --client

이런 결과를 확인할 수 있다.

생성한 클러스터 확인

명령행 도구도 설치했으니 이제 클러스터가 정상 동작중인지 확인해야 한다.
도커 데스크탑이 자동으로 위에서 쿠버네티스 컨트롤 플레인 + 워크노드를 내부적으로 구성했기 때문이다.
따라서

kubectl get nodes

를 실행하면 노드가 떠야 하는데
하지만 처음 실행했을 때 다음과 같은 오류가 발생했다.

처음 보는 에러라 감이 안 잡혀서 ChatGPT에게 물어보니,
kubectl이 아직 도커 데스크탑 쿠버네티스의 kubeconfig 파일을 인식하지 못하고 있다는 답변을 받았다.

그래서 이것을 해결해보겠다.

kubectl이 kubeconfig 파일 인식하게 하기

터미널에서 다음과 같은 명령어를 친다.

kubectl config use-context docker-desktop

그럼 이렇게 결과가 뜨는데, 이 명령어는
이 명령어는 kubectl이 “docker-desktop”이라는 쿠버네티스 클러스터로
연결 대상을 변경했다는 의미이다.

그런다음 아까 실패한
다음 명령어를 실행하여 다시 노드를 확인한다.

kubectl get nodes

드디어 성공적으로 쿠버네티스 클러스터가 연결되었다.
이제 kubectl을 통해 클러스터 자원들을 자유롭게 확인하고 관리할 수 있다.