실무자를 위한 Docker 핵심 스터디 가이드

1. Docker란?

Docker는 애플리케이션을 컨테이너라는 표준화된 단위로 패키징하고 실행하기 위한 오픈 소스 플랫폼입니다. 컨테이너는 코드, 런타임, 시스템 도구, 시스템 라이브러리 등 소프트웨어 실행에 필요한 모든 것을 포함하는 경량화된 실행 환경입니다.

2. 왜 써야 하는가? (기존 대안과 비교)

3. 핵심 개념

Docker는 클라이언트-서버 아키텍처로 동작합니다. 주요 구성 요소와 흐름을 이해해야 합니다.

4. 퀵스타트: 설치 → 설정 → 첫 예제

Step 1: 설치 (Ubuntu 기준)

# 기존 패키지 제거 (선택사항)
sudo apt-get remove docker docker-engine docker.io containerd runc

# 저장소 설정 및 패키지 설치
sudo apt-get update
sudo apt-get install -y \
    ca-certificates \
    curl \
    gnupg \
    lsb-release

# Docker 공식 GPG 키 추가
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

# 저장소 설정
echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Docker Engine 설치
sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

# 현재 사용자를 docker 그룹에 추가 (sudo 없이 실행)
sudo usermod -aG docker $USER
# **로그아웃 후 재로그인 필요**

Step 2: 기본 설정 확인

# Docker 데몬 상태 확인
sudo systemctl status docker

# Docker 데몬 시작 및 부팅 시 자동 실행 설정
sudo systemctl start docker
sudo systemctl enable docker

# 간단한 테스트: Hello World 컨테이너 실행
docker run hello-world

Step 3: 첫 번째 Python 애플리케이션 컨테이너화

간단한 Flask 앱을 Dockerize 해봅니다.

from flask import Flask
import os
app = Flask(__name__)

@app.route('/')
def hello():
    hostname = os.environ.get('HOSTNAME', 'unknown')
    return f"Hello from Docker Container! Hostname: {hostname}"

if __name__ == '__main__':
    app.run(host='0.0.0.0', port=5000)

# 베이스 이미지 선택 (경량 Python)
FROM python:3.11-slim

# 작업 디렉토리 설정
WORKDIR /app

# 의존성 파일 복사 및 설치
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 애플리케이션 소스 복사
COPY app.py .

# 환경 변수 설정 (선택)
ENV HOSTNAME=my-first-container

# 컨테이너가 사용할 포트 노출
EXPOSE 5000

# 컨테이너 실행 시 실행할 명령
CMD ["python", "app.py"]

# requirements.txt 생성
echo "Flask==3.0.0" > requirements.txt

# Docker 이미지 빌드 (태그 지정)
docker build -t my-python-app:1.0 .

# 빌드된 이미지 확인
docker images

# 컨테이너 실행 (포트 매핑, 백그라운드 실행)
docker run -d -p 8080:5000 --name my-app my-python-app:1.0

# 실행 중인 컨테이너 확인
docker ps

# 로그 확인
docker logs my-app

# 브라우저에서 http://localhost:8080 접속 테스트

# 컨테이너 중지 및 삭제
docker stop my-app
docker rm my-app

5. 핵심 설정 레퍼런스 (Dockerfile & docker run)

6. 실무 팁 & 트러블슈팅

# 좋은 예: 패키지 설치가 먼저
COPY requirements.txt .
RUN pip install -r requirements.txt # 캐시 활용
COPY app.py .                       # 변경 시 여기부터 재빌드

# .dockerignore 예시
.git
__pycache__
*.log
.env
Dockerfile
README.md
venv/
*.pyc

# 잘못된 예: 바로 종료
docker run ubuntu echo "hello"

# 해결 1: 인터랙티브 모드로 쉘 유지
docker run -it ubuntu bash

# 해결 2: 웹 서버 실행 (메인 프로세스가 지속됨)
docker run -d -p 80:80 nginx

# Dockerfile 내에서
RUN groupadd -r appuser && useradd -r -g appuser appuser
USER appuser
WORKDIR /home/appuser
# 이후 COPY/RUN 명령은 appuser 권한으로 실행

# 실행 중인 컨테이너 내부 쉘 접근
docker exec -it [container_name] /bin/bash

# 컨테이너 로그 실시간 확인
docker logs -f [container_name]

# 컨테이너 상세 정보 (IP, 마운트, 네트워크 등)
docker inspect [container_name]

# 시스템 자원 사용량 확인
docker stats

# 사용하지 않는 이미지, 컨테이너, 볼륨 일괄 정리
docker system prune -a --volumes

7. 참고 자료

• 📘 Docker 공식 문서 - 가장 정확하고 최신의 정보원
• 🐋 Docker Hub - 공식 및 커뮤니티 이미지 레지스트리
• 📝 Dockerfile 레퍼런스 - 모든 지시어 상세 설명
• 🚀 Awesome Compose - 다양한 애플리케이션의 Docker Compose 예제 모음
• 다음 단계 학습 추천: Docker Compose (다중 컨테이너 관리), Docker Swarm / Kubernetes (오케스트레이션), 컨테이너 보안 모범 사례