كيفية إنشاء Dockerfile احترافي باستخدام Ubuntu خطوة بخطوة [دليل 2025]

١. المقدمة

ما هو Docker وDockerfile؟

لماذا نستخدم Ubuntu كقاعدة؟

• تتوفر مستندات رسمية ومجتمعية غزيرة، مما يقلل من تكلفة التعلم
• سهولة تثبيت العديد من الحزم والأدوات عبر APT
• توفر صور رسمية خفيفة (مثل ubuntu:20.04 و ubuntu:24.04)

هدف ومحتوى هذا المقال والفئة المستهدفة

• المبتدئين الذين يريدون إعداد بيئة باستخدام Dockerfile لأول مرة
• من يريد بيئة تطوير قابلة للتكرار على Ubuntu
• من يرغب في فهم كيفية التعامل مع المشكلات التقنية الشائعة

٢. الهيكل الأساسي لـ Dockerfile

ما هو Dockerfile؟ فهم الدور والوظيفة

• أتمتة إعداد البيئة (لا حاجة للتكرار اليدوي)
• توحيد البيئة عند تطوير المشروع ضمن فريق
• سهولة الدمج مع خطوط CI/CD

أهم التعليمات (Directives) في Dockerfile

مثال Dockerfile بسيط مبني على Ubuntu

FROM ubuntu:24.04

RUN apt-get update && apt-get install -y 
    curl 
    vim

CMD ["/bin/bash"]

اختيار العلامة (Tag) المناسبة لـ Ubuntu

• ubuntu:22.04 (إصدار LTS – دعم طويل المدى، مناسب للاستقرار)
• ubuntu:24.04 (أحدث LTS، مخصص للميزات الأحدث)

٣. عملي: إنشاء Dockerfile مبني على Ubuntu

تثبيت الحزم المطلوبة لبيئة Ubuntu

• curl: لتنزيل الملفات واختبار API
• vim: محرر نصوص بسيط
• git: نظام إدارة الإصدارات
• build-essential: مجموعة أدوات البناء للغات C/C++

FROM ubuntu:24.04

RUN apt-get update && apt-get install -y 
    curl 
    vim 
    git 
    build-essential

إعداد التثبيت غير التفاعلي

ENV DEBIAN_FRONTEND=noninteractive

إزالة الكاش لتقليل حجم الصورة

RUN apt-get update && apt-get install -y 
    curl 
    vim 
    && rm -rf /var/lib/apt/lists/*

أفضل الممارسات في كتابة Dockerfile

• دمج أوامر RUN قدر الإمكان لتقليل عدد الطبقات
• استخدام ENV لتعريف الإعدادات والإصدارات
• كتابة تعليقات توضيحية للعمليات الهامة
• إزالة الملفات غير الضرورية واستخدام --no-install-recommends

RUN apt-get update && apt-get install -y --no-install-recommends 
    curl 
    git 
    && rm -rf /var/lib/apt/lists/*

٤. بناء صورة Docker والتحقق منها

بناء صورة Docker من Dockerfile

docker build -t my-ubuntu-image .

• خيار -t لتسمية الصورة (هنا my-ubuntu-image).
• . تعني الدليل الحالي حيث يوجد Dockerfile.

التحقق من الصور التي تم إنشاؤها

docker images

• REPOSITORY (اسم الصورة)
• TAG (العلامة)
• IMAGE ID (معرف فريد)
• CREATED (وقت الإنشاء)
• SIZE (الحجم)

REPOSITORY        TAG       IMAGE ID       CREATED          SIZE
my-ubuntu-image   latest    abcd1234abcd   5 minutes ago    189MB

تشغيل حاوية Docker للتحقق من الأداء

docker run -it my-ubuntu-image

• الخيار -it لتشغيل الوضع التفاعلي (طرفية).
• عند التشغيل بنجاح، ستحصل على سطر أوامر Ubuntu داخل الحاوية.

curl --version
vim --version

تنظيف الصور والحاويات غير الضرورية

• حذف الحاويات المتوقفة:

docker container prune

• حذف الصور غير المستخدمة:

docker image prune

• حذف كل البيانات غير المستخدمة (تنبيه!):

docker system prune

٥. متقدم: إعداد بيئة Python

إضافة بيئة Python إلى Dockerfile مبني على Ubuntu

تثبيت Python باستخدام apt

FROM ubuntu:24.04

RUN apt-get update && apt-get install -y 
    python3 
    python3-pip 
    && rm -rf /var/lib/apt/lists/*

إدارة إصدارات Python باستخدام pyenv

FROM ubuntu:24.04

ENV DEBIAN_FRONTEND=noninteractive

RUN apt-get update && apt-get install -y 
    git 
    curl 
    make 
    build-essential 
    libssl-dev 
    zlib1g-dev 
    libbz2-dev 
    libreadline-dev 
    libsqlite3-dev 
    wget 
    llvm 
    libncurses5-dev 
    libncursesw5-dev 
    xz-utils 
    tk-dev 
    libffi-dev 
    liblzma-dev 
    && rm -rf /var/lib/apt/lists/*

# تثبيت pyenv
RUN git clone https://github.com/pyenv/pyenv.git ~/.pyenv

ENV PYENV_ROOT="$HOME/.pyenv"
ENV PATH="$PYENV_ROOT/bin:$PATH"

RUN echo 'eval "$(pyenv init --path)"' >> ~/.bashrc

# تثبيت إصدار Python المطلوب
RUN pyenv install 3.11.6 && pyenv global 3.11.6

إدارة الحزم مع requirements.txt

flask==2.3.2
requests>=2.25.1
pandas

COPY requirements.txt /app/requirements.txt
WORKDIR /app

RUN pip install --no-cache-dir -r requirements.txt

أفضل الممارسات

• استخدم virtualenv أو venv لعزل بيئة Python وتجنب تعارض الاعتمادات
• استخدم خيار --no-cache-dir عند تثبيت الحزم لتقليل حجم الصورة
• قم بتحديث pip إلى آخر إصدار قبل تثبيت المكتبات (pip install --upgrade pip)

٦. المشاكل الشائعة وطرق التعامل معها

خطأ في الصلاحيات (Permissions)

مثال:

Permission denied

الحل:

• إعطاء الملفات صلاحية التنفيذ:

  RUN chmod +x script.sh

• تغيير المالك عند الحاجة:

  RUN chown root:root /path/to/file

حزم مفقودة أو لا يمكن تثبيتها

مثال:

E: Unable to locate package xxx

الحل:

• تأكد من تنفيذ apt-get update قبل تثبيت أي حزمة:

  RUN apt-get update && apt-get install -y curl

• تحقق من صحة اسم الحزمة

مشكلات في الشبكة أثناء البناء

مثال:

Temporary failure resolving 'deb.debian.org'

الحل:

• أعد تشغيل خدمة Docker:

  sudo systemctl restart docker

• تعديل إعدادات DNS في /etc/docker/daemon.json:

  {
    "dns": ["8.8.8.8", "8.8.4.4"]
  }

البناء باستخدام الكاش القديم

الحل:

• ابنِ الصورة بدون الكاش:

  docker build --no-cache -t my-image .

أوامر التشغيل لا تعمل داخل الحاوية أو الحاوية تغلق فوراً

الأسباب:

• خطأ في أوامر CMD أو ENTRYPOINT
• تحديد CMD ["/bin/bash"] دون الوضع التفاعلي يؤدي لإغلاق الحاوية

الحل:

• تشغيل الحاوية في وضع التصحيح (debug):

  docker run -it my-image /bin/bash

• فهم الفرق بين CMD و ENTRYPOINT واختيار الأنسب حسب الغرض

٧. الخلاصة

مراجعة أهم نقاط إعداد Dockerfile على Ubuntu

• فهم الهيكل الأساسي لـ Dockerfile يجب تعلم كيفية استخدام التعليمات مثل FROM وRUN وCMD وENV لأتمتة إعداد البيئة.
• Ubuntu كصورة أساسية تجمع بين الاستقرار والمرونة يوفر وفرة في الحزم، قاعدة مستخدمين واسعة، ودعم LTS مما يجعله أساساً مثالياً لبيئة التطوير.
• إدارة الحزم بفعالية تعلم استخدام apt-get وإزالة الكاش والإعداد غير التفاعلي لتسريع البناء.
• بناء بيئة عملية مثل Python باستخدام pyenv أو pip وrequirements.txt يمكنك بناء بيئة تطوير عالية التكرار والاعتمادية.
• القدرة على التعامل مع المشاكل تعني تشغيل أكثر استقراراً فهم مشاكل الصلاحيات والشبكة والكاش تساعد في تحسين الكفاءة التقنية.

الخطوات التالية لتعلم Dockerfile

• إدارة مشاريع متعددة الحاويات باستخدام Docker Compose
• دمج Docker مع أدوات CI/CD مثل GitHub Actions أو GitLab CI
• الربط مع أدوات تنظيم الحاويات مثل Kubernetes

روابط رسمية وموارد إضافية

• الوثائق الرسمية لـ Docker (باليابانية)
• Docker Hub – صورة Ubuntu الرسمية
• pyenv على GitHub

٨. الأسئلة الشائعة (FAQ)

س1: أي إصدار Ubuntu يجب أن أستخدمه في Dockerfile؟

س2: لماذا تظهر رسالة “لا يمكن العثور على الحزمة” عند استخدام apt-get install؟

RUN apt-get update && apt-get install -y curl

س3: كيف أضبط متغيرات البيئة في Dockerfile؟

ENV DEBIAN_FRONTEND=noninteractive

س4: ما الفرق بين CMD و ENTRYPOINT في Dockerfile؟

CMD ["python3", "app.py"]
# أو
ENTRYPOINT ["python3"]
CMD ["app.py"]

س5: لماذا لا تظهر التغييرات بعد تعديل Dockerfile؟

docker build --no-cache -t my-image .