Docker

Docker — حاويات Go

Go من أفضل اللغات لـ Docker — لأنها تُنتج ملفاً تنفيذياً واحداً بدون اعتماديات. هذا يعني صور Docker صغيرة جداً وآمنة.

لماذا Go + Docker = ❤️

ملف تنفيذي واحد (static binary) — لا تحتاج runtime
يمكن استخدام صورة scratch (فارغة!) — أصغر صورة ممكنة
البناء سريع مع cache الوحدات
Cross-compilation مدمج

Dockerfile بسيط

main.go

package main

import "fmt"

func main() {
    fmt.Println(`# ❌ Dockerfile بسيط (غير مُحسّن)
FROM golang:1.22

WORKDIR /app
COPY . .
RUN go build -o server .

CMD ["./server"]

# الحجم: ~1.2GB! 😱
# يحتوي كل أدوات Go + نظام تشغيل كامل`)

    fmt.Println()

    fmt.Println(`# ✅ Dockerfile متعدد المراحل (مُحسّن)
FROM golang:1.22-alpine AS builder

WORKDIR /app

# نسخ ملفات الوحدة أولاً للاستفادة من cache
COPY go.mod go.sum ./
RUN go mod download

# نسخ الكود والبناء
COPY . .
RUN CGO_ENABLED=0 GOOS=linux go build -ldflags="-s -w" -o server .

# المرحلة النهائية — صورة scratch فارغة!
FROM scratch

# نسخ شهادات SSL (للاتصال HTTPS)
COPY --from=builder /etc/ssl/certs/ca-certificates.crt /etc/ssl/certs/
COPY --from=builder /app/server /server

EXPOSE 8080
CMD ["/server"]

# الحجم: ~10-15MB! 🚀`)
}

Output:

شرح البناء المتعدد المراحل

main.go

package main

import "fmt"

func main() {
    fmt.Println("=== مراحل البناء ===\n")

    stages := []struct {
        stage string
        desc  string
        size  string
    }{
        {"golang:1.22-alpine", "مرحلة البناء — تحتوي كل الأدوات", "~300MB"},
        {"scratch", "المرحلة النهائية — فارغة تماماً!", "0MB"},
        {"الصورة النهائية", "الملف التنفيذي + شهادات SSL فقط", "~10-15MB"},
    }

    for i, s := range stages {
        fmt.Printf("%d. %s\n   %s (الحجم: %s)\n\n", i+1, s.stage, s.desc, s.size)
    }

    fmt.Println("=== الأعلام المهمة ===")
    fmt.Println("CGO_ENABLED=0  → بناء ثابت بدون اعتماديات C")
    fmt.Println("GOOS=linux     → بناء لنظام Linux")
    fmt.Println("-ldflags=\"-s -w\" → حذف معلومات التصحيح (أصغر)")
    fmt.Println("-trimpath      → حذف مسارات الملفات المحلية")

    fmt.Println("\n=== بدائل scratch ===")
    fmt.Println("scratch        → 0MB (لا shell، لا أدوات)")
    fmt.Println("alpine         → ~5MB (shell + أدوات أساسية)")
    fmt.Println("distroless     → ~2MB (أمان + شهادات)")
}

Output:

Docker Compose

main.go

package main

import "fmt"

func main() {
    fmt.Println(`# docker-compose.yml
version: "3.9"

services:
  app:
    build: .
    ports:
      - "8080:8080"
    environment:
      - DATABASE_URL=postgres://user:pass@db:5432/mydb?sslmode=disable
      - ENV=production
    depends_on:
      db:
        condition: service_healthy
    restart: unless-stopped

  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_USER: user
      POSTGRES_PASSWORD: pass
      POSTGRES_DB: mydb
    volumes:
      - pgdata:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U user"]
      interval: 5s
      timeout: 5s
      retries: 5

  redis:
    image: redis:7-alpine
    ports:
      - "6379:6379"

volumes:
  pgdata:`)

    fmt.Println("\n=== الأوامر ===")
    fmt.Println("docker compose up -d        → تشغيل في الخلفية")
    fmt.Println("docker compose logs -f app   → عرض السجلات")
    fmt.Println("docker compose down          → إيقاف وحذف")
    fmt.Println("docker compose build --no-cache → إعادة البناء")
}

Output:

.dockerignore

.git
.gitignore
README.md
Makefile
*.md
vendor/
tmp/
.env

أفضل ممارسات Docker + Go

main.go

package main

import "fmt"

func main() {
    tips := []struct {
        tip  string
        why  string
    }{
        {"استخدم multi-stage build", "حجم أصغر 100x"},
        {"CGO_ENABLED=0 دائماً", "بناء ثابت بدون مشاكل"},
        {"انسخ go.mod أولاً", "cache أفضل للاعتماديات"},
        {"استخدم scratch أو distroless", "أقل سطح هجوم"},
        {"لا تشغّل كـ root", "أمان أفضل"},
        {"أضف healthcheck", "Kubernetes/compose يعرف الحالة"},
        {"استخدم .dockerignore", "بناء أسرع"},
    }

    fmt.Println("=== أفضل ممارسات Docker + Go ===\n")
    for i, t := range tips {
        fmt.Printf("%d. %s\n   → %s\n\n", i+1, t.tip, t.why)
    }
}

Output:

إضافة مستخدم غير root

FROM scratch

# إضافة مستخدم — Add non-root user
COPY --from=builder /etc/passwd /etc/passwd
COPY --from=builder /app/server /server

USER nobody
CMD ["/server"]

تحدي — Challenge

package main

import "fmt"

func main() {
    // اطبع ملخص استراتيجية Docker لـ Go:
    // المرحلة 1, المرحلة 2, الحجم, الأمان
    // اكتب الكود هنا
}