نقل مستودعات GitHub إلى Gitea على خادم VPS خاص

لماذا الانتقال من GitHub إلى منصة استضافة ذاتية

ما يقدمه Gitea المستضاف ذاتياً على أرض الواقع

• الحفاظ على السجل الكامل: يستهلك استيراد ‪Gitea‬ أرشيف ‪tar.gz‬ من ‪GitHub‬ — الإيداعات والفروع والعلامات سليمة.
• نقل المشكلات والتسميات: تنقل نقطة النهاية POST /api/v1/repos/migrate المشكلاتِ والمراحلَ والتسمياتِ في مرور واحد.
• مشغِّل CI أصلي: يفهم ‪gitea-runner‬ صيغة سير عمل ‪GitHub Actions‬ — تعمل معظم خطوط الأنابيب دون إعادة كتابة.
• تكلفة يمكن التنبؤ بها: يكفي خادم ‪VPS‬ بمعالج افتراضي واحد و‪1 GB‬ لفريق صغير؛ البرنامج مفتوح المصدر.
• Webhooks متوافقة: تعرض ‪Gitea‬ الأحداث ذاتها مثل ‪GitHub‬ — تبقى تكاملات الأطراف الثالثة مرتبطة دون تعديل.
• رمز API محلي: تُدار الصلاحيات في واجهتك الخاصة، لا عند طرف ثالث.

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

الهجرة خطوة بخطوة

1. 01

   إنشاء المنظمة في Gitea

   في واجهة ‪Gitea‬، اذهب إلى + → ‪New Organization‬ واختر اسماً مطابقاً لمنظمتك في ‪GitHub‬.

   أو عبر واجهة البرمجة:

   curl -s -X POST https://git.your-domain.com/api/v1/orgs \
     -H "Authorization: token YOUR_GITEA_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"username":"my-org","visibility":"private"}'

2. 02

   استعراض مستودعات GitHub وتصديرها

   curl -s -H "Authorization: token YOUR_GITHUB_TOKEN" \
     "https://api.github.com/orgs/MY_ORG/repos?per_page=100&page=1" \
     | jq -r '.[].name' > repos.txt

3. 03

   استيراد كل مستودع عبر واجهة Gitea البرمجية

   while IFS= read -r REPO; do
     curl -s -X POST https://git.your-domain.com/api/v1/repos/migrate \
       -H "Authorization: token YOUR_GITEA_TOKEN" \
       -H "Content-Type: application/json" \
       -d "{\"clone_addr\": \"https://github.com/MY_ORG/$REPO\", \"auth_token\": \"YOUR_GITHUB_TOKEN\", \"uid\": 2, \"repo_name\": \"$REPO\", \"issues\": true, \"labels\": true, \"milestones\": true, \"mirror\": false}"
   done < repos.txt

4. 04

   تحديث عناوين الاستضافة المحلية

   git remote set-url origin https://git.your-domain.com/my-org/my-repo.git

   أو عبر SSH:

   git remote set-url origin [email protected]:my-org/my-repo.git

   تحقق بـ git remote -v، ثم اختبر بـ git fetch.

5. 05

   تحديث Webhooks

   في ‪Gitea‬، لكل مستودع: ‪Settings → Webhooks → Add Webhook‬. الصق عنوان ‪URL‬ لخدمة ‪CI‬ أو الطرف الثالث، مستبدلاً github.com بـ git.your-domain.com.

6. 06

   نقل خط أنابيب CI إلى gitea-runner

   wget -O gitea-runner https://dl.gitea.com/act_runner/latest/act_runner-latest-linux-amd64
   chmod +x gitea-runner
   ./gitea-runner register --no-interactive \
     --instance https://git.your-domain.com \
     --token YOUR_RUNNER_TOKEN \
     --name vps-runner \
     --labels ubuntu-latest:docker://node:20-bullseye
   ./gitea-runner daemon &

   أعد تسمية .github/workflows/ إلى .gitea/workflows/ للاستخدام المسار الأصلي لـ ‪Gitea‬.

التحقق بعد الهجرة

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

1. 07

   SSH: `Permission denied (publickey)`

   العَرَض: يفشل git clone [email protected]:… بخطأ Permission denied (publickey).

   التحقق: في ‪Gitea‬، ‪Settings → SSH / GPG Keys‬ — يجب أن يظهر المفتاح العام الذي تستخدمه. أضفه إن لم يكن موجوداً.

2. 08

   Remote: `fatal: repository not found`

   العَرَض: يُعيد git fetch رسالة fatal: repository not found.

   التشخيص: git remote -v — تأكد أن العنوان يشير إلى نسخة ‪Gitea‬ لا إلى github.com.

3. 09

   Webhooks صامتة بعد الهجرة

   العَرَض: لا يُشغِّل git push أي بناء في خدمة ‪CI‬.

   التشخيص: في ‪Gitea‬، ‪Settings → Webhooks → last delivery‬: يعرض حقل «‪Response‬» كود ‪HTTP‬ الذي أعادته خدمة ‪CI‬. 404 يعني مسار غير موجود؛ 401 يعني سر ‪HMAC‬ غير صحيح.

استضافة Gitea على خادم VPS من ServOrbit