도커 데스크톱 쿠버네티스

윈도우에서 쿠버네티스를 가장 빨리 만나는 길은 이미 깔려 있는 도커 데스크톱을 쓰는 것입니다. 설정 창의 체크박스 하나로 단일 노드 클러스터가 뜨고, kubectl 설정까지 자동으로 맞춰집니다.

• 도커 데스크톱은 내부적으로 WSL2 위에서 돈다 — 그래서 WSL에 준 자원이 곧 쿠버네티스가 쓸 자원이다
• Enable Kubernetes 체크 → Apply & restart, 이게 설치의 전부다(별도 바이너리를 받지 않는다)
• kubectl 컨텍스트가 docker-desktop 으로 자동 등록된다 — 터미널에서 바로 kubectl 을 쓸 수 있다
• 버전은 도커 데스크톱이 정한다 — 쿠버네티스 버전을 직접 고르려면 6장의 미니쿠베를 쓴다
• 이 장의 뒷부분은 "안 켜질 때" 되짚는 순서다 — 한 번에 켜졌다면 5절로 건너뛰어도 된다

출발점 — 도커 데스크톱

우분투에서 docker 명령을 쓰려면 — WSL 통합

Settings → Resources → WSL integration 에서 쓰는 배포판 토글을 켜고 Apply & restart 를 누른다. 이게 꺼져 있으면 우분투 터미널에서 docker 명령을 찾지 못한다(6장 미니쿠베도 이 설정을 그대로 쓴다).

.wslconfig 파일을 수정하는 것으로 도커에 할당할 수 있는 리소스를 지정할 수 있습니다. 아래 그림과 같이 processors와 memory 값을 넣는 것으로 도커에 할당할 CPU와 메모리 용량을 지정할 수 있습니다.

• 파일 위치는 윈도우 사용자 폴더 최상단이다 — 탐색기 주소창에 %UserProfile% 을 치면 바로 간다
• 새 텍스트 문서를 만들고 이름을 .wslconfig 로 바꾼다(확장자 .txt 가 남지 않게 주의한다)
• [wsl2] 섹션 아래 processors 와 memory 두 값만 있으면 된다
• 자원을 너무 크게 잡지 않는다 — 윈도우 본체가 쓸 몫을 남겨야 한다(8코어/6GB는 16GB 장비 기준의 예시다)
• 저장한 뒤 wsl --shutdown 으로 WSL을 한 번 내려야 새 값이 적용된다

1. 사용자 폴더 열기

탐색기 주소창에 %UserProfile% 을 입력하면 C:₩Users₩<계정> 으로 이동한다.

2. .wslconfig 파일 만들기

새 텍스트 문서를 만든 뒤 이름을 .wslconfig 로 바꾼다. 확장자 표시가 꺼져 있으면 .txt 가 뒤에 남을 수 있으니 확인한다.

3. 자원 값 넣기

C:\\Users\\<계정>\\.wslconfig복사

[wsl2]
processors=8
memory=6GB

4. 파일이 제자리에 있는지 확인

5. WSL을 내려서 적용하기

PowerShell에서 아래를 실행한다. WSL이 내려가면서 도커 데스크톱이 "WSL distro terminated abruptly" 경고를 띄우는데, Restart 를 눌러 다시 올리면 새 자원 값으로 시작한다.

wsl --shutdown

도커 데스크톱이 계속 멈춰 있거나 WSL 자체가 망가진 상태라면, WSL 기능을 다시 켜고 배포판을 새로 설치합니다. 관리자 권한 PowerShell에서 두 명령이면 됩니다.

• 먼저 도커 데스크톱이 멈춘 상태(Docker Desktop stopped…)인지 확인한다
• dism.exe 로 Windows 기능 "Linux용 Windows 하위 시스템"을 켠다 — 관리자 권한 PowerShell이어야 한다
• wsl --install 이 우분투를 내려받아 설치한다
• 설치 끝에 UNIX 사용자 계정을 만든다 — root 는 이미 있으므로 다른 이름을 쓴다
• Installation successful! 과 우분투 프롬프트가 뜨면 WSL2 쪽 준비는 끝난 것이다

1. 멈춘 상태 확인

2. WSL 기능 켜고 우분투 설치

관리자 권한 PowerShell에서 두 줄을 차례로 실행한다.

관리자 권한 PowerShell복사

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux
wsl --install

3. 설치 완료 확인

WSL을 새로 깔았다면 도커 데스크톱도 그 위에 다시 얹는 편이 확실합니다. 제어판에서 제거하고, 설치 파일로 다시 설치합니다.

• 제어판 → 프로그램 및 기능에서 Docker Desktop 을 제거한다
• 제거 중 "이 프로그램들을 닫아야 한다"는 창이 뜨면 Kill applications 를 누른다
• Uninstalled successfully 를 확인하고 Close 로 닫는다
• 도커 데스크탑을 다시 설치합니다 — 내려받아 둔 Docker Desktop Installer.exe 를 실행한다
• 설치가 끝나면 도커 데스크톱을 실행해 좌측 하단이 Engine running(초록)인지 먼저 확인한다

1. 제거

2. 다시 설치

도커 데스크탑을 다시 설치합니다 — 설치 파일을 실행하고 기본값으로 진행한다.

3. 엔진이 살아났는지 확인

여기가 이 장의 핵심입니다. Settings → Kubernetes 에서 Enable Kubernetes 를 체크하고 Apply & restart 를 누르면, 클러스터를 내려받아 설치하고 기동까지 알아서 진행합니다.

• Settings(톱니바퀴) → 좌측 Kubernetes 탭으로 들어간다
• Enable Kubernetes 체크 → 우측 하단 Apply & restart
• Kubernetes Cluster Installation 창이 뜨면 Install — 인터넷으로 이미지를 받으므로 몇 분 걸린다
• Starting … 진행바가 끝나면 하단 상태바에 아이콘 두 개가 초록으로 바뀐다
• 고래 아이콘 = Engine running(도커), 조타륜 아이콘 = Kubernetes running(쿠버네티스)
• 이 상태가 되면 터미널에서 kubectl get nodes 로 docker-desktop 노드가 보인다

1. 체크하고 적용

2. 기동 기다리기

3. 상태바에서 두 아이콘 확인

4. 터미널에서 확인

kubectl 컨텍스트가 docker-desktop 으로 잡혀 있고 노드 한 대가 Ready 면 끝이다.

kubectl config current-contextkubectl get nodes

클러스터가 이상한 상태로 남았을 때는 다시 깔지 말고 초기화합니다. Reset Kubernetes Cluster 는 클러스터의 모든 리소스를 지우고 빈 상태로 되돌립니다.

• Settings → Kubernetes → Reset Kubernetes Cluster
• 확인 창의 경고 그대로, 클러스터 안의 모든 스택과 리소스가 지워진다 — 도커 이미지는 남는다
• 되돌릴 수 없으므로, 실습 중인 매니페스트는 파일로 갖고 있어야 한다
• 초기화해도 안 되면 이 장의 3·4절(WSL 재설치 → 도커 재설치) 순서로 되짚는다
• 다음 장(6장 미니쿠베)은 도커 데스크톱 밖에서 클러스터를 따로 띄운다 — 쿠버네티스 버전을 직접 고르고 싶을 때의 선택지다

초기화 순서