ربط Forgejo
اربط خادم Forgejo، مثل Codeberg أو مثيلك الخاص، مع AI CodeOps برمز وصول شخصي، وتعرف على ما تفعله المنصة بمستودعاتك.
يعمل AI CodeOps مع خوادم Forgejo، سواء شغلت خادمك الخاص أو استخدمت مثيلا عاما. تربط بعنوان الخادم ورمز وصول شخصي. ثم تكتب الجلسات التغييرات على فرع جديد وتفتح طلب سحب للمراجعة.
قبل أن تبدأ
- عنوان https العام للخادم، مثل
https://forgejo.example.com. يعمل AI CodeOps في السحابة ويجب أن يستطيع الوصول إليه عبر الإنترنت. - ترفض العناوين الواقعة على شبكات خاصة، و
localhost، وعناوين link-local، والأسماء المنتهية بـ.localأو.internal، وكذلك العناوين التي فيها سلسلة استعلام أو#fragment. - حساب له صلاحية الكتابة على المستودعات التي تريد استخدامها.
- على Codeberg (وعنوانه
https://codeberg.org)، اقرأ أولا شروط الاستخدام لديه: فهي لا تسمح بالمشاريع التي يتكون معظمها من كود كتبته أدوات الذكاء الاصطناعي التوليدي.
أنشئ رمزا في Forgejo
- في Forgejo، افتح Settings → Applications وولّد رمز وصول جديدا.
- امنحه صلاحية القراءة والكتابة على repository (الاستنساخ ودفع الفروع وإنشاء طلبات السحب ودمجها) وصلاحية القراءة على user (إظهار الحساب المربوط).
- انسخ الرمز الآن. فلن يعرضه Forgejo إلا مرة واحدة.
اربط الرمز
- في مساحة عملك، افتح Configure → Settings وانزل إلى Git Providers.
- في بطاقة Forgejo، أدخل عنوان الخادم في Instance URL. وهو حقل مطلوب.
- الصق الرمز في الحقل or access token واختر Connect with token (ربط برمز).
يفحص AI CodeOps الرمز لدى الخادم قبل حفظه. وإذا تعذر الاتصال، تبين الرسالة الجزء الذي يجب إصلاحه: لم يتعرف Forgejo على الرمز، أو لا يسمح للرمز بقراءة حسابك (وتسمي النطاقات التي يجب إضافتها)، أو لم تجب أي واجهة Forgejo API على العنوان.
OAuth
خيار Connect via OAuth لا يعمل إلا لخادم Gitea أو Forgejo الوحيد المسجل عليه تطبيق OAuth الخاص بالمنصة، فلا تعرضه البطاقة إلا لذلك الخادم. ولأي خادم آخر، استخدم رمزا بدلا من ذلك.
ما يفعله AI CodeOps بالمستودع
- التصفح: صفحة Develop → Repositories تسرد المستودعات التي يستطيع الحساب رؤيتها، مع الفروع والملفات وطلبات السحب.
- الفروع وطلبات السحب: حين تجري الموافقة على تغيير ويجتاز بوابات الجودة الخاصة به، يدفع AI CodeOps فرعا اسمه
codeops/run-<id>ويفتح طلب سحب إلى الفرع الافتراضي للمشروع. ويكون مؤلف الإيداعات "AI CodeOps". - الدمج: طلب السحب الذي فتحته لوحة التحكم يمكن دمجه من لوحة التحكم. وتعمل بوابة الإصدار مرة أخرى أولا.
لا تثبت الجلسات أي webhook على الخادم، ولا يعلق AI CodeOps على طلبات السحب. والاستثناء هو المستودع الذي تربطه من Build & Test → Builds، فهو يحصل على webhook، ليبدأ الدفع أو طلب السحب عملية بناء، وعلى حالة إيداع بنتيجة كل عملية بناء. ولا يقرأ AI CodeOps أيضا نتائج Forgejo Actions؛ فالاختبارات تعمل في البيئة المعزولة الخاصة بالجلسة.
رمزك ووصولك
- الاتصال يخصك أنت، لا مساحة العمل. وتبقى أدوار مساحة العمل هي التي تقرر ما يستطيع كل عضو فعله.
- يشفر الرمز وهو مخزن (AES-256-GCM) ولا يكتب في إعدادات Git لأي مستودع.
- لإزالة الوصول، اختر Disconnect (فصل)، أو احذف الرمز في Forgejo. ولتدويره، افصل الاتصال واربط من جديد.
الخطوات التالية
- أنشئ مشروعا من مستودع على Forgejo.
- شغّل أول جلسة لك.
- استكشاف الأخطاء وإصلاحها