تخطي إلى المحتوى
#منشور_فيDevOpsBackup & RestoreDockerGitHub ActionsSupabase

تجاوز قيود الباقة المجانية: بناء نظام نسخ احتياطي مؤتمت لـ Supabase و Storage عبر GitHub Actions و Docker

GitHub Actions كمشغّل مجاني، pg_dump و AWS CLI كأدوات استخراج، وGit كمخزن — منظومة نسخ احتياطي أسبوعي بلا خادم دائم. والاستعادة عبر Docker: سطر أوامر واحد يعيد قاعدة البيانات والصور كاملة.

10 دقيقة قراءة

محتوى المقالة

عندما تصبح الباقة المجانية فخاً تشغيلياً

عندما أبدأ مشروعاً جديداً على Supabase، تبرز الباقة المجانية كخيار منطقي أول: قاعدة بيانات PostgreSQL كاملة، مصادقة، تخزين ملفات، وواجهات API جاهزة — كل ذلك بلا تكلفة. لكن مع الاستخدام الفعلي، يظهر قيدان يستحقان التمعّن — لحظة عفواً !!.

  • القيد الأول: غياب النسخ الاحتياطي التلقائي في الباقة المجانية. لا توجد نسخ مجدولة — على الأقل بحدود limits، والنسخ اليومي متاح فقط في الباقات المدفوعة. فإذا حدث خطأ بشري — حذف جدول، تحديث خاطئ، أو ترحيل فاشل — لا توجد نقطة رجوع.
  • القيد الثاني: إيقاف المشروع بعد فترة من الخمول. المشاريع المجانية تُوقف مؤقتاً تلقائياً، وعند استيقاظها قد تكون بعض العمليات المجدولة فاتت، أو حالة التخزين لم تعد متزامنة.

المشكلة الحقيقية ليست في القيدين بحد ذاتهما، بل في أن الباقة المجانية تُستخدم غالباً في مشاريع حقيقية — موقع شخصي، متجر صغير، أو لوحة تحكم داخلية. وهذه المشاريع لا تحتمل فقدان البيانات.

الحل التقليدي هو الترقية إلى باقة مدفوعة، لكن ذلك يفرض تكلفة شهرية ثابتة على مشروع قد لا يزال في مرحلة الإطلاق. من هنا برز السؤال الهندسي: كيف نبني نظام نسخ احتياطي موثوقاً دون دفع تكلفة استضافة إضافية؟

الفكرة الهندسية: GitHub Actions كخادم مجاني في الخلفية

تمثلت الفكرة في استغلال بنية تحتية موجودة أصلاً ولا تدفع مقابلها أي شيء إضافي: GitHub Actions.

تُوفر GitHub Actions للمستودعات العامة عدداً غير محدود من دقائق التشغيل، وللمستودعات الخاصة حصة شهرية سخية. والمفتاح هنا أن مهمة النسخ الاحتياطي الأسبوعية لا تستهلك سوى دقائق معدودة — أقل بكثير من أي حصة.

المعمارية العامة

┌─────────────────┐
│  GitHub Actions  │  ← يعمل أسبوعياً (Cron)
│  (Ubuntu Runner) │
└────────┬────────┘
         │
         ├──► supabase db dump ──► roles.sql + schema.sql + data.sql
         │
         ├──► aws s3 sync ────────► storage/media/
         │
         └──► git-auto-commit ────► مستودع خاص (Git History كأرشيف)

يعمل النظام على ثلاث مراحل متتابعة:

  • استخراج قاعدة البيانات عبر supabase db dump الذي يستدعي pg_dump خلف الكواليس، وينتج ثلاثة ملفات: roles.sql للأدوار والصلاحيات، schema.sql للجداول والدوال والمشغلات وسياسات RLS، وdata.sql للبيانات الفعلية بصيغة COPY.
  • مزامنة التخزين عبر AWS CLI الذي يتصل بنقطة نهاية S3 الخاصة بـ Supabase Storage، وينسخ محتوى bucket media إلى المجلد المحلي storage/media/. المزامنة تراكمية: فقط الملفات المتغيرة تُنزَّل كل أسبوع.
  • الحفظ في Git عبر git-auto-commit-action الذي يرفع الملفات الناتجة إلى المستودع الخاص. وهنا تكمن فكرة ذكية: تاريخ Git نفسه هو أرشيف النسخ الاحتياطية. كل commit أسبوعي يحمل نسخة كاملة، والرجوع إلى أي نسخة سابقة ممكن عبر git checkout.

لماذا هذا التصميم ذكي؟

  • لا خادم دائم: لا حاجة لتشغيل VPS أو حاوية تعمل على مدار الساعة. GitHub يستضيف الـ Runner مؤقتاً ثم يختفي.
  • لا تكلفة إضافية: ضمن الحصة المجانية تماماً.
  • أرشيف كامل: Git يحتفظ بكل النسخ، ويمكن استرجاع أي منها.
  • أمان: المستودع خاص، والبيانات لا تغادر حسابك.

الخطوات البرمجية: ملف الـ Workflow

ملف .github/workflows/backup.yml هو قلب النظام. جهزت هذه النسخته النظيفة منه:

name: Supabase backup

on:
  workflow_dispatch:
  schedule:
    - cron: '0 2 * * 0' # weekly - Sunday 02:00 UTC

permissions:
  contents: write

concurrency:
  group: supabase-backup
  cancel-in-progress: false

jobs:
  run_db_backup:
    runs-on: ubuntu-latest
    env:
      supabase_db_url: ${{ secrets.SUPABASE_DB_URL }}
    steps:
      - uses: actions/checkout@v4

      - uses: supabase/setup-cli@v1
        with:
          version: latest

      - name: Backup roles
        run: supabase db dump --remote="$supabase_db_url" -f roles.sql --role-only
      - name: Backup schema
        run: supabase db dump --remote="$supabase_db_url" -f schema.sql
      - name: Backup data
        run: supabase db dump --remote="$supabase_db_url" -f data.sql --data-only --use-copy

      - name: Get backup date
        id: date
        run: echo "date=$(date +'%Y-%m-%d')" >> "$GITHUB_OUTPUT"

      - name: Backup storage (media bucket)
        env:
          AWS_ACCESS_KEY_ID: ${{ secrets.SUPABASE_S3_ACCESS_KEY }}
          AWS_SECRET_ACCESS_KEY: ${{ secrets.SUPABASE_S3_SECRET_KEY }}
          AWS_DEFAULT_REGION: ${{ secrets.SUPABASE_S3_REGION }}
        run: |
          aws configure set default.s3.addressing_style path
          aws s3 sync s3://media storage/media \
            --endpoint-url "https://${{ secrets.SUPABASE_PROJECT_REF }}.storage.supabase.co/storage/v1/s3" \
            --no-progress

      - name: Commit backups
        uses: stefanzweifel/git-auto-commit-action@v5
        with:
          commit_message: 'Supabase backup ${{ steps.date.outputs.date }}'

حماية الأسرار (Secrets)

النقطة الأمنية الأهم: لا تضع بيانات الاتصال في الكود أبداً. خزّنها كلها في GitHub secrets & variables، ويصل إليها الـ Workflow عبر ${{ secrets.* }}:

السر القيمة
SUPABASE_DB_URL رابط اتصال PostgreSQL (pooler)
SUPABASE_S3_ACCESS_KEY مفتاح S3 للوصول
SUPABASE_S3_SECRET_KEY المفتاح السري لـ S3
SUPABASE_PROJECT_REF معرّف المشروع
SUPABASE_S3_REGION منطقة المشروع، مثل eu-central-1

ملاحظتان مهمتان

  • كلمة مرور PostgreSQL مخصصة للـ CI فقط: لا تستخدم كلمة مرور التطبيق، التطبيق غالباً يتصل عبر مفاتيح anon و service-role، وكلمة مرور Postgres تُستخدم حصرياً في ال CLI.
  • --no-delete مفعّلة ضمنياً: المزامنة لا تحذف الملفات المحلية حتى لو حُذفت من الـ bucket. هذه شبكة أمان متعمدة، لأن Supabase لا يوفر إصدارات للكائنات.

طوق النجاة: الاستعادة بنقرة واحدة عبر Docker

هذا هو القسم الأقوى في المنظومة. النسخ الاحتياطي بلا استعادة موثوقة مجرد طقس بلا فائدة. والاستعادة هنا مُصمَّمة لتكون تجربة سطر أوامر واحدة، تعمل على أي جهاز، دون تعديل أي ملف في المستودع.

لماذا Docker؟

لأنك تحتاج إلى psql وaws-cli بإصدارات محددة. بدلاً من تثبيتها على جهازك وتلويث بيئتك، تشغّل حاويات مؤقتة تُنجز المهمة ثم تختفي. هذا يعني أيضاً أن العملية متطابقة تماماً على أي نظام تشغيل — CachyOS، macOS، أو حتى Windows عبر WSL.

لا تنس تنفيذ هذه الخطوات ضمن مجلد مستودع النسخة الاحتياطة الذي قمت بنسخه من GitHub باستخدام الأمر git clone.

تعريف أداة مساعدة (مرة واحدة لكل جلسة)

function psqlc
    docker run --rm -i -e PGPASSWORD \
        -v "/path/to/rebex-db-backup:/backup:ro" \
        -w /backup \
        postgres:17 psql $argv
end

هذه الدالة تركّب مجلد النسخ الاحتياطي للقراءة فقط، وتمرّر كلمة المرور كمتغير بيئة لا يظهر في سجل الأوامر، وتوجّه كل ما عدا ذلك إلى psql الحقيقي.

خطوات الاستعادة

المرحلة 1 — تحضير مشروع جديد:

  • إنشاء مشروع Supabase جديد.
  • إعادة تعيين كلمة مرور Postgres لكلمة قويّة وحفظها.
  • نسخ رابط Session Pooler (منفذ 5432 لتجنب مشاكل IPv6).
  • ضبط متغيرات الجلسة:
set -gx PGPASSWORD '<كلمة مرور المشروع الجديد>'
set -gx TARGET_URL 'postgresql://postgres.<REF>@aws-0-<REGION>.pooler.supabase.com:5432/postgres?sslmode=require'
set -gx OLD_REF '<المعرّف القديم>'
set -gx NEW_REF '<المعرّف الجديد>'

المرحلة 2 — النسخ الاحتياطي النهائي:

قبل الاستعادة، شغّل نسخة احتياطية أخيرة من المشروع القديم يدوياً من GitHub Actions. هذه هي نقطة التحوّل التي تضمن عدم فقدان أي بيانات جديدة. لا تنس git pull أو fetch مع merge.

إذا واجهت صعوبة في تذكر أوامر git اليومية، ألق نظرة على Git Snaps مدونة المطورين ستجد هناك دليل، تذكير, ومثال.

المرحلة 3 — الاستعادة الفعلية:

# الأدوار — توقّع رسائل "already exists" طبيعية
psqlc "$TARGET_URL" -v ON_ERROR_STOP=0 -f roles.sql 2>&1 | tee restore_roles.log

# المخطط — الجداول والدوال والمشغلات وسياسات RLS
psqlc "$TARGET_URL" -v ON_ERROR_STOP=0 -f schema.sql 2>&1 | tee restore_schema.log

# البيانات — وضع صارم: توقف فوري عند أي فشل حقيقي
psqlc "$TARGET_URL" -v ON_ERROR_STOP=1 -f data.sql 2>&1 | tee restore_data.log

لاحظ الفرق في ON_ERROR_STOP: في الأدوار والمخطط نسمح بالأخطاء المتوقعة مثل "already exists"، أما في البيانات فنوقف كل شيء عند أول خطأ حقيقي.

المرحلة 4 — التحقق:

-- عدد الصفوف في كل جدول
-- اختبر جداولك والعلاقات بينها أيضا
SELECT '<table_name>' AS t, count(*) FROM public.<table_name>;

-- التأكد من أن RLS لا تزال مفعّلة
SELECT relname FROM pg_class c
JOIN pg_namespace n ON n.oid=c.relnamespace
WHERE n.nspname='public' AND c.relrowsecurity;

-- التأكد من أن صلاحيات Data API سليمة
SELECT grantee, privilege_type FROM information_schema.role_table_grants
WHERE table_schema='public' AND table_name='telegram_bot';

المرحلة 5 — استعادة الصور من التخزين:

هنا يظهر التكامل الحقيقي. الصور ليست في الـ dump؛ إنها في مستودع Git منفصل. نرفعها إلى bucket media في المشروع الجديد عبر حاوية AWS CLI:

docker run --rm \
  -e AWS_ACCESS_KEY_ID -e AWS_SECRET_ACCESS_KEY -e AWS_DEFAULT_REGION \
  -v "$PWD/storage/media:/media:ro" \
  amazon/aws-cli s3 sync /media s3://media \
  --endpoint-url "https://<new-ref>.storage.supabase.co/storage/v1/s3" \
  --no-progress

ملاحظة: يمكنك تخطّي هذه الخطوة وإنشاء storage bucket يديوياً في المشروع الجديد ورفع الملفات إليه – مع الحفاظ عل الهرمية نفسها للفولدرات – الحياة سهلة.

المرحلة 6 — تحديث مسارات الصور:

هذه هي الخطوة الحاسمة التي تربط كل شيء. الصور في قاعدة البيانات مخزّنة بروابط كاملة تشير إلى المشروع القديم. بعد الاستعادة، يجب تحديث هذه المسارات لتشير إلى المشروع الجديد. العملية برمتها عبارة عن تحديث واحد بسيط، بفرض أننا نخزن مسارات الصور في جدول media:

UPDATE public.media
SET url = replace(url, 'https://<OLD-REF>.supabase.co', 'https://<NEW-REF>.supabase.co')
WHERE url LIKE 'https://<OLD-REF>.supabase.co/%';

هذا مقتصر على جدول media فقط، بافتراض أن أي إشارة أخرى للصور في قاعدة البيانات تستخدم مفاتيح أجنبية (UUID) وليس روابط نصية، فتُحلّ تلقائياً عند القراءة. هذا تبسيط كبير مقارنة بالتصاميم القديمة التي كانت تخزّن الروابط في كل مكان.

تحقق أخير: هل كل صورة لها ملف؟

هناك فحص تكاملي مهم بين الـ dump والمرآة. يجب التأكد من أن كل صف في media له ملف مقابل في مستودع Git، وإلا ستظهر صورة مكسورة على الموقع بلا طريقة لإصلاحها، لأن الرابط هو السجل الوحيد:

# استخراج مسارات الصور من قاعدة البيانات
psqlc "$TARGET_URL" -t -A -c \
  "SELECT DISTINCT regexp_replace(url, '^https://[^/]+/', '') FROM public.media" \
  > .tmp/media_paths.txt

# استخراج مسارات الملفات من المرآة
find storage/media -type f -printf '%P\n' | sort -u > .tmp/mirror_paths.txt

# الفرق: أي صف بلا ملف؟
comm -23 .tmp/media_paths.txt .tmp/mirror_paths.txt

إذا طبعت comm شيئاً، فهذه صور مفقودة يجب إعادة مزامنتها فوراً.

الأثر المالي والتقني

"توفير بشويّة تفكير" – ريبيكس لحل المصايب

الأثر المالي

  • تصفير تكلفة النسخ الاحتياطي: GitHub Actions مجاني ضمن الحصة، ولا حاجة لخادم دائم.
  • تأجيل الترقية للباقة المدفوعة: يمكن البقاء على الباقة المجانية بثقة، لأن البيانات محمية.
  • لا تكلفة تخزين إضافية: Git يخزّن النسخ، والمستودعات الخاصة مجانية.

الأثر التقني

  • تصفير احتمالية فقدان البيانات: نسخة أسبوعية كاملة (قاعدة بيانات + صور) مع أرشيف تاريخي في Git.
  • تماثل بيئات الإنتاج والتطوير: يمكن استعادة النسخة محلياً عبر Docker وتشغيل الموقع في بيئة مطابقة تماماً للإنتاج — مفيد جداً لاختبار الترحيلات قبل تطبيقها.
  • مقاومة الأخطاء البشرية: إذا حذفت جدولاً بالخطأ، الاستعادة تستغرق دقائق.
  • مرونة التعافي من الكوارث: لو أُغلق المشروع أو تعطّل، يمكن إحياؤه على مشروع جديد خلال أقل من ساعة.

الدرس الهندسي

أهم درس من هذه التجربة: القيد في الباقة لا يعني غياب الحل، بل يعني أن الحل يحتاج تفكيراً أعمق. بدلاً من دفع تكلفة شهرية، استُخدمت بنية تحتية موجودة (GitHub Actions) وأدوات مفتوحة (pg_dump، AWS CLI، Docker) لبناء نظام يعمل بكفاءة.

الدرس الثاني: النسخ الاحتياطي بلا استعادة مُختبَرة وهم. النظام هنا لم يكتفِ بالحفظ، بل وثّق مسار الاستعادة الكامل خطوة بخطوة، بما في ذلك فحوصات التحقق بين المكونات.

الخلاصة

بناء نظام نسخ احتياطي مؤتمت لـ Supabase على الباقة المجانية ليس فقط ممكناً، بل يمكن أن يكون أكثر موثوقية من بعض الحلول المدفوعة. المكونات الثلاثة — GitHub Actions كمشغّل، Supabase CLI و AWS CLI كأدوات استخراج، وGit كمخزن — تشكل منظومة متكاملة بلا تكلفة إضافية.

والأهم أن الاستعادة عبر Docker تحوّل التعافي من كابوس إلى عملية سطر أوامر واحدة، مع تحقق مدمج يضمن تماسك قاعدة البيانات والصور معاً.

مبروك عليكن backup ولا أريح، والاستعادة مضمونة – برعاية ريبيكس.

أبحث دائماً عن التحديات البرمجية والمشاريع المبتكرة لتنفيذها بمعايير عالمية

هل لديك فكرة تبحث عن مطور يتقن تفاصيلها؟

جاهز لبدء مشروعك؟ تواصل معي

مشاركة_المقالة