نظرة عامة

استخدم قالب تطبيق GitLab ذاتي الإدارة لإنشاء مسودة تطبيق خاصة بمساحة العمل المشتركة لمثيل GitLab ذاتي الإدارة أو GitLab المخصّص. أدخل اسم مضيف GitLab وبيانات اعتماد تطبيق OAuth، وراجع مسودة التطبيق، ثم انشره لأعضاء مساحة العمل المشتركة المؤهلين. بعد النشر، تصبح إجراءات التطبيق المفعّلة متاحة في محادثات ChatGPT وجلسات Codex.

للاطّلاع على نظرة عامة حول سلوك GitLab المدعوم وتوفّره وأذوناته واستخدام البيانات ومتطلبات الشبكة، راجع: ربط GitLab بـChatGPT وCodex.

ما الذي تعدّه

أنت تنشئ تطبيقًا خاصًا بمساحة العمل المشتركة من قالب تطبيق GitLab ذاتي الإدارة. يستخدم التطبيق ما يلي:

• تطبيق GitLab OAuth مسجّل على مضيف GitLab ذاتي الإدارة أو GitLab المخصّص لديك.

• معرّف التطبيق والسر في GitLab OAuth لتفويض المستخدم.

• نطاقات OAuth المطلوبة: api وwrite_repository وopenid.

• اسم مضيف GitLab، مثل gitlab.example.com، لاشتقاق نقاط نهاية الويب وAPI والتفويض والرموز.

قبل البدء

تحتاج إلى:

• صلاحية مشرف أو مالك مساحة عمل مشتركة في ChatGPT.

• إذن GitLab لإنشاء تطبيق OAuth: صلاحية مالك المجموعة لتطبيق تملكه مجموعة، أو صلاحية مشرف المثيل لتطبيق على مستوى المثيل.

• اسم مضيف GitLab فقط، من دون https:// أو منفذ أو مسار. استخدم مضيف GitLab ذاتي الإدارة أو GitLab المخصّص، وليس gitlab.com.

• حدّد إجراءات GitLab التي ينبغي أن يدعمها ChatGPT وCodex، مثل البحث في المستودع أو مهام سير طلبات الدمج أو المشكلات أو تحرير الملفات أو مهام سير Codex الأوسع.

أبقِ ChatGPT وGitLab مفتوحين في علامتي تبويب منفصلتين. انسخ معرّف URI لإعادة التوجيه الظاهر في ChatGPT كما هو تمامًا؛ ولا تنشئه أو تعدّله.

القيم المطلوب تجهيزها

• اسم مضيف GitLab: مثل gitlab.example.com.

• معرّف URI لإعادة التوجيه: انسخه من مسار إعداد القالب في ChatGPT.

• معرّف تطبيق GitLab OAuth.

• سر GitLab OAuth.

• نطاقات OAuth: انسخها من مسار إعداد القالب في ChatGPT.

Start the template setup in ChatGPT

1. In ChatGPT, switch to the workspace where the app should be available.

2. Go to Workspace settings > Plugins.

3. In Directory, find GitLab, open its GitLab Self-Managed app template, and select Enable.

4. Enter a clear app name and description.

5. Enter the GitLab hostname, such as gitlab.example.com.

6. 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

اختيار مكان إنشاء التطبيق

1. افتح مضيف GitLab لديك، مثل https://gitlab.example.com.

2. اختر ما إذا كنت تريد إنشاء تطبيق على مستوى المثيل أم تطبيق تملكه مجموعة. يحدّد هذا الخيار من يدير التطبيق؛ أما الوصول إلى المشروع فيظل خاضعًا لأذونات مستخدم GitLab الذي يمنح التفويض ولنطاقات OAuth الممنوحة.

3. لإنشاء تطبيق على مستوى المثيل، انتقل إلى المشرف > التطبيقات. لإنشاء تطبيق تملكه مجموعة، انتقل إلى الإعدادات > التطبيقات في المجموعة.

إضافة تفاصيل التطبيق

1. اختر تطبيق جديد أو إضافة تطبيق جديد.

2. أدخل اسمًا واضحًا للتطبيق، مثل GitLab ذاتي الإدارة أو GitLab المخصّص.

3. في معرّف URI لإعادة التوجيه، الصق معرّف URI المنسوخ من ChatGPT كما هو تمامًا.

4. أبقِ خيار سري مفعّلًا لتطبيق OAuth هذا الذي يعمل من جانب الخادم.

إعداد الوصول والحفظ

1. بالنسبة إلى تطبيق على مستوى المثيل، توصي GitLab بتحديد موثوق به. يؤدي ذلك إلى تخطي مطالبة تفويض المستخدم.

2. حدّد النطاقات api وwrite_repository وopenid.

3. راجع من يمكنه إدارة التطبيق، وتأكّد من أن مستخدمي GitLab الذين يمنحون التفويض لديهم أذونات المجموعة والمشروع المناسبة.

4. احفظ التطبيق.

متطلبات نطاقات OAuth

يطلب القالب نطاقات OAuth التالية لإجراءات GitLab المفعّلة في ChatGPT وCodex:

• api: مطلوب لعمليات واجهة GitLab API التي يتيحها التطبيق، بما فيها إجراءات طلبات الدمج والمشكلات وCI/CD.

• write_repository: مطلوب لعمليات الكتابة إلى المستودع عبر Git.

• openid: مطلوب للحصول على معلومات الهوية والعضوية عبر OpenID Connect.

نسخ بيانات اعتماد GitLab OAuth

في تطبيق GitLab المحفوظ، انسخ معرّف التطبيق والسر. تعامل مع السر باعتباره بيانات اعتماد. إذا انكشف، فجدّده في GitLab وأنشئ تطبيقًا جديدًا لمساحة العمل المشتركة.

إكمال الإعداد في ChatGPT

1. عُد إلى علامة تبويب إعداد القالب في ChatGPT.

2. الصق معرّف تطبيق GitLab في معرّف عميل OAuth.

3. الصق سر GitLab في سر عميل OAuth.

4. تأكّد من أن حقل اسم مضيف GitLab لا يحتوي إلا على اسم المضيف، مثل gitlab.example.com.

5. اختر إنشاء مسودة.

6. افتح تفاصيل مسودة التطبيق وراجع الوصول حسب الدور وإعداد الإجراءات.

نشر التطبيق وإدارته لـChatGPT وCodex

لا يؤدي إنشاء مسودة التطبيق إلى إتاحته للأعضاء تلقائيًا. بعد مراجعة المسودة:

1. اختر نشر لمسودة التطبيق.

2. انتقل إلى إعدادات مساحة العمل المشتركة > المكوّنات الإضافية، وتأكّد من أن GitLab متاح للأدوار المقصودة.

3. راجع الوصول حسب الدور للأدوار التي ينبغي أن تستخدم التطبيق.

4. في إعداد الإجراءات، راجع إجراءات القراءة والكتابة المتاحة.

5. في إعداد الموافقات، اختر الحالات التي يجب فيها على المستخدمين الموافقة على إجراء قبل أن يستخدم ChatGPT أو Codex التطبيق.

6. اطلب من مستخدم اختباري لديه صلاحية الوصول فتح GitLab من دليل المكوّنات الإضافية أو الإعدادات > المكوّنات الإضافية. تأكّد من أن المستخدم يمكنه تثبيت المكوّن الإضافي والاتصال بالتطبيق المنشأ من قالب GitLab ذاتي الإدارة.

تنطبق إعدادات الموافقة على التطبيق هذه على محادثات ChatGPT وسلاسل Codex.

إعداد نشاط GitLab لمراجعة التعليمات البرمجية في Codex

بعد نشر التطبيق، أعدّ نشاط GitLab في Codex إذا كنت تنوي استخدام مراجعة التعليمات البرمجية في Codex. يُعدّ إعداد النشاط هذا أحداث خطاف الويب المطلوبة.

1. افتح إعدادات موصّلات Codex.

2. أعدّ حساب خدمة لمساحة العمل المشتركة. دع Codex ينشئ الحساب، أو أدخل رمز وصول شخصيًا لحساب خدمة حالي.

3. فعّل نشاط GitLab للمشروع أو لإحدى مجموعاته الرئيسية.

4. إذا احتاج Codex إلى تشغيل مهام برمجية أو استخدام إعداد خاص بالمشروع، فأنشئ بيئة للمشروع.

يستخدم تطبيق GitLab بروتوكول OAuth الخاص بالمستخدم لعمليات القراءة والإجراءات المفعّلة في ChatGPT وCodex. بالنسبة إلى عمليات الكتابة الناتجة عن مراجعات Codex على GitLab ذاتي الإدارة أو GitLab المخصّص، يحدّد رمز حساب الخدمة الذي تديره مساحة العمل المشتركة الهوية والمشاريع التي يمكن لـCodex التعليق أو التفاعل فيها.

اقرأ المزيد: مراجعة طلبات دمج GitLab باستخدام Codex.

ربط تطبيق GitLab واختباره

1. بصفتك مستخدمًا لديه صلاحية الوصول، افتح GitLab من دليل المكوّنات الإضافية أو الإعدادات > المكوّنات الإضافية. اختر تثبيت المكوّن الإضافي، ثم اختر اتصال.

2. إذا كانت مساحة العمل المشتركة تحتوي على أكثر من تطبيق GitLab، فاختر التطبيق الخاص بمضيف GitLab ذاتي الإدارة أو GitLab المخصّص هذا.

3. فوّض تطبيق GitLab OAuth عند مطالبتك بذلك.

4. نفّذ أولًا إجراء قراءة بسيطًا في ChatGPT أو Codex، مثل عرض المشاريع التي يمكن الوصول إليها أو جلب طلب دمج معروف.

5. إذا كانت إجراءات الكتابة مفعّلة، فاختبرها في مشروع منخفض المخاطر وفي كل منتج تنوي استخدامها فيه قبل طرحها على نطاق أوسع.

سلوك اسم المضيف وOAuth

يستخدم التطبيق اسم المضيف لاشتقاق نقاط نهاية GitLab. أدخل المضيف فقط، مثل gitlab.example.com. لا تُدرج https:// أو مسار واجهة API أو مستودع أو منفذًا أو gitlab.com. هذا القالب مخصّص لـGitLab ذاتي الإدارة أو GitLab المخصّص. بالنسبة إلى GitLab.com ‏(SaaS)، استخدم تطبيق GitLab.

استكشاف أخطاء إعداد تطبيق GitLab ذاتي الإدارة وإصلاحها

• عدم تطابق معرّف URI لإعادة التوجيه: تأكّد من أن معرّف URI لإعادة التوجيه في تطبيق GitLab OAuth يطابق تمامًا المعرّف الظاهر في ChatGPT.

• يتعذّر على ChatGPT إنشاء مسودة التطبيق أو حفظها: تأكّد من إدخال اسم المضيف ومعرّف التطبيق والسر ومعرّف URI لإعادة التوجيه.

• نجاح المصادقة مع فشل استدعاءات المشروع: تأكّد من أن مستخدم GitLab الذي يمنح التفويض يمكنه الوصول إلى المشروع، وأن تطبيق OAuth لديه نطاقات القالب.

• تعرض واجهة API الخطأ 403 أو أذونات غير كافية: تأكّد من أن حساب GitLab المتصل لديه أذونات المشروع أو المجموعة المطلوبة، وأن تطبيق OAuth يتضمن نطاقات القالب المطلوبة.

• لا يمكن الوصول إلى أي مشاريع: تأكّد من أن المستخدم لديه حق الوصول إلى المشروع، وأنه متصل بمثيل GitLab المقصود، وأنه اختار تطبيق GitLab الصحيح في ChatGPT أو Codex.

وثائق GitLab ذات الصلة

• وثائق GitLab: إعداد GitLab كموفّر هوية OAuth 2.0

• وثائق GitLab: نطاقات رموز الوصول

• وثائق GitLab: واجهة API لموفّر هوية OAuth 2.0

• وثائق GitLab: رموز الوصول الشخصية

• وثائق GitLab: الأدوار والأذونات

• وثائق GitLab: خطافات الويب