Windows10 WSL2 환경에 minikube 구축하기

0. minikube란?

Minikube는 개발자가 로컬 머신에 Kubernetes 클러스터를 설정할 수 있는 오픈 소스 도구로서, 손쉽게 K8s를 구축할 수 있도록 지원하는 플랫폼입니다. 

Minikube를 사용하면 개발자가 본격적인 프로덕션 환경을 설정할 필요 없이 로컬에서 Kubernetes를 구축 및 운영할 수 있어서 테스트 및 스터디에 적합합니다.

 

또한 클라우드 또는 매니지드 환경에 구축할 필요 없이 로컬에 구성이 가능하므로 비용적인 부담이 발생하지 않습니다. 

 

Minikube 유사한 도구로는 K3s, K6s 등이 존재합니다.

 

1. WSL2 설치

1. 설치를 진행하기에 앞서 해당 글을 참고하여 WSL2 환경을 구성합니다.

 

2. 도커 설치

1. 공식 홈페이지를 통해 도커 데스크탑을 설치합니다.

2. 설치 과정 중 "Use WSL2 instead of Hyper-V"를 반드시 체크하고 진행합니다. 

3. 설치가 완료되면 자동으로 PC가 재부팅되고 이후에 Docker Desktop을 실행합니다.

4. WSL에 접속해 "docker" 명령어 입력 후 정상적으로 작동하는지 확인합니다.

 

3. minikube 설치 및 실행

1. 공식 홈페이지를 통해 WSL에 minikube를 설치합니다. 

2. WSL에 접속 후 아래 명령어를 입력합니다.

curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64

sudo install minikube-linux-amd64 /usr/local/bin/minikube

3. 설치 완료 후 `minikube version`을 입력해 정상 설치 여부를 확인합니다.

4. `minikube start --driver=docker` 명령어를 입력해 minikube를 실행합니다.

 

4. minikube 사용팁

1. alias 등록

k8s 명령 실행 시 매번 `kubectl`을 입력해야 하는 번거로움을 극복하기 위해 `k`를 alias로 등록합니다.

echo 'alias k=kubectl' >> ~/.bashrc
source ~/.bashrc

2. 명령어 자동 완성 등록

tab 키를 활용해 명령어가 자동 완성되도록 기능을 설정합니다.

kubectl completion bash | sudo tee /etc/bash_completion.d/kubectl
echo 'complete -o default -F __start_kubectl k' >> ~/.bashrc
source ~/.bashrc

 

5. 참고

1. https://minikube.sigs.k8s.io/docs/start/
2. https://velog.io/@jonas-jun/minikubewsl

[kubernetes in action] WSL에 minikube 설치하기

minikube start