Source control in Azure Data Factory

ينطبق على: Azure Data Factory Azure Synapse Analytics

تلميح

Data Factory في Microsoft Fabric هو الجيل القادم من Azure Data Factory، مع بنية أبسط، وذكاء اصطناعي مدمج، وميزات جديدة. إذا كنت جديدا في تكامل البيانات، ابدأ مع Fabric Data Factory. يمكن لأعباء عمل ADF الحالية الترقية إلى Fabric للوصول إلى قدرات جديدة في علوم البيانات، والتحليلات اللحظية، والتقارير.

• ابدأ تجربة مجانية Fabric.
• الترقية من Azure Data Factory إلى Data Factory في Microsoft Fabric

افتراضيا، تجربة واجهة المستخدم في Azure Data Factory (UX) تتعامل مباشرة مع خدمة مصنع البيانات. وهذه التجربة لها القيود التالية:

• لا تتضمن خدمة Data Factory مستودعًا لتخزين وحدات JSON للتغييرات الخاصة بك. الطريقة الوحيدة لحفظ التغييرات هي عبر الزر نشر الكل ويتم نشر جميع التغييرات مباشرة إلى خدمة مصنع البيانات.
• لم يتم تحسين خدمة Data Factory للتعاون والتحكم في الإصدار.
• قالب Azure Resource Manager (ARM) المطلوب لنشر Data Factory نفسه غير مشمول.

لتوفير تجربة تأليف أفضل، يسمح لك Azure Data Factory بتكوين مستودع Git إما باستخدام مستودعات Azure أو GitHub. Git هو نظام تحكم في الإصدار يسمح بتعقب التغييرات والتعاون بشكل أسهل. توضح هذه المقالة كيفية تكوين والعمل في مستودع Git مع تسليط الضوء على أفضل الممارسات ودليل استكشاف المشكلات.

يمكنك أيضا الرجوع إلى التكامل المستمر والتسليم (CI/CD) في Azure Data Factory لتتعرف أكثر على نمط CI/CD الأكبر، والذي يعد التحكم في المصدر جانبا حاسما.

إشعار

الدعم العام ل GitHub متوفر الآن على Azure Gov و Microsoft Azure التي تديرها 21Vianet. لمزيد من المعلومات، راجع مدونة الإعلان.

لمعرفة المزيد عن كيفية تكامل Azure Data Factory مع Git، شاهد الفيديو التعليمي الذي مدته 15 دقيقة أدناه:

مزايا تكامل Git

فيما يلي قائمة ببعض المزايا التي يوفرها تكامل Git لتجربة التأليف:

• التحكم بالمصادر: عندما تصبح أحمال عمل مصنع البيانات حاسمة، قد ترغب في دمج المصنع الخاص بك مع Git لتطبيق العديد من مزايا التحكم بالمصادر مثل ما يلي:
  • القدرة على تتبع/مراجعة التغييرات.
  • القدرة على التراجع عن التغييرات التي أحدثت أخطاء.
• عمليات الحفظ الجزئي: عند التأليف مقابل خدمة مصنع البيانات، لا يمكنك حفظ التغييرات كمسودة، ويجب أن تجتاز جميع عمليات النشر التحقق من صحة مصنع البيانات. سواء لم تكن خطوط الأنابيب مكتملة أو ببساطة لا تريد فقدان التغييرات إذا تعطل جهاز الكمبيوتر الخاص بك، فإن تكامل Git يسمح بتغييرات تدريجية في موارد مصنع البيانات بغض النظر عن حالتها. إعداد مستودع Git يسمح لك بحفظ التغييرات، مما يسمح لك بالنشر فقط بعد اختبار التغييرات التي ترضينها.
• التعاون والتحكم: إذا كان لديك العديد من أعضاء الفريق المساهمين في نفس المصنع، فقد ترغب في السماح لزملائك في الفريق بالتعاون مع بعضهم البعض عبر عملية مراجعة التعليمات البرمجية. يمكنك أيضًا إعداد المصنع الخاص بك بحيث لا يكون لكل مساهم أذونات متماثلة. قد يسمح لبعض أعضاء الفريق فقط بإجراء تغييرات عبر Git ويسمح فقط لبعض الأشخاص في الفريق بنشر التغييرات على المصنع.
• تحسين CI/CD: إذا كنت تنشر في بيئات متعددة مع عملية تسليم مستمرة، فإن تكامل Git يجعل بعض الإجراءات أسهل. تتضمن بعض هذه الإجراءات ما يلي:
  • تكوين مسار الإصدار الخاص بك للتشغيل تلقائيًا بمجرد وجود أي تغييرات على مصنع 'التطوير'.
  • خصص الخصائص في مصنعك المتاحة كمعلمات في قالب Resource Manager. قد يكون من المفيد الاحتفاظ فقط بمجموعة الخصائص المطلوبة كمعلمات، ويكون كل شيء آخر مشفرا.
• أداء أفضل: المصنع العادي مع تكامل Git يحمل أسرع بعشر مرات من المؤلف مقابل خدمة مصنع البيانات. ويرجع تحسن الأداء هذا لتحميل الموارد عبر Git.

إشعار

يتم تعطيل التأليف المباشر باستخدام خدمة Data Factory في تجربة المستخدم Azure Data Factory عند تكوين مستودع Git. التغييرات التي تجرى عبر PowerShell أو SDK تنشر مباشرة إلى خدمة Data Factory ولا يتم إدخالها في Git.

التوصيل بمستودع Git

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

أسلوب التكوين 1: الصفحة الرئيسية

في الصفحة الرئيسية Azure Data Factory، اختر إعداد مستودع الكود في الأعلى.

أسلوب التكوين 2: لوحة التأليف

في لوحة تأليف تجربة المستخدم Azure Data Factory، اختر قائمة المنسدلة ><مصنع البيانات، ثم اختر إعداد مستودع الكود.

أسلوب التكوين 3: مركز الإدارة

اذهب إلى مركز الإدارة في Azure Data Factory Studio. حدد Git configuration في قسم Source control . إذا لم يكن لديك مستودع متصل، فحدد تكوين.

طريقة التكوين 4: أثناء إنشاء المصنع

عند إنشاء مصنع بيانات جديد في بوابة Azure، يمكنك تكوين معلومات مستودع Git في تبويب Git configuration.

إشعار

عند تكوين Git في بوابة Azure، يجب إدخال إعدادات مثل اسم المشروع واسم المستودع يدويا بدلا من أن تكون جزءا من قائمة منسدلة.

Author with مستودعات Azure Git integration

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

إشعار

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

مستودعات Azure settings

يرشدك جزء التكوين خطوة بخطوة من خلال تكوين كل من إعدادات مستودع التعليمات البرمجية التالية:

الإعدادات	‏‏الوصف	القيمة‬
نوع المستودع	نوع مستودع مستودعات Azure Code Repository.	Azure DevOps Git or GitHub
Microsoft Entra ID	اسم المستأجر الخاص بك في Microsoft Entra.	<your tenant name>
مستودعات Azure التنظيم	اسم المؤسسة الخاص بك في مستودعات Azure. يمكنك العثور على اسم مستودعات Azure المنظمة على https://{organization name}.visualstudio.com. يمكنك تسجيل الدخول إلى مؤسستك مستودعات Azure للوصول إلى ملفك الشخصي Visual Studio ورؤية مستودعات ومشاريعك.	<your organization name>
اسم المشروع	Your مستودعات Azure project name. يمكنك العثور على اسم مشروعك مستودعات Azure على https://{organization name}.visualstudio.com/{project name}.	<your Azure Repos project name>
اسم المستودع	Your مستودعات Azure code repository name. مشاريع مستودعات Azure تحتوي على مستودعات Git لإدارة كودك المصدري مع نمو مشروعك. يمكنك إنشاء مستودع جديد أو استخدام مستودع موجود بالفعل في مشروعك.	<your Azure Repos code repository name>
فرع التعاون	فرع التعاون الخاص بك في مستودعات Azure الذي يستخدم للنشر. بشكل افتراضي، يكون main. قم بتغيير هذا الإعداد إذا كنت تريد نشر موارد من فرع آخر.	<your collaboration branch name>
نشر الفرع	فرع النشر هو الفرع الموجود في المستودع الخاص بك حيث يتم تخزين وتحديث قوالب ARM المتعلقة بالنشر. بشكل افتراضي، يكون adf_publish.	<your publish branch name>
المجلد الجذر	Your root folder في فرع التعاون الخاص بك في مستودعات Azure.	<your root folder name>
استيراد موارد Data Factory الحالية إلى المستودع	يحدد ما إذا كان يجب استيراد موارد مصنع البيانات الموجودة من تجربة المستخدم Authoring canvas إلى مستودع Git مستودعات Azure. حدد المربع لاستيراد موارد مصنع البيانات الخاصة بك إلى مستودع Git المرتبط بتنسيق JSON. يقوم هذا الإجراء بتصدير كل مورد على حدة (أي يتم تصدير الخدمات ومجموعات البيانات المرتبطة إلى JSONs منفصلة). عندما لا يتم تحديد هذا المربع، لا يتم استيراد الموارد الموجودة.	محدد (افتراضي)
فرع لاستيراد المورد إلى	يحدد الفرع الذي يتم استيراد موارد مصنع البيانات إليه (مسارات ومجموعات البيانات والخدمات المرتبطة وما إلى ذلك). يمكنك استيراد الموارد إلى أحد الفروع التالية: أ. التعاون ب. إنشاء ج جديد. استخدام موجود

إشعار

إذا كنت تستخدم Microsoft Edge ولا ترى أي قيم في قائمة حسابك Azure DevOps، أضف https://*.visualstudio.com إلى قائمة المواقع الموثوقة.

تحرير إعدادات المستودع

إذا كان هناك حاجة لأي تعديلات على إعدادات مستودع Git المكون مستودعات Azure، يمكنك اختيار Edit.

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

استخدم مستأجر Microsoft Entra مختلف

يمكن أن يكون مستودع مستودعات Azure Git في مستأجر Microsoft Entra مختلف. لتحديد مستأجر مختلف في Microsoft Entra، يجب أن يكون لديك أذونات المسؤول لاشتراك Azure الذي تستخدمه. لمزيد من المعلومات، راجع تغيير مسؤول الاشتراك.

هام

للاتصال بمعرف Microsoft Entra ID آخر، يجب أن يكون المستخدم المسجل جزءا من ذلك الدليل النشط.

استخدم حسابك الشخصي في Microsoft

لاستخدام حساب Microsoft الشخصي للتكامل مع Git، يمكنك ربط مستودع Azure Repo الشخصي الخاص بك ب Active Directory الخاص بمؤسستك.

1. أضف حساب Microsoft الشخصية إلى Active Directory منظمتك كضيف. لمزيد من المعلومات، راجع إضافة Microsoft Entra مستخدمي التعاون بين الشركات في بوابة Azure.

2. سجل الدخول إلى بوابة Azure باستخدام حسابك الشخصي على حساب Microsoft. ثم انتقل إلى Active Directory الخاص بمؤسستك.

3. اذهب إلى قسم Azure DevOps، حيث ترى الآن مستودعك الشخصي. اختر المستودع واتصل ب Active Directory.

بعد خطوات التكوين هذه يتوفر الريبو الشخصي الخاص بك عند إعداد تكامل Git في واجهة مستخدم Data Factory.

لمزيد من المعلومات حول ربط مستودعات Azure ب Active Directory مؤسستك، راجع ربط مؤسستك Azure DevOps ب Microsoft Entra ID.

مؤلف مع تكامل GitHub

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

يدعم التكامل GitHub مع Data Factory كل من GitHub العامة (أي https://github.com)، GitHub Enterprise Cloud وخادم GitHub Enterprise. يمكنك استخدام مستودعات GitHub العامة والخاصة مع Data Factory طالما لديك إذن قراءة وكتابة للمستودع في GitHub. للاتصال بمستودع عام، حدد الخيار استخدام مستودع الارتباط، لأنها غير مرئية في القائمة المنسدلة لاسم المستودع. يعمل تكامل خادم المؤسسات GitHub في ADF فقط مع الإصدارات المدعومة رسميا من GitHub خادم المؤسسات.

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

إشعار

إذا كنت تستخدم Microsoft Edge، فإن إصدار GitHub Enterprise الأقل من 2.1.4 لا يعمل معه. GitHub يدعم رسميا >=3.0 وكل هذه يجب أن تكون مناسبة ل ADF. مع تغير GitHub للنسخة الدنيا، تتغير أيضا النسخ المدعومة من ADF.

إعدادات GitHub

إشعار

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

تظهر لوحة الإعدادات إعدادات مستودع GitHub التالية:

الإعداد	الوصف	القيمة
نوع المستودع	نوع مستودع الكود.	GitHub
استخدم GitHub Enterprise Server	اختر خيار اختيار GitHub Enterprise Server.	غير محدد (افتراضي)
GitHub رابط خادم المؤسسات	رابط جذر GitHub Enterprise (يجب أن يكون HTTPS لخادم GitHub Enterprise المحلي). على سبيل المثال: https://github.mydomain.com. مطلوب فقط إذا تم اختيار Use GitHub Enterprise Server	<your GitHub Enterprise Server URL>
GitHub مالك المستودع	منظمة أو حساب GitHub يملك المستودع. يمكن العثور على هذا الاسم من https://github.com/{owner}/{repository الاسم}. التنقل إلى هذه الصفحة يطلب منك إدخال بيانات اعتماد GitHub OAuth إلى منظمتك أو حسابك في GitHub. إذا اخترت Use GitHub Enterprise Server، يظهر مربع حوار يسمح لك بإدخال رمز الوصول الخاص بك.	<your GitHub repository owner name>
اسم المستودع	اسم مستودع كود GitHub الخاص بك. حسابات GitHub تحتوي على مستودعات Git لإدارة الشيفرة المصدرية الخاصة بك. يمكنك إنشاء مستودع جديد أو استخدام مستودع موجود بالفعل في حسابك. حدد اسم مستودع الرمز GitHub عند اختيار Select repository.	<your repository name>
رابط مستودع Git	رابط مستودع كود GitHub الخاص بك. حدد رابط مستودع الكود GitHub الخاص بك عند اختيار Use repository link.	<your repository link>
فرع التعاون	فرع التعاون الخاص بك في GitHub الذي يستخدم للنشر. بشكل افتراضي، هو الرئيسي. قم بتغيير هذا الإعداد إذا كنت تريد نشر موارد من فرع آخر. يمكنك أيضا إنشاء فرع تعاون جديد هنا.	<your collaboration branch>
نشر الفرع	الفرع في المستودع الخاص بك حيث يتم تخزين قوالب ARM المتعلقة بالنشر وتحديثها.	<your publish branch name>
المجلد الجذر	مجلد الجذر الخاص بك في فرع التعاون في GitHub الخاص بك.	<your root folder name>
استيراد الموارد الموجودة إلى المستودع	يحدد ما إذا كان يجب استيراد موارد مصنع البيانات الحالية من لوحة تأليف تجربة المستخدم إلى مستودع GitHub. حدد المربع لاستيراد موارد مصنع البيانات الخاصة بك إلى مستودع Git المرتبط بتنسيق JSON. يقوم هذا الإجراء بتصدير كل مورد على حدة (أي يتم تصدير الخدمات ومجموعات البيانات المرتبطة إلى JSONs منفصلة). عندما لا يتم تحديد هذا المربع، لا يتم استيراد الموارد الموجودة.	محدد (افتراضي)
استيراد مورد إلى هذا الإصدار الفرع	يحدد الفرع الذي يتم استيراد موارد مصنع البيانات إليه (مسارات ومجموعات البيانات والخدمات المرتبطة وما إلى ذلك).

تحرير إعدادات المستودع

إذا كان هناك حاجة لأي تعديلات على إعدادات مستودع GitHub المكون لديك، يمكنك اختيار Edit.

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

منظمات GitHub

الاتصال بمنظمة GitHub يتطلب من المنظمة منح إذن ل Azure Data Factory. يجب على المستخدم الذي لديه أذونات ADMIN في المؤسسة تنفيذ الخطوات التالية للسماح لمصنع البيانات بالاتصال.

الاتصال ب GitHub العام أو GitHub Enterprise Cloud لأول مرة في Azure Data Factory

إذا كنت تتصل لأول مرة ب GitHub العام أو GitHub Enterprise Cloud من Azure Data Factory، اتبع هذه الخطوات للاتصال بمنظمة GitHub.

1. في لوحة إعدادات Git، أدخل اسم المنظمة في حقل GitHub Account. يظهر طلب تسجيل الدخول إلى GitHub.
2. سجل الدخول باستخدام بيانات اعتماد المستخدم.
3. يطلب منك تفويض Azure Data Factory كتطبيق يسمى AzureDataFactory. على هذه الشاشة، ترى خيارا لمنح الإذن ل ADF للوصول إلى المؤسسة. إذا لم تر خيار منح الإذن، اطلب من المسؤول منح الإذن يدويا عبر GitHub.

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

متصل بالفعل ب GitHub العام أو GitHub Enterprise Cloud باستخدام حساب شخصي

إذا كنت قد اتصلت بالفعل ب GitHub العام أو GitHub Enterprise Cloud ومنحت فقط الإذن للوصول إلى حساب شخصي، اتبع الخطوات التالية لمنح الأذونات لمنظمة.

1. اذهب إلى GitHub وافتح Settings.

   

2. حدد استمارات التقديم. في علامة التبويب تطبيقات OAuth المعتمدة ، يجب أن ترى AzureDataFactory .

   

3. حدد التطبيق وامنح التطبيق حق الوصول إلى مؤسستك.

   

بمجرد اتباع هذه الخطوات، يمكن للمصنع الاتصال بكل من المستودعات العامة والخاصة داخل مؤسستك.

الاتصال بخادم GitHub Enterprise Server

إذا اتصلت بخادم GitHub Enterprise، تحتاج إلى استخدام رمز وصول شخصي للمصادقة. تعرف على كيفية إنشاء رمز مميز للوصول الشخصي في إنشاء رمز مميز للوصول الشخصي.

إشعار

خادم GitHub Enterprise موجود في بيئة خاصة مستضافتة ذاتيا، لذا تحتاج إلى تحكم كامل في جدار الحماية وسياسات الشبكة وVPN عند استخدام هذا المصادقة. لمزيد من المعلومات، راجع حول GitHub Enterprise Server.

القيود المعروفة ل GitHub

• يمكنك تخزين ملفات السكريبت والبيانات في مستودع GitHub. ومع ذلك، عليك رفع الملفات يدويا إلى تخزين Azure. خط أنابيب Data Factory لا يقوم تلقائيا برفع ملفات السكربت أو البيانات المخزنة في مستودع GitHub إلى تخزين Azure.

• GitHub Enterprise مع إصدار أقدم من 2.14.0 لا يعمل في متصفح Microsoft Edge.

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

Connecting to Azure DevOps Server 2022

إذا اتصلت ب Azure DevOps Server 2022، ستحتاج إلى استخدام رمز وصول شخصي للمصادقة. تعرف على كيفية إنشاء رمز مميز للوصول الشخصي هنا.

اتصل ب Azure DevOps المحلية من خلال توفير Azure DevOps Server URL و Azure DevOps Project Collection

قم بتوفير الرمز المميز مع نطاق الوصول للقراءة/الكتابة للتعليمات البرمجية.

التحكم بالإصدار

تسمح أنظمة التحكم بالإصدار (المعروفة أيضا باسم التحكم بالمصادر) للمطورين بالتعاون في التعليمات البرمجية وتتبع التغييرات التي يتم إجراؤها على قاعدة التعليمات البرمجية. ويعد التحكم في المصادر أداة أساسية للمشاريع متعددة المطورين.

إنشاء فروع ميزات

كل مستودع مستودعات Azure في Git مرتبط بمصنع بيانات له فرع تعاون. (main هو فرع التعاون الافتراضي). يمكن للمستخدمين أيضا إنشاء تفرعات ميزات باختيار + فرع جديد في قائمة الفروع المنسدلة.

بمجرد ظهور جزء الفرع الجديد، أدخل اسم فرع الميزة الخاص بك وحدد فرعًا لتأسيس العمل عليه.

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

تكوين إعدادات النشر

بشكل افتراضي، يقوم مصنع البيانات بإنشاء قوالب Resource Manager للمصنع المنشور وحفظها في فرع يسمى adf_publish. لتكوين فرع نشر مخصص، أضف ملفا publish_config.json إلى المجلد الجذر في فرع التعاون. عند النشر، يقرأ ADF هذا الملف، ويبحث عن الحقل publishBranch، ويحفظ جميع القوالب Resource Manager في الموقع المحدد. إذا لم يكن الفرع موجودا، يقوم مصنع البيانات بإنشائه تلقائيا. فيما يلي مثال لما يبدو عليه هذا الملف:

{
    "publishBranch": "factory/adf_publish"
}

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

إشعار

يقرأ publish_config.json Data Factory الملف فقط عندما يقوم بتحميل المصنع. إذا كان المصنع قد تم تحميله بالفعل في المدخل، فقم بتحديث المستعرض لجعل التغييرات الخاصة بك سارية المفعول.

نشر تغييرات التعليمات البرمجية

بعد دمج التغييرات في فرع التعاون (main وهو الافتراضي)، اختر النشر لنشر تغييرات الكود يدويا في الفرع الرئيسي إلى خدمة Data Factory.

سيتم فتح جزء جانبي حيث ستؤكد صحة فرع النشر والتغييرات المعلقة. بمجرد التحقق من التغييرات، اختر موافق لتأكيد النشر.

هام

الفرع الرئيسي لا يمثل ما يتم نشره في خدمة Data Factory. يجب نشر الفرع الرئيسي يدويًا لخدمة Data Factory.

أفضل الممارسات لتكامل Git

الأذونات

عادة لا تريد أن يكون لدى كل عضو في الفريق إذن لتحديث Data Factory. يوصى بإعدادات الأذونات التالية:

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

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

استخدام كلمات المرور من Azure Key Vault

يوصى باستخدام Azure Key Vault لتخزين أي سلاسل اتصال أو كلمات مرور أو إدارة التحقق من الهوية لخدمات Data Factory Linked. لأسباب أمنية، لا يقوم Data Factory بتخزين البيانات السرية في Git. أي تغييرات على الخدمات المرتبطة تحتوي على أسرار مثل كلمات المرور تنشر فورا إلى خدمة Azure Data Factory.

استخدام Key Vault أو إدارة الهوية يسهل أيضا التكامل المستمر والنشر لأنك لن تضطر لتقديم هذه الأسرار أثناء نشر قالب Resource Manager.

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

فرع النشر التي لا معنى لها

فيما يلي بعض الأمثلة على المواقف التي يمكن أن تتسبب في وجود فرع نشر قديم:

• المستخدم لديه فروع متعددة. في أحد فروع الميزات، حذفوا خدمة مرتبطة غير مرتبطة ب Azure Key Vault (AKV) (الخدمات غير المرتبطة ب AKV تنشر فورا بغض النظر عما إذا كانت في Git أم لا) ولم يدمجوا فرع الميزات في فرع التعاون.
• قام المستخدم بتعديل مصنع البيانات باستخدام SDK أو PowerShell
• قام مستخدم بنقل جميع الموارد إلى فرع جديد وحاول النشر لأول مرة. يجب إنشاء الخدمات المرتبطة يدويًا عند استيراد الموارد.
• يقوم المستخدم برفع خدمة غير مرتبطة ب AKV أو ملف JSON Integration Runtime يدويا. وهي تشير إلى هذا المورد من مورد آخر مثل مجموعة بيانات أو خدمة مرتبطة أو مسار. يتم نشر خدمة مرتبطة غير AKV تم إنشاؤها من خلال واجهة المستخدم على الفور لأن بيانات الاعتماد تحتاج إلى تشفير. إذا قمت بتحميل مجموعة بيانات تشير إلى تلك الخدمة المرتبطة وحاولت نشرها، فإن واجهة المستخدم تسمح بذلك لأنها موجودة في بيئة Git. سيتم رفضه عند وقت النشر لأنه غير موجود في خدمة مصنع البيانات.

إذا كان فرع النشر غير متزامن مع الفرع الرئيسي ويحتوي على موارد قديمة على الرغم من النشر الأخير، فيمكنك استخدام أي من الحلول التالية:

الخيار 1: استخدم وظيفة وضع الاستبدال المباشر

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

تدفق التعليمات البرمجية:فرع التعاون -> الوضع المباشر

الخيار 2: افصل مستودع Git وأعد توصيله

يستورد الرمز من الوضع المباشر إلى فرع التعاون. يعتبر الكود في الوضع المباشر مصدرًا للحقيقة.

تدفق التعليمات البرمجية:الوضع المباشر -> فرع التعاون

1. قم بإزالة مستودع Git الحالي الخاص بك
2. أعد تكوين Git بالإعدادات نفسها، ولكن تأكد من تحديد استيراد موارد Data Factory الحالية إلى المستودع واختر فرع تعاون (نفس الفرع)
3. أنشئ طلب سحب لدمج التغييرات في فرع التعاون.

إشعار

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

اختر أيا من الطريقتين بشكل مناسب حسب الحاجة.

تظهر جميع الموارد على أنها جديدة عند النشر

أثناء النشر، قد تظهر جميع الموارد كجديدة حتى لو تم نشرها مسبقا. يمكن أن يحدث هذا إذا أعيد تعيين خاصية lastCommitId على خاصية المصنع repoConfiguration إما عن طريق إعادة توزيع قالب مصنع ARM أو تحديث خاصية repoConfiguration للمصنع من خلال PowerShell أو واجهة برمجة تطبيقات REST. يمكن أن يؤدي الاستمرار في نشر الموارد إلى حل المشكلة، ولكن لمنع حدوثها مرة أخرى، تجنب تحديث خاصية تكوين مستودع المصنع.

التبديل إلى مستودع Git مختلف

للتبديل إلى مستودع Git مختلف، انتقل إلى صفحة تكوين Git في مركز الإدارة ضمن التحكم بالمصادر. حدد قطع الاتصال.

أدخل اسم مصنع البيانات الخاص بك واختر تأكيد لإزالة مستودع Git المرتبط بمصنع بياناتك.

بعد إزالة الاقتران مع المستودع الحالي، يمكنك تكوين إعدادات Git لاستخدام مستودع مختلف ثم استيراد موارد Data Factory الموجودة إلى المستودع الجديدة.

هام

لا تؤدي إزالة تكوين Git من مصنع البيانات إلى حذف أي شيء من المستودع. يحتوي المصنع على جميع الموارد المنشورة. ويمكنك الاستمرار في تحرير المصنع مباشرةً مقابل الخدمة.

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

• لمعرفة المزيد حول مراقبة وإدارة مسارات، راجع مراقبة وإدارة مسارات برمجيًا .
• لتنفيذ التكامل والنشر المستمر، انظر التكامل والتسليم المستمر (CI/CD) في Azure Data Factory.