Docker 입문: 컨테이너로 개발 환경 통일하기

┌─────────────────────────────────────────────┐
│               Docker Host                   │
│                                             │
│  ┌──────────┐      ┌───────────────────┐   │
│  │  Docker  │ REST │   Docker Daemon   │   │
│  │  Client  │─────▶│   (dockerd)       │   │
│  │(docker)  │      │                   │   │
│  └──────────┘      │  ┌─────────────┐ │   │
│                    │  │  Container  │ │   │
│                    │  └─────────────┘ │   │
│                    │  ┌─────────────┐ │   │
│                    │  │  Container  │ │   │
│                    │  └─────────────┘ │   │
│                    └───────────────────┘   │
└─────────────────────────────────────────────┘
         ▲
         │ push/pull
         ▼
   ┌───────────┐
   │ Docker Hub│ (Registry)
   └───────────┘

이미지 = 실행 가능한 스냅샷 (읽기 전용)

┌──────────────────────────┐
│  내 앱 코드 (Layer 4)    │  ← COPY . .
├──────────────────────────┤
│  pip 패키지 (Layer 3)    │  ← RUN pip install
├──────────────────────────┤
│  requirements.txt (L2)   │  ← COPY requirements.txt
├──────────────────────────┤
│  python:3.11-slim (L1)   │  ← FROM
└──────────────────────────┘

이미지 : 컨테이너 = 클래스 : 객체

FROM python:3.11-slim          # 베이스 이미지
WORKDIR /app                   # 작업 디렉토리 설정
COPY requirements.txt .        # 파일 복사
RUN pip install -r requirements.txt  # 명령 실행 (레이어 생성)
COPY . .                       # 소스코드 복사
CMD ["python", "app.py"]       # 컨테이너 시작 시 실행할 명령

docker --version
# Docker version 26.x.x, build ...

docker run hello-world
# Hello from Docker! 출력되면 정상

FROM python:3.11-slim
FROM ubuntu:22.04
FROM scratch          # 완전히 빈 이미지 (Go 바이너리 등에 사용)

# 나쁜 예 — RUN 3개 = 레이어 3개
RUN apt-get update
RUN apt-get install -y curl
RUN apt-get clean

# 좋은 예 — && 로 연결하면 레이어 1개
RUN apt-get update && \
    apt-get install -y curl && \
    apt-get clean && \
    rm -rf /var/lib/apt/lists/*

COPY src/ /app/src/        # 로컬 파일/디렉토리 복사 (권장)
ADD archive.tar.gz /app/   # 자동 압축해제 기능 있음 (tar만)
ADD https://example.com/file /app/  # URL에서 직접 다운로드 (보안상 비권장)

# ARG — 빌드 시에만 사용되는 변수
ARG VERSION=1.0
RUN echo "Building version $VERSION"

# ENV — 빌드 + 런타임 모두 사용 가능한 환경변수
ENV APP_ENV=production
ENV PORT=8000

# CMD — 기본 명령. docker run 시 오버라이드 가능
CMD ["python", "app.py"]
CMD ["python", "-m", "pytest"]  # 테스트용으로 오버라이드 가능

# ENTRYPOINT — 반드시 실행할 명령. 오버라이드하려면 --entrypoint 필요
ENTRYPOINT ["python", "app.py"]

# 함께 쓰면: ENTRYPOINT가 명령, CMD가 기본 인자
ENTRYPOINT ["python"]
CMD ["app.py"]
# docker run myapp            → python app.py
# docker run myapp test.py    → python test.py

EXPOSE 8000     # 컨테이너가 이 포트를 사용한다는 문서화 (실제 포트 오픈은 -p 옵션)

RUN addgroup --system appgroup && adduser --system --ingroup appgroup appuser
USER appuser    # 이후 모든 명령은 appuser로 실행

# Docker Hub에서 이미지 내려받기
docker pull nginx
docker pull nginx:1.25       # 태그(버전) 지정

# 로컬 이미지 목록
docker images
docker images --filter "dangling=true"  # 태그 없는 이미지만

# 이미지 삭제
docker rmi nginx
docker image prune            # 사용하지 않는 이미지 전체 삭제

# 기본 실행
docker run nginx

# 자주 쓰는 옵션 조합
docker run -d \              # 백그라운드 실행
  -p 8080:80 \               # 호스트포트:컨테이너포트
  --name my-nginx \          # 이름 지정
  --rm \                     # 종료 시 자동 삭제
  nginx

# 환경변수 전달
docker run -e DB_HOST=localhost -e DB_PORT=5432 my-app

# .env 파일로 환경변수 전달
docker run --env-file .env my-app

# 컨테이너 안으로 들어가기
docker run -it ubuntu bash

# 컨테이너 목록
docker ps           # 실행 중
docker ps -a        # 전체 (종료된 것 포함)

# 중지 / 재시작 / 삭제
docker stop my-nginx
docker start my-nginx
docker restart my-nginx
docker rm my-nginx
docker rm -f my-nginx   # 강제 삭제 (실행 중이어도)

# 실행 중인 컨테이너에 명령 실행
docker exec -it my-nginx bash
docker exec my-nginx cat /etc/nginx/nginx.conf

# 로그 확인
docker logs my-nginx
docker logs -f my-nginx          # 실시간 follow
docker logs --tail 100 my-nginx  # 마지막 100줄

# 리소스 사용량 확인
docker stats my-nginx
docker stats                     # 모든 컨테이너

# 컨테이너 상세 정보
docker inspect my-nginx

FROM python:3.11-slim
WORKDIR /app
COPY . .                              # 소스코드 변경 → 이 이후 캐시 무효화
RUN pip install -r requirements.txt   # 매번 재실행됨
CMD ["python", "app.py"]

FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt .               # requirements.txt만 먼저 복사
RUN pip install --no-cache-dir -r requirements.txt  # 캐시됨
COPY . .                              # 소스코드는 나중에 (자주 바뀜)
CMD ["python", "app.py"]

# 호스트 디렉토리를 컨테이너에 직접 연결
docker run -d \
  -p 5000:5000 \
  -v $(pwd)/data:/app/data \    # 호스트경로:컨테이너경로
  my-flask-app

# 볼륨 생성
docker volume create mydata

# 볼륨 연결
docker run -d \
  -v mydata:/app/data \
  my-flask-app

# 볼륨 목록
docker volume ls

# 볼륨 삭제
docker volume rm mydata

# 네트워크 목록
docker network ls

# 커스텀 네트워크 생성
docker network create my-network

# 컨테이너를 네트워크에 연결해서 실행
docker run -d --name app --network my-network my-flask-app
docker run -d --name db --network my-network postgres

# 같은 네트워크 안에서는 컨테이너 이름으로 통신 가능
# app 컨테이너에서 db 컨테이너에 접근: host = "db"

# Stage 1: 빌드
FROM golang:1.22 AS builder
WORKDIR /app
COPY . .
RUN go build -o server .

# Stage 2: 실행 (golang 컴파일러 불필요)
FROM alpine:3.19
WORKDIR /app
COPY --from=builder /app/server .   # builder 스테이지에서 바이너리만 복사
CMD ["./server"]

# Stage 1: 빌드
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

# Stage 2: 서빙 (node_modules 불필요)
FROM nginx:alpine
COPY --from=builder /app/dist /usr/share/nginx/html

my-app/
├── app.py
├── requirements.txt
├── Dockerfile
└── .dockerignore

from flask import Flask, jsonify
import os

app = Flask(__name__)

@app.route("/")
def hello():
    return jsonify({
        "message": "Hello from Docker!",
        "env": os.environ.get("APP_ENV", "development")
    })

@app.route("/health")
def health():
    return jsonify({"status": "ok"})

if __name__ == "__main__":
    port = int(os.environ.get("PORT", 5000))
    app.run(host="0.0.0.0", port=port)

flask==3.0.3
gunicorn==21.2.0

FROM python:3.11-slim

# 보안: 비루트 사용자
RUN addgroup --system appgroup && \
    adduser --system --ingroup appgroup appuser

WORKDIR /app

# 의존성 먼저 (캐시 최적화)
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt

# 소스코드
COPY . .

# 소유권 변경
RUN chown -R appuser:appgroup /app

USER appuser

EXPOSE 5000

# 개발: flask 직접 실행, 프로덕션: gunicorn 권장
CMD ["gunicorn", "--bind", "0.0.0.0:5000", "app:app"]

__pycache__/
*.pyc
*.pyo
.env
.git
.gitignore
.venv
venv/
*.log
README.md

# 이미지 빌드
docker build -t my-flask-app .

# 빌드된 이미지 확인
docker images my-flask-app

# 실행 (환경변수 포함)
docker run -d \
  -p 5000:5000 \
  -e APP_ENV=production \
  --name flask-app \
  my-flask-app

# 동작 확인
curl http://localhost:5000
curl http://localhost:5000/health

# 로그 확인
docker logs flask-app

# 종료된 컨테이너 로그 확인
docker logs <container-id>

# 종료 코드 확인
docker inspect <container-id> --format='{{.State.ExitCode}}'

# 셸로 직접 들어가서 확인
docker run -it my-flask-app bash   # CMD 무시하고 bash 실행

docker history my-flask-app

# 실행 중인 컨테이너에 접속
docker exec -it flask-app bash

# 파일 복사 (컨테이너 → 호스트)
docker cp flask-app:/app/app.log ./app.log

docker build --no-cache -t my-flask-app .

# Docker Hub 로그인
docker login

# 이미지 태그 (username/repo:tag 형식)
docker tag my-flask-app myusername/my-flask-app:1.0.0
docker tag my-flask-app myusername/my-flask-app:latest

# 푸시
docker push myusername/my-flask-app:1.0.0
docker push myusername/my-flask-app:latest

# 나쁜 예
FROM python:latest    # 버전이 언제 바뀔지 모름

# 좋은 예
FROM python:3.11-slim  # 버전 고정

# node_modules, .git 등 불필요한 파일까지 컨텍스트에 포함됨
# 빌드가 느려지고 이미지가 커짐

# 컨테이너 탈출 취약점 발생 시 호스트까지 위험
# USER 지시어로 비루트 사용자 지정 권장

# 절대 금지 — 이미지 히스토리에 남음
ENV DB_PASSWORD=mysecretpassword

# 대신 런타임에 환경변수로 전달
docker run -e DB_PASSWORD=$DB_PASSWORD my-app
# 또는 Docker Secrets, 외부 시크릿 관리 도구 사용