---

이 글은 한화 SW 과정 실습 중 겪은 환경 문제를
스스로 Docker를 도입해 해결한 실제 경험과
도커의 개념, 구조, 명령어, 실습 환경을
기술적으로 정리해 공유하는 글입니다.

---

목차

1. Docker 기본 개념: "한 번 만들어 어디서나 똑같이 실행"
2. Docker 동작 원리 및 구조 (그림과 함께)
3. Docker와 실제 개발/운영 환경에서의 가치
4. 나는 왜 Docker를 선택했나? (실습 환경 기준, 문제점과 해결)
5. 실습 환경 아키텍처 (포트/네트워크 흐름)
6. 실제 설치/실행 경험 (명령어/실제 화면 정리)
7. Docker의 기술적 배경 (CS 관점 요약)
8. 앞으로의 실습/학습 목표
9. Reference

---

1. Docker 기본 개념: "한 번 만들어 어디서나 똑같이 실행"

출처: https://www.docker.com/

📦 도커란?

• Docker는 "컨테이너(Container)"라는 기술을 이용해 애플리케이션 실행 환경 전체를 캡슐화하는 오픈소스 플랫폼입니다.
• "내 컴퓨터에선 되는데?"라는 문제(환경 불일치)를 해결.
• 한 번 패키징한 이미지는 어떤 OS, 어떤 컴퓨터에서도 완벽하게 재현!

---

2. Docker 동작 원리 및 구조 (그림과 함께)

(1) 전체 동작 구조

출처: https://www.docker.com

구성요소

• Client: docker run, docker build, docker pull 등 명령어로 Docker를 조작하는 주체 (보통 개발자의 터미널)
• Docker Host: Docker가 설치된 컴퓨터.
  • Docker Daemon(서버): 실제로 이미지 관리, 컨테이너 실행, 네트워크·스토리지 관리 등 모든 동작을 수행
  • Images: 실행 가능한 프로그램, 라이브러리, 의존성, 설정값 등 전체 실행 환경의 '스냅샷'
  • Containers: 이미지를 실행시켜 만들어진 독립적인 '실행 인스턴스'
• Registry: 이미지의 저장소 (ex: Docker Hub).
  • 이미지를 pull/push해서 팀/회사/커뮤니티와 공유 가능

흐름

1. 이미지는 보통 레지스트리(도커허브 등)에서 pull 해서 내려받음
2. 이미지를 기반으로 컨테이너를 run 해서 실행
3. 필요하다면 직접 build(Dockerfile 기반)해서 이미지 생성 가능
4. 컨테이너는 격리된 상태(별도 네트워크, 파일시스템, 환경변수 등)에서 실행됨

---

(2) VM(Virtual Machine vs Docker Containers 구조 비교

출처: https://www.atlassian.com/microservices/cloud-computing/containers-vs-vms

구분	Virtual Machine(가상머신)	Docker(컨테이너)
구조	물리서버 → Hypervisor → 게스트OS → 앱	물리서버 → Host OS → Docker Engine → 컨테이너(앱)
장점	완벽한 격리, OS마다 완전 다르게 사용 가능	매우 빠름, 가볍고, 필요 최소 리소스만 사용
단점	느림, 무거움, VM마다 OS가 따로 구동	Host OS 커널에 따라 약간의 제약
용도	완전 독립된 OS 환경 필요할 때	서비스 분리, 신속 배포, CI/CD, DevOps

핵심

• VM은 "OS까지 통째로 복제", 컨테이너는 "앱과 의존성만 격리해서 초경량화"
• 대용량 컨테이너도 서버 한 대에서 띄우는게 가능

---

(3) Docker 실행의 핵심 단계: Dockerfile → Image → Container

출처:https://www.docker.com

1. Dockerfile 작성
   • 설치할 프로그램, 명령어, 환경변수 등 '레시피' 작성
2. 이미지(Image)로 빌드
   • 모든 설정/라이브러리/앱 파일이 포함된 스냅샷 생성
3. 컨테이너(Container)로 실행
   • 이미지를 기반으로 메모리 위에 띄우는 '실행 인스턴스'

주요 명령어

• docker build -t myapp . : Dockerfile에서 이미지 생성
• docker pull ubuntu:22.04 : 도커허브에서 이미지 가져오기
• docker run -d -p 8080:80 myapp : 컨테이너 생성 및 포트포워딩

---

3) Docker Architecture Overview: 컨테이너 생명주기와 주요 컴포넌트

출처: https://until.blog/@xeros/docker%EB%9E%80-%EB%AC%B4%EC%97%87%EC%9D%B4%EB%A9%B0-%EA%B8%B0%EB%B3%B8%EC%A0%81%EC%9C%BC%EB%A1%9C-%EC%96%B4%EB%96%BB%EA%B2%8C-%EC%82%AC%EC%9A%A9%ED%95%98%EB%8A%94%EA%B0%80-

구조 한눈에 보기

이 그림은 Docker의 내부 구조와 명령의 흐름을 한눈에 보여줍니다.
개발자가 CLI로 명령을 입력하면, 아래와 같은 경로로 동작합니다.

---

📌 각 구성요소 설명

• Docker Client
  개발자가 터미널(혹은 기타 API, GUI)에서 docker run, docker build, docker pull 등 명령을 실행하는 주체.

• Docker Daemon (Server)
  Docker의 핵심 엔진. 클라이언트 명령을 받아 실제로 이미지 빌드, 컨테이너 실행/정지, 리소스 관리 등을 담당합니다.

• Docker Engine
  Daemon + REST API + CLI 등 Docker를 구성하는 전체 엔진 구조.

• Docker Images
  코드, 라이브러리, 환경변수 등 애플리케이션이 동작하는 데 필요한 실행 환경의 스냅샷.
  이미지를 기반으로 컨테이너를 생성합니다.

• Docker Containers
  이미지를 실제로 실행한 격리된 인스턴스.
  각각 독립된 환경에서 돌아가는 하나의 어플리케이션.

• Docker Registry
  이미지를 저장/공유하는 중앙 저장소(Docker Hub, 자체 Registry 등).
  이미지는 Registry에서 pull, 내 이미지는 push로 업로드 가능.

• Running Instances
  이미지를 기반으로 실제 동작 중인 컨테이너(실행 인스턴스).

---

⏩ 동작 흐름

1. 개발자가 터미널에서 명령 실행
   → 예) docker run mariadb:latest
2. Client가 명령을 Docker Daemon에 전달
3. Daemon은 필요 시 Registry에서 이미지를 pull
4. 이미지를 바탕으로 컨테이너(Container)를 실행
5. 실행 중인 컨테이너는 Daemon이 계속 관리
6. 필요에 따라 이미지는 Registry에 push/pull로 공유

---

정리:
Docker의 명령어 실행부터 실제 컨테이너 구동,
이미지의 생성/저장/공유까지의 전체 라이프사이클을
하나의 그림으로 쉽게 이해할 수 있습니다.

---

3. Docker와 실제 개발/운영 환경에서의 가치

• 재현성: 어디서든 같은 환경 (테스트/운영/배포)
• 쉬운 확장/복제: 컨테이너 수백 개 자동화 관리 (Docker Compose, K8s 등)
• 빠른 시작/종료: OS 구동 불필요, 수 초 만에 서비스 교체 가능
• DevOps, CI/CD: 테스트/배포 자동화에 필수적

---

4. 나는 왜 Docker를 선택했나? (실습 환경 기준, 문제점과 해결)

• 로컬에 이미 MySQL이 설치되어 있고, 실습에서는 MariaDB를 별도 사용해야 하는 상황이었음
• Mac 환경에서는 HeidiSQL(윈도우 전용 DB툴) 사용이 불가능
• Docker로 MariaDB 컨테이너를 띄우고, Sequel Ace로 연결 → 포트만 분리해서 중복 걱정 없이 사용
• VirtualBox로 리눅스 서버를 띄우지 않아도, Docker 컨테이너로 간단하게 환경 복제/관리가 가능
• 네트워크, 포트포워딩, ssh 등 실습에 필요한 거의 모든 인프라 환경을 코드(명령어)로 세팅할 수 있었음

---

5. 실습 환경 아키텍처 (포트/네트워크 흐름)

• 간단하지만 실습 환경 아키텍처를 직접 그려봤다
  

• Mac(Host)
  • Docker Desktop 실행 (도커 엔진/컨테이너 관리)
  • Sequel Ace(로컬 클라이언트) → 포트포워딩(127.0.0.1:3307 → MariaDB 컨테이너:3306)
  • 터미널 SSH → 포트포워딩(127.0.0.1:2222 → Ubuntu 컨테이너:22)
• Docker Container
  • Ubuntu(SSH 서버 구동)
  • MariaDB(별도 포트, 데이터 볼륨, 네트워크 격리)
• 각 컨테이너는 별도 가상 네트워크(bridge)에서 동작
  • 컨테이너 내부에서는 172.x.x.x와 같은 내부 IP로 직접 통신 가능 (Ubuntu → MariaDB 등)
  • Mac에서는 오직 외부로 개방한 포트로만 접근 가능

---

6. 실제 설치/실행 경험 (명령어 /실제 화면 정리)

1) Docker Desktop 설치

• 공식사이트에서 Mac용 Docker Desktop 다운로드/설치

2) MariaDB 컨테이너 띄우기

MariaDB 컨테이너 실행 예시

docker pull mariadb:latest
docker run -d \
  --name mariadb-test \
  -e MYSQL_ROOT_PASSWORD=비밀번호 \
  -p 3307:3306 \
  mariadb:latest

옵션	설명	예시
-d	컨테이너를 백그라운드(Detached)로 실행	docker run -d ...
--name	컨테이너에 이름 지정	docker run --name my-container ...
-e	환경변수(ex. 비밀번호 등) 설정	docker run -e MYSQL_ROOT_PASSWORD=비번 ...
-p	포트포워딩 (로컬:컨테이너) 설정	docker run -p 3307:3306 ...

3)Ubuntu 컨테이너 띄우기

• Ubuntu(SSH) 컨테이너 실행 예시

docker pull rastasheep/ubuntu-sshd:18.04
docker run -d \
  --name ubuntu-ssh \
  -p 2222:22 \
  rastasheep/ubuntu-sshd:18.04

기본 ubuntu 이미지에는 SSH 데몬이 설치/구동되어 있지 않으니, rastasheep/ubuntu-sshd와 같이 SSH가 포함된 이미지를 사용하면 편리함.

4) Sequel Ace/터미널 연결 예시

• Sequel Ace에서 연결 설정

Host: 127.0.0.1
Port: 3307 (아까 -p 3307:3306으로 포워딩한 포트)
사용자/비번: MariaDB 환경에 맞게 입력

ssh root@127.0.0.1 -p 2222

• 명령어를 통해 둘다 잘 연결 됐는지 확인
  

4) 컨테이너 IP/포트/네트워크 확인법

docker ps                # 모든 컨테이너/포트 매핑 확인
docker inspect [컨테이너명] | grep IPAddress

docker exec -it [컨테이너명] bash  # 내부 진입
ifconfig                  # 내부에서 IP 확인

---

7. Docker의 기술적 배경 (CS 관점 요약)

CS를 단순히 이론으로만 받아들이지 않고, 직접 사용하는 툴에 적용한 CS관점을 추후 공부하기 위해 정리 해놓으려고 한다.

• 리눅스 커널 기술: Namespace(격리), cgroups(리소스 제한), OverlayFS(계층화)
• 이미지 레이어: 불필요한 중복 없이, 공통 파일을 공유하고 필요한 부분만 추가
• 격리 수준: 프로세스, 네트워크, 파일시스템, 사용자 권한 등 모두 별도 공간처럼 분리
• 실행 속도: OS 부팅 없이 컨테이너 프로세스만 실행. VM 대비 압도적 속도/효율

---

8. 앞으로의 실습/학습 목표 ( 무조건 하리라..)

• docker-compose로 여러 서비스 일괄 관리 및 자동화

• MariaDB 데이터 볼륨, 백업/복구, 데이터 이관 자동화

• Spring과의 실제 연동 프로젝트 구축

• CI/CD, Jenkins, Github Actions 등 DevOps 파이프라인 실습

• AWS, GCP 등 퍼블릭 클라우드 배포 실습

---

[Reference]

• Docker 공홈
• docker
• 컨테이너와 VM의 차이 (블로그)
• Docker + ubuntu
• Docker + maria DB

---