إضافة كتالوج وتكوينه من GitHub أو Azure Repos

يشرح هذا الدليل كيفية إضافة كتالوج وتكوينه في مركز تطوير بيئات نشر Azure. الكتالوج هو مستودع مستضاف في GitHub أو Azure DevOps.

يمكنك استخدام كتالوج لتزويد فرق التطوير بمجموعة منسقة من البنية الأساسية كقوالب تعليمات برمجية (IaC) تسمى تعريفات البيئة.

تدعم بيئات النشر الكتالوجات المستضافة في Azure Repos (خدمة المستودع في Azure، ويشار إليها عادة باسم Azure DevOps) والكتالوجات المستضافة في GitHub. يدعم Azure Repos المصادقة عن طريق تعيين أذونات لهوية مدارة. يدعم كل من Azure Repos وGitHub استخدام رمز وصول شخصي (PAT) للمصادقة. لمزيد من تأمين القوالب الخاصة بك، يتم تشفير الكتالوج؛ تدعم Azure Deployment Environments التشفير الثابت باستخدام مفاتيح التشفير المدارة بواسطة النظام الأساسي، والتي تديرها Microsoft for Azure Services.

  • لمعرفة كيفية استضافة مستودع في GitHub، راجع بدء استخدام GitHub.
  • لمعرفة كيفية استضافة مستودع Git في مشروع Azure Repos، راجع Azure Repos.

تقدم Microsoft كتالوج البدء السريع الذي يمكنك إضافته إلى مركز التطوير، وكتالوج عينة يمكنك استخدامه كمستودع. يمكنك أيضا استخدام المستودع الخاص بك، أو يمكنك نسخ تعريفات البيئة وتخصيصها في الكتالوج النموذجي.

تكوين هوية مدارة لمركز التطوير

بعد إنشاء مركز تطوير، قبل أن تتمكن من إرفاق كتالوج، يجب تكوين هوية مدارة، تسمى أيضا هوية الخدمة المدارة (MSI)، لمركز التطوير. يمكنك إرفاق إما هوية مدارة معينة من قبل النظام (MSI المعينة من قبل النظام) أو هوية مدارة معينة من قبل المستخدم (MSI المعينة من قبل المستخدم). ثم تقوم بتعيين أدوار للهوية المدارة للسماح لمركز التطوير بإنشاء أنواع البيئة في اشتراكك وقراءة مشروع Azure Repos الذي يحتوي على مستودع الكتالوج.

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

لمعرفة المزيد حول الهويات المدارة، راجع ما هي الهويات المدارة لموارد Azure؟

إضافة كتالوج

يمكنك إضافة كتالوج من مستودع Azure Repos أو مستودع GitHub. يمكنك اختيار المصادقة عن طريق تعيين أذونات إلى MSI أو باستخدام PAT، الذي تقوم بتخزينه في مخزن مفاتيح.

حدد علامة التبويب لنوع المستودع والمصادقة التي تريد استخدامها.

لإضافة كتالوج، أكمل المهام التالية:

  • تعيين أذونات في Azure Repos للهوية المدارة لمركز التطوير.
  • أضف مستودعك ككتالوج.

تعيين أذونات في Azure Repos للهوية المدارة لمركز التطوير

يجب منح أذونات الهوية المدارة لمركز التطوير إلى المستودع في Azure Repos.

  1. سجّل الدخول إلى مؤسسة Azure DevOps .

    إشعار

    يجب أن تكون مؤسسة Azure DevOps في نفس الدليل مثل اشتراك Azure الذي يحتوي على مركز التطوير الخاص بك.

  2. حدد إعدادات المؤسسة.

    لقطة شاشة تعرض صفحة مؤسسة Azure DevOps، مع تمييز الإعدادات المؤسسة.

  3. في صفحة Overview ، حدد Users.

    لقطة شاشة تعرض صفحة نظرة عامة على المؤسسة، مع تمييز المستخدمين.

  4. في صفحة المستخدمين ، حدد إضافة مستخدمين.

    لقطة شاشة تعرض صفحة المستخدمين، مع تمييز إضافة مستخدم.

  5. أكمل إضافة مستخدمين جدد عن طريق إدخال المعلومات التالية أو تحديدها، ثم حدد إضافة:

    الاسم القيمة‬
    المستخدمون أو كيانات الخدمة أدخل اسم مركز التطوير الخاص بك.
    عند استخدام MSI المعين من قبل النظام، حدد اسم مركز التطوير، وليس معرف الكائن للحساب المدار. عند استخدام MSI المعين من قبل المستخدم، استخدم اسم الحساب المدار.
    مستوى الوصول حدد أساسي.
    إضافة إلى المشاريع حدد المشروع الذي يحتوي على المستودع الخاص بك.
    مجموعات Azure DevOps حدد Project Readers.
    إرسال دعوات بالبريد الإلكتروني (إلى المستخدمين فقط) قم بإلغاء تحديد خانة الاختيار.

    لقطة شاشة تعرض إضافة مستخدمين، مع تمييز إدخالات المثال وإضافة.

إضافة مستودعك ككتالوج

تدعم Azure Deployment Environments إرفاق مستودعات Azure Repos ومستودعات GitHub. يمكنك تخزين مجموعة من قوالب IaC المنسقة في مستودع. يؤدي إرفاق المستودع بمركز التطوير ككتالوج إلى منح فرق التطوير إمكانية الوصول إلى القوالب وتمكينهم من إنشاء بيئات متسقة بسرعة.

تتيح لك الخطوات التالية إرفاق مستودع Azure Repos.

  1. في مدخل Microsoft Azure، انتقل إلى مركز التطوير الخاص بك.

  2. في القائمة اليمنى ضمن Environment configuration، حدد Catalogs، ثم حدد Add.

    لقطة شاشة تعرض جزء الكتالوجات.

  3. في إضافة كتالوج، أدخل المعلومات التالية، ثم حدد إضافة:

    الحقل القيمة
    الاسم أدخل اسما للكتالوج.
    موقع الكتالوج حدد Azure DevOps.
    نوع المصادقة حدد الهوية المدارة.
    المنظمة حدد مؤسسة Azure DevOps.
    المشروع من قائمة المشاريع، حدد المشروع الذي يخزن المستودع.
    الريبو من قائمة المستودعات، حدد المستودع الذي تريد إضافته.
    الفرع حدد الفرع.
    مسار المجلد يسترد Dev Box قائمة بالمجلدات في الفرع الخاص بك. حدد المجلد الذي يخزن قوالب IaC.

    لقطة شاشة تعرض جزء إضافة كتالوج مع إدخالات أمثلة وإضافة مميزة.

  4. في كتالوجات مركز التطوير، تحقق من ظهور الكتالوج. عند نجاح الاتصال، تقرأ الحالة مزامنة ناجحة. قد يستغرق الاتصال إلى كتالوج بضع دقائق في المرة الأولى.

تحديث كتالوج

إذا قمت بتحديث محتويات قالب Azure Resource Manager (قالب ARM) أو التعريف في المستودع المرفق، يمكنك توفير أحدث مجموعة من تعريفات البيئة لفرق التطوير الخاصة بك عن طريق مزامنة الكتالوج.

لمزامنة كتالوج محدث في بيئات نشر Azure:

  1. في القائمة اليسرى لمركز التطوير الخاص بك، ضمن Environment configuration، حدد Catalogs.

  2. حدد الكتالوج المحدد، ثم حدد مزامنة. تقوم الخدمة بالمسح الضوئي من خلال المستودع وتجعل أحدث قائمة من تعريفات البيئة متاحة لجميع المشاريع المرتبطة في مركز التطوير.

حذف كتالوج

يمكنك حذف كتالوج لإزالته من مركز تطوير بيئات نشر Azure. لا تتوفر القوالب الموجودة في كتالوج محذوف لفرق التطوير عند توزيع بيئات جديدة. تحديث مرجع تعريف البيئة لأي بيئات موجودة تم إنشاؤها باستخدام تعريفات البيئة في الكتالوج المحذوف. إذا لم يتم تحديث المرجع وإعادة نشر البيئة، يفشل النشر.

لحذف كتالوج:

  1. في القائمة اليسرى لمركز التطوير الخاص بك، ضمن Environment configuration، حدد Catalogs.

  2. حدد الكتالوج المحدد، ثم حدد حذف.

  3. في مربع الحوار حذف الكتالوج ، حدد متابعة لحذف الكتالوج.

أخطاء مزامنة الكتالوج

عند إضافة كتالوج أو مزامنته، قد تواجه خطأ في المزامنة. يشير خطأ المزامنة إلى أن بعض تعريفات البيئة أو كلها تحتوي على أخطاء. استخدم Azure CLI أو واجهة برمجة تطبيقات REST للحصول على الكتالوج. تظهر لك استجابة GET نوع الخطأ:

  • تعريفات البيئة التي تم تجاهلها والتي تم اكتشاف أنها مكررة.
  • تعريفات البيئة غير صحيحة التي فشلت بسبب أخطاء المخطط أو المرجع أو التحقق من الصحة.

حل أخطاء تعريف البيئة التي تم تجاهلها

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

حل أخطاء تعريف البيئة غير الصالحة

قد يحدث خطأ غير صالح في تعريف البيئة لأسباب مختلفة:

  • أخطاء مخطط البيان. تأكد من أن ملف بيئة تعريف البيئة الخاص بك يطابق المخطط المطلوب.

  • أخطاء التحقق من الصحة. تحقق من العناصر التالية لحل أخطاء التحقق من الصحة:

    • تأكد من تكوين نوع محرك ملف البيئة بشكل صحيح ك ARM.
    • تأكد من أن اسم تعريف البيئة بين 3 و63 حرفا.
    • تأكد من أن اسم تعريف البيئة يتضمن فقط الأحرف الصالحة لعنون URL، وهي أحرف أبجدية رقمية وهذه الرموز: ~!,.';:=-_+()*&$@
  • أخطاء مرجعية. تأكد من أن مسار القالب الذي يشير إليه ملف البيئة هو مسار نسبي صالح لملف في المستودع.