ربط خدمة الشيفرة المصدرية

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

يغطي هذا الدرس GitHub وAzure DevOps وGitLab. تستخدم اتصالات الشيفرة المصدرية صفحة الوصول إلى الكود (الوصول إلى كود البناء > )، وليس معالج الموصل المدار. يركز هذا المقال على تفاصيل الشيفرة المصدرية: كيف تقوم كل خدمة بالمصادقة وكيفية التحقق من صحة الاتصال.

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

• وكيل SRE يعمل والوصول إلى sre.azure.com.
• إذن لتكوين الوكيل.
• حساب على الخدمة لديه وصول إلى المستودعات أو المشاريع التي يجب على الوكيل قراءتها.

لخدمات الإشعارات، انظر Connect a إشعار.

موصلات الشفرة المصدرية

الموصل	الخدمة	المصادقة	الاستخدام النموذجي
GitHub	GitHub و GitHub Enterprise Cloud	تطبيق GitHub الخاص بك (OAuth وPAT مدعومان أيضا github.com)	اقرأ المستودعات، القضايا، وطلبات السحب عبر المشاريع والمؤسسات؛ أنشئ القضايا أو اسحب الطلبات بالموافقة
Azure DevOps	Azure DevOps	الهوية المدارة (OAuth وPAT مدعومان أيضا)	اقرأ المستودعات وطلب السحب عبر المشاريع؛ إنشاء طلبات سحب أو عناصر عمل بالموافقة
منصة GitLab	منصة GitLab	رمز الوصول الشخصي (PAT)	اقرأ المستودعات، الإصدارات، وطلبات الدمج؛ أنشئ القضايا والتعليقات مع الموافقة

يقدم GitHub و Azure DevOps خيارات المصادقة كأزرار راديو. يستخدم GitLab رمز وصول شخصي.

الخطوة 1: الوصول إلى الرمز المفتوح

1. اذهب إلى sre.azure.com واختر وكيلك.
2. في الشريط الجانبي الأيسر، قم بتوسيع Builder، ثم اختر Code Access.
3. اختر علامة التبويب الخاصة بخدمتك (GitHub، Azure DevOps، أو GitLab).
4. اختر إضافة المستودع.

الخطوة 2: التحقق من صحتك

يفتتح مربع "إضافة المستودعات" بمعالج من ثلاث خطوات: اختر منصة → المصادقة → إضافة المستودعات. حدد التالي بعد كل خطوة. الخطوة الأخيرة تحتوي على زر حفظ .

GitHub

استخدم تطبيق GitHub الخاص بك لسحابة المؤسسات في GitHub أو لتحديد نطاق الوصول حسب المنظمة أو التثبيت.

1. تحت طرق تسجيل الدخول، اختر إحضار تطبيق GitHub الخاص بك.
2. أكمل حقول إعداد التطبيق التي يعرضها المعالج.
3. حدد التالي.

يتطلب GitHub Enterprise Cloud (.ghe.com) اتصال تطبيق GitHub. بالنسبة ل github.com، يدعم حسابك (OAuth، إذا تم تكوينه لبيئتك) أو رمز الوصول الشخصي أيضا، رغم أن خيار تطبيق GitHub مفضل في سيناريوهات الإنتاج لتمكين صلاحيات أكثر تفصيلا ورؤية التدقيق.

بعد الاتصال، يمكن للوكيل البحث في المستودعات والمشكلات وسحب الطلبات عبر المشاريع والمنظمات التي يمكن لتطبيقك أو حسابك الوصول إليها.

أAzure DevOps

استخدم الهوية المدارة للاستخدام الإنتاجي، مما يتجنب الاعتمادات طويلة الأمد.

1. تحت طرق تسجيل الدخول، اختر الهوية المدارة.
2. أكمل الحقول التي يعرضها المعالج، وتأكد من أن هوية الوكيل المدارة لديها إمكانية الوصول إلى مشاريع ومستودعات Azure DevOps التي يحتاجها الوكيل.
3. حدد التالي.

كما يتم دعم مصادقة حسابك (OAuth) ورمز الوصول الشخصي، لكنها الأنسب للتطوير أو الاختبار أو السيناريوهات التي لا يمكن فيها استخدام الهوية المدارة. استخدم أضيق هوية أو رمز يمكنه قراءة المشاريع والمستودعات التي يحتاجها الوكيل.

بعد الاتصال، يمكن للوكيل البحث في المستودعات، وقراءة طلبات السحب، وفحص عناصر العمل عبر مشاريعك.

GitLab

1. أدخل رمز الوصول الشخصي (PAT) الخاص ب GitLab.
2. حدد التالي.

امنح PAT فقط النطاق الذي يحتاجه الوكيل للوصول إلى المستودع والإصدار وطلب الدمج.

بعد الاتصال، يمكن للوكيل قراءة المستودعات والمشكلات وطلبات الدمج داخل المشاريع التي يمكن للرمز الوصول إليها.

ترى الخدمة الهوية التي سمحت بالاتصال. تظهر المشكلات، والتعليقات، ونشاط طلبات السحب الذي ينشئه الوكيل تحت ذلك الحساب.

الخطوة 3: إضافة المستودعات

تظهر خطوة إضافة المستودعات جدولا حيث تحدد أي المستودعات يفهرس الوكلاء. كل صف هو مستودع واحد.

1. إذا كانت خدمتك Azure DevOps، اختر أولا project من قائمة Azure DevOps Project. عمود رابط المستودع يمتلئ بالمستودعات في ذلك المشروع.

2. في عمود عنوان المستودع ، اختر مستودعا من القائمة المنسدلة أو اكتب عنوانا مباشرة. بالنسبة ل GitHub وGitLab، قوائم القوائم المنسدلة التي يمكن لبيانات اعتمادك الوصول إليها. بالنسبة ل Azure DevOps، يسرد المستودعات في المشروع المختار.

3. في عمود اسم العرض ، أدخل اسما مختصرا يستخدمه الوكيل للإشارة إلى المستودع.

4. يمكنك ملء عمود الوصف اختياريا لإعطاء الوكيل مزيدا من السياق حول ما يحتويه المستودع.

5. إذا كانت خدمتك Azure DevOps والمستودع كبير جدا، قم بتفعيل مربع اختيار TRemote. يستخدم الوكيل البحث المدعوم بالذكاء الاصطناعي على النسخة البعيدة بدلا من استنساخها محليا. يتم استنساخ المستودعات بحد أقصى 100 جيجابايت للقرص؛ تفعيل Remote يتجنب هذا القيد.

6. لإضافة مستودع آخر، اختر إضافة واملأ الصف التالي.

7. عند اكتمال الجدول، اختر الحفظ.

الخطوة 4: التحقق من ذلك باستخدام سيناريو

1. افتح محادثة مع وكيلك.

2. اطرح سؤالا للقراءة، مثل:

   List the open issues in the payments repository from the last week.
   

3. تحقق من بطاقة الأداة لترى الوكيل يبحث في الخدمة ويعيد النتائج بناء على بياناتك.

عندما تظهر نتائج تشير إلى مستودعك، يعمل الاتصال من نقطة إلى أخرى.

استكشاف الأخطاء وإصلاحها

المشكلة	السبب	إصلاح
البحث لا يعطي نتائج	الحساب يفتقر إلى الوصول إلى المشروع أو المستودع	تأكد من أن حساب الاتصال يمكنه رؤية المشروع أو المستودع، ثم أعد المحاولة.
فشل إنشاء مع خطأ في الإذن	الرمز أو الحساب يفتقر إلى نطاق الكتابة	امنح النطاق المطلوب للرمز أو الحساب، أو استخدم بيانات اعتماد تحتوي على صلاحية كتابة.
GitHub Enterprise Cloud يرفض الاتصال	يتطلب GitHub Enterprise Cloud اتصال تطبيق GitHub	في صفحة الوصول إلى الكود، افصل اتصال GitHub، اختر إضافة المستودع، اختر GitHub، أدخل مضيفك.ghe.com، واختر تطبيق GitHub الخاص بك كطريقة المصادقة.

المحتوى ذو الصلة

• ربط خدمة إشعارات
• ربط مصدر تليمترية
• قم بإعداد موصل مدار