تحديث إصدارات مكدس اللغة في Azure Functions

مقالة
07/06/2024

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

تعتمد الطريقة التي تقوم بها بتحديث تطبيق الوظائف على:

اللغة التي تستخدمها لتأليف وظائفك؛ تأكد من اختيار لغة البرمجة في أعلى المقالة.
نظام التشغيل الذي يعمل عليه تطبيقك في Azure: Windows أو Linux.
خطة الاستضافة.

إشعار

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

الاستعداد للتحديث

قبل تحديث تكوين المكدس لتطبيق الوظائف في Azure، يجب إكمال هذه المهام:

1. تحقق من وظائفك محليا

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

استخدم هذه الخطوات لتحديث المشروع على الكمبيوتر المحلي:

تأكد من تثبيت الإصدار الهدف من .NET SDK.

إذا كنت تستهدف إصدار معاينة، فراجع إرشادات الوظائف لمعاينة إصدارات .NET للتأكد من دعم الإصدار. قد تكون هناك حاجة إلى خطوات إضافية لمعاينات .NET.
قم بتحديث مراجعك إلى أحدث إصدارات: Microsoft.Azure.Functions.Worker وMicrosoft.Azure.Functions.Worker.Sdk .
تحديث إطار العمل المستهدف لمشروعك إلى الإصدار الجديد. بالنسبة لمشاريع C#، يجب تحديث <TargetFramework> العنصر في .csproj الملف. راجع أطر العمل الهدف للحصول على تفاصيل تتعلق بالإصدار المختار.

قد يتطلب تغيير إطار العمل المستهدف لمشروعك أيضا تغييرات على أجزاء من سلسلة الأدوات الخاصة بك، خارج التعليمات البرمجية للمشروع. على سبيل المثال، في VS Code، قد تحتاج إلى تحديث إعداد الملحق azureFunctions.deploySubpath من خلال إعدادات المستخدم أو ملف المشروع .vscode/settings.json . تحقق من وجود أي تبعيات على إصدار إطار العمل قد تكون موجودة خارج التعليمات البرمجية لمشروعك، كجزء من خطوات الإنشاء أو مسار CI/CD.
قم بإجراء أي تحديثات على التعليمات البرمجية لمشروعك المطلوبة من قبل إصدار .NET الجديد. تحقق من ملاحظات إصدار الإصدار للحصول على تفاصيل. يمكنك أيضا استخدام مساعد ترقية .NET لمساعدتك في تحديث التعليمات البرمجية استجابة للتغييرات عبر الإصدارات الرئيسية.

بعد إجراء هذه التغييرات، أعد إنشاء مشروعك واختبره لتأكيد تشغيل تطبيقك كما هو متوقع.

2. الانتقال إلى أحدث وقت تشغيل للدالات

تأكد من تشغيل تطبيق الوظائف على أحدث إصدار من وقت تشغيل الوظائف (الإصدار 4.x). يمكنك تحديد إصدار وقت التشغيل إما في مدخل Microsoft Azure أو باستخدام Azure CLI.

مدخل Microsoft Azure
Azure CLI

استخدم هذه الخطوات لتحديد إصدار وقت تشغيل الوظائف:

في مدخل Microsoft Azure، حدد موقع تطبيق الوظائف وحدد Configuration على الجانب الأيسر ضمن Settings.
حدد علامة التبويب إعدادات وقت تشغيل الدالة وتحقق من قيمة إصدار وقت التشغيل لمعرفة ما إذا كان تطبيق الوظائف قيد التشغيل على الإصدار 4.x من وقت تشغيل الوظائف (~4).

استخدم هذا az functionapp config appsettings list الأمر للتحقق من إصدار وقت التشغيل:

az functionapp config appsettings list --name "<FUNCTION_APP_NAME>" --resource-group "<RESOURCE_GROUP_NAME>"

يعين FUNCTIONS_EXTENSION_VERSION الإعداد إصدار وقت التشغيل. تعني القيمة ~4 أن تطبيق الوظائف الخاص بك يعمل بالفعل على أحدث إصدار ثانوي من أحدث إصدار رئيسي (4.x).

إذا كنت بحاجة إلى تحديث تطبيق الوظائف أولا إلى الإصدار 4.x، فشاهد ترحيل التطبيقات من الإصدار 1.x من Azure Functions إلى الإصدار 4.x أو ترحيل التطبيقات من Azure Functions الإصدار 3.x إلى الإصدار 4.x. يجب اتباع الإرشادات الواردة في هذه المقالات بدلا من تغيير FUNCTIONS_EXTENSION_VERSION الإعداد فقط.

نشر تحديثات التطبيق

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

تلميح

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

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

تحديث تكوين المكدس

تعتمد الطريقة التي تقوم بها بتحديث تكوين المكدس على ما إذا كنت تعمل على Windows أو على Linux في Azure.

عند استخدام فتحة التقسيم المرحلي، تأكد من استهداف التحديثات بالفتحة الصحيحة.

استخدم الخطوات التالية لتحديث إصدار Java:

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

استخدم الخطوات التالية لتحديث إصدار .NET:

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

استخدم الخطوات التالية لتحديث إصدار Node.js:

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

استخدم الخطوات التالية لتحديث إصدار PowerShell:

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

تطبيقات Python غير مدعومة على Windows. حدد علامة التبويب Linux بدلا من ذلك.

إشعار

يمكنك فقط استخدام مدخل Microsoft Azure لتحديث تطبيقات الوظائف على Linux المستضافة في خطة Premium أو خطة مخصصة (خدمة التطبيقات). بالنسبة للتطبيقات على Linux المستضافة في خطة الاستهلاك، يجب عليك بدلا من ذلك استخدام Azure CLI.

استخدم الخطوات التالية لتحديث إصدار Java:

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

استخدم الخطوات التالية لتحديث إصدار .NET:

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

استخدم الخطوات التالية لتحديث إصدار Node.js:

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

استخدم الخطوات التالية لتحديث إصدار PowerShell:

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

تطبيقات Python غير مدعومة على Windows. حدد علامة التبويب Linux بدلا من ذلك.

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

إشعار

لا يمكنك تغيير إصدار Python عند التشغيل في خطة Consumption.
حدد حفظ وعند إعلامك بإعادة التشغيل، حدد متابعة.

تطبيقات Python غير مدعومة على Windows. حدد علامة التبويب Linux بدلا من ذلك.

أولا، استخدم az functionapp list-runtimes الأمر لعرض قيم الإصدار المدعومة للغة الخاصة بك. ثم قم بتشغيل az functionapp config set الأمر لتحديث إصدار اللغة من تطبيق الوظائف:

az functionapp list-runtimes قم بتشغيل الأمر لعرض قيم الإصدار المدعومة ل .NET على نموذج العامل المعزول:

az functionapp list-runtimes --os "windows" --query "[?runtime == 'java'].{Version:version}" --output table

az functionapp config set --java-version "<VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

az functionapp list-runtimes --os "windows" --query "[?runtime == 'dotnet-isolated'].{Version:version}" --output table

az functionapp config set قم بتشغيل الأمر لتحديث إصدار .NET من تطبيق الوظائف الخاص بك:

az functionapp config set --net-framework-version "v<VERSION>.0" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

أولا، استخدم az functionapp list-runtimes الأمر لعرض قيم الإصدار المدعومة لمكدس اللغة (Node.js). ثم قم بتشغيل az functionapp config set الأمر لتحديث الإصدار Node.js من تطبيق الوظائف:

az functionapp list-runtimes --os "windows" --query "[?runtime == 'node'].{Version:version}" --output table

az functionapp config appsettings set --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --settings "WEBSITE_NODE_DEFAULT_VERSION=~<VERSION>" --slot "staging"

az functionapp list-runtimes --os "windows" --query "[?runtime == 'powershell'].{Version:version}" --output table

az functionapp config set --powershell-version "<VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

في هذا المثال، استبدل <APP_NAME> و <RESOURCE_GROUP> باسم تطبيق الوظائف ومجموعة الموارد، على التوالي. استبدل <VERSION> أيضا بإصدار اللغة المدعوم الذي تقوم بالتحديث إليه. إذا كنت لا تستخدم فتحة تقسيم مرحلي، فقم بإزالة المعلمة --slot .

إشعار

لا يمكنك تغيير إصدار Python عند التشغيل في خطة Consumption.

az functionapp list-runtimes قم بتشغيل الأمر لعرض إعداد الموقع المدعوم linuxFxVersion لإصدار اللغة:

az functionapp list-runtimes قم بتشغيل الأمر لعرض إعداد الموقع المدعوم linuxFxVersion لإصدار مكدس اللغة:

az functionapp list-runtimes --os linux --query "[?runtime == 'python'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'dotnet-isolated'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'node'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'python'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp list-runtimes --os linux --query "[?runtime == 'powershell'].{Version:version, linuxFxVersion:linux_fx_version}" --output table

az functionapp config set قم بتشغيل الأمر لتحديث إعداد الموقع لإصدار اللغة الجديد من تطبيق الوظائف:

az functionapp config set قم بتشغيل الأمر لتحديث إعداد الموقع لإصدار المكدس الجديد من تطبيق الوظائف:

az functionapp config set --linux-fx-version "<LANGUAGE|VERSION>" --name "<APP_NAME>" --resource-group "<RESOURCE_GROUP>" --slot "staging"

في هذا المثال، استبدل <APP_NAME> و <RESOURCE_GROUP> باسم تطبيق الوظائف ومجموعة الموارد، على التوالي. استبدل <LANGUAGE|VERSION> أيضا بالتحديث linuxFxVersion الخاص بك. إذا كنت لا تستخدم فتحة تقسيم مرحلي، فقم بإزالة المعلمة --slot .

يتم إعادة تشغيل تطبيق الوظائف بعد تحديث الإصدار.

فتحات المبادلة

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