[k8s] windows local 환경에서 wsl과 docker desktop 이용하여 설치 테스트

[k8s] windows local 환경에서 wsl과 docker desktop 이용하여 설치 테스트

2025. 8. 11. 21:34ㆍBackend/Container(Docker,k8s)

📝 Kubernetes(이하 'k8s') 를 로컬에서 설치하고, 쿠버네티스 dashboard 사이트를 접속해보기 위하여 작성한 글입니다.

윈도우 환경이지만, k8s 환경을 쉽게 설치하고자 WSL2을 사용하였습니다. wsl 설치는 아래 글을 참고해주세요

[Redis] Redis란? Redis 설치!

📝 [비전공자도 이해할 수 있는 Redis 입문/실전(조회 성능 최적화편)]을 공부하고 있습니다. 틀리거나 다른 부분이 있을 수 있습니다.Redis란 무엇일까요? Redis를 구글링을 통해 확인하게 되면,

gw-sheep.tistory.com

1. Windows powershell 을 이용하여, wsl을 실행합니다.

//powershell에서 ubuntu 실행
wsl -d Ubuntu

//wsl 관련 정보 확인
//wsl --list --verbose

2. wsl을 이용하여 k8s 설치

# kubernetes 설치
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
# kubectl 설치
sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl
# 설치 확인
kubectl version --client

3. 설치 후에, docker desktop에서 k8s 활성화

docker desktop > settings > Kubernetes > Enable Kubernetes

🧑‍💻 혹시라도 오류가 발생하거나 starting이 지속된다면, docker desktop을 한 번 재부팅 후 다시 시도해주세요~!

4. docker desktop의 kubeconfig를 사용하기

# Windows kubeconfig 경로를 WSL에서 참조
export KUBECONFIG=/mnt/c/Users/<윈도우계정>/.kube/config

# 참조 내용 확인
kubectl config get-contexts
kubectl get nodes

5. dashboard 배포

kubectl apply -f https://raw.githubusercontent.com/kubernetes/dashboard/v2.7.0/aio/deploy/recommended.yaml

6. Dashboard 접속을 위한 token 발급

kubectl -n kubernetes-dashboard create serviceaccount (계정)
kubectl create clusterrolebinding (계정)-binding \
  --clusterrole=cluster-admin \
  --serviceaccount=kubernetes-dashboard:(계정)
  
# Kubernetes 1.24+ 에서 토큰 발급:
kubectl -n kubernetes-dashboard create token (계정)

7. Proxy로 접근 및 Dashboard 확인