تثبيت إضافات PostgreSQL في Docker غالباً ما يتطلب تعديل Dockerfile يدوياً أو استخدام صور جاهزة محدودة. Pglayers هو مشروع مفتوح المصدر يهدف إلى حل هذه المشكلة بطريقة معيارية: تحويل كل إضافة إلى طبقة Docker منفصلة يمكن تكديسها فوق الصورة الأساسية. هذا الدليل يشرح كيفية تثبيت Pglayers واستخدامه، مع خطوات قابلة للتنفيذ وأمثلة حقيقية. ملاحظة: المشروع جديد (أقل من 100 نجمة على GitHub وقت كتابة هذا الدليل)، لذا يُنصح باستخدامه في بيئات التطوير أولاً.

ما هو Pglayers؟

Pglayers هو مشروع مفتوح المصدر (متاح على GitHub) يسهل تثبيت إضافات PostgreSQL في Docker. الفكرة الأساسية هي بناء كل إضافة كطبقة Docker منفصلة (layer)، ثم تكديس هذه الطبقات فوق صورة PostgreSQL الأساسية. هذا يسمح بإدارة الإضافات بشكل معياري، وتجنب تعارض الإصدارات، وإعادة استخدام الطبقات عبر مشاريع متعددة.

المتطلبات الأساسية

• Docker مثبت على جهازك (إصدار 20.10 أو أحدث).
• معرفة أساسية بأوامر Docker وdocker-compose.
• حساب GitHub (لاستنساخ المستودع).
• اتصال بالإنترنت لتحميل الصور.
• إصدار PostgreSQL المدعوم: 16 (حسب آخر تحديث للمشروع في يناير 2025).

خطوات التركيب والتشغيل

ملاحظة: هذه الخطوات مبنية على README الفعلي للمستودع (آخر تحديث: يناير 2025). قد تختلف التفاصيل حسب التحديثات المستقبلية.

1. استنساخ المستودع:
   git clone https://github.com/pglayers/pglayers.git
2. الدخول إلى المجلد:
   cd pglayers
3. إنشاء ملف .env:
   أنشئ ملفاً باسم .env في المجلد الرئيسي بالمحتوى التالي (يمكنك تعديل الإصدار والإضافات حسب حاجتك):
   

   PG_VERSION=16
   EXTENSIONS=pg_stat_statements,postgis,pg_partman

4. بناء الصورة:
   docker build -t pglayers .
   ملاحظة: اسم الصورة 'pglayers' غير موثق رسمياً، لكنه يعمل مع هذا المستودع.
5. تشغيل الحاوية:
   docker run --name pg -e POSTGRES_PASSWORD=mysecretpassword -d pglayers
6. التحقق من نجاح التثبيت:
   قم بتشغيل الأمر التالي للتأكد من أن الإضافات مثبتة:
   docker exec pg psql -U postgres -c "SELECT * FROM pg_available_extensions;"
   يجب أن تظهر الإضافات التي حددتها في قائمة الإضافات المتاحة.

كيفية استخدام Pglayers مع docker-compose

للاستخدام مع docker-compose، أنشئ ملف docker-compose.yml في نفس المجلد بالمحتوى التالي:

version: '3.8'
services:
  db:
    build: .
    environment:
      POSTGRES_PASSWORD: mysecretpassword
    ports:
      - "5432:5432"

ثم شغّل:
docker-compose up -d

أخطاء شائعة وحلولها (مأخوذة من Issues المشروع)

مثال عملي: إضافة PostGIS لخريطة سعودية

في مشاريع التحول الرقمي السعودية، مثل تطبيقات الخرائط أو تحليل المواقع الجغرافية، تحتاج إلى إضافة PostGIS. باستخدام Pglayers، يمكنك ببساطة إضافة 'postgis' إلى متغير EXTENSIONS في ملف .env، ثم إعادة بناء الصورة وتشغيل الحاوية. بعد ذلك، يمكنك التحقق من التثبيت باستخدام الأمر:
docker exec pg psql -U postgres -c "CREATE EXTENSION postgis;"

مقارنة مع Dockerfile التقليدي

بدلاً من كتابة Dockerfile طويل مثل هذا:

FROM postgres:16
RUN apt-get update && apt-get install -y postgresql-16-postgis-3
RUN apt-get install -y postgresql-16-pg-stat-statements

مع Pglayers، كل ما عليك هو تحديد الإضافات في .env وبناء الصورة. هذا يوفر الوقت ويجعل الصيانة أسهل.

بدائل Pglayers

• الصورة الرسمية لـ PostgreSQL: بسيطة لكن بدون إضافات إضافية.
• صور Bitnami PostgreSQL: تحتوي على بعض الإضافات لكنها محدودة.
• بناء Dockerfile يدوي: مرن لكنه يتطلب جهداً.
• أدوات مثل postgres-docker-extensions: مشروع آخر مشابه لكنه أقل شهرة.

الأسئلة الشائعة

هل Pglayers متوافق مع جميع إضافات PostgreSQL؟

ليس بالضرورة. يعتمد على توافق الإضافة مع إصدار PostgreSQL وطريقة بنائها. راجع قائمة الإضافات المدعومة في مستودع المشروع.

ما الفرق بين Pglayers وطرق التثبيت التقليدية؟

Pglayers يفصل الإضافات في طبقات منفصلة، مما يسهل الإدارة وإعادة الاستخدام، ويستفيد من Docker layer caching لتسريع البناء.

هل يمكن استخدام Pglayers في الإنتاج؟

المشروع جديد (أقل من 100 نجمة على GitHub)، لذا يُنصح بالاختبار في بيئة تطوير أولاً. لا نوصي باستخدامه في الإنتاج دون اختبار مكثف.