쿠버네티스 첫걸음 2편 — 맥·윈도우에 라이선스 걱정 없이 로컬 클러스터 만들기: Rancher Desktop·OrbStack·Docker Desktop·kind·minikube·k3d 비교

들어가며 — 쿠버네티스를 연습할 클러스터가 없다

크게 보기

쿠버네티스를 배우려는 분이 가장 먼저 부딪히는 벽은 "연습할 클러스터가 없다"는 것입니다. 회사 클러스터에서 연습하자니 무언가를 망가뜨릴까 겁나고, 클라우드에 EKS를 만들자니 시간당 요금이 나갑니다. 그리고 도커 첫걸음 2편에서 봤던 라이선스 질문이 다시 나옵니다. "Docker Desktop에 쿠버네티스 켜기 버튼이 있던데, 그거 회사에서 써도 되나요?"

답은 간단합니다. 노트북 안에 작은 클러스터를 만들면 됩니다. 무료이고, 몇 분이면 되고, 망가뜨려도 지우고 다시 만들면 그만입니다.

1. 로컬 클러스터 도구가 하는 일

도커 2편에서 맥·윈도우용 도커 도구는 "작은 리눅스 VM을 띄워 그 안에서 도커 엔진을 돌리는 앱"이라고 했습니다. 로컬 쿠버네티스 도구도 같은 원리입니다. 방식은 크게 두 가지입니다.

2. 도구 한눈에 비교 (2026년 9월 기준)

아래 위젯에서 운영체제, 사용처, 이미 쓰는 도커 도구, 목적을 고르면 추천 순서와 시작 명령, kubectl에서 보일 context 이름이 나옵니다.

3. 공통 준비 — kubectl 설치

kubectl(큐브컨트롤, 큐브씨티엘 등으로 읽음)은 쿠버네티스에 명령을 보내는 공식 CLI입니다. 어떤 도구로 클러스터를 만들든 kubectl로 조작합니다. Rancher Desktop·Docker Desktop·OrbStack은 kubectl을 함께 설치해 주지만, 따로 설치해 두면 버전 관리가 편합니다.

맥

brew install kubectl

윈도우 (PowerShell)

winget install -e --id Kubernetes.kubectl

설치를 확인합니다.

kubectl version --client

4. 맥에서 클러스터 만들기

4-1. Rancher Desktop (회사 무료 · GUI)

도커 2편에서 Rancher Desktop을 설치했다면 이미 절반은 끝났습니다. 아직이라면:

brew install --cask rancher

앱을 열고 Preferences → Kubernetes에서:

4-2. OrbStack (개인 맥 · 가장 가벼움)

brew install --cask orbstack
orb start k8s

OrbStack 앱의 Kubernetes 탭에서 켜도 됩니다. OrbStack은 서비스에 *.k8s.orb.local 도메인을 자동으로 붙여 주고, 로컬에서 빌드한 이미지를 레지스트리 없이 바로 파드에서 쓸 수 있습니다. 다만 업무용은 유료라는 점(도커 2편)을 기억하세요.

4-3. kind (무료 · 여러 노드 · 도커 필요)

kind는 도커 엔진이 있어야 합니다. OrbStack·Rancher Desktop·Colima 무엇이든 도커가 돌고 있으면 됩니다.

brew install kind
kind create cluster --name dev

노드를 여러 개 만들어 보고 싶다면 설정 파일을 씁니다. 아래 내용을 kind-multi.yaml로 저장하세요.

kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
nodes:
  - role: control-plane
  - role: worker
  - role: worker

kind create cluster --name multi --config kind-multi.yaml

다 쓰면 지웁니다. 몇 초면 사라집니다.

kind delete cluster --name multi

4-4. minikube · k3d (선택)

brew install minikube
minikube start --memory 6g

brew install k3d
k3d cluster create dev --agents 2

5. 윈도우에서 클러스터 만들기

윈도우의 로컬 쿠버네티스는 모두 WSL2 위에서 돕니다. 도커 2편의 "8-1. WSL2 설치"를 먼저 마치세요.

5-1. Rancher Desktop (가장 쉬움 · 무료 · GUI)

winget install --id SUSE.RancherDesktop

첫 화면(또는 Preferences → Kubernetes)에서 Enable Kubernetes를 체크하고, Container Engine은 dockerd (moby)를 고릅니다. 설치가 끝나면 PowerShell에서 바로 kubectl을 쓸 수 있습니다.

5-2. kind (무료 · 여러 노드)

도커가 돌고 있어야 합니다(Rancher Desktop의 dockerd, 또는 WSL2 안의 Docker Engine).

winget install -e --id Kubernetes.kind
kind create cluster --name dev

WSL2 우분투 안에 Docker Engine을 직접 설치했다면(도커 2편 8-3), 우분투 터미널 안에서 리눅스용 kind와 kubectl을 설치해 쓰는 편이 자연스럽습니다.

curl -Lo ./kind https://kind.sigs.k8s.io/dl/latest/kind-linux-amd64
chmod +x ./kind && sudo mv ./kind /usr/local/bin/kind
kind create cluster --name dev

5-3. minikube (선택)

winget install -e --id Kubernetes.minikube
minikube start --driver=docker --memory 6g

6. 확인 — 이 세 줄이 되면 준비 완료

어떤 도구든 클러스터가 만들어지면 아래 명령으로 확인합니다.

kubectl config current-context
kubectl get nodes
kubectl get pods -A

get nodes에 노드가 Ready로 보이면 성공입니다.

NAME                   STATUS   ROLES                  AGE   VERSION
lima-rancher-desktop   Ready    control-plane,master   2m    v1.36.4+k3s1

get pods -A(모든 네임스페이스)에는 kube-system 네임스페이스에 coredns 같은 시스템 파드들이 Running으로 보입니다. 쿠버네티스가 스스로를 돌리려고 띄운 파드들입니다. 건드리지 마세요.

7. kubeconfig와 context — kubectl은 어디에 연결되나

kubectl은 kubeconfig라는 설정 파일을 읽어 어느 클러스터에, 누구로, 어느 네임스페이스에 명령을 보낼지 정합니다. 기본 위치는 ~/.kube/config(윈도우는 %USERPROFILE%\.kube\config)입니다. 로컬 도구들은 클러스터를 만들 때 이 파일에 자기 항목을 자동으로 추가합니다.

도구를 여러 개 써 봤다면 context도 여러 개입니다.

kubectl config get-contexts

CURRENT   NAME              CLUSTER           AUTHINFO          NAMESPACE
          kind-dev          kind-dev          kind-dev
*         orbstack          orbstack          orbstack
          rancher-desktop   rancher-desktop   rancher-desktop

별표가 현재 context입니다. 바꾸려면:

kubectl config use-context kind-dev

8. 첫 파드 한 번 띄워 보기

3편에서 자세히 하겠지만, 클러스터가 제대로 도는지 맛만 봅시다.

kubectl run hello --image=nginx:1.29
kubectl get pods

hello 파드가 ContainerCreating을 거쳐 Running이 되면 성공입니다. 브라우저로 확인해 봅니다.

kubectl port-forward pod/hello 8080:80

http://localhost:8080에 nginx 환영 페이지가 보입니다. Ctrl+C로 port-forward를 끝내고 파드를 지웁니다.

kubectl delete pod hello

9. 한 걸음 더 — k3s 제대로 알기

지금까지 k3s는 Rancher Desktop·OrbStack·Colima·k3d 안에 숨어 있는 엔진으로만 나왔습니다. 그런데 k3s는 그 자체로 가장 널리 쓰이는 쿠버네티스 배포판 중 하나이고, 특히 팀이 함께 쓰는 작은 클러스터를 만들 때 가장 손쉬운 선택입니다. 노트북 밖으로 한 걸음 나가 봅시다.

9-1. k3s는 무엇을 덜고, 무엇을 더했나

k3s는 SUSE(Rancher)가 만든 Apache 2.0 오픈소스이고, CNCF(클라우드 네이티브 컴퓨팅 재단) 샌드박스 프로젝트이자 CNCF 적합성 인증을 받은 배포판입니다. 쿠버네티스 API는 그대로 두고, 설치와 운영을 무겁게 만드는 부분을 바꿨습니다.

k3s에 기본으로 들어 있는 것 — 3·4편에서 "k3s 계열은 된다"고 했던 이유가 여기 있습니다.

이름이 비슷한 친척들 — 헷갈리기 쉬우니 한 번에 정리합니다.

9-2. 리눅스 서버에 k3s 설치하기 — 팀 공용 클러스터

사내에 남는 리눅스 서버, 클라우드 VM 한 대, 또는 맥이라면 OrbStack의 리눅스 머신(orb create ubuntu k3s-lab)이 있으면 됩니다. 필요한 것은 서버 2코어·2GB 이상, 그리고 노드끼리 통신할 포트(TCP 6443 API 서버, UDP 8472 네트워크, TCP 10250 kubelet)가 열려 있는 것입니다.

① 서버(컨트롤 플레인) 설치 — 서버에 SSH로 접속해 한 줄이면 됩니다.

curl -sfL https://get.k3s.io | sh -

1분 안팎이면 끝납니다. k3s는 kubectl도 함께 설치하고, 관리자용 kubeconfig를 /etc/rancher/k3s/k3s.yaml에 씁니다.

sudo kubectl get nodes
sudo kubectl get pods -A

kube-system에 traefik, coredns, local-path-provisioner, metrics-server 파드가 보입니다. 위 표의 기본 구성 요소들입니다.

② 워커 노드 추가(선택) — 서버에서 가입 토큰을 확인합니다.

sudo cat /var/lib/rancher/k3s/server/node-token

추가할 다른 리눅스 머신에서, 서버 주소와 토큰을 넣어 설치합니다. K3S_URL이 있으면 서버가 아니라 에이전트(워커)로 설치됩니다.

curl -sfL https://get.k3s.io | K3S_URL=https://서버IP:6443 K3S_TOKEN=위에서복사한토큰 sh -

서버에서 sudo kubectl get nodes를 다시 치면 노드가 둘이 됩니다. 1편 시뮬레이터에서 노드를 끄던 실험을 이제 진짜로 해 볼 수 있습니다.

③ 내 노트북에서 접속 — 서버의 kubeconfig를 가져와, 주소를 127.0.0.1에서 서버 IP로 바꿉니다. 노트북 터미널에서:

ssh 사용자@서버IP "sudo cat /etc/rancher/k3s/k3s.yaml" | sed "s/127.0.0.1/서버IP/" > ~/.kube/k3s-team.yaml
chmod 600 ~/.kube/k3s-team.yaml
KUBECONFIG=~/.kube/k3s-team.yaml kubectl get nodes

기존 ~/.kube/config와 섞지 않고 별도 파일로 둔 것은 6편의 "운영은 기본값이 아니게" 원칙 때문입니다. 자주 쓴다면 이 파일의 context 이름(default)을 team-k3s처럼 알아보기 쉽게 바꿔 두세요.

KUBECONFIG=~/.kube/k3s-team.yaml kubectl config rename-context default team-k3s

9-3. 기본 포함된 Traefik으로 도메인 공개해 보기

4편의 hello-api 디플로이먼트와 서비스를 이 클러스터에 올렸다면(이미지는 레지스트리에서 받도록 ghcr.io/... 이름으로), Ingress 하나로 브라우저에서 도메인으로 접속할 수 있습니다. DNS가 없어도 되도록 IP를 이름에 넣으면 그 IP로 풀어 주는 무료 서비스 nip.io를 씁니다.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: hello-api
spec:
  ingressClassName: traefik
  rules:
    - host: hello.서버IP.nip.io
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: hello-api
                port:
                  number: 80

kubectl apply -f ingress.yaml 후 http://hello.서버IP.nip.io를 열면 hello-api가 응답합니다. port-forward 없이, 팀원 누구나 사내망에서 같은 주소로 접속할 수 있습니다. 호스트 이름은 hello.192.168.0.10.nip.io처럼 서버 IP를 그대로 넣습니다.

9-4. 쓰기 전에 알아 둘 점과 정리

10. 팀 추천 조합

마치며

다음 편에서는 kubectl을 제대로 익힙니다. 명령의 문법, 노드와 파드를 들여다보는 법, 파드가 안 뜰 때 원인을 찾는 순서를 실습합니다.

👉 3편: kubectl로 파드와 노드 다루기

참고 자료

• Kubernetes, Releases (지원 버전 1.37·1.36·1.35) · Version Skew Policy
• Kubernetes 문서, Install Tools (kubectl) · Organizing Cluster Access Using kubeconfig Files
• Rancher Desktop, Kubernetes 설정 문서
• OrbStack, Kubernetes 문서 · Pricing
• Docker 문서, Deploy on Kubernetes with Docker Desktop
• kind · minikube · k3d · k3s
• k3s 문서, Quick-Start · Requirements · Architecture · High Availability Embedded etcd
• 도커 시리즈: 도커 첫걸음 2편 — 설치와 라이선스