النشر المستمر لدالات Azure

تمكنك Azure Functions من نشر التغييرات التي تم إجراؤها في مستودع التحكم بالمصادر باستمرار إلى تطبيق وظائف متصل. يتيح تكامل التحكم بالمصادر هذا سير عمل يقوم فيه تحديث التعليمات البرمجية بتشغيل الإنشاء والتعبئة والنشر من مشروعك إلى Azure.

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

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

تدعم الوظائف هذه المصادر للتوزيع المستمر لتطبيقك:

Azure Repos

الاحتفاظ بالتعليمات البرمجية لمشروعك في Azure Repos، إحدى الخدمات في Azure DevOps. يدعم كل من Git والتحكم في إصدار Team Foundation. يستخدم مع موفر إنشاء Azure Pipelines. لمزيد من المعلومات، راجع ما هو Azure Repos؟

GitHub

الاحتفاظ بالتعليمات البرمجية لمشروعك في GitHub. مدعوم من قبل جميع موفري البنية. لمزيد من المعلومات، راجع مستندات GitHub.

GitHub هو مصدر النشر المستمر الوحيد المدعوم للتطبيقات التي تعمل على Linux في خطة Consumption، والتي تتضمن تطبيقات Python بلا خادم.

Bitbucket

الاحتفاظ بالتعليمات البرمجية لمشروعك في Bitbucket. يتطلب موفر إنشاء App Service.

Git المحلي

الاحتفاظ بالتعليمات البرمجية لمشروعك في خادم Git مخصص مستضاف في نفس خطة App Service مع تطبيق الوظائف الخاص بك. يتطلب موفر إنشاء App Service. لمزيد من المعلومات، راجع نشر Git المحلي إلى Azure App Service.

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

إشعار

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

المتطلبات

وحدة نشر الدالات في Azure هي تطبيق الدالة. لكي ينجح النشر المستمر، يجب أن تكون بنية الدليل لمشروعك متوافقة مع بنية المجلد الأساسية التي تتوقعها Azure Functions. عند إنشاء مشروع التعليمات البرمجية باستخدام Azure Functions Core Tools أو Visual Studio Code أو Visual Studio، يتم استخدام قوالب Azure Functions لإنشاء مشاريع التعليمات البرمجية باستخدام بنية الدليل الصحيحة. يتم نشر جميع الوظائف في تطبيق الوظائف في نفس الوقت وفي نفس الحزمة.

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

إشعار

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

تحديد موفر بناء

يعد إنشاء مشروع التعليمات البرمجية جزءا من عملية التوزيع. تعتمد عملية الإنشاء المحددة على مكدس اللغة ونظام التشغيل وخطة الاستضافة المحددة. يمكن إجراء الإصدارات محليا أو عن بعد، مرة أخرى اعتمادا على استضافتك المحددة. لمزيد من المعلومات، راجع Remote build.

هام

لزيادة الأمان، ضع في اعتبارك استخدام موفر بناء يدعم الهويات المدارة، بما في ذلك Azure Pipelines وGitub Actions. تتطلب خدمة App Service (Kudu) تمكين المصادقة الأساسية والعمل مع بيانات الاعتماد المستندة إلى النص.

تدعم الوظائف موفري البناء هؤلاء:

مسارات Azure

Azure Pipelines هي إحدى الخدمات في Azure DevOps وموفر البناء الافتراضي لمشاريع Azure Repos. يمكنك أيضا استخدام Pipelines لإنشاء مشاريع من GitHub. في Pipelines، هناك مهمة مصممة AzureFunctionApp خصيصا للتوزيع إلى Azure Functions. توفر لك هذه المهمة التحكم في كيفية إنشاء المشروع وتعبئته ونشره. يدعم الهويات المدارة.

GitHub Actions

GitHub Actions هو موفر البناء الافتراضي لمشاريع GitHub. يوفر لك GitHub Actions التحكم في كيفية بناء المشروع وتعبئته ونشره. يدعم الهويات المدارة.

خدمة App Service (Kudu)

يحتفظ النظام الأساسي لخدمة التطبيقات بخدمة توزيع أصلية (Project Kudu) لدعم نشر Git المحلي وبعض عمليات نشر الحاويات ومصادر التوزيع الأخرى غير المدعومة من قبل البنية الأساسية لبرنامج ربط العمليات التجارية أو إجراءات GitHub. يتم تنفيذ البنيات عن بعد والتعبئة ومهام الصيانة الأخرى في مجال scm.azurewebsites.net فرعي مخصص لتطبيقك، مثل https://myfunctionapp.scm.azurewebsites.net. يمكن استخدام خدمة الإنشاء هذه فقط عندما scm يمكن الوصول إلى الموقع من خلال النشر الخاص بك. تتطلب العديد من أدوات النشر مصادقة أساسية للاتصال بنقطة scm النهاية، ما يعني أنه لا يمكنك استخدام الهويات المدارة.

يتم استخدام موفر البناء هذا عند نشر مشروع التعليمات البرمجية باستخدام Visual Studio أو Visual Studio Code أو Azure Functions Core Tools. إذا لم تكن قد قمت بالفعل بنشر التعليمات البرمجية إلى تطبيق الوظائف باستخدام إحدى هذه الأدوات، فقد تحتاج إلى تمكين المصادقة الأساسية للتوزيع لاستخدام scm الموقع.

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

قم بتكوين مسار التوزيع المستمر

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

في مدخل Microsoft Azure، استعرض للوصول إلى صفحة تطبيق الوظائف وحدد Deployment Center ضمن Deployment في الجزء الأيمن.

حدد نوع مستودع المصدر حيث يتم الاحتفاظ بالتعليمات البرمجية للمشروع من أحد هذه الخيارات المدعومة:

Azure Repos

يتم تعريف عمليات التوزيع من Azure Repos التي تستخدم Azure Pipelines في مدخل Azure DevOps وليس من تطبيق الوظائف. للحصول على دليل خطوة بخطوة لإنشاء نشر يستند إلى البنية الأساسية لبرنامج ربط العمليات التجارية من Azure Repos، راجع التسليم المستمر باستخدام Azure Pipelines.

GitHub

يتم تعريف عمليات النشر من GitHub التي تستخدم Azure Pipelines في مدخل Azure DevOps وليس من تطبيق الوظائف. للحصول على دليل خطوة بخطوة لإنشاء نشر يستند إلى البنية الأساسية لبرنامج ربط العمليات التجارية من GitHub، راجع التسليم المستمر باستخدام Azure Pipelines.

Bitbucket

لا يمكنك النشر من Bitbucket باستخدام Azure Pipelines. بدلا من ذلك، اختر موفر إنشاء App Service.

Git المحلي

لا يمكنك النشر من git المحلي باستخدام Azure Pipelines. بدلا من ذلك، اختر موفر إنشاء App Service.

Azure Repos

لا يمكنك النشر من Azure Repos باستخدام GitHub Actions. اختر موفر بناء مختلفا.

GitHub

لإضافة سير عمل GitHub Actions إلى تطبيق وظائف موجود:

1. انتقل إلى تطبيق الوظائف في مدخل Microsoft Azure وحدد Deployment Center.

2. بالنسبة للمصدر، حدد GitHub. إذا لم تشاهد الرسالة الافتراضية Building with GitHub Actions، فحدد Change provider اختر GitHub Actions وحدد OK.

3. إذا لم تكن قد أذنت بالفعل بوصول GitHub، فحدد Authorize. قم بتوفير بيانات اعتماد GitHub وحدد تسجيل الدخول. لتخويل حساب GitHub مختلف، حدد تغيير الحساب وسجل الدخول باستخدام حساب آخر.

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

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

6. حدد معاينة الملف لمشاهدة ملف سير العمل الذي تتم إضافته إلى مستودع GitHub في github/workflows/.

7. حدد حفظ لإضافة ملف سير العمل إلى المستودع الخاص بك.

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

Bitbucket

لا يمكنك النشر من Bitbucket باستخدام GitHub Actions. بدلا من ذلك، اختر موفر إنشاء App Service.

Git المحلي

لا يمكنك النشر من git المحلي باستخدام GitHub Actions. بدلا من ذلك، اختر موفر إنشاء App Service.

Azure Repos

1. انتقل إلى تطبيق الوظائف في مدخل Microsoft Azure وحدد Deployment Center.

2. بالنسبة للمصدر، حدد Azure Repos. إذا لم يكن موفر خدمة إنشاء App Service هو الافتراضي، فحدد Change provider اختر App Service build service وحدد OK.

3. حدد قيم المؤسسة والمشروع والمستودع والفرع. يتم عرض المؤسسات التي تنتمي إلى حساب Azure الخاص بك فقط.

4. حدد حفظ لإنشاء خطاف الويب في المستودع الخاص بك.

GitHub

1. انتقل إلى تطبيق الوظائف في مدخل Microsoft Azure وحدد Deployment Center.

2. بالنسبة للمصدر، حدد GitHub. إذا لم يكن موفر خدمة إنشاء App Service هو الافتراضي، فحدد Change provider اختر App Service build service وحدد OK.

3. إذا لم تكن قد أذنت بالفعل بوصول GitHub، فحدد Authorize. قم بتوفير بيانات اعتماد GitHub وحدد تسجيل الدخول. إذا كنت بحاجة إلى تخويل حساب GitHub مختلف، فحدد تغيير الحساب وتسجيل الدخول باستخدام حساب آخر.

4. حدد قيم المؤسسة والمستودع والفرع. تستند القيم إلى موقع التعليمات البرمجية.

5. راجع جميع التفاصيل وحدد حفظ. يتم وضع إخطار على الويب في المستودع الذي اخترته.

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

Bitbucket

1. انتقل إلى تطبيق الوظائف في مدخل Microsoft Azure وحدد Deployment Center.

2. بالنسبة للمصدر، حدد Bitbucket.

3. إذا لم تكن قد أذنت بالفعل بوصول Bitbucket، فحدد Authorize ثم Grant access. إذا طلب منك ذلك، فقم بتوفير بيانات اعتماد Bitbucket وحدد تسجيل الدخول. إذا كنت بحاجة إلى تخويل حساب Bitbucket مختلف، فحدد تغيير الحساب وتسجيل الدخول باستخدام حساب آخر.

4. حدد قيم المؤسسة والمستودع والفرع. تستند القيم إلى موقع التعليمات البرمجية.

5. راجع جميع التفاصيل وحدد حفظ. يتم وضع إخطار على الويب في المستودع الذي اخترته.

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

Git المحلي

1. انتقل إلى تطبيق الوظائف في مدخل Microsoft Azure وحدد Deployment Center.

2. بالنسبة للمصدر، حدد Local Git وحدد Save.

3. يتم إنشاء مستودع محلي في خطة App Service الحالية، والتي يتم الوصول إليها من scm المجال. انسخ Git clone URI واستخدمه لإنشاء نسخة من هذا المستودع الجديد على الكمبيوتر المحلي.

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

بعد اكتمال النشر، يتم نشر جميع التعليمات البرمجية من المصدر المحدد إلى تطبيقك. عند هذه المرحلة، تؤدي التغييرات في مصدر النشر إلى نشر هذه التغييرات على تطبيق الدالة في Azure.

تمكين النشر المستمر أثناء إنشاء التطبيق

حاليا، يمكنك تكوين النشر المستمر من GitHub باستخدام إجراءات GitHub عند إنشاء تطبيق الوظائف في مدخل Microsoft Azure. يمكنك القيام بذلك على علامة التبويب Deployment في صفحة Create Function App .

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

تمكين المصادقة الأساسية للتوزيع

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

هام

عند استخدام المصادقة الأساسية، يتم إرسال بيانات الاعتماد في نص واضح. لحماية بيانات الاعتماد هذه، يجب عليك فقط الوصول إلى scm نقطة النهاية عبر اتصال مشفر (HTTPS) عند استخدام المصادقة الأساسية. لمزيد من المعلومات، راجع النشر الآمن.

لتمكين المصادقة الأساسية إلى scm نقطة النهاية:

مدخل Microsoft Azure

1. انتقل إلى تطبيق الوظائف الجديد في مدخل Azure.

2. في القائمة اليسرى للتطبيق، قم بتحديدConfiguration>إعدادات عامة.

3. قم بتعيين بيانات اعتماد نشر المصادقة الأساسية ل SCM إلى تشغيل، ثم حدد حفظ.

Azure CLI

يمكنك استخدام Azure CLI لتشغيل المصادقة الأساسية باستخدام هذا az resource update الأمر لتحديث المورد الذي يتحكم في scm نقطة النهاية.

az resource update --resource-group <RESOURCE_GROUP> --name scm --namespace Microsoft.Web --resource-type basicPublishingCredentialsPolicies --parent sites/<APP_NAME> --set properties.allow=true

في هذا الأمر، استبدل العناصر النائبة باسم مجموعة الموارد واسم التطبيق.

الخطوات التالية

أفضل الممارسات في Azure Functions