# 특정 버전 태그 사용 (권장)
FROM ubuntu:22.04

# Alpine 기반 경량 이미지
FROM python:3.11-slim-bookworm

# 스크래치에서 시작 (Go 바이너리 등 자급자족 앱용)
FROM scratch

# 멀티스테이지 빌드에서 이전 스테이지 참조
FROM builder AS runtime

# Shell 형식 (기본 셸 /bin/sh -c 로 실행)
RUN apt-get update && apt-get install -y \
    curl \
    wget \
    git \
    && rm -rf /var/lib/apt/lists/*

# Exec 형식 (셸 없이 직접 실행, 셸 특수문자 해석 없음)
RUN ["apt-get", "install", "-y", "curl"]

# 나쁜 예: 레이어 낭비 + 캐시 부패 위험
RUN apt-get update
RUN apt-get install -y nginx
RUN apt-get install -y curl

# 좋은 예: 하나의 RUN으로 연결 + 캐시 정리
RUN apt-get update && apt-get install -y --no-install-recommends \
    nginx \
    curl \
    && rm -rf /var/lib/apt/lists/*

# COPY: 로컬 파일/디렉토리를 이미지로 복사 (권장)
COPY package.json package-lock.json ./
COPY src/ /app/src/
COPY --chown=node:node . /app

# ADD: COPY의 기능 + URL 다운로드 + tar 자동 압축 해제
# 예측 가능성이 낮아 특별한 이유 없으면 COPY 사용 권장
ADD https://example.com/file.tar.gz /tmp/
ADD ./archive.tar.gz /app/  # tar 자동 해제

# COPY는 빌드 컨텍스트 기준, 절대 경로 불가
COPY ../parent/file.txt /app/  # ❌ 에러

# CMD: 기본 실행 명령어 (docker run 인수로 덮어쓰기 가능)
CMD ["node", "server.js"]
CMD ["python", "app.py"]

# ENTRYPOINT: 컨테이너의 실행 파일 (덮어쓰기 어려움)
ENTRYPOINT ["nginx", "-g", "daemon off;"]

# 함께 사용: ENTRYPOINT=실행파일, CMD=기본 인수
ENTRYPOINT ["python", "app.py"]
CMD ["--port", "8080"]   # docker run 시 인수 미제공 시 기본값
# docker run myapp --port 9090 → python app.py --port 9090 실행

# 컨테이너가 리스닝하는 포트 문서화 (실제 포트를 여는 것은 아님)
EXPOSE 8080
EXPOSE 443/tcp
EXPOSE 53/udp

# 빌드 및 런타임에 유효한 환경 변수
ENV NODE_ENV=production
ENV PORT=8080 \
    DATABASE_URL=postgresql://localhost/mydb

# 사용
RUN echo "Environment: $NODE_ENV"

# 이후 명령어들의 기본 디렉토리 설정
WORKDIR /app

# WORKDIR이 없으면 RUN cd /app은 다음 명령어에 영향 없음!
# RUN cd /app    ❌ 다음 명령어는 여전히 /에서 실행
WORKDIR /app    # ✅ 이후 모든 명령어가 /app에서 실행

# 비root 사용자로 실행 (보안 권장 사항)
RUN groupadd -r appuser && useradd -r -g appuser appuser
USER appuser

# Node.js 공식 이미지에는 node 사용자가 있음
USER node

# 빌드 시 --build-arg로 전달받는 변수 (런타임에는 없음)
ARG APP_VERSION=1.0.0
ARG BUILD_DATE

RUN echo "Building version $APP_VERSION on $BUILD_DATE"

# 빌드 시 사용
# docker build --build-arg APP_VERSION=2.0.0 --build-arg BUILD_DATE=$(date) .

docker build -t myapp:1.0 .
   │
   ① 빌드 컨텍스트 전송         (. 디렉토리 → 데몬/빌더, .dockerignore로 필터)
   │
   ② FROM 베이스 이미지 로드     (로컬에 없으면 레지스트리에서 pull)
   │
   ③ 명령마다 레이어 생성        (RUN/COPY → 임시 컨테이너 실행 → 결과를 레이어로 커밋)
   │      이 과정을 명령 줄 수만큼 반복
   │
   ④ 각 명령 전에 캐시 조회       (캐시 키 = 명령 문자열 + 입력 해시)
   │      → 히트면 실행 건너뛰고 캐시 레이어 재사용
   │      → 미스면 실행하고 그 아래 명령도 전부 재실행
   │
   ⑤ 최종 이미지 조립           (레이어 스택 + CMD·ENV·EXPOSE 등 설정 메타데이터)
   │
   ⑥ 이미지에 태그 부여          (-t myapp:1.0 → 이미지 ID에 이름 참조 연결)
   ▼
myapp:1.0   (docker images 목록에 등장)

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

docker build -t myapp:1.0 .
#                          ↑ 빌드 컨텍스트 = 현재 디렉토리

# Sending build context to Docker daemon  1.234GB  ← 너무 크면 문제!

# .dockerignore 파일 예시

# 의존성 디렉토리 (컨테이너 내에서 재설치)
node_modules/
vendor/
.venv/
__pycache__/
*.pyc

# 버전 관리 파일
.git/
.gitignore

# 개발 환경 파일
.env
.env.local
*.env

# 테스트 및 CI 파일
.github/
tests/
coverage/
*.test.js

# 빌드 결과물 (소스만 필요)
dist/
build/
target/

# 문서
*.md
docs/

# macOS 시스템 파일
.DS_Store
Thumbs.db

# IDE 설정
.vscode/
.idea/
*.swp

# ❌ 최적화 전: 소스코드 변경 시 매번 npm install 재실행
FROM node:20-alpine
WORKDIR /app
COPY . .                    # 소스 전체 복사 (자주 변경됨)
RUN npm install             # 매번 재실행됨 (캐시 무효화)
CMD ["node", "server.js"]

# ✅ 최적화 후: 소스코드 변경 시 npm install 캐시 재사용
FROM node:20-alpine
WORKDIR /app
COPY package.json package-lock.json ./  # 의존성 명세 먼저 복사
RUN npm ci                              # 의존성 설치 (package.json 변경 시만 재실행)
COPY . .                                # 소스코드 복사 (자주 변경되어도 npm install 캐시 유지)
CMD ["node", "server.js"]

# 특정 ARG 변경으로 캐시 무효화
ARG CACHE_DATE=unknown
RUN curl https://example.com/latest-config > /app/config.json

# 빌드 시
docker build --build-arg CACHE_DATE=$(date) -t myapp .

# 또는 --no-cache 플래그로 전체 캐시 무시
docker build --no-cache -t myapp .

# Go 앱 멀티스테이지 빌드 예시

# === 빌드 스테이지 ===
FROM golang:1.21-alpine AS builder
WORKDIR /src
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -a -installsuffix cgo -o app .

# === 런타임 스테이지 ===
FROM scratch                  # 완전히 비어있는 이미지
COPY --from=builder /src/app /app
COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/
EXPOSE 8080
ENTRYPOINT ["/app"]

# 결과: 빌드 이미지 ~300MB → 최종 이미지 ~10MB

# Node.js 앱 멀티스테이지 빌드 예시

# === 의존성 설치 스테이지 ===
FROM node:20-alpine AS deps
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production

# === 빌드 스테이지 (TypeScript 컴파일 등) ===
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json ./
RUN npm ci
COPY . .
RUN npm run build

# === 런타임 스테이지 ===
FROM node:20-alpine AS runtime
WORKDIR /app
ENV NODE_ENV=production
RUN addgroup -S appgroup && adduser -S appuser -G appgroup
COPY --from=deps /app/node_modules ./node_modules
COPY --from=builder /app/dist ./dist
USER appuser
EXPOSE 3000
CMD ["node", "dist/server.js"]

ARG:  빌드 시점에만 존재합니다.
      docker build --build-arg KEY=VAL 로 주입.
      완성된 이미지에는 값이 남지 않습니다.

ENV:  빌드 + 런타임 모두에서 존재합니다.
      이미지 레이어에 기록되어 컨테이너 실행 시에도 유효합니다.
      docker run -e KEY=VAL 로 런타임에 덮어쓸 수 있습니다.

# 버전을 빌드 인수로 받아 FROM에서 사용
ARG NODE_VERSION=20
FROM node:${NODE_VERSION}-alpine

# 빌드 시 원하는 버전 지정
# docker build --build-arg NODE_VERSION=18 -t myapp:node18 .

# ARG 기본값 설정
ARG APP_ENV=production

# 빌드 시 ARG 전달
docker build --build-arg NODE_VERSION=18 -t myapp:node18 .

# ARG 값은 완성된 이미지에 안 남음 (보안 이점)
docker inspect myapp:node18 | grep NODE_VERSION   # 결과 없음

# 단일 변수
ENV NODE_ENV=production

# 여러 변수 (한 줄로 설정하면 레이어 1개)
ENV PORT=8080 \
    LOG_LEVEL=info \
    TZ=Asia/Seoul

# ENV 값은 이미지에 기록됨
docker inspect myapp:node18 | grep -A5 '"Env"'
# "NODE_ENV=production",
# "PORT=8080"

# 컨테이너 실행 시 -e 로 덮어쓰기 가능
docker run -e NODE_ENV=development myapp

# 빌드 시 버전 주입 → 런타임에도 접근 가능하게 전달
ARG APP_VERSION=1.0.0
ENV APP_VERSION=${APP_VERSION}

# 이제 컨테이너 안에서 $APP_VERSION 사용 가능
# 또는 docker inspect 로 확인 가능

# ❌ 절대 하면 안 됨: 이미지 레이어에 영구히 기록됨
ENV AWS_SECRET_KEY=abc123secret
ENV DB_PASSWORD=mysecretpassword

# ✅ 올바른 방법: 런타임에 -e 옵션으로 주입
# docker run -e DB_PASSWORD=$MY_SECRET myapp

# ✅ 또는 --env-file 사용 (파일은 .gitignore에 추가)
# docker run --env-file .env.prod myapp

# Shell form: 문자열로 작성
CMD node server.js
ENTRYPOINT node server.js

# Exec form: JSON 배열로 작성 (권장)
CMD ["node", "server.js"]
ENTRYPOINT ["node", "server.js"]

Shell form 실행 과정:
  Docker → /bin/sh -c "node server.js" 실행
                ↑
           이게 PID 1이 됨!
           node는 PID 2 (자식 프로세스)

# Shell form으로 실행된 컨테이너
docker exec my-container ps aux
# PID   COMMAND
#   1   /bin/sh -c node server.js   ← PID 1 = sh
#   6   node server.js              ← PID 2 = 앱

docker stop → SIGTERM → /bin/sh 수신 → node에 전달 안 됨
                                     → 10초 대기 후 SIGKILL
                                     → node 강제 종료 → 데이터 손실 가능!

Exec form 실행 과정:
  Docker → ["node", "server.js"] 직접 exec
                ↑
           node가 PID 1이 됨!

# Exec form으로 실행된 컨테이너
docker exec my-container ps aux
# PID   COMMAND
#   1   node server.js   ← PID 1 = 앱 자체

docker stop → SIGTERM → node 직접 수신 → graceful shutdown 실행 ✓
                                       → 진행 중인 요청 완료 후 종료
                                       → 데이터 손실 없음 ✓

# ENTRYPOINT: 실행 파일 고정 (덮어쓰기 어려움)
# CMD: 기본 인수 (docker run 시 쉽게 덮어쓰기 가능)
ENTRYPOINT ["python", "app.py"]
CMD ["--port", "8080"]

# 기본 실행: python app.py --port 8080
docker run myapp

# 포트 변경: python app.py --port 9090
docker run myapp --port 9090

# 완전히 다른 명령: python manage.py migrate
docker run --entrypoint python myapp manage.py migrate

# Node.js 앱
ENTRYPOINT ["node"]
CMD ["server.js"]

# Python 앱
ENTRYPOINT ["python", "-u"]
CMD ["app.py"]

# nginx (공식 이미지에서 사용하는 방식)
CMD ["nginx", "-g", "daemon off;"]

# .dockerignore 없을 때 빌드 컨텍스트 크기 확인
docker build -t myapp . 2>&1 | head -1
# Sending build context to Docker daemon  487MB  ← 너무 큼!

# .dockerignore 적용 후
# Sending build context to Docker daemon  1.2MB  ← 최적화됨

# .dockerignore

# 의존성 디렉토리 (빌드 중 재설치하므로 불필요)
node_modules/
vendor/
__pycache__/
*.pyc
.venv/

# 버전 관리
.git/
.gitignore
.svn/

# 민감한 파일 ← 보안!
.env
.env.*
*.key
*.pem
*.p12
secrets/
credentials.json

# 빌드 아티팩트
dist/
build/
*.log
coverage/
.nyc_output/

# 개발 도구 설정
.DS_Store
.idea/
.vscode/
*.swp

# 테스트
test/
tests/
__tests__/
*.test.js
*.spec.js

# ❌ 실수: .dockerignore 없이 빌드하면 .env가 이미지에 포함됨
# Dockerfile에 COPY . . 가 있으면 .env도 복사됨

# 확인: 이미지 안에 .env가 들어갔는지 검사
docker run --rm myapp find / -name ".env" 2>/dev/null
# /app/.env  ← 포함되어 있으면 위험!

# ✅ 해결: .dockerignore에 반드시 .env 추가
echo ".env" >> .dockerignore

# ❌ 나쁜 패턴: 전체 복사 (node_modules도 함께 복사될 수 있음)
COPY . .

# ✅ 좋은 패턴 1: 필요한 파일만 명시
COPY package*.json ./
RUN npm ci
COPY src/ ./src/
COPY public/ ./public/

# ✅ 좋은 패턴 2: 전체 복사 + .dockerignore로 제외
# (위의 .dockerignore 파일이 제대로 설정된 경우)
COPY . .