إذا كنت مطور PostgreSQL وتستخدم Docker، فربما واجهت صعوبات في تثبيت الإضافات مثل PostGIS أو pg_stat_statements بسبب توافق الإصدارات وتعارض المكتبات. Pglayers هو مشروع مفتوح المصدر يهدف إلى حل هذه المشكلة عن طريق تحويل الإضافات إلى طبقات Docker قابلة للتكديس. لكن README الخاص بالمشروع غير واضح، لذا أعددنا هذا الدليل العملي لمساعدتك على تثبيته واستخدامه بفعالية. سنقدم مثالاً كاملاً لملف docker-compose.yml، ونشرح كل متغير، ونوضح كيفية التحقق من نجاح التثبيت.

ما هو Pglayers؟

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

من يحتاج Pglayers؟

يناسب: مطوري PostgreSQL الذين يديرون عدة إضافات في بيئات Docker، مهندسي DevOps، ومشرفي الأنظمة في السعودية والخليج. مثال: شركة عقارية سعودية (اسم وهمي: عقارات الرؤية) تحتاج PostGIS للبيانات المكانية وpg_stat_statements لمراقبة الأداء. لا يناسب: المبتدئين في Docker أو PostgreSQL، أو من يحتاج إضافة واحدة فقط (الأسهل تثبيتها يدوياً). أيضاً، لا يناسب بيئات الإنتاج الحرجة قبل استقرار المشروع.

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

• Docker مثبت (الإصدار 20.10 أو أحدث).
• Docker Compose (اختياري لكن موصى به).
• معرفة أساسية بأوامر Docker وPostgreSQL.
• اتصال بالإنترنت لتحميل الصور.

مثال كامل لملف docker-compose.yml

قم بإنشاء ملف docker-compose.yml بالمحتوى التالي:

version: '3.8'
services:
  pglayers:
    image: pglayers/pglayers:latest
    container_name: pglayers_container
    environment:
      - POSTGRES_VERSION=15
      - EXTENSIONS=postgis,pg_stat_statements,pg_partman
    ports:
      - "5432:5432"
    volumes:
      - pgdata:/var/lib/postgresql/data
volumes:
  pgdata:

شرح كل سطر:

• version: '3.8': إصدار Docker Compose.
• services:: تعريف الخدمات.
• pglayers:: اسم الخدمة.
• image: pglayers/pglayers:latest: صورة Pglayers من Docker Hub.
• container_name: pglayers_container: اسم الحاوية.
• environment:: متغيرات البيئة. POSTGRES_VERSION يحدد إصدار PostgreSQL (15 أو 16). EXTENSIONS يحدد الإضافات مفصولة بفواصل.
• ports:: ربط المنفذ 5432 للحاوية مع المضيف.
• volumes:: وحدة تخزين لبيانات PostgreSQL.

خطوات التثبيت

1. استنساخ المستودع: git clone https://github.com/pglayers/pglayers.git
2. الانتقال إلى المجلد: cd pglayers
3. إنشاء ملف docker-compose.yml بالمحتوى أعلاه.
4. إنشاء ملف .env (اختياري) بمحتوى مثل: POSTGRES_VERSION=15 و EXTENSIONS=postgis,pg_stat_statements
5. تشغيل الأمر: docker-compose up -d

كيفية التحقق من عمل الإضافات

بعد التشغيل، تحقق من أن الحاوية تعمل: docker ps. ثم اتصل بقاعدة البيانات: psql -h localhost -U postgres. نفذ الأمر: SELECT * FROM pg_extension; يجب أن تظهر الإضافات المحددة.

أخطاء شائعة وحلولها

استخدامات عملية في السوق السعودي

مثال: شركة عقارية سعودية (عقارات الرؤية) تحتاج PostGIS للبيانات المكانية وpg_stat_statements لمراقبة الأداء. باستخدام Pglayers، يمكنها بناء صورة واحدة تحتوي على الإضافتين وتوزيعها على عدة خوادم.

هل يستحق Pglayers التجربة؟

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