실습 예제 on Advanced Beginner

환경 설정

d8lzz1gpw@mozmail.com (kimbenji) — Sun, 11 Jan 2026 00:00:00 +0000

대상 독자: 로컬에서 Kubernetes를 실습하고 싶은 개발자 선수 지식: Docker 기본 이 문서를 읽으면: Minikube 또는 Kind로 로컬 Kubernetes 환경을 구성할 수 있습니다

TL;DR

Minikube: 단일 노드, 초보자에게 권장, 다양한 애드온 지원

Kind: 다중 노드 가능, CI/CD에 적합, 빠른 클러스터 생성

Docker Desktop: macOS/Windows에서 가장 간단한 설정

로컬 Kubernetes 옵션 비교#

도구	장점	단점	적합한 경우
Minikube	애드온 풍부, 문서 많음	단일 노드만	학습, 개발
Kind	빠름, 다중 노드, CI 친화	애드온 적음	CI/CD, 테스트
Docker Desktop	설치 쉬움	리소스 많이 사용	빠른 시작
k3d	경량, 빠름	프로덕션과 차이	빠른 테스트

Minikube 설치#

설치#

macOS

# Homebrew로 설치
brew install minikube

# 버전 확인
minikube version

Linux

# 바이너리 다운로드
curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-linux-amd64

# 설치
sudo install minikube-linux-amd64 /usr/local/bin/minikube

# 버전 확인
minikube version

Windows

# Chocolatey로 설치
choco install minikube

# 또는 수동 설치
# https://minikube.sigs.k8s.io/docs/start/

클러스터 시작#

# 기본 설정으로 시작
minikube start

# 리소스 지정
minikube start --cpus=4 --memory=8192

# 특정 Kubernetes 버전 사용
minikube start --kubernetes-version=v1.29.0

# 드라이버 지정
minikube start --driver=docker

사용 가능한 드라이버는 다음과 같습니다.

기본 예제

d8lzz1gpw@mozmail.com (kimbenji) — Sun, 11 Jan 2026 00:00:00 +0000

대상 독자: Kubernetes 핵심 리소스를 실습하고 싶은 개발자 선수 지식: Pod, Deployment, Service 개념 이 문서를 읽으면: Pod, Deployment, Service, ConfigMap을 직접 생성하고 관리할 수 있습니다

TL;DR

Nginx Deployment를 생성하고 Service로 노출합니다

ConfigMap으로 설정을 주입합니다

롤링 업데이트와 롤백을 실습합니다

사전 준비#

다음이 필요합니다:

로컬 Kubernetes 클러스터 (Minikube 또는 Kind)
kubectl

# 클러스터 상태 확인
kubectl cluster-info

실습 1: Deployment와 Service#

Deployment 생성#

웹 서버를 배포합니다.

# nginx-deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
 name: nginx
 labels:
 app: nginx
spec:
 replicas: 3
 selector:
 matchLabels:
 app: nginx
 template:
 metadata:
 labels:
 app: nginx
 spec:
 containers:
 - name: nginx
 image: nginx:1.25
 ports:
 - containerPort: 80
 resources:
 requests:
 memory: "64Mi"
 cpu: "100m"
 limits:
 memory: "128Mi"
 cpu: "200m"

# Deployment 생성
kubectl apply -f nginx-deployment.yaml

# 상태 확인
kubectl get deployment nginx
kubectl get pods -l app=nginx

예상 출력:

Spring Boot 배포

d8lzz1gpw@mozmail.com (kimbenji) — Sun, 11 Jan 2026 00:00:00 +0000

대상 독자: Spring Boot 애플리케이션을 Kubernetes에 배포하고 싶은 백엔드 개발자 선수 지식: Deployment, Service, ConfigMap, Docker 이 문서를 읽으면: Spring Boot 앱을 컨테이너화하고 Kubernetes에 배포할 수 있습니다

TL;DR

Dockerfile 작성 → 이미지 빌드 → Kubernetes 배포

ConfigMap/Secret으로 환경별 설정 분리

Actuator 엔드포인트로 헬스 체크 구성

전체 흐름#

flowchart LR
 A[Spring Boot App] --> B[Dockerfile]
 B --> C[Docker Build]
 C --> D[이미지 Push]
 D --> E[K8s Deployment]
 E --> F[Service]
 F --> G[Ingress]

1. Spring Boot 애플리케이션 준비#

예제 애플리케이션 구조#

my-app/
├── src/main/
│ ├── java/com/example/
│ │ └── MyAppApplication.java
│ └── resources/
│ └── application.yml
├── Dockerfile
├── build.gradle.kts
└── kubernetes/
 ├── deployment.yaml
 ├── service.yaml
 ├── configmap.yaml
 └── secret.yaml

application.yml#

spring:
 application:
 name: my-app
 datasource:
 url: ${DATABASE_URL:jdbc:postgresql://localhost:5432/mydb}
 username: ${DATABASE_USERNAME:postgres}
 password: ${DATABASE_PASSWORD:postgres}

server:
 port: 8080

management:
 endpoints:
 web:
 exposure:
 include: health,info,prometheus
 endpoint:
 health:
 probes:
 enabled: true
 health:
 livenessState:
 enabled: true
 readinessState:
 enabled: true

간단한 컨트롤러#

@RestController
public class HelloController {

 @GetMapping("/")
 public String hello() {
 return "Hello from Kubernetes!";
 }

 @GetMapping("/hostname")
 public String hostname() {
 try {
 return "Pod: " + InetAddress.getLocalHost().getHostName();
 } catch (UnknownHostException e) {
 return "Unknown";
 }
 }
}

2. Docker 이미지 빌드#

Dockerfile (멀티스테이지 빌드)#

# 빌드 스테이지
FROM eclipse-temurin:17-jdk AS build
WORKDIR /app
COPY gradle gradle
COPY build.gradle.kts settings.gradle.kts gradlew ./
COPY src src
RUN ./gradlew bootJar --no-daemon

# 실행 스테이지
FROM eclipse-temurin:17-jre
WORKDIR /app

# 보안: non-root 사용자
RUN addgroup --system appgroup && adduser --system appuser --ingroup appgroup
USER appuser

COPY --from=build /app/build/libs/*.jar app.jar

EXPOSE 8080

ENTRYPOINT ["java", "-jar", "app.jar"]

이미지 빌드#

# Docker 이미지 빌드
docker build -t my-app:1.0 .

# 로컬 테스트
docker run -p 8080:8080 my-app:1.0

# Minikube 환경에서 로컬 이미지 사용
eval $(minikube docker-env)
docker build -t my-app:1.0 .

# Kind 환경에서 로컬 이미지 사용
kind load docker-image my-app:1.0

3. Kubernetes 리소스 작성#

ConfigMap (환경 설정)#

# kubernetes/configmap.yaml
apiVersion: v1
kind: ConfigMap
metadata:
 name: my-app-config
data:
 SPRING_PROFILES_ACTIVE: "kubernetes"
 DATABASE_URL: "jdbc:postgresql://postgres-service:5432/mydb"
 JAVA_OPTS: "-Xms256m -Xmx512m"

Secret (민감 정보)#

# Secret 생성 (명령어)
kubectl create secret generic my-app-secret \
 --from-literal=DATABASE_USERNAME=myuser \
 --from-literal=DATABASE_PASSWORD=mypassword

또는 YAML로:

StatefulSet 실습

d8lzz1gpw@mozmail.com (kimbenji) — Mon, 23 Mar 2026 00:00:00 +0000

대상 독자: 상태를 유지해야 하는 애플리케이션을 Kubernetes에 배포하고 싶은 개발자 선수 지식: Deployment, Service, PersistentVolume 개념 이 문서를 읽으면: StatefulSet으로 MySQL을 배포하고 데이터 영속성을 검증할 수 있습니다

TL;DR

StatefulSet으로 MySQL을 배포합니다

Headless Service로 개별 Pod에 접근합니다

PersistentVolumeClaim 템플릿으로 데이터를 영속화합니다

스케일 업/다운 시 데이터 보존을 확인합니다

전체 흐름#

flowchart LR
 A[Headless Service] --> B[StatefulSet]
 B --> C[mysql-0]
 B --> D[mysql-1]
 B --> E[mysql-2]
 C --> F[PVC-0]
 D --> G[PVC-1]
 E --> H[PVC-2]

사전 준비#

다음이 필요합니다:

RBAC 설정 실습

d8lzz1gpw@mozmail.com (kimbenji) — Mon, 23 Mar 2026 00:00:00 +0000

대상 독자: Kubernetes 클러스터의 접근 제어를 설정하고 싶은 개발자/운영자 선수 지식: Namespace, Pod, Deployment 개념 이 문서를 읽으면: Role, RoleBinding, ServiceAccount를 활용한 네임스페이스별 접근 제어를 구성할 수 있습니다

TL;DR

개발팀용 제한된 권한 Role을 만듭니다

ServiceAccount를 생성하고 Role에 바인딩합니다

kubectl auth can-i로 권한을 테스트합니다

네임스페이스별로 접근 권한을 분리합니다

RBAC 구조#

flowchart TD
 SA[ServiceAccount] -->|바인딩| RB[RoleBinding]
 R[Role] -->|참조| RB
 RB -->|권한 부여| NS[Namespace 리소스]

 SA2[ServiceAccount] -->|바인딩| CRB[ClusterRoleBinding]
 CR[ClusterRole] -->|참조| CRB
 CRB -->|권한 부여| CL[클러스터 전체 리소스]

리소스	범위	설명
Role	Namespace	특정 Namespace 내 리소스 권한
ClusterRole	Cluster	클러스터 전체 리소스 권한
RoleBinding	Namespace	Role/ClusterRole을 주체에 바인딩
ClusterRoleBinding	Cluster	ClusterRole을 주체에 바인딩

사전 준비#

다음이 필요합니다:

CronJob 실습

d8lzz1gpw@mozmail.com (kimbenji) — Mon, 23 Mar 2026 00:00:00 +0000

대상 독자: Kubernetes에서 주기적 작업을 스케줄링하고 싶은 개발자 선수 지식: Pod, Job 개념 이 문서를 읽으면: CronJob으로 주기적 백업 작업을 만들고, 실행 이력과 동시 실행 정책을 관리할 수 있습니다

TL;DR

CronJob으로 주기적 데이터 백업을 자동화합니다

successfulJobsHistoryLimit로 실행 이력을 관리합니다

concurrencyPolicy로 동시 실행을 제어합니다

실패 시 알림을 설정합니다

CronJob 동작 흐름#

flowchart TD
 CRON[CronJob Controller] -->|스케줄에 따라| JOB[Job 생성]
 JOB --> POD[Pod 실행]
 POD -->|성공| SUCCESS[완료 기록]
 POD -->|실패| RETRY{재시도?}
 RETRY -->|backoffLimit 이내| POD
 RETRY -->|초과| FAIL[실패 기록]

 SUCCESS --> HIST[이력 관리<br>successfulJobsHistoryLimit]
 FAIL --> HIST2[이력 관리<br>failedJobsHistoryLimit]

사전 준비#

다음이 필요합니다: