본문으로 바로가기
쿠버네티스 입문, 원하는 상태를 유지하는 시스템
LinkedInGitHub
WORKSPACE

EXPLORER

157 POSTS
BLOG
면접질문
해야하는 거
AI 시대, 개발자는 사라지는가?
Python Counter, 빈도수를 쉽게 세는 방법
정렬
1. 투 포인터
DFS와 BFS
알고리즘 논리
코딩 테스트 핵심 알고리즘 정리파이썬 딕셔너리와 코딩 테스트 활용
예시로 살펴보는 AXAX 프로젝트, 문제 정의부터 확산까지AX 시대의 가치 정의와 현장 리딩
MSA
1. Singleton PatternSOLID
Kafka의 핵심 설계 원리Kafka 메시징 시스템의 구성과 동작 방식Kafka 기본 개념과 EC2 Docker 구성
쿠버네티스 입문
Modular Monolith1. MonolithMSA, 서비스 분리와 운영의 원리
Socket이란 무엇인가
네크워크 참조 모델
전체 데이터 구조REST API의 개념과 설계 원칙2. Field/ Parameter / Argument/ this
Actuator 란?EntityManagerJPA 연관관계 매핑JPA 트랜잭션(Transaction)입력값 검증Java의 AOP(Aspect Oriented Programming)Async : AsynchronousBeanJPA(Java Persistence API)Proxy 패턴Spring MVCdocker container1. Spirng 필요컴포넌트 스캔
Spring 컨테이너
application.yamlLombok
이번 강의는 무엇을 노리고 있을까?Spring AI를 배우기 전에 정리할 것23
1. 기술 스택
개발 문서를 읽기 위한 핵심 기술 용어
Docker를 이해하기 위한 운영체제 기초
sigterm
6. 설정과 저장소, 앱을 운영할 수 있는 상태로 만들기5. Service와 Ingress, 요청은 어디로 흐를까4. 직접 실험하는 Kubernetes, Pod 복구부터 롤백까지3. kubectl과 Pod, 상태에서 원인을 찾는 법2. 클러스터는 명령을 어떻게 Pod로 바꿀까1. 쿠버네티스, 원하는 상태와 컨테이너 이미지Calico쿠버네티스 입문, 원하는 상태를 유지하는 시스템
Psql JSONB, 행 잠금, 멱등성Psql 함수,프로시져,트리거
머신러닝 입문딥러닝 학습 기본 개념데이터 시각화기초 통계와 ML 파이프라인 연결분석 자동화와 파이프라인 설계
CNN 아키텍처 발전 과정이미지 세그멘테이션 모델과 핵심 개념객체 탐지 모델과 핵심 개념
딥러닝 데이터셋 엔지니어링
딥러닝 학습 문제 진단과 디버깅
도메인 적응 방법현대 LLM 워크플로의 패턴
Transformer에서 LoRA 적용 대상 정하기LoRA (Low-Rank Adaptation)
LLM 양자화와 QLoRA
분산 학습과 MLOps딥러닝 모델 경량화와 추론 최적화딥러닝 기본 학습 테크닉딥러닝 중급 학습 테크닉
Mixture of Experts(MoE) 핵심 개념멀티모달 파운데이션 모델 핵심 개념State Space Model과 MambaTransformer와 Vision Transformer
Latent Space
1Chunking?
DevOps 기초 1편
실습에서는?Agile 개요, 왜 필요한가?
CI/CD 기초 4편: 배포 전략과 운영CI/CD 기초 3편: Jenkins와 Argo CD를 이용한 GitOps 배포CI/CD 기초 2편: Docker 이미지와 배포 파이프라인CI/CD 기초 1편: 개념과 GitHub Actions
OCI: 컨테이너 이미지와 런타임의 공통 표준Docker 기초 13편: Compose Healthcheck와 실전 구성Docker 기초 12편: Compose 네트워크와 VolumeDocker 기초 11편: Compose 명령어와 환경 변수Docker 기초 10편: Compose 기본 구조와 이미지 빌드Docker 기초 9편: Docker 및 Kubernetes 네트워크Docker 기초 8편: 컨테이너 런타임과 격리Docker 기초 7편: 이미지 Layer와 tar 내부 구조Docker 기초 6편: 이미지 Layer와 빌드 최적화Docker 기초 5편: 컨테이너 기본 명령어와 VolumeDocker 기초 4편: 가상화와 컨테이너 이미지 생명주기Docker 기초 3편: CI/CD 연결과 배포 원칙Docker 기초 2편: Layer, Registry, Volume과 NetworkDocker 기초 1편: Dockerfile, Image와 Container
NginxNginx 로드 밸런싱과 HTTPSNginx 리버스 프록시와 Spring Boot 연결Nginx 기초와 동작 구조
05. Pinia 상태 관리: store 설계와 사용법04. Vue 컴포넌트 설계: props, emit, slot과 생명주기03. Vue Composition API 정리02. Vue 기초 문법 점검: JavaScript, 템플릿01. Vue.js 입문: 핵심 구조와 렌더링
Java 심화 Part 3: 함수형 프로그래밍과 LambdaJava 심화 Part 2: AnnotationJava 심화 Part 1: Reflection
Java 기초 Part 5: Stream APIJava 기초 Part 4: 제네릭Java 기초 Part 3: 제어문Java 기초 Part 2: 주석과 JavadocJava 기초 Part 1: 백엔드 배경과 Java 실행 구조
Java 디버깅 Part 1: 자주 헷갈리는 핵심 개념Java 디버깅 Part 2: VS Code 자동 컴파일과 프로젝트 구조
Java 실행과 JVM Part 3: ClassLoader와 JVM 메모리Java 실행과 JVM Part 2: 메모리와 데이터 흐름Java 실행과 JVM Part 1: Java와 Python 컴파일 비교
Java 객체지향 Part 5: static 메서드와 중첩 클래스Java 객체지향 Part 4: 상속과 인터페이스Java 객체지향 Part 3: 좋은 설계와 OOP 4대 특성Java 객체지향 Part 2: OOP 핵심 문법Java 객체지향 Part 1: 클래스, 객체, 필드와 생성자
Spring 기초 Part 11: Actuator와 애플리케이션 모니터링Spring 기초 Part 10: 비동기 처리와 @AsyncSpring 기초 Part 9: JPA 트랜잭션과 동시성 제어Spring 기초 Part 8: AOP와 공통 관심사 분리Spring 기초 Part 7: Proxy 패턴과 Spring ProxySpring 기초 Part 6: JPA 연관관계 매핑Spring 기초 Part 5: EntityManager와 영속성 컨텍스트Spring 기초 Part 4: JPA, Entity와 RepositorySpring 기초 Part 3: REST API 요청값과 입력값 검증Spring 기초 Part 2: Spring MVC 요청 처리 흐름Spring 기초 Part 1: IoC, Bean, DI와 주요 Annotation
DNS = Domain Name System
Spring Boot, WebSocket, Vue, Docker 로 Raspberry Pi 실시간 모니터링 프로젝트 만들기 - 1편1. Spring Boot 구현
1. GitHub Project 만들기
Python 코드 품질: 디버깅부터 테스트와 자동화까지Python 01. 실행 구조와 실무 기초
sLLM 핵심 기술과 전체 구조제한된 자원에서 sLLM 구축하기
시대 단상에 대한 주저리주저리
WORKSPACE

SEARCH

제목, 카테고리와 태그로 검색하세요.

VERSION CONTROL

SOURCE CONTROL

masterGitHub Pages
저장소 열기
BUILD STATUS

RUN AND DEBUG

게시물은 GitHub Actions에서 검증하고 정적 페이지로 빌드합니다.

Actions 열기
WORKSPACE

MANAGE

홈 열기전체 게시물태그 보기블로그 소개
쿠버네티스 입문, 원하는 상태를 유지하는 시스템●
workspace>posts>ci-cd-docker>kubernetes>kubernetes1.md
CI-CD-Docker / kubernetes2026.08.261 min read5 tags

쿠버네티스 입문, 원하는 상태를 유지하는 시스템

Docker와 Kubernetes의 역할, 원하는 상태와 조정 루프, Pod와 Deployment, Service의 관계를 먼저 살펴본다.

QUICK SUMMARY

핵심 요약

쿠버네티스는 여러 노드에서 컨테이너를 원하는 상태로 실행하고, 실제 상태가 달라지면 컨트롤러가 차이를 줄인다. 기본 구조를 이해한 뒤 파트별 글과 3D 모의 실습으로 이어갈 수 있다.

쿠버네티스

‘직접 실험하는 Kubernetes’의 6개 파트 학습 목차와 3D Kubernetes 터미널 실험실을 추가했다. 이 글은 처음 개념을 잡는 입문 노트다.

쿠버네티스는 여러 컴퓨터에서 컨테이너를 원하는 상태로 실행하고, 그 상태가 깨지면 자동으로 복구하는 컨테이너 오케스트레이션 시스템

1. Docker와 쿠버네티스 차이

Docker는 컨테이너 하나를 만들고 실행하는 데 집중한다.

docker run nginx

쿠버네티스는 다음과 같은 운영 문제를 담당

  • 컨테이너를 어느 서버에서 실행할지 결정
  • 컨테이너가 죽으면 다시 실행
  • 사용자가 많아지면 여러 개로 확장
  • 여러 컨테이너로 트래픽 분산
  • 새 버전으로 점진적 교체
  • 설정과 저장 공간 관리
Docker
    이미지 → 컨테이너 실행

Kubernetes
    이미지 → 여러 서버에 배치 → 감시 → 복구 → 확장 → 트래픽 연결

쿠버네티스가 컨테이너 이미지를 만드는 것으 아니다. 일반적으로 Docker등으로 이미지를 만들고 저장소에 올리면, 쿠버네티스가 그 이미지를 가져와 실행한다.

2. 가장 중요한 개념 : 원하는 상태

선언적 명령

쿠버네티스는 명령을 하나씩 내리기 보다는 원하는 상태를 선언

예를 들어서

replicas: 3
image: nginx:1.27

의미는 다음과 같다.

nginx 1.27 컨테이너를 항상 3개 실행

그래서 3개의 Nginx 컨테이너가 정상적으로 돌아가고 있다면 아무것도 하지 않는다.

현재 3개 = 원하는 상태 3개
    → 유지

근데 만약 1개가 죽었다?

현재 2개 ≠ 원하는 상태 3개
    → 새 컨테이너 1개를 생성
    → 그리고서는 다시 3개로 복구한다.

이처럼 현재 상태를 원하는 상태에 맞추는 것을 Reconciliation

즉, 조정(Reconciliation) 이라고 한다.

3. 전체 구조

Cluster
├── Control Plane
│   ├── API Server
│   ├── Scheduler
│   ├── Controller Manager
│   └── etcd
│
└── Worker Node
    ├── kubelet
    ├── Container Runtime
    └── Pod
        └── Container

Cluster

  • 쿠버네티스가 관리하는 전체 시스템, 여러 서버를 하나의 묶음으로 관리

Control Plane

  • 클러스터의 두뇌
    • 사용자의 요청을 받음
    • 현재 상태를 확인
    • 어느 서버에서 실행할지 결정
    • 원하는 상태와 다르면 수정

worker Node

실제로 애플리케이션 컨테이너가 실행되는 서버

Pod

쿠버네티스가 배포하는 가장 작은 실행 단위

Pod
└── nginx 컨테이너

컨테이너를 쿠버네티스에 직접 배포하기보다는, 컨테이너를 감싼 Pod를 배포한다고 생각하면 좋다

4. 핵심 단어

단어의미
Cluster쿠버네티스가 관리하는 전체 서버 묶음
Control Plane클러스터를 관리하는 두뇌
Node쿠버네티스에 참여하는 서버
Pod컨테이너가 실행되는 최소 단위
DeploymentPod의 개수, 이미지, 업데이트 방식을 관리
Replica동일하게 실행할 Pod의 개수
Service변경되는 Pod들을 하나의 고정된 주소로 연결
Ingress외부 HTTP 요청을 적절한 Service로 전달
Namespace리소스를 논리적으로 구분하는 공간
ConfigMap일반 설정값을 분리해 저장
Secret비밀번호, 토큰 같은 민감한 설정 관리
Volume컨테이너가 사용할 저장 공간
PVC필요한 저장 공간을 요청하는 객체
LabelPod 등의 리소스에 붙이는 분류표
Selector특정 Label을 가진 리소스를 선택하는 조건
Manifest원하는 상태를 작성한 YAML 파일

일단은 이 정도만 알고 있으면 되는 것은..

Deployment
    ↓ Pod 생성 및 개수 유지
Pod
    ↓ 애플리케이션 실행
Service
    ↓ 여러 Pod를 하나의 주소로 연결
Ingress
    ↓ 외부 사용자의 요청을 Service로 전달

5. 요청이 들어오는 흐름

웹 애플리케이션을 배포했다고 했을 때를 예시로 들어보자

사용자
    ↓
Ingress
    ↓
Service
    ↓
Pod 1, Pod 2, Pod 3
    ↓
컨테이너 애플리케이션

여기서 Pod는 언제든 죽거나 새로 생성될 수 있기 때문에 IP 주소가 바뀔 수 있다.

사용자는 Pod에 직접 연결하지 않는다. Service가 고정된 접근 지점을 제공하고, 적잘한 Pod으로 요청을 전달한다.

6. 배포할 때 내부에서 벌어지는 일

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
        - name: nginx
          image: nginx:1.27

적용 명령

kubectl apply -f deployment.yaml

내부 흐름은 다음과 같다.

  1. Kubectl이 YAML을 API Server에 전달
  2. API Server가 요청을 검사하고 etcd에 저장
  3. Controller가 Pod 3개가 필요하다는 것을 확인
  4. Scheduler가 각 Pod를 실행할 Node를 선택
  5. 각 Node의 kubelet이 컨테이너 이미지 다운로드
  6. Container Runtime이 컨테이너 실행
  7. Controller가 계속 상태를 감시

kubectl은 쿠버네티스 클러스터에 명령을 전달하는 도구

확인 할 때는 다음 명령을 사용한다.

kubectl get deployments
kubectl get pods
kubectl get services

7. 핵심 설계 철학

선언적 관리

"컨테이너 하나를 실행해" 라는 절차보다 "항상 3개가 실행되어야 한다~" 라는 결과를 선언

명령형: 컨테이너를 하나 실행해
선언형: 컨테이너가 항상 3개 존재해야 해

지속적인 조정

쿠버네티스는 한 번 실행하고 끝나는 시스템이 아님

현재 상태 관찰
    → 원하는 상태와 비교
    → 차이가 있으면 수정
    → 다시 관찰

이 반복 구조를 Control Loop

장애를 정상적인 상황으로 간주

쿠버네티스는 Pod가 서버가 언젠가 고장난다고 가정

그래서 개별 Pod이 죽으면, 새로운 Pod으로 교체한다.

기존 서버 운영: 이 서버가 절대 죽지 않도록 관리
쿠버네티스:     죽을 수 있으니 자동으로 대체

개별 객체보다 집합 관리

Pod 하나를 직접 관리하기보다, Deployment로 Pod의 집합을 관리한다.

Pod 하나 직접 관리
    → 죽으면 끝

Deployment로 관리
    → Pod가 죽으면 새 Pod 생성

느슨한 연결

Deployment는 실행, Service는 네트워크 연결, ConfigMap은 설정을, Volume은 저장 공간을 담당한다.

기능을 분리해 필요한 부분만 교체할 수 있게 설계되어 있다.

불변 이미지

실행 중인 컨테이너 내부를 직접 수정하지 않고, 새 이미지를 만들고 기존 Pod를 새 Pod로 교체

nginx:1.0 Pod
    ↓ 점진적 교체
nginx:2.0 Pod
TAGS#Kubernetes#Docker#Pod#Deployment#Reconciliation
PREVIOUSDNS = Domain Name SystemNEXTCalico
DISCUSSION

COMMENTS

GitHub 계정으로 로그인하여 댓글을 남길 수 있습니다. 댓글은 GitHub Discussions에 공개 저장되며, 작성 내용과 GitHub 프로필 정보가 다른 방문자에게 보일 수 있습니다.

GitHub 로그인 후 댓글 쓰기Discussion 열기
DOCUMENT STRUCTURE

이 문서에는 목차가 없습니다.

DOCUMENT INFO
TYPE
Markdown
DATE
2026.08.26
READ
1 min read
WORDS
0
CATEGORY
CI-CD-Docker / kubernetes
RELATED DOCUMENTS
1. 쿠버네티스, 원하는 상태와 컨테이너 이미지4. 직접 실험하는 Kubernetes, Pod 복구부터 롤백까지3. kubectl과 Pod, 상태에서 원인을 찾는 법6. 설정과 저장소, 앱을 운영할 수 있는 상태로 만들기5. Service와 Ingress, 요청은 어디로 흐를까2. 클러스터는 명령을 어떻게 Pod로 바꿀까
main CI-CD-Docker / kubernetes
1 min readUTF-8Markdown
본문 글씨 크기
RECENTLY OPENED1
쿠버네티스 입문, 원하는 상태를 유지하는 시스템recently opened