انتقل إلى المحتوى الرئيسي

الفصل 2: حاويات Docker

مقدمة​

يسمح لك Docker بتغليف تطبيقك مع جميع تبعياته. "يعمل على جهازي" يصبح "يعمل في كل مكان".

🎯 أهداف الفصل​

في نهاية هذا الفصل، ستعرف:

  1. ✅ إنشاء Dockerfile لـ Spring Boot
  2. ✅ تحسين باستخدام multi-stage builds
  3. ✅ استخدام Docker Compose
  4. ✅ إدارة التكوينات
  5. ✅ تحسين حجم الصور

1. Dockerfile الأساسي​

النسخة البسيطة​

FROM eclipse-temurin:17-jre
WORKDIR /app
COPY target/*.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "app.jar"]

البناء والتشغيل​

# تجميع التطبيق
mvn clean package -DskipTests

# بناء الصورة
docker build -t myapp:1.0 .

# تشغيل
docker run -p 8080:8080 myapp:1.0

2. Multi-Stage Build (موصى به)​

Dockerfile المحسن​

# ===== STAGE 1: Build =====
FROM maven:3.9-eclipse-temurin-17 AS builder
WORKDIR /app

# نسخ ملفات التبعيات أولاً (ذاكرة التخزين المؤقت لـ Docker)
COPY pom.xml .
RUN mvn dependency:go-offline -B

# نسخ كود المصدر وتجميعه
COPY src ./src
RUN mvn clean package -DskipTests

# ===== STAGE 2: Runtime =====
FROM eclipse-temurin:17-jre-alpine
WORKDIR /app

# إنشاء مستخدم غير root
RUN addgroup -S spring && adduser -S spring -G spring
USER spring:spring

# نسخ JAR من المرحلة السابقة
COPY --from=builder /app/target/*.jar app.jar

# التكوين
EXPOSE 8080
ENV JAVA_OPTS="-Xms256m -Xmx512m"

ENTRYPOINT ["sh", "-c", "java $JAVA_OPTS -jar app.jar"]

فوائد Multi-Stage​

صورة بسيطة:      ~500 MB (مع Maven + JDK)
صورة متعددة المراحل: ~200 MB (فقط JRE)
صورة Alpine:      ~150 MB (JRE Alpine الحد الأدنى)

3. Dockerfile مع Layers​

يدعم Spring Boot 2.3+ الطبقات لذاكرة التخزين المؤقت لـ Docker المحسنة:

# ===== STAGE 1: Build =====
FROM maven:3.9-eclipse-temurin-17 AS builder
WORKDIR /app
COPY pom.xml .
RUN mvn dependency:go-offline -B
COPY src ./src
RUN mvn clean package -DskipTests

# استخراج الطبقات
RUN java -Djarmode=layertools -jar target/*.jar extract

# ===== STAGE 2: Runtime =====
FROM eclipse-temurin:17-jre-alpine
WORKDIR /app
RUN addgroup -S spring && adduser -S spring -G spring
USER spring:spring

# نسخ الطبقات (حسب تكرار التغيير)
COPY --from=builder /app/dependencies/ ./
COPY --from=builder /app/spring-boot-loader/ ./
COPY --from=builder /app/snapshot-dependencies/ ./
COPY --from=builder /app/application/ ./

EXPOSE 8080
ENTRYPOINT ["java", "org.springframework.boot.loader.launch.JarLauncher"]

تفعيل الطبقات​

<!-- pom.xml -->
<plugin>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-maven-plugin</artifactId>
    <configuration>
        <layers>
            <enabled>true</enabled>
        </layers>
    </configuration>
</plugin>

4. Docker Compose​

docker-compose.yml​

version: '3.8'

services:
  app:
    build: .
    ports:
      - "8080:8080"
    environment:
      - SPRING_PROFILES_ACTIVE=docker
      - DATABASE_URL=jdbc:postgresql://db:5432/mydb
      - DB_USERNAME=postgres
      - DB_PASSWORD=secret
    depends_on:
      db:
        condition: service_healthy
    networks:
      - backend

  db:
    image: postgres:15-alpine
    environment:
      - POSTGRES_DB=mydb
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=secret
    volumes:
      - postgres_data:/var/lib/postgresql/data
    healthcheck:
      test: ["CMD-SHELL", "pg_isready -U postgres"]
      interval: 5s
      timeout: 5s
      retries: 5
    networks:
      - backend

volumes:
  postgres_data:

networks:
  backend:
    driver: bridge

أوامر Docker Compose​

# بدء جميع الخدمات
docker-compose up -d

# عرض السجلات
docker-compose logs -f app

# إيقاف
docker-compose down

# إعادة البناء
docker-compose up -d --build

5. ملف تعريف Docker​

application-docker.properties​

# التكوين لـ Docker
spring.datasource.url=${DATABASE_URL}
spring.datasource.username=${DB_USERNAME}
spring.datasource.password=${DB_PASSWORD}

# Flyway
spring.flyway.enabled=true

# Actuator
management.endpoints.web.exposure.include=health,info,prometheus

# تسجيل
logging.level.root=INFO

6. .dockerignore​

# بناء
target/
!target/*.jar

# IDE
.idea/
*.iml
.vscode/

# Git
.git/
.gitignore

# Docker
Dockerfile
docker-compose*.yml
.dockerignore

# سجلات
*.log
logs/

# اختبارات
src/test/

7. تحسينات​

صورة Alpine (أخف)​

FROM eclipse-temurin:17-jre-alpine

مستخدم غير Root​

RUN addgroup -S spring && adduser -S spring -G spring
USER spring:spring

فحص الصحة​

HEALTHCHECK --interval=30s --timeout=3s --start-period=30s --retries=3 \
  CMD wget --quiet --tries=1 --spider http://localhost:8080/actuator/health || exit 1

حدود الموارد​

# docker-compose.yml
services:
  app:
    deploy:
      resources:
        limits:
          cpus: '1'
          memory: 512M
        reservations:
          cpus: '0.5'
          memory: 256M

8. بناء Docker مع BuildKit​

تفعيل BuildKit​

# متغير البيئة
export DOCKER_BUILDKIT=1
docker build -t myapp .

# أو في Docker Desktop: Settings > Docker Engine
{
  "features": {
    "buildkit": true
  }
}

ذاكرة التخزين المؤقت لتبعيات Maven​

FROM maven:3.9-eclipse-temurin-17 AS builder
WORKDIR /app

# ذاكرة التخزين المؤقت للتبعيات مع BuildKit
COPY pom.xml .
RUN --mount=type=cache,target=/root/.m2 mvn dependency:go-offline -B

COPY src ./src
RUN --mount=type=cache,target=/root/.m2 mvn clean package -DskipTests

9. أوامر مفيدة​

بناء​

# بناء بسيط
docker build -t myapp:latest .

# بناء مع tag
docker build -t myapp:1.0.0 -t myapp:latest .

# بناء بدون ذاكرة التخزين المؤقت
docker build --no-cache -t myapp .

# بناء مع المتغيرات
docker build --build-arg JAR_FILE=target/*.jar -t myapp .

تشغيل​

# تشغيل أساسي
docker run -p 8080:8080 myapp

# تشغيل في الخلفية
docker run -d -p 8080:8080 --name myapp-container myapp

# تشغيل مع متغيرات البيئة
docker run -d -p 8080:8080 \
  -e SPRING_PROFILES_ACTIVE=prod \
  -e DATABASE_URL=jdbc:postgresql://host:5432/db \
  myapp

# تشغيل مع ملف .env
docker run -d -p 8080:8080 --env-file .env myapp

تصحيح​

# سجلات
docker logs myapp-container
docker logs -f myapp-container  # متابعة

# Shell داخل الحاوية
docker exec -it myapp-container sh

# فحص
docker inspect myapp-container

10. ملخص​

Dockerfile الموصى به​

FROM maven:3.9-eclipse-temurin-17 AS builder
WORKDIR /app
COPY pom.xml .
RUN mvn dependency:go-offline -B
COPY src ./src
RUN mvn clean package -DskipTests

FROM eclipse-temurin:17-jre-alpine
WORKDIR /app
RUN addgroup -S spring && adduser -S spring -G spring
USER spring:spring
COPY --from=builder /app/target/*.jar app.jar
EXPOSE 8080
ENTRYPOINT ["java", "-jar", "app.jar"]

قائمة التحقق Docker​

□ بناء متعدد المراحل
□ صورة Alpine (خفيفة)
□ مستخدم غير root
□ .dockerignore مهيأ
□ متغيرات البيئة للأسرار
□ فحص الصحة
□ docker-compose للتطوير المحلي

🎯 الخطوة التالية​

صورة Docker جاهزة. دعونا نؤتمت البناء والنشر باستخدام CI/CD!

➡️ الفصل 3: CI/CD مع GitHub Actions

⬅️ العودة إلى الوحدة 12