Docker: الممارسة المتكاملة للمرحلة الثانية

# Dockerfile إنتاج متعدد المراحل
FROM python:3.12-slim AS builder
# ... بناء venv محسن

FROM python:3.12-slim
# ... نسخ venv، غير root، healthcheck

todo-app/
├── app.py              # تطبيق Flask
├── requirements.txt    # تبعيات Python
├── templates/          # قوالب HTML
│   └── index.html
├── Dockerfile          # بناء إنتاج متعدد المراحل
├── .dockerignore       # استبعاد الملفات غير الضرورية
├── nginx.conf          # إعدادات وكيل Nginx العكسي
└── docker-run.sh       # برنامج نشر بنقرة واحدة

# ============================================
# Dockerfile متعدد المراحل لتطبيق Flask للمهام
# المرحلة 1: بناء البيئة الافتراضية
# المرحلة 2: تشغيل الإنتاج
# ============================================

# ---------- المرحلة 1: البناء ----------
FROM python:3.12-slim AS builder

WORKDIR /build

# التخزين المؤقت: تثبيت التبعيات أولاً
COPY requirements.txt .
RUN python -m venv /opt/venv && \
    /opt/venv/bin/pip install --no-cache-dir -r requirements.txt

# ---------- المرحلة 2: الإنتاج ----------
FROM python:3.12-slim

# تثبيت curl لفحص الصحة
RUN apt-get update && \
    apt-get install -y --no-install-recommends curl && \
    rm -rf /var/lib/apt/lists/*

# إنشاء مستخدم غير root
RUN groupadd -r appgroup && \
    useradd -r -g appgroup -u 1000 -m -d /home/appuser appuser

WORKDIR /app

# نسخ البيئة الافتراضية من مرحلة البناء
COPY --from=builder /opt/venv /opt/venv
ENV PATH="/opt/venv/bin:$PATH"

# نسخ كود التطبيق
COPY --chown=appuser:appgroup . .

# إنشاء دليل السجلات
RUN mkdir -p /app/logs && chown appuser:appgroup /app/logs

# التبديل إلى مستخدم غير root
USER appuser

# متغيرات البيئة (افتراضيات، التجاوز وقت التشغيل)
ENV FLASK_ENV=production \
    LOG_LEVEL=info \
    APP_PORT=5000

EXPOSE 5000

# فحص الصحة
HEALTHCHECK --interval=30s --timeout=5s --start-period=15s --retries=3 \
  CMD curl -f http://localhost:5000/health || exit 1

# بدء التطبيق
CMD ["python", "app.py"]

# .dockerignore
__pycache__
*.pyc
*.pyo
.git
.env
venv
.venv
*.md
Dockerfile
docker-compose*.yml

# التشغيل مع متغيرات بيئة مخصصة
docker run -d \
  --name todo-app \
  -e FLASK_ENV=production \
  -e DATABASE_URL="postgresql://appuser:apppass@todo-db:5432/tododb" \
  -e LOG_LEVEL=warning \
  -p 5000:5000 \
  todo-app:1.0

# إنشاء ملف .env
cat > .env << 'EOF'
FLASK_ENV=production
DATABASE_URL=postgresql://appuser:apppass@todo-db:5432/tododb
LOG_LEVEL=warning
APP_PORT=5000
EOF

# التشغيل بـ --env-file
docker run -d \
  --name todo-app \
  --env-file .env \
  -p 5000:5000 \
  todo-app:1.0

# تركيب وحدة تخزين مسماة لسجلات التطبيق
docker run -d \
  --name todo-app \
  -v app-logs:/app/logs \
  -e LOG_LEVEL=info \
  todo-app:1.0

# البناء بوسوم متعددة
docker build -t todo-app:v1.0.0 -t todo-app:latest .

# دفع جميع الوسوم
docker push localhost:5000/todo-app:v1.0.0
docker push localhost:5000/todo-app:latest

# ============================================
# برنامج نشر بنقرة واحدة
# ============================================

# 1. إنشاء الشبكة ووحدات التخزين
docker network create todo-net
docker volume create pg-data
docker volume create app-logs

# 2. بدء PostgreSQL
docker run -d \
  --name todo-db \
  --network todo-net \
  -e POSTGRES_USER=appuser \
  -e POSTGRES_PASSWORD=apppass \
  -e POSTGRES_DB=tododb \
  -v pg-data:/var/lib/postgresql/data \
  --restart=unless-stopped \
  postgres:15-alpine

# 3. انتظار تهيئة PostgreSQL
sleep 15

# 4. بناء وبدء تطبيق Flask
docker build -t todo-app:1.0 ./todo-app
docker run -d \
  --name todo-app \
  --network todo-net \
  -e DATABASE_URL="postgresql://appuser:apppass@todo-db:5432/tododb" \
  -v app-logs:/app/logs \
  --restart=unless-stopped \
  todo-app:1.0

# 5. بدء وكيل Nginx العكسي
docker run -d \
  --name todo-nginx \
  --network todo-net \
  -p 80:80 \
  -v $(pwd)/todo-app/nginx.conf:/etc/nginx/conf.d/default.conf \
  --restart=unless-stopped \
  nginx:1.25-alpine

# 6. التحقق
docker ps
curl http://localhost/health

# تحليل الصورة متعددة المراحل
dive todo-app:1.0

# المتوقع: درجة الكفاءة > 90%، بدون مساحة مهدرة

# ============================================
# شرح كامل: تحويل تطبيق Flask إلى حاويات
# يغطي: Dockerfile، بناء، نشر متعدد الحاويات
# ============================================

# 1. بناء الصورة المحسنة
docker build -t todo-app:v1.0.0 -t todo-app:latest ./todo-app

# 2. التحقق من الصورة
docker images todo-app
docker history todo-app:v1.0.0

# 3. إنشاء البنية التحتية
docker network create todo-net
docker volume create pg-data
docker volume create app-logs

# 4. بدء PostgreSQL مع تخزين دائم
docker run -d \
  --name todo-db \
  --network todo-net \
  -e POSTGRES_USER=appuser \
  -e POSTGRES_PASSWORD=apppass \
  -e POSTGRES_DB=tododb \
  -v pg-data:/var/lib/postgresql/data \
  --restart=unless-stopped \
  postgres:15-alpine

# 5. بدء تطبيق Flask
docker run -d \
  --name todo-app \
  --network todo-net \
  -e DATABASE_URL="postgresql://appuser:apppass@todo-db:5432/tododb" \
  -v app-logs:/app/logs \
  --restart=unless-stopped \
  todo-app:v1.0.0

# 6. بدء وكيل Nginx العكسي
docker run -d \
  --name todo-nginx \
  --network todo-net \
  -p 8080:80 \
  -v $(pwd)/todo-app/nginx.conf:/etc/nginx/conf.d/default.conf \
  --restart=unless-stopped \
  nginx:1.25-alpine

# 7. التحقق من المجموعة الكاملة
echo "=== الحاويات ===" && docker ps
echo "=== فحص الصحة ===" && docker inspect todo-app --format='{{.State.Health.Status}}'
echo "=== استجابة التطبيق ===" && curl -s http://localhost:8080/health

# 8. الدفع إلى المستودع الخاص (اختياري)
docker tag todo-app:v1.0.0 localhost:5000/todo-app:v1.0.0
docker push localhost:5000/todo-app:v1.0.0

# 9. التنظيف (اختياري)
# docker stop todo-nginx todo-app todo-db
# docker rm todo-nginx todo-app todo-db