DevOps Engineering

[Kubernetes] 리눅스 서버에 Kubernetes in Docker 설치하기

FruFru__ 2026. 3. 26. 11:43

🔥 0️⃣ 사전 체크

 

서버에 Docker와 kubectl 모두 있어야 합니다 .. ! 👇

docker --version
kubectl version --client
 
 

Docker나 Kubectl이 없으면, 

 

→ 명령어 'docker' || 'kubectl' 을(를) 찾을 수 없습니다. 라고 뜰 거에요 ..!

 

저는 Docker는 설치되어있고, kubectl이 없어서, 리눅스 서버에 kubectl을 설치했습니다.

 

 

🔥 1️⃣ kubectl 설치

curl -LO https://dl.k8s.io/release/v1.29.0/bin/linux/amd64/kubectl
chmod +x kubectl
mv kubectl /usr/local/bin/


1. kubectl 실행 파일을 다운로드합니다.

2. kubectl에 실행 권한을 부여 → 시스템이 파일을 프로그램(실행 파일)으로 인식하게 합니다.

3. 어디서든 쓸 수 있도록, 전역 명령어로 등록한다.

 

mv kubectl /usr/local/bin 할 때,

→ mv: 일반 파일 '/usr/local/bin/kubectl'을(를) 생성할 수 없음: 허가 거부 라고 뜰 수 있습니다.

 

/usr/local/bin은 시스템 공용 영역이라, 일반 사용자가 마음대로 파일을 넣거나 수정할 수 없습니다. 따라서, 관리자 권한으로 실행해야 합니다.

 

설치가 끝났다면, 위의 버전 확인 명령어로 버전 정보가 잘 나오는지 확인해보시면 좋습니다.

 

 

🔥 2️⃣ kind 설치

curl -Lo ./kind https://kind.sigs.k8s.io/dl/v0.23.0/kind-linux-amd64
chmod +x ./kind
mv ./kind /usr/local/bin/kind

 

1. kind 저장소에서 리눅스용 실행 파일을 다운로드합니다.

2. kind 파일에 실행 권한을 부여합니다.

3. 시스템 공용 폴더

 

kind create cluster --name uoahir-cluster

Creating cluster "uoahir-cluster" ...
 ✓ Ensuring node image (kindest/node:v1.30.0) 🖼
 ✓ Preparing nodes 📦
 ✓ Writing configuration 📜
 ✓ Starting control-plane 🕹️
 ✓ Installing CNI 🔌
 ✓ Installing StorageClass 💾
Set kubectl context to "kind-uoahir-cluster"
You can now use your cluster with:

kubectl cluster-info --context kind-uoahir-cluster

Thanks for using kind! 😊

 

kind로 cluster를 만들면, kind가 알아서 cluster를 만들어줍니다 ! WOW !@!@

 

kubectl get nodes

NAME                           STATUS   ROLES           AGE   VERSION
uoahir-cluster-control-plane   Ready    control-plane   17m   v1.30.0

 

kubectl get nodes로 정보를 확인할 수 있습니다.

 

 

🔥 결론

kubectl 설치 ✔
kind 설치 ✔
클러스터 생성 ✔
→ control-plane 노드 1개 생성 ✔

 

단일 노드 Kubernetes 클러스터 완성

 

리눅스 서버
 └─ Docker
     └─ kind 컨테이너 (node 1개)
         └─ control-plane 역할
             └─ Pod들 실행 가능