إذا كنت مطور PostgreSQL وتستخدم Docker، فأنت تعرف صعوبة تثبيت الإضافات مثل PostGIS أو pg_stat_statements داخل الحاوية. غالباً ما تحتاج لبناء صورة مخصصة أو التعامل مع تعارضات الإصدارات. هنا يأتي Pglayers، مشروع ظهر مؤخراً على Hacker News، يهدف إلى تبسيط هذه العملية عن طريق تحويل كل إضافة إلى طبقة Docker قابلة للتكديس. لكن README المشروع غير واضح حالياً، والمشروع لا يزال في مرحلة ألفا. هذا الدليل يشرح ما هو Pglayers، حالته الحالية، وكيف يمكنك تجربته بحذر، مع بدائل عملية.

ما هو Pglayers؟ شرح مبسط

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

ما هو الوضع الحالي للمشروع؟

آخر تحديث للمشروع كان منذ أكثر من عام (تحقق من تاريخ آخر commit على GitHub). المشروع غير نشط، ولا توجد Issues أو Pull Requests حديثة. README غير مكتمل ولا يوضح خطوات التركيب أو الاستخدام. لذلك، لا يمكن الاعتماد عليه في بيئة إنتاج.

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

• Docker مثبت على جهازك (إصدار 20.10 أو أحدث).
• معرفة أساسية بـ Docker و Dockerfile.
• PostgreSQL (يفضل الإصدار 14 أو 15، لكن المشروع لا يحدد إصداراً مدعوماً).
• اتصال بالإنترنت لتحميل الصور والإضافات.

التركيب خطوة بخطوة (مع تحذير: الخطوات تقريبية)

ملاحظة: README المشروع لا يوضح خطوات التركيب بوضوح. الخطوات التالية مبنية على تحليل بنية المشروع وافتراضات معقولة. قد تختلف الأوامر الفعلية. لم يتم توثيق أوامر التركيب بعد.

1. استنساخ المستودع: git clone https://github.com/pglayers/pglayers.git
2. الدخول إلى المجلد: cd pglayers
3. إنشاء Dockerfile أساسي لـ PostgreSQL (مثال: FROM postgres:15).
4. استخدام سكريبت Pglayers لبناء الطبقات: الأمر غير موثق. قد يكون ./pglayers build --extensions postgis,pg_stat_statements لكن هذا غير مؤكد.
5. بناء الصورة النهائية: docker build -t my-postgres-with-extensions .

شرح متغيرات البيئة (إن وجدت)

حتى الآن، لا يوجد ملف .env في المشروع. لكن يمكنك استخدام متغيرات البيئة في Docker Compose لتحديد الإضافات. مثال: EXTENSIONS=postgis,pg_stat_statements. لم يتم توثيق أي متغيرات بيئة رسمية.

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

بعد بناء الصورة، شغّل الحاوية: docker run --name my-postgres -e POSTGRES_PASSWORD=mysecretpassword -d my-postgres-with-extensions. ثم ادخل إلى الحاوية وتحقق من الإضافات: docker exec -it my-postgres psql -U postgres -c "SELECT * FROM pg_extension;"

أخطاء شائعة وحلولها (خاصة بـ Pglayers)

نظراً لعدم وجود Issues موثقة، الأخطاء التالية عامة:

من يحتاج Pglayers ومن لا؟

من يحتاجه: المطورون الذين يريدون تجربة أدوات جديدة ويدركون المخاطر. من لا يحتاجه: من يبحث عن حل مستقر للإنتاج.

بدائل عملية: صور Docker الرسمية مع الإضافات

• صورة postgis/postgis الرسمية تحتوي على PostGIS.
• بناء Dockerfile يدويًا باستخدام apt-get install للإضافات.
• أدوات مثل pgxn (PostgreSQL Extension Network) لتثبيت الإضافات.

هل يستحق التجربة؟ تقييم صادق

Pglayers فكرة واعدة لكنها لا تزال في مراحلها الأولى. README غير مكتمل، والمشروع لم ينضج بعد. إذا كنت من عشاق التجارب المبكرة، يمكنك تجربته بحذر. أما إذا كنت بحاجة لحل مستقر للإنتاج، فانتظر حتى ينضج المشروع أو استخدم البدائل.