#Kubernetes 완전 학습 코스

기본부터 고급까지, 25개 스텝으로 Kubernetes를 처음부터 끝까지 익힙니다. 모든 매니페스트는 실제로 돌아가는 Kubernetes 클러스터(kind, v1.36)에서 검증했고, 교재의 출력은 여러분 화면과 거의 동일합니다.

#시작하기 (5분)

# 1. 도구 설치 (macOS 기준)
brew install kind kubectl helm

# 2. 학습용 클러스터 생성 (control-plane 1 + worker 2)
cd k8s/cluster
./create-cluster.sh

#   ⚠️ 사내망에서 TLS 가로채기 프록시를 쓴다면 (이미지 pull 이 인증서 오류로 실패):
#   INJECT_CA=1 ./create-cluster.sh

# 3. 확인
kubectl get nodes

결과

NAME                  STATUS   ROLES           AGE   VERSION
learn-control-plane   Ready    control-plane   1m    v1.36.1
learn-worker          Ready    <none>          1m    v1.36.1
learn-worker2         Ready    <none>          1m    v1.36.1

언제든 처음부터 다시 시작하려면:

cd k8s/cluster && ./delete-cluster.sh && ./create-cluster.sh

왜 kind인가? 노트북 위 Docker 컨테이너를 노드로 쓰는 가장 가볍고 빠른 학습용 클러스터입니다. 만들고 부수는 데 1분이면 됩니다. minikube, k3d, Docker Desktop 내장 k8s로도 대부분의 실습이 가능하지만, 멀티노드 실습(Step 13, 21)은 kind가 가장 편합니다.

#커리큘럼

#1부 — 기초: 핵심 오브젝트 (Step 01~07)

kubectl을 처음 써봅니다. 여기서 시작합니다.

#2부 — 워크로드와 스토리지 (Step 08~13)

#3부 — 네트워킹과 접근 제어 (Step 14~16)

#4부 — 운영과 고급 (Step 17~25)

#각 스텝의 구성

step-05-deployments/
├── index.md          ← 교재 본문. 개념 + 매니페스트 + 실제 실행 결과 + 함정/팁
├── manifests/        ← 실습용 YAML 파일들
│   ├── deployment.yaml
│   └── ...
├── commands.sh       ← 교재의 kubectl 명령을 순서대로 담은 실행 스크립트
└── challenge.md      ← 연습 과제 + 해답

권장 학습 방법

1. index.md를 읽으며 매니페스트를 직접 kubectl apply 하고 결과를 관찰합니다.
2. kubectl get, describe, logs로 무슨 일이 일어났는지 확인합니다.
3. 결과가 교재와 다르면 멈추고 원인을 찾으세요.
4. challenge.md의 과제를 풀고 다음 스텝으로.

각 스텝은 자기만의 네임스페이스(step05 등)를 씁니다. 다른 스텝과 섞이지 않고, 끝나면 네임스페이스 하나만 지우면 깨끗이 정리됩니다.

kubectl delete namespace step05

#학습에 쓰는 이미지

인터넷/사내망 어디서든 잘 받아지는 멀티아키텍처(amd64·arm64) 이미지만 씁니다.

#실습 규칙

• 실습은 각 스텝의 전용 네임스페이스에서 진행합니다. 다른 네임스페이스(특히 kube-system)를 건드리지 마세요.
• 클러스터 전체에 영향을 주는 실습(노드 taint, cordon/drain)은 반드시 원복합니다. 각 스텝 교재에 원복 명령이 있습니다.
• 꼬였다면 언제든 클러스터를 재생성하세요. 학습 클러스터는 부수라고 있는 것입니다.

  cd k8s/cluster && ./delete-cluster.sh && ./create-cluster.sh

#이 코스가 특히 신경 쓴 것

"YAML은 apply됐는데 왜 안 되는가" 를 진단하는 힘을 기르는 데 집중했습니다. Kubernetes는 명령이 성공해도 원하는 상태가 아닐 수 있습니다. 예를 들면:

• 프로브를 잘못 걸면 파드가 무한 재시작(CrashLoopBackOff) 합니다 (Step 08, 24)
• requests를 안 주면 스케줄러가 노드를 잘못 골라 Pending에 빠집니다 (Step 09, 13)
• Service의 셀렉터가 파드 레이블과 한 글자만 달라도 트래픽이 0이 됩니다 (Step 06)
• emptyDir에 DB를 두면 파드 재시작 시 데이터가 증발합니다 (Step 10)
• 메모리 limit을 넘기면 OOMKilled로 조용히 죽습니다 (Step 09, 24)

각 스텝의 ⚠️ 함정과 Step 24 트러블슈팅을 특히 눈여겨 보세요.

#환경 정보