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

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

تساعدك الكتالوجات على توفير مجموعة من قوالب البنية الأساسية كتعليمية (IaC) المنسقة، والمعروفة باسم تعريفات البيئة لفرق التطوير الخاصة بك لإنشاء بيئات. يمكنك إرفاق مستودع التحكم بالمصادر الخاص بك من GitHub أو Azure DevOps ككتالوج وتحديد المجلد مع تعريفات البيئة الخاصة بك. تقوم بيئات النشر بفحص المجلد بحثا عن تعريفات البيئة وتجعلها متاحة لفرق التطوير لإنشاء بيئات.

لمزيد من تأمين القوالب الخاصة بك، يتم تشفير الكتالوج؛ تدعم Azure Deployment Environments التشفير الثابت باستخدام مفاتيح التشفير المدارة بواسطة النظام الأساسي، والتي تديرها Microsoft for Azure Services.

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

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

في هذه المقالة، ستتعرف على كيفية:

1. تكوين كتالوجات على مستوى المشروع
2. تكوين هوية مدارة
3. إضافة كتالوج من Azure Repos أو GitHub
4. تحديث كتالوج
5. حذف كتالوج
6. استكشاف أخطاء مزامنة الكتالوج وإصلاحها

تكوين كتالوجات على مستوى المشروع

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

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

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

إضافة كتالوج إلى مشروع

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

لتمكين استخدام الكتالوجات على مستوى المشروع على مستوى مركز التطوير:

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

2. في القائمة على اليسار، ضمن Settings، اختر Configuration.

   

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

   

لتمكين استخدام تعريفات البيئة في المشروع:

1. في مدخل Microsoft Azure، انتقل إلى مشروعك.

2. في القائمة اليسرى، ضمن الإعدادات، حدد Catalogs.

   

3. في صفحة Catalogs ، حدد Catalog item permissions.

   

4. في جزء إعدادات عنصر الكتالوج، حدد تعريفات بيئة توزيع Azure لتمكين استخدام تعريفات البيئة على مستوى المشروع.

   

الآن، يمكنك إضافة كتالوج إلى المشروع.

بالنسبة للكتالوجات التي تستخدم هوية مدارة أو رمز الوصول الشخصي (PAT) للمصادقة، يجب تعيين هوية مدارة للمشروع. بالنسبة للكتالوجات التي تستخدم PAT، يجب تخزين PAT في مخزن مفاتيح ومنح الهوية المدارة حق الوصول إلى سر key vault.

تكوين هوية مُدارة

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

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

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

إضافة كتالوج

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

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

مستودع Azure Repos مع MSI

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

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

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

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

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

   إشعار

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

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

   

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 Repos مع PAT

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

• احصل على عنوان URL المستنسخ لمستودع Azure Repos.
• إنشاء رمز مميز للوصول الشخصي (PAT).
• قم بتخزين PAT كبيانات سرية لخزنة المفاتيح في Azure Key Vault.
• أضف مستودعك ككتالوج.

الحصول على عنوان URL المستنسخ لمستودع Azure Repos

1. انتقل إلى الصفحة الرئيسية لمجموعة الفريق (على سبيل المثال، https://contoso-web-team.visualstudio.com)، ثم حدد مشروعك.

2. احصل على عنوان URL المستنسخ ل Azure Repos Git repo.

3. انسخ عنوان URL واحفظه.

إنشاء رمز وصول شخصي في Azure Repos

1. انتقل إلى الصفحة الرئيسية لمجموعة الفريق (على سبيل المثال، https://contoso-web-team.visualstudio.com) وحدد مشروعك.

2. إنشاء PAT.

3. انسخ الرمز المميز الذي تم إنشاؤه واحفظه لاستخدامه لاحقا.

إنشاء Key Vault

تحتاج إلى Azure Key Vault لتخزين PAT المستخدم لمنح Azure حق الوصول إلى مستودعك. يمكن لخزائن المفاتيح التحكم في الوصول إما باستخدام نهج الوصول أو التحكم في الوصول استنادا إلى الدور (RBAC). إذا كان لديك مخزن مفاتيح موجود، يمكنك استخدامه، ولكن يجب عليك التحقق مما إذا كان يستخدم نهج الوصول أو تعيينات التحكم في الوصول استنادا إلى الدور للتحكم في الوصول. للحصول على تعليمات حول تكوين نهج وصول لمخزن مفاتيح، راجع تعيين نهج الوصول إلى Key Vault.

استخدم الخطوات التالية لإنشاء مخزن مفاتيح RBAC:

1. قم بتسجيل الدخول إلى بوابة Azure.

2. في مربع البحث، أدخل Key Vault.

3. من قائمة النتائج، حدد المخزن الرئيسي على اليسار.

4. في صفحة Key Vault، حدد Create.

5. في علامة التبويب Create key vault ، قم بتوفير المعلومات التالية:

   الاسم	القيمة‬
   الاسم	أدخل اسما لمخزن المفاتيح.
   الاشتراك	حدد الاشتراك الذي تريد إنشاء خزنة المفاتيح فيه.
   مجموعة الموارد	إما أن تستخدم مجموعة موارد موجودة أو حدد إنشاء جديد وأدخل اسما لمجموعة الموارد.
   Location	حدد الموقع أو المنطقة التي تريد إنشاء خزنة المفاتيح فيها.

   اترك الخيارات الأخرى في الإعدادات الافتراضية الخاصة بها.

6. في علامة التبويب نهج الوصول ، حدد التحكم في الوصول المستند إلى دور Azure، ثم حدد مراجعة + إنشاء.

7. حدد Review + create من علامة التبويب، حدد Create.

إذا كانت نهج مؤسستك تتطلب منك الحفاظ على خصوصية Key Vault من الإنترنت، يمكنك تعيين Key Vault الخاص بك للسماح خدمات Microsoft الموثوق بها بتجاوز قاعدة جدار الحماية.

لمعرفة كيفية السماح خدمات Microsoft الموثوق بها بتجاوز جدار الحماية، راجع تكوين إعدادات شبكة Azure Key Vault.

تخزين الرمز المميز للوصول الشخصي في مخزن المفاتيح

1. في Key Vault، في القائمة اليسرى، حدد Secrets.

2. في صفحة Secrets ، حدد Generate/Import.

3. في صفحة إنشاء بيانات سرية :

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

الحصول على المعرف السري

احصل على المسار إلى السر الذي أنشأته في مخزن المفاتيح.

1. في مدخل Azure، انتقل إلى Key Vault.

2. في صفحة key vault، من القائمة اليسرى، حدد Secrets.

3. في صفحة Secrets ، حدد السر الذي أنشأته سابقا.

4. في صفحة الإصدارات، حدد الإصدار الحالي.

5. في صفحة الإصدار الحالي، بالنسبة إلى المعرف السري، حدد نسخة.

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

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

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

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

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

   الحقل	القيمة
   الاسم	أدخل اسما للكتالوج.
   موقع الكتالوج	حدد Azure DevOps.
   نوع المصادقة	حدد الرمز المميز للوصول الشخصي.
   المنظمة	حدد المؤسسة التي تستضيف مستودع الكتالوج.
   المشروع	حدد المشروع الذي يخزن مستودع الكتالوج.
   Rep	حدد المستودع الذي يخزن الكتالوج.
   مسار المجلد	حدد المجلد الذي يحتوي على قوالب IaC.
   المعرف السري	أدخل المعرف السري الذي يحتوي على PAT الخاص بك للمستودع. عند نسخ معرف سري، يتضمن سلسلة الاتصال معرف إصدار في النهاية، كما في هذا المثال: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat/9376b432b72441a1b9e795695708ea5a. تضمن إزالة معرف الإصدار أن بيئات النشر تجلب أحدث إصدار من السر من مخزن المفاتيح. إذا انتهت صلاحية PAT الخاص بك، يجب تحديث خزنة المفاتيح فقط. مثال على المعرف السري:https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat

   

5. في الكتالوجات، تحقق من ظهور الكتالوج. إذا كان الاتصال ناجحا، يتم الاتصال الحالة.

GitHub repo DevCenter App

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

1. تثبيت تطبيق Microsoft مركز التطوير وتكوينه
2. تعيين أذونات في GitHub للمستودعات.
3. أضف مستودعك ككتالوج.

تثبيت تطبيق Microsoft مركز التطوير

1. قم بتسجيل الدخول إلى بوابة Azure.

2. انتقل إلى مركز التطوير أو المشروع.

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

4. في جزء إضافة كتالوج ، أدخل أو حدد ما يلي:

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

5. لتثبيت تطبيق Microsoft مركز التطوير، حدد تكوين المستودعات الخاصة بك.

   

6. إذا تمت مطالبتك بالمصادقة على GitHub، فصادق.

7. في صفحة Microsoft DevCenter ، حدد تكوين.

   

8. حدد مؤسسة GitHub التي تحتوي على المستودع الذي تريد إضافته ككتالوج. يجب أن تكون مالكا للمؤسسة لتثبيت هذا التطبيق.

   

9. في صفحة Install Microsoft DevCenter، حدد Only select repositories، وحدد المستودع الذي تريد إضافته ككتالوج، ثم حدد Install.

   

   يمكنك تحديد مستودعات متعددة لإضافتها ككتالوجات. يجب إضافة كل مستودع ككتالوج منفصل، كما هو موضح في إضافة مستودعك ككتالوج.

10. في صفحة Microsoft DevCenter by Microsoft، ترغب Microsoft في الحصول على إذن ل: ، راجع الأذونات المطلوبة، ثم حدد تخويل Microsoft مركز التطوير.

    

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

1. ارجع إلى بوابة Azure.

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

   الحقل	القيمة
   الريبو	حدد المستودع الذي تريد إضافته ككتالوج.
   الفرع	حدد الفرع.
   مسار المجلد	حدد المجلد الذي يحتوي على مجلدات فرعية تحتوي على تعريفات البيئة الخاصة بك.

   

3. في الكتالوجات، تحقق من ظهور الكتالوج. عند نجاح الاتصال، تقرأ الحالة مزامنة ناجحة.

   

مستودع GitHub مع PAT

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

• احصل على عنوان URL المستنسخ لمستودع GitHub الخاص بك.
• إنشاء رمز وصول شخصي (PAT) في GitHub.
• قم بتخزين PAT كبيانات سرية لخزنة المفاتيح في Azure Key Vault.
• أضف مستودعك ككتالوج.

الحصول على عنوان URL المستنسخ لمستودع GitHub الخاص بك

1. انتقل إلى الصفحة الرئيسية لمستودع GitHub الذي يحتوي على تعريفات القالب.

2. احصل على عنوان URL لنسخ مستودع GitHub.

3. انسخ عنوان URL واحفظه.

إنشاء رمز وصول شخصي في GitHub

تدعم Azure Deployment Environments المصادقة على مستودعات GitHub باستخدام الرموز المميزة الكلاسيكية أو الرموز المميزة الدقيقة. في هذا المثال، يمكنك إنشاء رمز مميز دقيق.

1. انتقل إلى الصفحة الرئيسية لمستودع GitHub الذي يحتوي على تعريفات القالب.

2. في الزاوية العلوية اليمنى من GitHub، حدد صورة ملف التعريف، ثم حدد الإعدادات.

3. على الشريط الجانبي الأيسر، حدد إعدادات>المطور الرموز المميزة>للوصول الشخصي الرموز المميزة الدقيقة.

4. حدد إنشاء رمز مميز جديد.

5. في صفحة New fine-grained personal access token ، قم بتوفير المعلومات التالية:

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

   

6. حدد إنشاء رمز.

7. انسخ الرمز المميز الذي تم إنشاؤه واحفظه لاستخدامه لاحقا.

هام

عند العمل مع مستودع خاص مخزن داخل مؤسسة GitHub، يجب التأكد من تكوين GitHub PAT لمنح حق الوصول إلى المؤسسة الصحيحة والمستودعات داخلها.

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

يمكن أن تؤدي PATs المكونة بشكل غير صحيح إلى خطأ لم يتم العثور على المستودع.

إنشاء Key Vault

تحتاج إلى Azure Key Vault لتخزين PAT المستخدم لمنح Azure حق الوصول إلى مستودعك. يمكن لخزائن المفاتيح التحكم في الوصول إما باستخدام نهج الوصول أو التحكم في الوصول استنادا إلى الدور (RBAC). إذا كان لديك مخزن مفاتيح موجود، يمكنك استخدامه، ولكن يجب عليك التحقق مما إذا كان يستخدم نهج الوصول أو تعيينات التحكم في الوصول استنادا إلى الدور للتحكم في الوصول. للحصول على تعليمات حول تكوين نهج وصول لمخزن مفاتيح، راجع تعيين نهج الوصول إلى مخزن المفاتيح.

استخدم الخطوات التالية لإنشاء مخزن مفاتيح RBAC:

1. قم بتسجيل الدخول إلى بوابة Azure.

2. في مربع البحث، أدخل key vault.

3. من قائمة النتائج، حدد المخزن الرئيسي على اليسار.

4. في صفحة Key Vault، حدد Create.

5. في علامة التبويب Create key vault ، قم بتوفير المعلومات التالية:

   الاسم	القيمة‬
   الاسم	أدخل اسما لمخزن المفاتيح.
   الاشتراك	حدد الاشتراك الذي تريد إنشاء خزنة المفاتيح فيه.
   مجموعة الموارد	إما أن تستخدم مجموعة موارد موجودة أو حدد إنشاء جديد وأدخل اسما لمجموعة الموارد.
   Location	حدد الموقع أو المنطقة التي تريد إنشاء خزنة المفاتيح فيها.

   اترك الخيارات الأخرى في الإعدادات الافتراضية الخاصة بها.

6. في علامة التبويب نهج الوصول ، حدد التحكم في الوصول المستند إلى دور Azure، ثم حدد مراجعة + إنشاء.

7. حدد Review + create من علامة التبويب، حدد Create.

إذا كانت نهج مؤسستك تتطلب منك الحفاظ على خصوصية Key Vault من الإنترنت، يمكنك تعيين Key Vault الخاص بك للسماح خدمات Microsoft الموثوق بها بتجاوز قاعدة جدار الحماية.

لمعرفة كيفية السماح خدمات Microsoft الموثوق بها بتجاوز جدار الحماية، راجع تكوين إعدادات شبكة Azure Key Vault.

تخزين الرمز المميز للوصول الشخصي في مخزن المفاتيح

1. في Key Vault، في القائمة اليسرى، حدد Secrets.

2. في صفحة Secrets ، حدد Generate/Import.

3. في صفحة إنشاء بيانات سرية :

   • في مربع الاسم ، أدخل اسما وصفيا لسرك.
   • في مربع القيمة السرية، الصق PAT الخاص بك.
   • حدد إنشاء.

الحصول على المعرف السري

احصل على المسار إلى السر الذي أنشأته في مخزن المفاتيح.

1. في مدخل Azure، انتقل إلى Key Vault.

2. في صفحة key vault، من القائمة اليسرى، حدد Secrets.

3. في صفحة Secrets ، حدد السر الذي أنشأته سابقا.

4. في صفحة الإصدارات، حدد الإصدار الحالي.

5. في صفحة الإصدار الحالي، بالنسبة إلى المعرف السري، حدد نسخة.

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

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

2. تأكد من أن الهوية المدارة المرفقة بمركز التطوير أو المشروع لديها حق الوصول إلى سر key vault حيث يتم تخزين رمز الوصول الشخصي الخاص بك.

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

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

   الحقل	القيمة
   الاسم	أدخل اسما للكتالوج.
   موقع الكتالوج	حدد GitHub.
   الريبو	أدخل أو الصق عنوان URL المستنسخ إما لمستودع GitHub أو مستودع Azure Repos الخاص بك. مثال على الكتالوج النموذجي:https://github.com/Azure/deployment-environments.git
   الفرع	أدخل فرع المستودع للاتصال به. مثال على الكتالوج النموذجي:main
   مسار المجلد	أدخل مسار المجلد بالنسبة إلى نسخ URI الذي يحتوي على مجلدات فرعية تحتوي على تعريفات البيئة الخاصة بك. مسار المجلد مخصص للمجلد الذي يحتوي على مجلدات فرعية تحتوي على ملفات بيئة تعريف البيئة، وليس للمجلد الذي يحتوي على ملف بيئة تعريف البيئة نفسه. تعرض الصورة التالية نموذج بنية مجلد الكتالوج. مثال على الكتالوج النموذجي:/Environments يمكن أن يبدأ مسار المجلد ب أو بدون شرطة مائلة للأمام (/).
   المعرف السري	أدخل المعرف السري الذي يحتوي على PAT الخاص بك للمستودع. عند نسخ معرف سري، يتضمن سلسلة الاتصال معرف إصدار في النهاية، كما في هذا المثال: https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat/9376b432b72441a1b9e795695708ea5a. تضمن إزالة معرف الإصدار أن بيئات النشر تجلب أحدث إصدار من السر من مخزن المفاتيح. إذا انتهت صلاحية PAT الخاص بك، يجب تحديث خزنة المفاتيح فقط. مثال على المعرف السري:https://contoso-kv.vault.azure.net/secrets/GitHub-repo-pat

   

5. في الكتالوجات، تحقق من ظهور الكتالوج. عند نجاح الاتصال، تقرأ الحالة مزامنة ناجحة.

عرض عناصر الكتالوج المتزامنة

بغض النظر عن نوع المستودع الذي تستخدمه، يمكنك عرض عناصر الكتالوج التي تتم مزامنتها من الكتالوج.

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

2. في جزء Catalogs ، حدد اسم الكتالوج.

   

3. ترى قائمة بعناصر الكتالوج التي تمت مزامنتها بنجاح.

   

تحديث كتالوج

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

مزامنة كتالوج يدويا

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

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

2. حدد الكتالوج المحدد، ثم من شريط الأوامر، حدد مزامنة.

   

مزامنة كتالوج تلقائيا

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

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

2. حدد الكتالوج المحدد، ثم حدد تحرير.

   

3. في جزء تحرير الكتالوج ، حدد مزامنة هذا الكتالوج تلقائيا، ثم حدد حفظ.

   

حذف كتالوج

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

لحذف كتالوج:

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

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

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

استكشاف أخطاء مزامنة الكتالوج وإصلاحها

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

عرض حالة مزامنة الكتالوج

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

عرض حالات فشل مزامنة الكتالوج

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

2. في عمود الحالة ، حدد ارتباط الحالة للكتالوج الذي فشل في المزامنة.

   

3. ترى جزء التفاصيل الذي يعرض التغييرات في المزامنة الأخيرة وعدد أخطاء المزامنة ونوع الأخطاء.

   

عرض تحذيرات مزامنة الكتالوج

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

2. في عمود الحالة ، حدد ارتباط الحالة للكتالوج الذي تمت مزامنته ولكنه يبلغ عن تحذير.

   

3. ترى جزء التفاصيل الذي يعرض التغييرات في المزامنة الأخيرة، وعدد أخطاء العنصر، ونوع كل خطأ ومصدره.

   

4. يمكنك عرض العناصر التي تمت مزامنتها بنجاح من كتالوج يبلغ أيضا عن أخطاء المزامنة. من جزء Catalogs ، حدد اسم الكتالوج.

   

5. ترى قائمة بعناصر الكتالوج التي تمت مزامنتها بنجاح.

   

استكشاف أخطاء مزامنة الكتالوج وإصلاحها باستخدام Azure CLI

استخدم Azure CLI أو واجهة برمجة تطبيقات REST للحصول على الكتالوج. تظهر لك استجابة GET نوع الخطأ:

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

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

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

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

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

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

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

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

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

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

• تكوين أنواع البيئة لمركز التطوير
• إنشاء مشروع وتكوينه باستخدام Azure CLI
• تكوين أنواع بيئة المشروع