মডিউল ৪: Dockerfile ও Image Build (Go-এর জন্য)

Dockerfile ──docker build──▶ Image ──docker run──▶ Container
 (তুমি লেখো)                (layer-এর স্তূপ)      (চলন্ত প্রসেস)

# ❌ খারাপ - বিশাল ইমেজ
FROM golang:1.24
 
# ✅ ভালো - বিল্ডের জন্য alpine
FROM golang:1.24-alpine AS builder
 
# ✅ সেরা - রানটাইমের জন্য alpine বা scratch
FROM alpine:3.19
# অথবা
FROM scratch

# ❌ খারাপ - root এ কাজ করা
COPY . /
RUN go build
 
# ✅ ভালো - ডেডিকেটেড ডিরেক্টরি
# পরবর্তী সব কমান্ড (COPY, RUN) এই ফোল্ডারের ভেতরেই রান হবে।
# অনেকটা লিনাক্সের cd (change directory)-র মতো, কিন্তু ডিরেক্টরি না থাকলে তৈরিও করে দেয়।
WORKDIR /app
COPY . .
RUN go build

# ✅ ভালো - COPY ব্যবহার
COPY go.mod go.sum ./
COPY main.go .
 
# ❌ খারাপ - অকারণে ADD (implicit behavior, cache অনিশ্চিত)
ADD https://example.com/file.tar.gz .
 
# ✅ ভালো - নির্দিষ্ট ফোল্ডার কপি (সব কিছু না)
COPY cmd/ ./cmd/
COPY internal/ ./internal/

# ❌ খারাপ - অনেক লেয়ার (স্লো বিল্ড, বড় ইমেজ)
RUN apk add --no-cache ca-certificates
RUN apk add --no-cache tzdata
RUN apk add --no-cache curl
 
# ✅ ভালো - এক লেয়ার
RUN apk add --no-cache \
    ca-certificates \
    tzdata \
    curl
 
# ✅ সেরা - ক্লিনআপ সহ (একই লেয়ারে মুছতে হবে, নইলে সাইজ কমে না)
RUN apk add --no-cache ca-certificates tzdata && \
    rm -rf /var/cache/apk/*

# ✅ বিল্ড টাইম কনফিগ
ENV GO111MODULE=on \
    CGO_ENABLED=0 \
    GOOS=linux \
    GOARCH=amd64
 
# ✅ রানটাইম কনফিগ (ডিফল্ট মান)
ENV APP_ENV=production \
    LOG_LEVEL=info \
    PORT=8080

# ❌ সেন্সিটিভ ডাটা কখনো ইমেজে না — docker history দিয়ে যে কেউ দেখতে পাবে
ENV DB_PASSWORD=secret123

# ✅ রানটাইমে ইনজেক্ট করো
docker run --env-file .env myapp

EXPOSE 8080

# ❌ খারাপ - কিছু না লিখলে ডিফল্ট root
 
# ✅ ভালো - non-root user তৈরি করে সুইচ
RUN addgroup -g 1001 appgroup && \
    adduser -D -u 1001 -G appgroup appuser
USER appuser
 
# ✅ সেরা - ownership সহ কপি
COPY --chown=appuser:appgroup ./app .
USER appuser

# ✅ HTTP endpoint check
HEALTHCHECK --interval=30s --timeout=3s --start-period=40s --retries=3 \
    CMD wget --no-verbose --tries=1 --spider http://localhost:8080/health || exit 1
 
# ✅ Custom script
COPY healthcheck.sh /usr/local/bin/
HEALTHCHECK CMD /usr/local/bin/healthcheck.sh

ENTRYPOINT ["./app"]

WORKDIR /app
ENTRYPOINT ["./app"]

docker run my-image --help

./app --help

# ✅ সঠিক
RUN go build -o app
ENTRYPOINT ["./app"]

# ✅ সঠিক
RUN go build -o my-server
ENTRYPOINT ["./my-server"]

# ❌ Beginner trap
RUN go build          # module name অনুযায়ী binary বানায়, "app" নামে না
ENTRYPOINT ["./app"]

exec: "./app": no such file or directory

CMD ["--port=8080"]

docker run my-image --port=9090   # CMD সম্পূর্ণ replace হয়ে যায়

ENTRYPOINT ["./app"]
CMD ["--port=8080"]

docker run my-image
# চালায়: ./app --port=8080
 
docker run my-image --port=9090
# চালায়: ./app --port=9090

docker inspect <container> --format '{{.Config.Entrypoint}} {{.Config.Cmd}} {{.Config.WorkingDir}}'
docker run --rm --entrypoint sh -it myapp:1.4.2 -c 'ls -l && id'

COPY go.mod go.sum ./   ✅ hit
RUN go mod download     ✅ hit
COPY . .                ❌ miss  ← কোড বদলেছে
RUN go build            ❌ miss  ← ডমিনো

# ❌ খারাপ অর্ডার — প্রতিবার পুরো rebuild
FROM golang:1.24-alpine
WORKDIR /app
 
COPY . .                # কোড বদলেছে → Cache Miss ❌
RUN go mod download     # ডমিনো এফেক্টে এটাও নতুন করে ⚠️ ৫ মিনিট নষ্ট
RUN go build -o app .

# ✅ ভালো অর্ডার — স্মার্ট ক্যাশিং
FROM golang:1.24-alpine
WORKDIR /app
 
COPY go.mod go.sum ./   # ফাইলে হাত দেইনি → Cache Hit ✅
RUN go mod download     # ক্যাশ থেকেই আসবে ✅ ০ সেকেন্ড
 
COPY . .                # এখান থেকে নতুন কাজ শুরু
RUN go build -o app .

# ============================================
# Stage 1: Builder (রান্নাঘর) 🍳
# ============================================
FROM golang:1.24-alpine AS builder
 
RUN apk add --no-cache git ca-certificates tzdata
 
WORKDIR /build
 
# ১. স্মার্ট ক্যাশিং: আগে go.mod
COPY go.mod go.sum ./
RUN go mod download && go mod verify
 
# ২. সোর্স কোড
COPY . .
 
# ৩. অপ্টিমাইজড বিল্ড
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build \
    -ldflags='-w -s -extldflags "-static"' \
    -a \
    -o /build/app \
    ./cmd/server
 
# ============================================
# Stage 2: Production (ডাইনিং টেবিল) 🍽️
# ============================================
FROM alpine:3.19
 
RUN apk add --no-cache ca-certificates tzdata
 
# ৪. সিকিউরিটি: non-root user
RUN addgroup -g 1001 appgroup && \
    adduser -D -u 1001 -G appgroup appuser
 
WORKDIR /app
 
# ৫. ম্যাজিক কপি: আগের স্টেজ থেকে শুধু বাইনারি
COPY --from=builder --chown=appuser:appgroup /build/app .
 
USER appuser
 
HEALTHCHECK --interval=30s --timeout=3s --start-period=40s \
    CMD wget --no-verbose --tries=1 --spider http://localhost:8080/health || exit 1
 
EXPOSE 8080
 
ENTRYPOINT ["./app"]

# Git
.git
.gitignore

# Editor
.vscode
.idea
*.swp

# Docs
README.md
docs/
*.md

# Tests
*_test.go
**/*_test.go
testdata/

# Build artifacts
bin/
dist/
build/
*.exe

# Dependencies (container-এ ডাউনলোড হবে)
vendor/

# Environment / secrets
.env
.env.*
*.env

# CI/CD
.github/
.gitlab-ci.yml
Jenkinsfile

# Docker
Dockerfile*
docker-compose*.yml
.dockerignore

# Logs
*.log
logs/

# OS
.DS_Store
Thumbs.db

# Temp
tmp/
temp/
*.tmp

# ✅ নির্দিষ্ট version (latest না)
FROM golang:1.24-alpine AS builder
 
# ✅ checksum verify
RUN go mod verify
 
# ✅ ইমেজে secret না
# ❌ করো না: COPY .env .
# ✅ করো: docker run --env-file .env myapp
 
# ✅ মিনিমাল runtime
FROM alpine:3.19
# FROM scratch   # আরও secure, কিন্তু ডিবাগ কঠিন
 
# ✅ Non-root
USER appuser

# ✅ Read-only filesystem (আরও এক স্তর সুরক্ষা)
docker run --read-only --tmpfs /tmp myapp:1.4.2

# ❌ সহজেই cache ভাঙে
COPY . .
RUN go build
 
# ✅ স্মার্ট caching
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN go build

# ❌ অনেক layer
RUN apk add curl
RUN apk add git
RUN apk add ca-certificates
 
# ✅ এক layer
RUN apk add --no-cache curl git ca-certificates

# syntax=docker/dockerfile:1
 
# মডিউল ক্যাশ ও build ক্যাশ layer-এর বাইরে রাখা হয় —
# তাই cache miss হলেও আবার ডাউনলোড/কম্পাইল লাগে না
RUN --mount=type=cache,target=/go/pkg/mod \
    go mod download
 
RUN --mount=type=cache,target=/root/.cache/go-build \
    --mount=type=cache,target=/go/pkg/mod \
    go build -o app ./cmd/server

export DOCKER_BUILDKIT=1   # নতুন Docker-এ ডিফল্ট

# ধাপ ১: কোনো অপটিমাইজেশন নেই
FROM golang:1.24
WORKDIR /app
COPY . .
RUN go build -o app .
CMD ["./app"]

# ধাপ ২: multi-stage + alpine
FROM golang:1.24-alpine AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN go build -o app .
 
FROM alpine:3.19
COPY --from=builder /app/app .
CMD ["./app"]

# ধাপ ৩: static binary + scratch
FROM golang:1.24-alpine AS builder
WORKDIR /app
COPY go.mod go.sum ./
RUN go mod download
COPY . .
RUN CGO_ENABLED=0 go build -ldflags="-w -s" -o app .
 
FROM scratch
COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/
COPY --from=builder /app/app /app
ENTRYPOINT ["/app"]

myapp/
├── cmd/
│   └── server/
│       └── main.go
├── internal/
│   ├── handler/
│   ├── service/
│   └── repository/
├── pkg/
│   └── logger/
├── migrations/
├── config/
├── go.mod
├── go.sum
├── Dockerfile
├── .dockerignore
└── docker-compose.yml

package main
 
import (
    "context"
    "fmt"
    "log"
    "net/http"
    "os"
    "os/signal"
    "syscall"
    "time"
)
 
func main() {
    mux := http.NewServeMux()
 
    mux.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
        fmt.Fprintf(w, "Hello from Docker! 🐳\n")
    })
 
    // Health check endpoint — HEALTHCHECK এখানেই হিট করবে
    mux.HandleFunc("/health", func(w http.ResponseWriter, r *http.Request) {
        w.WriteHeader(http.StatusOK)
        fmt.Fprintf(w, `{"status":"healthy"}`)
    })
 
    server := &http.Server{Addr: ":8080", Handler: mux}
 
    stop := make(chan os.Signal, 1)
    signal.Notify(stop, syscall.SIGTERM, syscall.SIGINT)
 
    go func() {
        log.Println("Server starting on :8080")
        if err := server.ListenAndServe(); err != nil && err != http.ErrServerClosed {
            log.Fatalf("Server error: %v", err)
        }
    }()
 
    <-stop
    log.Println("Shutting down gracefully...")
 
    ctx, cancel := context.WithTimeout(context.Background(), 30*time.Second)
    defer cancel()
 
    if err := server.Shutdown(ctx); err != nil {
        log.Printf("Shutdown error: %v", err)
    }
    log.Println("Server stopped")
}

# ============================================
# Build Arguments
# ============================================
ARG GO_VERSION=1.24
ARG ALPINE_VERSION=3.19
 
# ============================================
# Stage 1: Build
# ============================================
FROM golang:${GO_VERSION}-alpine AS builder
 
RUN apk add --no-cache git
 
WORKDIR /build
 
COPY go.mod go.sum ./
RUN go mod download && go mod verify
 
COPY cmd/ ./cmd/
COPY internal/ ./internal/
COPY pkg/ ./pkg/
 
# Version metadata — বাইনারিতেই বসিয়ে দেওয়া
ARG VERSION=dev
ARG BUILD_TIME
ARG GIT_COMMIT
 
RUN CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build \
    -ldflags="-w -s \
    -X main.Version=${VERSION} \
    -X main.BuildTime=${BUILD_TIME} \
    -X main.GitCommit=${GIT_COMMIT}" \
    -a \
    -o app \
    ./cmd/server
 
# ============================================
# Stage 2: Production
# ============================================
FROM alpine:${ALPINE_VERSION}
 
LABEL maintainer="your-email@example.com" \
      description="My Go Application"
 
RUN apk add --no-cache ca-certificates tzdata && update-ca-certificates
 
ENV TZ=Asia/Dhaka \
    APP_ENV=production \
    LOG_LEVEL=info \
    PORT=8080
 
RUN addgroup -g 1001 -S appgroup && \
    adduser -u 1001 -S appuser -G appgroup
 
RUN mkdir -p /app/logs /app/data && chown -R appuser:appgroup /app
 
WORKDIR /app
 
COPY --from=builder --chown=appuser:appgroup /build/app .
 
# কনফিগ/মাইগ্রেশন লাগলে
# COPY --chown=appuser:appgroup ./config ./config
# COPY --chown=appuser:appgroup ./migrations ./migrations
 
USER appuser
 
HEALTHCHECK --interval=30s --timeout=3s --start-period=40s --retries=3 \
    CMD wget --no-verbose --tries=1 --spider http://localhost:8080/health || exit 1
 
EXPOSE 8080
 
ENTRYPOINT ["./app"]
CMD ["serve"]

# Build with metadata
docker build \
  --build-arg VERSION=1.0.0 \
  --build-arg BUILD_TIME=$(date -u '+%Y-%m-%d_%H:%M:%S') \
  --build-arg GIT_COMMIT=$(git rev-parse --short HEAD) \
  -t myapp:1.0.0 \
  -t myapp:latest \
  .
 
# Run (production flags)
docker run -d \
  --name myapp \
  --restart unless-stopped \
  -p 127.0.0.1:8080:8080 \
  --env-file .env \
  --memory 512m --cpus 1 \
  myapp:1.0.0
 
# যাচাই
curl http://localhost:8080/health
docker logs -f myapp
docker inspect --format='{{.State.Health.Status}}' myapp
docker images myapp        # সাইজ দেখো
 
# graceful stop
docker stop -t 30 myapp