يتوفر GitLab في ChatGPT وCodex حاليًا بإصدار تجريبي.
نظرة عامة
استخدم قالب تطبيق GitLab Self-Managed لإنشاء مسودة تطبيق خاصة بمساحة عمل مشتركة لمثيل GitLab Self-Managed أو GitLab Dedicated. أدخل اسم مضيف GitLab وبيانات اعتماد تطبيق OAuth، وراجع مسودة التطبيق، ثم انشره لأعضاء مساحة العمل المشتركة المؤهلين. بعد النشر، تصبح إجراءات التطبيق المفعّلة متاحة في محادثات ChatGPT وجلسات Codex.
للحصول على نظرة عامة على وظائف GitLab المدعومة وتوفّرها والأذونات واستخدام البيانات ومتطلبات الشبكة، راجع: ربط GitLab بـ ChatGPT وCodex.
ما الذي تقوم بإعداده؟
أنت تنشئ تطبيقًا خاصًا بمساحة عمل مشتركة باستخدام قالب تطبيق GitLab Self-Managed. يستخدم التطبيق ما يلي:
تطبيق GitLab OAuth مسجّل على مضيف GitLab Self-Managed أو GitLab Dedicated لديك.
معرّف التطبيق والسر الخاصّين بتطبيق GitLab OAuth للحصول على تفويض المستخدم.
نطاقات OAuth المطلوبة: api وwrite_repository وopenid.
اسم مضيف GitLab لديك، مثل gitlab.example.com، لاشتقاق نقاط نهاية الويب وواجهة API والتفويض ورموز الوصول.
قبل البدء
تحتاج إلى ما يلي:
صلاحيات مشرف أو مالك مساحة العمل المشتركة في ChatGPT.
إذن في GitLab لإنشاء تطبيق OAuth: صلاحيات مالك المجموعة لتطبيق تملكه مجموعة، أو صلاحيات مسؤول المثيل لتطبيق يشمل المثيل بأكمله.
اسم مضيف GitLab فقط، من دون https:// أو منفذ أو مسار. استخدم مضيف GitLab Self-Managed أو GitLab Dedicated، وليس gitlab.com.
تحديد إجراءات GitLab التي ينبغي أن يدعمها ChatGPT وCodex، مثل البحث في المستودعات، أو مسارات عمل طلبات الدمج، أو مسارات عمل المشكلات، أو تعديل الملفات، أو مسارات عمل أوسع في Codex.
أبقِ ChatGPT وGitLab مفتوحين في علامتَي تبويب منفصلتين. انسخ URI إعادة التوجيه كما يظهر تمامًا في ChatGPT؛ ولا تنشئه أو تعدّله.
لفتح صفحة التطبيقات من وحدة تحكّم المشرف، اختر مساحة العمل المشتركة المطلوبة في ChatGPT، وافتح المكوّنات الإضافية، ثم اختر إدارة التطبيقات القديمة.
القيم التي يجب تحضيرها
اسم مضيف GitLab: مثل gitlab.example.com.
URI إعادة التوجيه: انسخه من خطوات إعداد القالب في ChatGPT.
معرّف التطبيق الخاص بتطبيق GitLab OAuth.
السر الخاص بتطبيق GitLab OAuth.
نطاقات OAuth: انسخها من خطوات إعداد القالب في ChatGPT.
Start the template setup in ChatGPT
In ChatGPT, switch to the workspace where the app should be available.
Go to Workspace settings > Apps.
In Directory, find GitLab, open its GitLab Self-Managed app template, and select Enable.
Enter a clear app name and description.
Enter the GitLab hostname, such as gitlab.example.com.
Copy the Redirect URI shown in ChatGPT, and keep this tab open.
Example: https://chatgpt.com/connector/oauth/<redirect_id>. Do not remove the redirect ID, add a trailing slash, or replace the URI with a generic ChatGPT URL.
إنشاء تطبيق GitLab OAuth في GitLab
اختيار مكان إنشاء التطبيق
افتح مضيف GitLab لديك، مثل https://gitlab.example.com.
اختر ما إذا كنت تريد إنشاء تطبيق يشمل المثيل بأكمله أو تطبيق تملكه مجموعة. يحدّد هذا الاختيار من يدير التطبيق؛ أما الوصول إلى المشاريع فيظل خاضعًا لأذونات GitLab الخاصة بالمستخدم الذي يمنح التفويض ولنطاقات OAuth الممنوحة.
لإنشاء تطبيق يشمل المثيل بأكمله، انتقل إلى الإدارة > التطبيقات. لإنشاء تطبيق تملكه مجموعة، انتقل إلى الإعدادات > التطبيقات الخاصة بالمجموعة.
إضافة تفاصيل التطبيق
اختر تطبيق جديد أو إضافة تطبيق جديد.
أدخل اسمًا واضحًا للتطبيق، مثل GitLab Self-Managed أو GitLab Dedicated.
في حقل URI إعادة التوجيه، الصق URI الذي نسخته من ChatGPT دون أي تغيير.
أبقِ خيار سرّي مفعّلًا لتطبيق OAuth هذا الذي يعمل على الخادم.
تهيئة الوصول والحفظ
للتطبيق الذي يشمل المثيل بأكمله، توصي GitLab باختيار موثوق. يؤدي ذلك إلى تخطّي طلب التفويض من المستخدم.
اختر النطاقات api وwrite_repository وopenid.
راجع من يمكنه إدارة التطبيق، وتأكّد من أن مستخدمي GitLab الذين يمنحون التفويض لديهم الأذونات المناسبة للمجموعات والمشاريع.
احفظ التطبيق.
متطلبات نطاقات OAuth
يطلب القالب نطاقات OAuth التالية لإجراءات GitLab المفعّلة في ChatGPT وCodex:
api: مطلوب لعمليات واجهة GitLab API التي يتيحها التطبيق، بما في ذلك إجراءات طلبات الدمج والمشكلات وCI/CD.
write_repository: مطلوب لعمليات الكتابة في المستودعات عبر Git.
openid: مطلوب لمعلومات الهوية والعضوية عبر OpenID Connect.
نسخ بيانات اعتماد GitLab OAuth
في تطبيق GitLab المحفوظ، انسخ معرّف التطبيق والسر. تعامَل مع السر بوصفه أحد بيانات الاعتماد. إذا انكشف، فجدّده في GitLab وأنشئ تطبيقًا جديدًا لمساحة العمل المشتركة.
إكمال الإعداد في ChatGPT
عُد إلى علامة تبويب إعداد القالب في ChatGPT.
الصق معرّف التطبيق من GitLab في حقل معرّف عميل OAuth.
الصق السر من GitLab في حقل سر عميل OAuth.
تأكّد من أن حقل اسم مضيف GitLab يحتوي على اسم المضيف فقط، مثل gitlab.example.com.
اختر إنشاء مسودة.
افتح تفاصيل مسودة التطبيق وراجع إعدادَي الوصول حسب الدور وتهيئة الإجراءات.
نشر التطبيق وإدارته لاستخدامه في ChatGPT وCodex
إنشاء مسودة التطبيق لا يجعله متاحًا للأعضاء تلقائيًا. بعد مراجعة المسودة:
اختر نشر لمسودة التطبيق.
انتقل إلى وحدة تحكّم المشرف، واختر مساحة العمل المشتركة المطلوبة في ChatGPT، وافتح المكوّنات الإضافية، ثم تأكّد من أن GitLab متاح للأدوار المطلوبة.
راجع الوصول حسب الدور للأدوار التي ينبغي أن تستخدم التطبيق.
في تهيئة الإجراءات، راجع إجراءات القراءة والكتابة المتاحة.
في تهيئة الموافقات، حدّد متى يجب على المستخدمين الموافقة على إجراء قبل أن يستخدم ChatGPT أو Codex التطبيق.
اطلب من مستخدم لديه صلاحية الوصول أن يفتح GitLab من دليل المكوّنات الإضافية أو الإعدادات > المكوّنات الإضافية لاختبار التطبيق. تأكّد من أن المستخدم يستطيع تثبيت المكوّن الإضافي والاتصال بالتطبيق الذي أُنشئ من قالب GitLab Self-Managed.
تنطبق إعدادات الموافقة هذه الخاصة بالتطبيق على محادثات ChatGPT وسلاسل محادثات Codex.
إعداد نشاط GitLab لمراجعة التعليمات البرمجية باستخدام Codex
بعد نشر التطبيق، هيّئ نشاط GitLab في Codex إذا كنت تنوي استخدام Codex لمراجعة التعليمات البرمجية. يؤدي إعداد النشاط هذا إلى تهيئة أحداث خطافات الويب المطلوبة.
افتح إعدادات موصّلات Codex.
هيّئ حساب خدمة لمساحة العمل المشتركة. دع Codex ينشئ الحساب، أو قدّم رمز وصول شخصيًا لحساب خدمة موجود.
فعّل نشاط GitLab للمشروع أو لإحدى المجموعات الأعلى منه في التسلسل الهرمي.
إذا احتاج Codex إلى تنفيذ مهام برمجية أو استخدام إعداد خاص بالمشروع، فأنشئ بيئة للمشروع.
يستخدم تطبيق GitLab تفويض OAuth الخاص بالمستخدم لعمليات القراءة والإجراءات المفعّلة في ChatGPT وCodex. بالنسبة إلى عمليات الكتابة أثناء مراجعات Codex على GitLab Self-Managed أو GitLab Dedicated، يحدّد رمز حساب الخدمة المُدار ضمن مساحة العمل المشتركة الهوية التي يستخدمها Codex والمشاريع التي يمكنه التعليق أو إضافة تفاعلات فيها.
اقرأ المزيد: مراجعة طلبات الدمج في GitLab باستخدام Codex.
ربط تطبيق GitLab واختباره
باستخدام حساب لديه صلاحية الوصول، افتح GitLab من دليل المكوّنات الإضافية أو الإعدادات > المكوّنات الإضافية. اختر تثبيت المكوّن الإضافي، ثم اختر اتصال.
إذا كانت مساحة العمل المشتركة لديك تتضمّن أكثر من تطبيق GitLab واحد، فاختر التطبيق الخاص بمضيف GitLab Self-Managed أو GitLab Dedicated هذا.
امنح التفويض لتطبيق GitLab OAuth عند مطالبتك بذلك.
نفّذ أولًا إجراء قراءة بسيطًا في ChatGPT أو Codex، مثل عرض قائمة بالمشاريع التي يمكن الوصول إليها أو جلب طلب دمج معروف.
إذا كانت إجراءات الكتابة مفعّلة، فاختبرها في مشروع منخفض المخاطر وفي كل منتج تنوي استخدامها فيه قبل تعميمها على نطاق أوسع.
اسم المضيف وآلية عمل OAuth
يستخدم التطبيق اسم المضيف لاشتقاق نقاط نهاية GitLab. أدخل اسم المضيف فقط، مثل gitlab.example.com. لا تُضمّن https:// أو مسار واجهة API أو مستودع، أو منفذًا، أو gitlab.com. هذا القالب مخصص لـ GitLab Self-Managed أو GitLab Dedicated. بالنسبة إلى GitLab.com (SaaS)، استخدم تطبيق GitLab.
استكشاف مشكلات إعداد تطبيق GitLab Self-Managed وإصلاحها
عدم تطابق URI إعادة التوجيه: تأكّد من أن URI إعادة التوجيه لتطبيق GitLab OAuth يطابق تمامًا URI إعادة التوجيه المعروض في ChatGPT.
يتعذّر على ChatGPT إنشاء مسودة التطبيق أو حفظها: تأكّد من إدخال اسم المضيف ومعرّف التطبيق والسر وURI إعادة التوجيه.
تنجح المصادقة لكن تفشل استدعاءات المشروع: تأكّد من أن مستخدم GitLab الذي يمنح التفويض يستطيع الوصول إلى المشروع، وأن تطبيق OAuth لديه نطاقات القالب.
تُرجع واجهة API الخطأ 403 أو تفيد بأن الأذونات غير كافية: تأكّد من أن حساب GitLab المتصل لديه أذونات المشروع أو المجموعة المطلوبة، وأن تطبيق OAuth يتضمّن نطاقات القالب المطلوبة.
لا يمكن الوصول إلى أي مشروع: تأكّد من أن المستخدم لديه صلاحية الوصول إلى المشاريع، ومتصل بمثيل GitLab المطلوب، وقد اختار تطبيق GitLab الصحيح في ChatGPT أو Codex.