nginx:alpine 이미지            myapp:v1.0 이미지
┌─────────────────┐            ┌─────────────────┐
│ nginx 설정 레이어 │  ←다름→   │ 앱 코드 레이어   │
├─────────────────┤            ├─────────────────┤
│ nginx 바이너리  │  ←다름→    │ 의존성 레이어    │
├─────────────────┤            ├─────────────────┤
│ Alpine Linux    │ ←공유→    │ Alpine Linux     │
└─────────────────┘            └─────────────────┘
         ↑                              ↑
    같은 레이어 ID — 디스크에 한 번만 저장됨

# 실습 디렉토리 준비
mkdir -p /tmp/docker/part1/exam_3 && cd /tmp/docker/part1/exam_3

# 이미지 레이어 히스토리 보기
docker history nginx:alpine

# 출력 예시:
# IMAGE          CREATED        CREATED BY                    SIZE
# a3b4c5d6e7f8   2 days ago     CMD ["nginx" "-g" "daemon…"   0B
# <missing>      2 days ago     EXPOSE map[80/tcp:{}]          0B
# <missing>      2 days ago     COPY 10-listen-on-ipv6-by…    0B
# <missing>      2 days ago     ENV NGINX_VERSION=1.25.3      0B
# <missing>      2 days ago     RUN /bin/sh -c set -x...      12.6MB
# <missing>      3 weeks ago    /bin/sh -c #(nop) ADD fil…   7.34MB  ← Alpine 기반

# 이미지 상세 정보 (레이어 SHA256 등)
docker inspect nginx:alpine | grep -A5 "Layers"

[레지스트리주소/][계정명/]이미지명[:태그]

예시:
  nginx                          → Docker Hub, nginx 공식 이미지, :latest
  nginx:1.25-alpine              → nginx 버전 1.25, Alpine 변형
  ubuntu:22.04                   → ubuntu 22.04 LTS
  python:3.11-slim               → Python 3.11, slim 변형 (불필요한 패키지 제거)
  myusername/myapp:v1.2.3        → Docker Hub, 개인 저장소
  ghcr.io/myorg/myapp:latest     → GitHub Container Registry
  123456789.dkr.ecr.us-east-1.amazonaws.com/myapp:v1  → AWS ECR

# 기본 pull (latest 태그)
docker pull nginx

# 특정 버전 지정 (프로덕션 권장)
docker pull nginx:1.25.3-alpine

# 여러 이미지 한 번에 pull
docker pull python:3.11-slim
docker pull postgres:15-alpine
docker pull redis:7-alpine

# pull 후 이미지 목록 확인
docker images
# REPOSITORY   TAG              IMAGE ID       CREATED       SIZE
# nginx        1.25.3-alpine    a3b4c5d6e7f8   2 days ago    42.6MB
# python       3.11-slim        b4c5d6e7f8a9   1 week ago    129MB

# 이미지 삭제
docker rmi nginx:1.25.3-alpine

# 사용하지 않는 이미지 모두 삭제 (dangling images)
docker image prune

# 태그 없는 이미지 포함 모두 삭제 (주의: 신중히)
docker image prune -a

# 실습 디렉토리 생성
mkdir -p /tmp/docker-image-lab && cd /tmp/docker-image-lab

# Dockerfile (파일 이름 그대로 'Dockerfile')

# FROM: 베이스 이미지 지정 (항상 첫 번째 명령)
FROM python:3.11-slim

# WORKDIR: 컨테이너 내부 작업 디렉토리 설정
# 이후 명령들의 기본 경로
WORKDIR /app

# COPY: 호스트의 파일을 컨테이너 안으로 복사
# (빌드 컨텍스트 기준 경로)
COPY requirements.txt .

# RUN: 이미지 빌드 중 실행할 명령
# 새 레이어 생성 — 캐시 활용을 위해 변경 빈도 낮은 것을 앞에
RUN pip install --no-cache-dir -r requirements.txt

# 소스코드는 마지막에 복사 (코드 변경 시 pip 재설치 방지)
COPY . .

# EXPOSE: 문서화 목적 (실제 포트 바인딩은 docker run -p로)
EXPOSE 8000

# CMD: 컨테이너 시작 시 실행할 기본 명령
# exec 형식 (배열) 권장 — 신호를 직접 받을 수 있음
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

# requirements.txt 생성
cat > /tmp/docker-image-lab/requirements.txt << 'EOF'
fastapi==0.104.1
uvicorn==0.24.0
EOF

# 간단한 FastAPI 앱 생성
cat > /tmp/docker-image-lab/main.py << 'EOF'
from fastapi import FastAPI
app = FastAPI()

@app.get("/")
def read_root():
    return {"message": "Hello from Docker!", "version": "1.0"}

@app.get("/health")
def health_check():
    return {"status": "ok"}
EOF

# Dockerfile 생성
cat > /tmp/docker-image-lab/Dockerfile << 'EOF'
FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install --no-cache-dir -r requirements.txt
COPY . .
EXPOSE 8000
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]
EOF

cd /tmp/docker-image-lab

# 기본 빌드
docker build -t myapp:v1.0 .

# 빌드 진행 상황 확인 (각 단계가 레이어)
# Step 1/6 : FROM python:3.11-slim
# Step 2/6 : WORKDIR /app
# Step 3/6 : COPY requirements.txt .
# Step 4/6 : RUN pip install --no-cache-dir -r requirements.txt
# Step 5/6 : COPY . .
# Step 6/6 : CMD ["uvicorn", ...]

# 빌드 결과 확인
docker images myapp

# 실행 테스트
docker run -d --name test-app -p 8000:8000 myapp:v1.0
curl http://localhost:8000
# {"message":"Hello from Docker!","version":"1.0"}

curl http://localhost:8000/health
# {"status":"ok"}

# 정리
docker stop test-app && docker rm test-app

# 소스코드만 변경 후 재빌드
echo 'print("updated")' >> /tmp/docker-image-lab/main.py
docker build -t myapp:v1.1 .

# 출력에서 캐시 활용 확인:
# Step 1/6 : FROM python:3.11-slim
#  ---> Using cache          ← 캐시 사용
# Step 2/6 : WORKDIR /app
#  ---> Using cache          ← 캐시 사용
# Step 3/6 : COPY requirements.txt .
#  ---> Using cache          ← requirements.txt 미변경
# Step 4/6 : RUN pip install ...
#  ---> Using cache          ← 의존성 재설치 안 함!
# Step 5/6 : COPY . .
#  ---> 새로 실행             ← 코드 변경됨

# 빌드 시 바로 태그 지정
docker build -t myapp:v1.0 .

# 기존 이미지에 추가 태그 부여
docker tag myapp:v1.0 myapp:latest
docker tag myapp:v1.0 myapp:stable

# Docker Hub에 push하기 위한 태그 (사용자명/이미지명 형식 필수)
docker tag myapp:v1.0 myusername/myapp:v1.0
docker tag myapp:v1.0 myusername/myapp:latest

# AWS ECR 형식
docker tag myapp:v1.0 123456789.dkr.ecr.us-east-1.amazonaws.com/myapp:v1.0

# GitHub Container Registry 형식
docker tag myapp:v1.0 ghcr.io/myorg/myapp:v1.0

# 모든 태그 확인
docker images myapp
# REPOSITORY   TAG       IMAGE ID       CREATED          SIZE
# myapp        v1.0      a3b4c5d6e7f8   5 minutes ago    145MB
# myapp        latest    a3b4c5d6e7f8   5 minutes ago    145MB  ← 같은 IMAGE ID
# myapp        stable    a3b4c5d6e7f8   5 minutes ago    145MB  ← 같은 IMAGE ID

# Docker Hub 로그인
docker login
# Username: myusername
# Password: ****

# push (태그가 '사용자명/이미지명' 형식이어야 함)
docker push myusername/myapp:v1.0
docker push myusername/myapp:latest

# 특정 레지스트리에 로그인
docker login ghcr.io -u myusername --password-stdin <<< $GITHUB_TOKEN

# AWS ECR 로그인 (AWS CLI 필요)
aws ecr get-login-password --region us-east-1 | \
  docker login --username AWS --password-stdin \
  123456789.dkr.ecr.us-east-1.amazonaws.com

# push
docker push 123456789.dkr.ecr.us-east-1.amazonaws.com/myapp:v1.0

# Git 커밋 해시를 태그로 사용 (추적 가능성)
GIT_SHA=$(git rev-parse --short HEAD)
docker build -t myapp:${GIT_SHA} .
docker tag myapp:${GIT_SHA} myapp:latest

# 릴리즈 버전 태그
VERSION="v2.1.3"
docker build -t myapp:${VERSION} .
docker tag myapp:${VERSION} myapp:latest

# 브랜치별 태그
BRANCH=$(git branch --show-current | sed 's/\//-/g')
docker build -t myapp:${BRANCH}-${GIT_SHA} .