Docker 개념 및 예제

📌 0. Docker 개념

✅ 0-1. 개념

Docker는 응용 프로그램과 그 의존성을 하나의 패키지로 묶어 실행할 수 있는 컨테이너 기술

• Docker: 가장 널리 사용하는 컨테이너 엔진
• 컨테이너 엔진: 컨테이너를 생성하고 실행하는 소프트웨어 (컨테이너 구현 기술)
• 컨테이너: 애플리케이션을 실행하기 위한 격리된 실행 환경 (OS커널 공유, VM보다 가볍고 빠름) 

*VM: OS까지 포함한 완전한 가상환경
컨테이너: OS 없이 실행 환경만 격리

 

✅ 0-2. 사용 이유

👉 성능 때문 ❌
👉 운영/관리 때문 ⭕

• 환경 통일: 내 PC·팀원·서버 어디서든 동일한 실행 환경 보장
• 버전 관리: 이미지로 버전을 고정하여 환경 충돌 없이 안정적인 실행 가능
• 한 번에 실행: DB·Redis·서비스 등을 한 번에 실행하여 세팅 시간 최소화
• 격리 (Isolation): 서비스별로 분리되어 포트 및 라이브러리 충돌 방지
• 삭제/초기화 쉬움: 명령어 한 번으로 환경을 빠르게 초기화하고 재구성 가능
• 확장성: 서비스를 쉽게 추가·확장하고 독립적으로 실행 및 테스트 가능

 

⭐ Tip

🔹Docker 이미지는 보통 인터넷에서 다운로드

Docker Hub / 사설 레지스트리 → pull → 로컬 저장

 

🔹폐쇠망에서는?

이미지 파일로 옮김

docker save -o mariadb.tar mariadb:10.6

docker load -i mariadb.tar

✔ 외부망 → 내부망 이동 가능

✔ 폐쇄망에서도 사용 가능

 

✅ 0-3. 설치 가능 서비스 예시

• 데이터베이스 및 캐시 (RDBMS: MariaDB / NoSQL: MongoDB / 캐시: Redis 등)
• 메시지 브로커 (Kafka, RabbitMQ 등)
• 웹 서버 및 애플리케이션 서버 (웹 서버: Nginx / 애플리케이션 서버: Tomcat 등)
• 개발 도구 (CI/CD 툴: Jenkins / 코드 품질 분석: ESLint / 로컬 개발 환경: Adminer )
• 빅데이터 및 분석 ( Hadoop / Elasticsearch + Kibana (ELK Stack) / Spark )
• 네트워크 및 보안 (프록시 서버 / 보안 스캐너)
• 모니터링 및 로깅 
• 머신러닝 및 데이터 사이언스
• 기타 (버전 관리 및 협업: Git, SVN / CMS / VPN 및 네트워크 관리)
• 운영 자동화 (Ansible AWX, Terraform)

---

📌 1. Docker 기본

✅ 1-1. Docker 설치 (윈도우 기준) 🛠

👉 Docker Desktop 설치

https://www.docker.com/products/docker-desktop/

 

✔ 그냥 Next Next 설치
✔ WSL2 자동 설정

 

설치 완료 시 아래 두개 창이 뜸. (둘 다 닫아도 된다.)

🔹 Docker Desktop => 작업표시줄에서 Docker Desktop이 실행중인지 확인 (미실행 중이면 docker 명령어 안 먹음)

🔹 WSL(Windows Subsystem for Linux) => WSL 직접 쓸 필요 거의 없음, 그냥 Docker 쓰면 자동으로 돌아감

 

👉 확인 방법. Version이 2면 제대로 실행중.

$ wsl -l -v
  NAME              STATE           VERSION
* docker-desktop    Running         2

*후에 성능 최적화 필요시 wsl에 우분투를 깔고, wsl 내부에서 도커 실행 가능하나 지금은 넘어간다!

 

👉 설치 후

# 설치 버전 확인
docker --version

# Docker Desktop 실행 중인지 확인
docker p

 

✅1-2. 컨테이너 실행 확인

🔹 컨테이너 실행

docker run hello-world

✔ Docker 설치하면 docker 명령어가 시스템 PATH에 등록됨 어느 경로에서든 명령어 실행 가능

 

👉 성공하면 도커 정상 작동 (성공 출력)

$ docker run hello-world
Unable to find image 'hello-world:latest' locally # ✔️이미지 로컬에서 찾을 수 없어서 다운로드 시작
latest: Pulling from library/hello-world # ✔️Docker Hub에서 이미지 받아옴
17eec7bbc9d7: Pull complete
ea52d2000f90: Download complete
Digest: sha256:85404b3c53951c3ff5d40de0972b1bb21fafa2e8daa235355baf44f33db9dbdd
Status: Downloaded newer image for hello-world:latest

Hello from Docker! # ✔️컨테이너 실행성공
This message shows that your installation appears to be working correctly.

To generate this message, Docker took the following steps:
 1. The Docker client contacted the Docker daemon.
 2. The Docker daemon pulled the "hello-world" image from the Docker Hub.
    (amd64)
 3. The Docker daemon created a new container from that image which runs the
    executable that produces the output you are currently reading.
 4. The Docker daemon streamed that output to the Docker client, which sent it
    to your terminal.

To try something more ambitious, you can run an Ubuntu container with:
 $ docker run -it ubuntu bash

Share images, automate workflows, and more with a free Docker ID:
 https://hub.docker.com/

For more examples and ideas, visit:
 https://docs.docker.com/get-started/​

---

📌2. 컨테이너 관리

✅2-1. Docker 핵심 명령어 정리

명령어	설명	언제 씀	예시
docker ps	실행 중 컨테이너만 조회	지금 돌아가는 것 확인	docker ps
docker ps -a	전체 컨테이너 조회 (종료 포함)	과거 실행 기록 확인	docker ps -a
docker run	컨테이너 생성 + 실행	처음 실행할 때	docker run nginx
docker start	중지된 컨테이너 다시 시작	재사용	docker start my-container
docker stop	실행 중 컨테이너 종료	종료할 때	docker stop my-container
docker restart	재시작	설정 변경 후	docker restart my-container
docker rm	컨테이너 삭제	완전히 제거	docker rm my-container
docker images	이미지 목록 조회	다운로드된 이미지 확인	docker images
docker rmi	이미지 삭제	용량 정리	docker rmi nginx
docker logs	컨테이너 로그 확인	에러/디버깅	docker logs my-container
docker exec	컨테이너 내부 접속	DB 확인, 테스트	docker exec -it my-container bash
docker pull	이미지 다운로드	미리 받아둘 때	docker pull nginx
docker build	이미지 직접 생성	Dockerfile 사용 시	docker build .

 

✅2-2. 개별 컨테이너 실행

각 컨테이너를 일일이 docker run으로 실행해야 해서 잘 쓰지 않는다!!

# MariaDB
docker run -d \
 --name mariadb \
 -e MYSQL_ROOT_PASSWORD=root \
 -p 3306:3306 \
 -v mariadb_data:/var/lib/mysql \
 mariadb:10.6

# Redis
docker run -d \
 --name redis \
 -p 6379:6379 \
 -v redis_data:/data \
 redis

 

🔹 단점

• 컨테이너 간 의존성 관리 힘듦 (depends_on 같은 기능 없음)
• 네트워크 연결 직접 설정 필요
• 서비스 추가/삭제 시 명령어 길게 반복
• 멀티 컨테이너 환경에서 실행 순서 관리 어려움

---

📌 3. Docker Compose

✅ 3-1. Docker Compose 개념

Docker Compose = 여러 컨테이너를 한 번에 정의하고 실행하는 도구

• docker-compose.yml 한 파일 안에서 서비스(컨테이너) 정의 + 포트 + 환경 변수 + 볼륨 + 네트워크 모두 관리
• 명령어 한 번(docker-compose up -d)으로 여러 컨테이너 실행, 연결, 데이터 영속성까지 처리 가능
• 개발 환경에서 MSA/인프라 전체 스택 구성할 때 매우 유용
  
  

🔹 장점

항목	장점
자동화	단일 명령어로 모든 서비스 실행 가능
연결 관리	컨테이너끼리 네트워크 이름으로 바로 통신 가능
환경 분리	dev/test/prod 환경 별 Compose 파일 가능
재현성	팀원 모두 동일 환경 재현 가능

 

✅ 3-2. docker-compose.yml 작성

docker-compose.yml은 “프로젝트 폴더 루트”에 둔다.

 

📖 Spring Boot(application.properties) 예시

# DB (3307)
spring.datasource.url=jdbc:mariadb://localhost:3307/mydb
# 다른 컨테이너로 접근할 때 (localhost X → 컨테이너 이름, 3306)
# spring.datasource.url=jdbc:mariadb://mariadb:3306/mydb
spring.datasource.username=root
spring.datasource.password=root
spring.jpa.hibernate.ddl-auto=update #테이블 자동 생성

# Redis
spring.redis.host=localhost
spring.redis.port=6379

* mariadb는 이미 로컬에서 3306으로 수행 중. 

학습을 위해 3307로 테스트. 실제로는 이미 데이터 들어있어서 그냥 로컬 썼음.

service.msc에서 로컬 db 종료하고 도커에서 3306써도 됨. (동시 실행 불가)

 

📖 docker-compose.yml 예시

services:
  mariadb:
    image: mariadb:10.6
    container_name: mariadb
    environment:
      MYSQL_ROOT_PASSWORD: root
    ports:
      - "3307:3306" # 로컬 PC에 mariaDB가 있어서 포트 변경
    volumes:
      - mariadb_data:/var/lib/mysql   # DB 데이터 영구 저장

  redis:
    image: redis
    container_name: redis
    ports:
      - "6379:6379"
    volumes:
      - redis_data:/data             # Redis 데이터 저장

volumes:
  mariadb_data:
  redis_data:​

 

🔹 설정 항목

항목	역할	예시
환경 변수	컨테이너 내부 설정 전달	MYSQL_ROOT_PASSWORD=root
포트	호스트 ↔ 컨테이너 매핑	3306:3306, 6379:6379
네트워크	컨테이너끼리 통신	app ↔ mariadb 동일 네트워크
볼륨	데이터 영속성	/var/lib/mysql → mariadb_data

 

✅ 3-3. 실행/종료

프로젝트 루트 경로(docker-compose.yml와 같은 경로)에서 실행.

 

🔹생성, 실행: up

docker-compose up -d

• 컨테이너 없으면 → 생성 + 실행
• 컨테이너 있으면 → (Compose.yml 수정) 변경사항 반영해서 →  재생성 + 실행
• *Dockerfile 수정 시: docker-compose up -d --build → 시작 + 생성 + 실행

 

🔹제거: down

docker-compose down

• 컨테이너 삭제
• 네트워크 삭제
• ✔ “완전히 종료 + 제거”
• ❗volume은 기본 유지

 

🔹정지: stop

docker-compose stop

• 컨테이너 “정지”만 함
• 삭제 안 함 “일시정지 느낌”

 

🔹재실행: start

docker-compose start

• stop된 컨테이너 다시 실행
• ✔ “재시작 (이미 존재해야 함)”

 

🔹정지, 재실행: restrart

docker-compose restart

• stop + start

 

---

📌4. 볼륨(volume) 

✅4-1. Volume 개념

Volume=데이터 영속성

• Docker 볼륨 = 컨테이너 외부에 데이터를 저장하는 공간
• 컨테이너는 원래 임시 공간에서 동작 → 삭제 시 데이터도 삭제
• 볼륨을 쓰면 컨테이너 삭제 후에도 데이터 유지 가능
  
  

📖 예시: DB 데이터 저장

• 컨테이너 내부 기준: /var/lib/mysql (MariaDB)
• 여기 안에 DB 파일, 테이블, 인덱스, 로그 등 모두 저장
  
  

✅ 4-2. 볼륨 종류

종류	설명	예시
Named Volume (추천)	Docker가 관리, 안전하게 데이터 유지	mariadb_data:/var/lib/mysql
Bind Mount	PC 경로와 컨테이너 연결, 파일 직접 확인 가능	./dbdata:/var/lib/mysql

✔ 실무 기준: 기본은 Named Volume, 필요 시 Bind Mount

✅ 4-3. 볼륨 확인 방법

1️⃣ 볼륨 리스트 확인

docker volume ls

2️⃣ 볼륨 실제 경로 확인

docker volume inspect mariadb_data

📖 결과 예시:

[
 {
   "Name": "mariadb_data",
   "Mountpoint": "/var/lib/docker/volumes/mariadb_data/_data"
 }
]

✔ /var/lib/docker/volumes/mariadb_data/_data ← 실제 DB 파일 저장 위치

 

✅ 4-4. 인프라 초기화 예제

많이 쓰는 외부 인프라 MariaDB와 Redis로 실습해보았다.

*GUI에서도 생성/확인 가능하다!!

 

🚀 인프라 초기화 총정리

1. docker-compose up -d → 공용 MariaDB, Redis, ES 컨테이너 실행
2. MariaDB 접속 → 서비스별 DB 생성 (orders, products)
3. 테이블 생성 → SQL 직접 작성 또는 Spring Boot JPA 자동 생성
4. Redis 초기화 → redis-cli 사용
5. 서비스 실행 → DB/Redis 연결 확인 → 볼륨 덕분에 데이터 영구 저장

✅ 4-4-1. mariaDB

1️⃣ MariaDB 접속 및 DB 생성

① 컨테이너 내부 접속

docker exec -it common-mariadb mysql -uroot -p
# 비밀번호: root

 

② 호스트에서 접속 (포트 매핑 활용)

mysql -h 127.0.0.1 -P 3306 -uroot -p

 

 

③ 서비스별 DB 생성

-- Order 서비스용 DB
CREATE DATABASE orders;

-- Product 서비스용 DB
CREATE DATABASE products;

-- 권한 부여 (root 계정은 기본으로 모든 DB 접근 가능, 필요 시 별도 계정 생성)
GRANT ALL PRIVILEGES ON orders.* TO 'root'@'%';
GRANT ALL PRIVILEGES ON products.* TO 'root'@'%';
FLUSH PRIVILEGES;

💡 포인트: 공용 MariaDB 하나지만, DB 이름만 다르게 생성 → MSA 서비스별 데이터 분리

 

2️⃣ 테이블 생성

🔹 방법 1: SQL 직접 작성 (기존 코드 없을 때!!)

-- orders DB
USE orders;

CREATE TABLE order_info (
  id BIGINT AUTO_INCREMENT PRIMARY KEY,
  user_id BIGINT NOT NULL,
  product_id BIGINT NOT NULL,
  quantity INT NOT NULL,
  status VARCHAR(50) DEFAULT 'ORDERED',
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
);

🔹 방법 2: Spring Boot JPA 자동 생성 (기존 코드 있을 )

- application.properties 예시 (Order 서비스 기준)

# DB
spring.datasource.url=jdbc:mariadb://localhost:3306/orders
spring.datasource.username=root
spring.datasource.password=root
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

• JPA 엔티티 기반으로 테이블 자동 생성
• 장점: 코드 중심 테이블 관리, 컨테이너 재시작해도 볼륨 덕분에 데이터 유지
• 단점: 운영 환경에서는 SQL 스크립트/마이그레이션 툴 권장

 

3️⃣ 테이블 조회

🔹 방법 1: Docker Desktop → 컨테이너 접속

mariadb 컨테이너 Terminal에서.

mysql -u root -p
비번: root
SHOW DATABASES;
USE orders;
SHOW TABLES;

 

🔹 방법 2: DB 툴 (추천 👍)

🔥 연결 정보

host: localhost

port: 3307 (나는 로컬에 mariaDB가 3306써서 이렇게 설정함)

user: root

password: root

database: orders

 

# DB

spring.datasource.url=jdbc:mariadb://localhost:3307/orders

 

✅ IDE에서 실행할 때

jdbc:mariadb://localhost:3307/orders

 

✅ Docker 안에서 실행할 때

jdbc:mariadb://mariadb:3306/orders

 

✅ 4-4-2. Redis 초기화 / 확인

🔹 컨테이너 접속:

docker exec -it common-redis redis-cli

 

🔹 데이터 확인 / 삭제

> KEYS *          # 모든 key 확인

> FLUSHALL        # 모든 데이터 삭제 (초기화)

 

💡 Redis는 기본적으로 메모리 기반이라 초기화는 이렇게 CLI로 간단하게 가능

---

📌 5. Docker 네트워크 & DNS

🔹 컨테이너는 각각 localhost를 가진다

• 각 컨테이너는 다른 컴퓨터 취급
• localhost = 자기 자신
  
  

🔹 컨테이너 간 통신 방법

• Docker Compose는 컨테이너끼리 통신용 DNS를 자동 생성한다. 
• 서비스 이름으로 통신 (eureka-server)
  
  

🔹 외부 ↔ 컨테이너 통신

• 포트 매핑 (8761:8761)
• 포트 포워딩(port mapping) => 내 로컬 PC에서 실행중인 프로그램 or 브라우저로 직접 접속 시에는, localhost로 컨테이너에서 실행중인 서비스에 접속가능하다!!

 

🔹 컨테이너 → 로컬 PC 접근

• Host.docker.internal => Docker가 특별히 제공하는 가짜 DNS 이름
• *Linux는 안 될수도 있다고 한다.

 

🚀 네트워크 흐름 총정리

[내 PC]
   localhost:8080  → 컨테이너 (포트포워딩)
   localhost:8761  → 컨테이너 (포트포워딩)

[컨테이너 내부]
   localhost       → 자기 자신 ❌
   eureka-server   → 다른 컨테이너 ✅
   host.docker.internal → 내 PC ✅

 

---

📌 6. 환경변수

로컬/컨테이너 실행환경이 다르기 때문에 환경변수 설정이 필요하다.

Docker-compose.yml에 환경 변수 설정하면 application.yml 설정 덮어써서 로컬실행, 도커실행 둘다 가능하다.

 

✅ 6-1. 환경 변수 이름

Spring boot 설정파일 (application.yml or application-properties)랑 매핑된다.

eureka.client.service-url.defaultZone

↓

EUREKA_CLIENT_SERVICEURL_DEFAULTZONE

 

📖 예시

# 로컬 pc에서 서비스 실행 시 (eureka, gateway)
# application.yml
eureka.client.service-url.defaultZone=http://localhost:8761/eureka/
↓
# 도커쓰면 서비스 네임으로 컨테이너 간 통신
# docker-compose.yml
environment:
 - EUREKA_CLIENT_SERVICEURL_DEFAULTZONE=http://eureka-server:8761/eureka/

 

---

📌 7. 실습: MSA 공통 인프라 자동 실행

기존 존재하던 MSA 프로젝트에서 애플리케이션 인프라를 컨테이너 시작 시 같이 실행되게 하려고한다! 

• eureka-server와 api-gateway는 공통 인프라는 변경이 적고, 항상 먼저 실행되어야 한다.
• 컨테이너로 고정 실행하여 안정적으로 서비스 의존성 순서 보장 (eureka → gateway → 서비스)하고자 한다.
• 비즈니스 서비스(order, product 등)는 개별로 수동 실행

 

✅ 7-1. Compose.yml 수정 (나머지 부분은 3번 예제 참고!)

• 포트 매핑
• Healthcheck과 depends_on으로 실행 순서 제어. (의존성 관리)
• Environment로 환경변수 설정
• Profile 설정

 # =====================
  # 자동 시작 MSA
  # =====================
  eureka-server:
    build: ./eureka
    container_name: eureka-server
    ports:
      - "8761:8761"
    depends_on:  # 리스트 방식 (예시임. 얘는 의존성 필요없다)
      - mariadb
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:8761/actuator/health"]
      interval: 5s
      retries: 10

  api-gateway:
    build: ./gateway
    container_name: api-gateway
    ports:
      - "8080:8080"
    Depends_on: # 객체 방식
        mariadb:
            condition: service_started
        eureka-server:
            condition: service_healthy
    environment:
      - EUREKA_CLIENT_SERVICEURL_DEFAULTZONE=http://eureka-server:8761/eureka/
    # healthcheck:
    #   test: ["CMD", "curl", "-f", "http://localhost:8080/actuator/health"]
    #   interval: 5s
    #   retries: 10


# =====================
# 다른 서비스 (수동 실행)
# =====================
  order-service:
    build: ./order-service
    container_name: order-service
    profiles: ["optional"]
    ports:
      - "8085:8080"
    depends_on:
      eureka-server:
        condition: service_healthy
    environment:
      - EUREKA_CLIENT_SERVICEURL_DEFAULTZONE=http://eureka-server:8761/eureka/
  product-service:
    build: ./product-service
    container_name: product-service
    profiles: ["optional"]
    ports:
      - "8083:8080"
    depends_on:
      eureka-server:
        condition: service_healthy
    environment:
      - EUREKA_CLIENT_SERVICEURL_DEFAULTZONE=http://eureka-server:8761/eureka/​

 

✅ 7-2. JAR 파일 준비

1️⃣ Build.gradle

tasks.bootJar {
    archiveFileName = 'gateway.jar'                // JAR 이름
    destinationDirectory = file("$buildDir/target") // 경로
}

2️⃣ \gradlew bootJar 수행

3️⃣ build/target/{}.jar 파일 생성 확인.

 

✅7-3. 도커 이미지 준비

각 서비스(폴더) 안에 Dockerfile 필요

- Dockerfile (eureka)

FROM eclipse-temurin:17-jdk # jdk버전 유의 (유효버전 검색)
COPY build/target/eureka-server.jar /app.jar # 실제 jar 위치
ENTRYPOINT ["java", "-jar", "/app.jar"]

 

✅ 7-4. docker-compose up 실행 옵션

🔹 기본 실행

profile 속성이 없는 서비스 전체 실행

docker-compose up -d

 

🔹 profile 포함 실행

profiles: ["optional"] 속성 포함 전체 서비스 실행

*비즈니스 서비스 개발 시에는 로컬PC IDE에서 실행, 운영에서는 컨테이너에서 실행 가능!!

docker-compose --profile optional up -d

 

🔹개별 서비스 실행

Profiles여부와 상관없이 개별로 실행가능.

docker-compose up -d order-service

여러개 선택 실행도 가능.

docker-compose up -d  eureka-server api-gateway mariadb redis

 

1️⃣ 스프링부트 Jar 파일 직접 실행 (Dockerfile 없이)

• 이미 빌드된 jar 파일이 있다면 image: + command:로 바로 컨테이너 실행 가능

api-gateway:
 image: openjdk:17
 container_name: api-gateway

 ports:
   - "8080:8080"

 volumes:
   - ./api-gateway/target:/app

 working_dir: /app
 command: ["java", "-jar", "api-gateway.jar"]
 depends_on:
   - eureka-server

✔  ./api-gateway/target/api-gateway.jar 경로에 실제 jar 파일 있어야 함

✔  Dockerfile 없이도 컨테이너에서 실행 가능

 

🔹 확인

# 컨테이너 상태 확인
docker ps

# Eureka 서버가 정상 구동됐는지 확인
docker logs eureka-server

# Gateway 정상 구동 확인
docker logs api-gateway