# ربط Gitea

> اربط خادم Gitea الخاص بك مع AI CodeOps برمز وصول شخصي: عنوان المثيل، ونطاقات الرمز التي يحتاج إليها، وطريقة فتح طلبات السحب لك.

المصدر: https://aicodeops.dev/ar/docs/git/gitea

يعمل AI CodeOps مع خوادم Gitea التي تشغلها أنت. تربط بعنوان خادمك ورمز وصول شخصي. ثم تكتب الجلسات التغييرات على فرع جديد وتفتح طلب سحب على خادمك للمراجعة.

## قبل أن تبدأ

- عنوان **https** العام لخادم Gitea لديك، مثل `https://gitea.example.com`. يعمل AI CodeOps في السحابة، فيجب أن يستطيع الوصول إلى الخادم عبر الإنترنت.
- ترفض العناوين الواقعة على شبكات خاصة، و `localhost`، وعناوين link-local، والأسماء المنتهية بـ `.local` أو `.internal`. وكذلك العناوين التي فيها سلسلة استعلام أو `#fragment`. ونص الخطأ هو "Use the public https address of your Git server".
- حساب له صلاحية الكتابة على المستودعات التي تريد استخدامها.

## أنشئ رمزا في Gitea

1. في Gitea، افتح **Settings → Applications** وولّد رمزا جديدا.
2. أعطه صلاحية القراءة والكتابة على **repository** (للاستنساخ ودفع الفروع وإنشاء طلبات السحب ودمجها) وصلاحية القراءة على **user** (لإظهار الحساب المربوط).
3. انسخ الرمز. فلن يعرضه Gitea إلا مرة واحدة.

## اربط الرمز

1. في مساحة عملك، افتح **Configure → Settings** وانزل إلى **Git Providers**.
2. في بطاقة **Gitea**، أدخل عنوان خادمك في **Instance URL**. وهو حقل مطلوب.
3. الصق الرمز في الحقل **or access token** واختر **Connect with token** (ربط برمز).

يفحص AI CodeOps الرمز لدى خادمك قبل أن يحفظه. وإذا تعذر الاتصال، تبين الرسالة الجزء الذي يجب إصلاحه: لم يتعرف Gitea على الرمز، أو لا يسمح للرمز بقراءة حسابك (وتسمي النطاقات التي يجب إضافتها)، أو لم تجب أي واجهة Gitea API على العنوان.

## OAuth

خيار **Connect via OAuth** لا يعمل إلا لخادم Gitea أو Forgejo الوحيد المسجل عليه تطبيق OAuth الخاص بالمنصة، فلا تعرضه البطاقة إلا لذلك الخادم. ولخادمك الخاص، استخدم رمزا.

## ما يفعله AI CodeOps بالمستودع

- **التصفح:** صفحة **Develop → Repositories** تسرد المستودعات التي يستطيع الحساب رؤيتها، مع الفروع والملفات وطلبات السحب.
- **الفروع وطلبات السحب:** حين تجري الموافقة على تغيير ويجتاز [بوابات الجودة](https://aicodeops.dev/ar/docs/quality-gates) الخاصة به، يدفع AI CodeOps فرعا اسمه `codeops/run-<id>` ويفتح طلب سحب إلى الفرع الافتراضي للمشروع. ويكون مؤلف الإيداعات "AI CodeOps".
- **الدمج:** طلب السحب الذي فتحته لوحة التحكم يمكن دمجه من لوحة التحكم. وتعمل بوابة الإصدار مرة أخرى أولا.

لا تثبت الجلسات أي webhook على خادمك، ولا يعلق AI CodeOps على طلبات السحب. والاستثناء هو المستودع الذي تربطه من **Build & Test → Builds**، فهو يحصل على webhook، ليبدأ الدفع أو طلب السحب عملية بناء، وعلى حالة إيداع بنتيجة كل عملية بناء.

## رمزك ووصولك

- الاتصال يخصك أنت، لا مساحة العمل. وتبقى أدوار مساحة العمل هي التي تقرر ما يستطيع كل عضو فعله.
- يشفر الرمز وهو مخزن (AES-256-GCM) ولا يكتب في إعدادات Git لأي مستودع.
- لإزالة الوصول، اختر **Disconnect** (فصل)، أو احذف الرمز في Gitea. ولتدوير رمز، افصل الاتصال واربط من جديد بالرمز الجديد.

## الخطوات التالية

- [أنشئ مشروعا](https://aicodeops.dev/ar/docs/projects) من مستودع على Gitea.
- [شغّل أول جلسة لك](https://aicodeops.dev/ar/docs/sessions).
- [استكشاف الأخطاء وإصلاحها](https://aicodeops.dev/ar/docs/troubleshooting)
