‏Gitea وForgejo: بديل ‏GitHub Actions المدفوع على ‏VPS

ما الذي تغيّر في تسعير ‏GitHub Actions

لماذا تنقل ‏CI/CD إلى ‏forge مستضافة ذاتياً

• ‏التكلفة المتغيرة تُلغى — يعمل ‏runner على ‏VPS الخاص بك؛ كل دقيقة ‏CI هي مورد مدفوع مسبقاً، لا سطر فوترة إضافي.
• ‏سرية ‏pipelines — الكود المصدري وأسرار البيئة ونتائج البناء لا تغادر بنيتك التحتية.
• ‏توافق ‏YAML — يتبع .gitea/workflows/ci.yml نفس صياغة .github/workflows/ci.yml؛ نقل ‏pipeline موجود لا يتطلب في أغلب الأحيان سوى نقل ملف.
• ‏تحكم كامل في صور ‏runner — اختر إصدارات ‏PHP و‏Node و‏Python و‏Docker بدون الاعتماد على كتالوج ‏GitHub.
• ‏‏forge خفيفة — يعمل ‏Gitea بـ 200 إلى 300 ميغابايت من الذاكرة العشوائية للمستودعات؛ يستهلك act_runner نحو 50 ميغابايت لكل مهمة؛ ‏VPS بجيغابايت واحد كافٍ لفريق صغير.
• ‏استقلالية الخدمة — تستمر ‏pipelines في العمل بغض النظر عن توافر المنصة الأصلية أو سياستها التسعيرية.
• ‏إدارة موحدة للوصول — الصلاحيات والفِرق و‏webhooks تعيش على نسختك الخاصة دون تفويض الوصول لطرف ثالث.
• ‏نتائج البناء تحت سيطرتك — التنفيذات وصور ‏Docker وتقارير التغطية مخزّنة حيث تقرر.

المتطلبات المسبقة

‏Gitea Actions مقابل ‏Forgejo Actions مقابل ‏Woodpecker CI

مرّر الجدول أفقيًا

‏الخيار الأول: Gitea مع act_runner

تثبيت ‏Gitea و‏runner

1. 01

   إنشاء ملف ‏Docker Compose

   ‏أنشئ دليل عمل وملف docker-compose.yml:

   services:
     gitea:
       image: gitea/gitea:latest
       container_name: gitea
       environment:
         - USER_UID=1000
         - USER_GID=1000
         - GITEA__actions__ENABLED=true
       volumes:
         - ./gitea-data:/data
         - /etc/timezone:/etc/timezone:ro
         - /etc/localtime:/etc/localtime:ro
       ports:
         - "3000:3000"
         - "222:22"
       restart: unless-stopped

   ‏فعّل GITEA__actions__ENABLED=true منذ البداية — بدون هذا المتغير، لن تظهر علامة تبويب ‏Actions في الواجهة.

2. 02

   تشغيل ‏Gitea وإكمال الإعداد الأولي

   ‏شغّل الحاوية ثم افتح http://<your-ip>:3000 في متصفح. يطلب منك معالج التثبيت نوع قاعدة البيانات (‏SQLite كافٍ لـ ‏forge صغيرة) واسم الخادم والرابط الخارجي. أدخل رابط ‏HTTPS الذي ستضبطه (https://git.your-domain.com) — يُكتب في الإعداد ويُستخدم كأساس لروابط ‏clone و‏webhooks.

   ‏أنشئ حساب المسؤول من هذا المعالج.

3. 03

   ضبط ‏reverse proxy و‏TLS

   ‏ضع ‏Gitea خلف ‏nginx مع شهادة ‏Let's Encrypt. مثال على كتلة server:

   server {
       listen 443 ssl;
       server_name git.your-domain.com;
       ssl_certificate /etc/letsencrypt/live/git.your-domain.com/fullchain.pem;
       ssl_certificate_key /etc/letsencrypt/live/git.your-domain.com/privkey.pem;
       location / {
           proxy_pass http://127.0.0.1:3000;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
       }
   }

   ‏احصل على الشهادة باستخدام certbot certonly --nginx -d git.your-domain.com ثم أعد تحميل ‏nginx.

4. 04

   إنشاء رمز ‏runner في ‏Gitea

   ‏سجّل الدخول إلى نسخة ‏Gitea الخاصة بك كمسؤول. انتقل إلى إدارة الموقع ← ‏Runners ← إنشاء ‏runner. انسخ الرمز المعروض — سيُستخدم في الخطوة التالية لتسجيل act_runner.

5. 05

   نشر ‏act_runner

   ‏أضف خدمة act_runner إلى docker-compose.yml:

     act_runner:
       image: gitea/act_runner:latest
       container_name: act_runner
       environment:
         - GITEA_INSTANCE_URL=https://git.your-domain.com
         - GITEA_RUNNER_REGISTRATION_TOKEN=<your-token>
         - GITEA_RUNNER_NAME=vps-runner
       volumes:
         - /var/run/docker.sock:/var/run/docker.sock
         - ./runner-data:/data
       restart: unless-stopped
       depends_on:
         - gitea

   ‏أعد التشغيل باستخدام docker compose up -d. يظهر ‏runner في واجهة ‏Gitea ضمن إدارة الموقع ← Runners بحالة Idle.

6. 06

   دفع ‏workflow اختباري

   ‏في أحد مستودعات ‏Gitea الخاصة بك، أنشئ الملف .gitea/workflows/ci.yml:

   name: CI
   on: [push]
   jobs:
     test:
       runs-on: ubuntu-latest
       steps:
         - uses: actions/checkout@v4
         - name: Check
           run: echo "Pipeline active on Gitea Actions"

   ‏ادفع ‏commit. يظهر المهمة في علامة تبويب Actions بالمستودع وتنفّذ على ‏runner VPS الخاص بك.

‏الخيار الثاني: Forgejo مع act_runner

اختلافات التثبيت مقارنة بـ ‏Gitea

1. 07

   استبدال صورة ‏Docker

   ‏في docker-compose.yml، استبدل صورة ‏Gitea بصورة ‏Forgejo الرسمية:

   services:
     forgejo:
       image: codeberg.org/forgejo/forgejo:latest
       container_name: forgejo
       environment:
         - USER_UID=1000
         - USER_GID=1000
         - FORGEJO__actions__ENABLED=true
       volumes:
         - ./forgejo-data:/data
       ports:
         - "3000:3000"
         - "222:22"
       restart: unless-stopped

   ‏يتغير بادئة متغير البيئة من GITEA__ إلى FORGEJO__ للإعدادات الخاصة بـ ‏Forgejo.

2. 08

   استخدام ‏runner الخاص بـ ‏Forgejo

   ‏تحتفظ ‏Forgejo بنسختها الخاصة من act_runner. استخدم الصورة المنشورة على ‏registry الخاص بـ ‏Codeberg:

     act_runner:
       image: code.forgejo.org/forgejo/runner:latest
       container_name: forgejo_runner
       environment:
         - FORGEJO_INSTANCE_URL=https://git.your-domain.com
         - FORGEJO_RUNNER_REGISTRATION_TOKEN=<your-token>
         - FORGEJO_RUNNER_NAME=vps-runner
       volumes:
         - /var/run/docker.sock:/var/run/docker.sock
         - ./runner-data:/data
       restart: unless-stopped

3. 09

   استرداد رمز ‏runner في ‏Forgejo

   ‏الإجراء مطابق لـ ‏Gitea: إدارة الموقع ← Runners ← إنشاء Runner. الرمز للاستخدام مرة واحدة — دوّنه قبل إغلاق الصفحة.

4. 10

   ‏ضع workflows في `.gitea/workflows/`

   ‏تقرأ ‏Forgejo ملفات ‏workflow من نفس الدليل المستخدم في ‏Gitea: .gitea/workflows/. يعمل ‏workflow مكتوب لـ ‏GitHub Actions أو ‏Gitea Actions دون تعديل. قيد واحد: الإجراء actions/checkout@v4 وأقاربه يُحلّ عبر ذاكرة التخزين المؤقت للإجراءات في نسختك — يُنزّلها التشغيل الأول، وتُعاد استخدامها في التشغيلات التالية.

‏توافق YAML مع GitHub Actions

name: Tests
on:
  push:
    branches: [main, dev]
  pull_request:

jobs:
  phpunit:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Setup PHP
        uses: shivammathur/setup-php@v2
        with:
          php-version: '8.4'
      - run: composer install --no-interaction
      - run: vendor/bin/phpunit

المزايا المقارنة لـ ‏runner المستضاف ذاتياً

• ‏تكلفة ثابتة وقابلة للتنبؤ — لا تدفع سوى ‏VPS، بغض النظر عن تكرار ‏pipelines.
• ‏السرية — الكود المصدري ومتغيرات البيئة ونتائج البناء لا تمر عبر خدمة طرف ثالث.
• ‏تخصيص ‏runner — ثبّت التبعيات النظامية والأدوات الخاصة بمكدسك أو صور ‏Docker الخاصة مباشرة على ‏runner.
• ‏الوصول إلى الشبكة الداخلية — يمكن لمهمة الوصول إلى قاعدة بيانات تجريبية أو ‏registry Docker خاص على شبكتك دون كشف عام.
• ‏نشر بدون عبور شبكي خارجي — ‏يعمل الـ‏runner في نفس مركز البيانات الذي يضم خادمك المستهدف؛ تُنسخ ملفات البناء محلياً دون المرور بخوادم GitHub.
• ‏الأرشفة تحت سيطرتك — سجلات ‏pipeline ونتائجها تُحفظ طالما تقرر، دون حد تفرضه المنصة.

استكشاف الأخطاء — الأخطاء الشائعة

استعادة السيطرة على ‏CI/CD الخاص بك