ترحيل التطبيقات من Azure Functions الإصدار 3.x إلى الإصدار 4.x
Azure Functions الإصدار 4.x متوافقة للغاية مع الإصدارات القديمة حتى الإصدار 3.x. يجب ترحيل معظم التطبيقات بأمان إلى 4.x دون الحاجة إلى تغييرات كبيرة في التعليمات البرمجية. لمزيد من المعلومات حول إصدارات وقت تشغيل الوظائف، راجع نظرة عامة على إصدارات وقت تشغيل Azure Functions.
هام
اعتبارا من 13 ديسمبر 2022، وصلت تطبيقات الوظائف التي تعمل على الإصدارين 2.x و3.x من وقت تشغيل Azure Functions إلى نهاية الدعم الموسع. لمزيد من المعلومات، راجع الإصدارات المتوقفة.
ترشدك هذه المقالة خلال عملية ترحيل تطبيق الوظائف بأمان للتشغيل على الإصدار 4.x من وقت تشغيل الوظائف. نظرا لأن إرشادات ترحيل المشروع تعتمد على اللغة، فتأكد من اختيار لغة التطوير من المحدد في أعلى المقالة.
تحديد تطبيقات الوظائف المراد ترحيلها
استخدم البرنامج النصي PowerShell التالي لإنشاء قائمة بتطبيقات الوظائف في اشتراكك التي تستهدف حاليا الإصدارات 2.x أو 3.x:
$Subscription = '<YOUR SUBSCRIPTION ID>'
Set-AzContext -Subscription $Subscription | Out-Null
$FunctionApps = Get-AzFunctionApp
$AppInfo = @{}
foreach ($App in $FunctionApps)
{
if ($App.ApplicationSettings["FUNCTIONS_EXTENSION_VERSION"] -like '*3*')
{
$AppInfo.Add($App.Name, $App.ApplicationSettings["FUNCTIONS_EXTENSION_VERSION"])
}
}
$AppInfo
اختر إصدار .NET المستهدف
في الإصدار 3.x من وقت تشغيل الوظائف، يستهدف تطبيق وظائف C# .NET Core 3.1 باستخدام النموذج قيد المعالجة أو .NET 5 باستخدام نموذج العامل المعزول.
عند ترحيل تطبيق الوظائف، ستتوفر لديك الفرصة لاختيار الإصدار الهدف من .NET. يمكنك تحديث مشروع C# إلى أحد الإصدارات التالية من .NET التي يدعمها الإصدار 4.x من Functions:
| إصدار .NET | نوع إصدار نهج الدعم الرسمي ل .NET | نموذجمعالجة الوظائف 1,2 |
|---|---|---|
| .NET 8 | LTS (نهاية الدعم في 10 نوفمبر 2026) | نموذج عامل معزول، النموذجقيد المعالجة 2,3 |
| .NET 6 | LTS (نهاية الدعم في 12 نوفمبر 2024) | نموذج عامل معزول، النموذجقيد المعالجة 2 |
| .NET Framework 4.8 | راجع النهج | نموذج عامل معزول |
1يدعم نموذج العامل المعزول إصدارات الدعم طويل الأجل (LTS) ودعم المصطلحات القياسية (STS) من .NET، بالإضافة إلى .NET Framework. يدعم النموذج قيد المعالجة إصدارات LTS من .NET فقط، وتنتهي ب .NET 8. للحصول على مقارنة كاملة للميزات والوظائف بين النموذجين، راجع الاختلافات بين العملية قيد المعالجة وعزل وظائف .NET Azure.
2 ينتهي الدعم للنموذج قيد المعالجة في 10 نوفمبر 2026. لمزيد من المعلومات، راجع إعلان الدعم هذا. للحصول على الدعم الكامل المستمر، يجب ترحيل تطبيقاتك إلى نموذج العامل المعزول.
3 لم يتم تمكين استهداف .NET 8 باستخدام النموذج قيد المعالجة لنظام Linux، أو للتطبيقات المستضافة في بيئات خدمة التطبيقات، أو للتطبيقات في السحب السيادية. سيتم توصيل التحديثات على مؤشر ترابط التعقب هذا على GitHub.
تلميح
نوصي بالتحديث إلى .NET 8 على نموذج العامل المعزول. .NET 8 هو الإصدار الذي تم إصداره بالكامل مع أطول نافذة دعم من .NET.
على الرغم من أنه يمكنك اختيار استخدام النموذج قيد المعالجة بدلا من ذلك، لا يوصى بذلك إذا كان من الممكن تجنبه. سينتهي الدعم للنموذج قيد المعالجة في 10 نوفمبر 2026، لذلك ستحتاج إلى الانتقال إلى نموذج العامل المعزول قبل ذلك. سيؤدي القيام بذلك أثناء الترحيل إلى الإصدار 4.x إلى تقليل إجمالي الجهد المطلوب، وسيمنح نموذج العامل المعزول تطبيقك فوائد إضافية، بما في ذلك القدرة على استهداف الإصدارات المستقبلية من .NET بسهولة أكبر. إذا كنت تنتقل إلى نموذج العامل المعزول، يمكن لمساعد ترقية .NET أيضا معالجة العديد من تغييرات التعليمات البرمجية الضرورية لك.
لا يقدم هذا الدليل أمثلة محددة ل .NET 6. إذا كنت بحاجة إلى استهداف هذا الإصدار، يمكنك تكييف أمثلة .NET 8.
التجهيز للترحيل
إذا لم تكن قد قمت بذلك بالفعل، فحدد قائمة التطبيقات التي تحتاج إلى ترحيل في اشتراك Azure الحالي باستخدام Azure PowerShell.
قبل ترحيل تطبيق إلى الإصدار 4.x من وقت تشغيل الوظائف، يجب عليك القيام بالمهام التالية:
- راجع قائمة التغييرات العاجلة بين الإصدارات 3.x و4.x.
- أكمل الخطوات الواردة في ترحيل مشروعك المحلي لترحيل مشروعك المحلي إلى الإصدار 4.x.
- بعد ترحيل المشروع، اختبر التطبيق بالكامل محليا باستخدام الإصدار 4.x من Azure Functions Core Tools.
- قم بتشغيل مدقق ما قبل الترقية على التطبيق المستضاف في Azure، وحل أي مشكلات محددة.
- تحديث تطبيق الوظائف في Azure إلى الإصدار الجديد. إذا كنت بحاجة إلى تقليل وقت التعطل، ففكر في استخدام فتحة التقسيم المرحلي لاختبار التطبيق الذي تم ترحيله والتحقق من صحته في Azure على إصدار وقت التشغيل الجديد. ومن ثَم يمكنك نشر تطبيقك مع إعدادات الإصدار المحدثة إلى فتحة الإنتاج. لمزيد من المعلومات، راجع التحديث باستخدام الفتحات.
- انشر مشروعك الذي تم ترحيله إلى تطبيق الوظائف المحدث.
عند استخدام Visual Studio لنشر مشروع إصدار 4.x إلى تطبيق دالة موجود في إصدار أقل، تتم مطالبتك بلسماح ل Visual Studio بتحديث تطبيق الوظائف إلى الإصدار 4.x أثناء النشر. يستخدم هذا التحديث نفس العملية المحددة في التحديث بدون فتحات.
ترحيل مشروعك المحلي
تعتمد تعليمات الترقية على اللغة. إذا لم تتمكن من رؤية لغتك، فاخترها من المحدد في أعلى المقالة.
اختر علامة التبويب التي تطابق الإصدار الهدف من .NET ونموذج العملية المطلوب (عملية عامل قيد المعالجة أو معزولة).
تلميح
إذا كنت تنتقل إلى إصدار LTS أو STS من .NET باستخدام نموذج العامل المعزول، يمكن استخدام مساعد ترقية .NET لإجراء العديد من التغييرات المذكورة في الأقسام التالية تلقائيا.
ملف المشروع
المثال التالي هو .csproj ملف مشروع يستخدم .NET Core 3.1 على الإصدار 3.x:
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>netcoreapp3.1</TargetFramework>
<AzureFunctionsVersion>v3</AzureFunctionsVersion>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Microsoft.NET.Sdk.Functions" Version="3.0.13" />
</ItemGroup>
<ItemGroup>
<Reference Include="Microsoft.CSharp" />
</ItemGroup>
<ItemGroup>
<None Update="host.json">
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
</None>
<None Update="local.settings.json">
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
<CopyToPublishDirectory>Never</CopyToPublishDirectory>
</None>
</ItemGroup>
</Project>
استخدم أحد الإجراءات التالية لتحديث ملف XML هذا لتشغيله في Functions الإصدار 4.x:
تفترض هذه الخطوات مشروع C# محليا، وإذا كان تطبيقك يستخدم بدلا من ذلك برنامج C# النصي (.csx ملفات)، فيجب عليك التحويل إلى نموذج المشروع قبل المتابعة.
التغييرات التالية مطلوبة في .csproj ملف مشروع XML:
تعيين قيمة
PropertyGroup.TargetFrameworkإلىnet8.0.تعيين قيمة
PropertyGroup.AzureFunctionsVersionإلىv4.أضف العنصر التالي
OutputTypeإلىPropertyGroup:<OutputType>Exe</OutputType>في
ItemGroup.PackageReferenceاستبدل مرجع الحزمة بالمراجعMicrosoft.NET.Sdk.Functionsالتالية:<FrameworkReference Include="Microsoft.AspNetCore.App" /> <PackageReference Include="Microsoft.Azure.Functions.Worker" Version="1.21.0" /> <PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" Version="1.17.2" /> <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore" Version="1.2.1" /> <PackageReference Include="Microsoft.ApplicationInsights.WorkerService" Version="2.22.0" /> <PackageReference Include="Microsoft.Azure.Functions.Worker.ApplicationInsights" Version="1.2.0" />دون أي مراجع إلى حزم أخرى في
Microsoft.Azure.WebJobs.*مساحات الأسماء. ستستبدل هذه الحزم في خطوة لاحقة.أضف الجديد
ItemGroupالتالي:<ItemGroup> <Using Include="System.Threading.ExecutionContext" Alias="ExecutionContext"/> </ItemGroup>
بعد إجراء هذه التغييرات، يجب أن يبدو مشروعك المحدث مثل المثال التالي:
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net8.0</TargetFramework>
<AzureFunctionsVersion>v4</AzureFunctionsVersion>
<RootNamespace>My.Namespace</RootNamespace>
<OutputType>Exe</OutputType>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
</PropertyGroup>
<ItemGroup>
<FrameworkReference Include="Microsoft.AspNetCore.App" />
<PackageReference Include="Microsoft.Azure.Functions.Worker" Version="1.21.0" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" Version="1.17.2" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore" Version="1.2.1" />
<PackageReference Include="Microsoft.ApplicationInsights.WorkerService" Version="2.22.0" />
<PackageReference Include="Microsoft.Azure.Functions.Worker.ApplicationInsights" Version="1.2.0" />
<!-- Other packages may also be in this list -->
</ItemGroup>
<ItemGroup>
<None Update="host.json">
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
</None>
<None Update="local.settings.json">
<CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
<CopyToPublishDirectory>Never</CopyToPublishDirectory>
</None>
</ItemGroup>
<ItemGroup>
<Using Include="System.Threading.ExecutionContext" Alias="ExecutionContext"/>
</ItemGroup>
</Project>
تغييرات الحزمة ومساحة الاسم
استنادا إلى النموذج الذي تقوم بالترحيل إليه، قد تحتاج إلى تحديث أو تغيير الحزم التي يشير إليها التطبيق الخاص بك. عند اعتماد الحزم الهدف، تحتاج بعد ذلك إلى تحديث مساحة الاسم لاستخدام عبارات وبعض الأنواع التي تشير إليها. يمكنك مشاهدة تأثير تغييرات مساحة الاسم هذه على using العبارات في أمثلة قالب مشغل HTTP لاحقا في هذه المقالة.
إذا لم تكن قد قمت بالفعل، فقم بتحديث مشروعك للإشارة إلى أحدث الإصدارات الثابتة من:
استنادا إلى المشغلات والروابط التي يستخدمها تطبيقك، قد يحتاج تطبيقك إلى الرجوع إلى مجموعة مختلفة من الحزم. يعرض الجدول التالي الاستبدالات لبعض الملحقات الأكثر استخداما:
| السيناريو | التغييرات التي تم إجراؤها على مراجع الحزمة |
|---|---|
| مشغل المؤقت | إضافة Microsoft.Azure.Functions.Worker.Extensions.Timer |
| روابط التخزين | الاستبدالMicrosoft.Azure.WebJobs.Extensions.Storageمع Microsoft.Azure.Functions.Worker.Extensions.Storage.Blobs، Microsoft.Azure.Functions.Worker.Extensions.Storage.Queues، و Microsoft.Azure.Functions.Worker.Extensions.Tables |
| روابط الكائن الثنائي كبير الحجم | استبدال المراجع بMicrosoft.Azure.WebJobs.Extensions.Storage.Blobsمع أحدث إصدار من Microsoft.Azure.Functions.Worker.Extensions.Storage.Blobs |
| روابط قائمة الانتظار | استبدال المراجع بMicrosoft.Azure.WebJobs.Extensions.Storage.Queuesمع أحدث إصدار من Microsoft.Azure.Functions.Worker.Extensions.Storage.Queues |
| روابط الجدول | استبدال المراجع بMicrosoft.Azure.WebJobs.Extensions.Tablesمع أحدث إصدار من Microsoft.Azure.Functions.Worker.Extensions.Tables |
| روابط Cosmos DB | استبدال المراجع بMicrosoft.Azure.WebJobs.Extensions.CosmosDBو/أو Microsoft.Azure.WebJobs.Extensions.DocumentDBمع أحدث إصدار من Microsoft.Azure.Functions.Worker.Extensions.CosmosDB |
| روابط ناقل خدمة Microsoft Azure | استبدال المراجع بMicrosoft.Azure.WebJobs.Extensions.ServiceBusمع أحدث إصدار من Microsoft.Azure.Functions.Worker.Extensions.ServiceBus |
| روابط مراكز الأحداث | استبدال المراجع بMicrosoft.Azure.WebJobs.Extensions.EventHubsمع أحدث إصدار من Microsoft.Azure.Functions.Worker.Extensions.EventHubs |
| روابط شبكة الأحداث | استبدال المراجع بMicrosoft.Azure.WebJobs.Extensions.EventGridمع أحدث إصدار من Microsoft.Azure.Functions.Worker.Extensions.EventGrid |
| روابط خدمة SignalR | استبدال المراجع بMicrosoft.Azure.WebJobs.Extensions.SignalRServiceمع أحدث إصدار من Microsoft.Azure.Functions.Worker.Extensions.SignalRService |
| Durable Functions | استبدال المراجع بMicrosoft.Azure.WebJobs.Extensions.DurableTaskمع أحدث إصدار من Microsoft.Azure.Functions.Worker.Extensions.DurableTask |
| Durable Functions (موفر تخزين SQL) |
استبدال المراجع بMicrosoft.DurableTask.SqlServer.AzureFunctionsمع أحدث إصدار من Microsoft.Azure.Functions.Worker.Extensions.DurableTask.SqlServer |
| Durable Functions (موفر تخزين Netherite) |
استبدال المراجع بMicrosoft.Azure.DurableTask.Netherite.AzureFunctionsمع أحدث إصدار من Microsoft.Azure.Functions.Worker.Extensions.DurableTask.Netherite |
| روابط SendGrid | استبدال المراجع بMicrosoft.Azure.WebJobs.Extensions.SendGridمع أحدث إصدار من Microsoft.Azure.Functions.Worker.Extensions.SendGrid |
| روابط Kafka | استبدال المراجع بMicrosoft.Azure.WebJobs.Extensions.Kafkaمع أحدث إصدار من Microsoft.Azure.Functions.Worker.Extensions.Kafka |
| روابط RabbitMQ | استبدال المراجع بMicrosoft.Azure.WebJobs.Extensions.RabbitMQمع أحدث إصدار من Microsoft.Azure.Functions.Worker.Extensions.RabbitMQ |
| إدراج التبعية وتكوين بدء التشغيل |
إزالة المراجع إلىMicrosoft.Azure.Functions.Extensions(يوفر نموذج العامل المعزول هذه الوظيفة بشكل افتراضي.) |
راجع الارتباطات المدعومة للحصول على قائمة كاملة من الملحقات التي يجب مراعاتها، واستشر وثائق كل ملحق للحصول على إرشادات التثبيت الكاملة لنموذج العملية المعزول. تأكد من تثبيت أحدث إصدار مستقر من أي حزم تستهدفها.
تلميح
قد تتطلب أي تغييرات على إصدارات الملحقات أثناء هذه العملية تحديث host.json الملف أيضا. تأكد من قراءة وثائق كل ملحق تستخدمه.
على سبيل المثال، يحتوي ملحق ناقل خدمة Microsoft Azure على تغييرات فاصلة في البنية بين الإصدارين 4.x و5.x. لمزيد من المعلومات، راجع روابط ناقل خدمة Azure ل Azure Functions.
يجب ألا يشير تطبيق نموذج العامل المعزول إلى أي حزم في Microsoft.Azure.WebJobs.* مساحات الأسماء أو Microsoft.Azure.Functions.Extensions. إذا كان لديك أي مراجع متبقية لهذه، يجب إزالتها.
تلميح
قد يعتمد تطبيقك أيضا على أنواع Azure SDK، إما كجزء من المشغلات والروابط أو كتبعية مستقلة. يجب عليك اغتنم هذه الفرصة لتحديث هذه أيضا. تعمل أحدث إصدارات ملحقات الوظائف مع أحدث إصدارات Azure SDK ل .NET، وجميع الحزم تقريبا هي النموذج Azure.*.
ملف Program.cs
عند الترحيل للتشغيل في عملية عامل معزولة، يجب إضافة ملف program.cs التالي إلى مشروعك:
using Microsoft.Azure.Functions.Worker;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
var host = new HostBuilder()
.ConfigureFunctionsWebApplication()
.ConfigureServices(services => {
services.AddApplicationInsightsTelemetryWorkerService();
services.ConfigureFunctionsApplicationInsights();
})
.Build();
host.Run();
يتضمن هذا المثال تكامل ASP.NET Core لتحسين الأداء وتوفير نموذج برمجة مألوف عندما يستخدم تطبيقك مشغلات HTTP. إذا كنت لا تنوي استخدام مشغلات HTTP، يمكنك استبدال الاستدعاء ConfigureFunctionsWebApplication باستدعاء إلى ConfigureFunctionsWorkerDefaults. إذا قمت بذلك، يمكنك إزالة المرجع إلى Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore من ملف المشروع. ومع ذلك، للحصول على أفضل أداء، حتى بالنسبة للوظائف مع أنواع المشغلات الأخرى، يجب الاحتفاظ FrameworkReference ب إلى ASP.NET Core.
Program.cs سيستبدل الملف أي ملف يحتوي على السمة FunctionsStartup ، وهو عادة Startup.cs ملف. في الأماكن التي تشير IFunctionsHostBuilder.Servicesفيها التعليمات البرمجية الخاصة بك FunctionsStartup ، يمكنك بدلا من ذلك إضافة عبارات ضمن .ConfigureServices() أسلوب HostBuilder في .Program.cs لمعرفة المزيد حول العمل مع Program.cs، راجع بدء التشغيل والتكوين في دليل نموذج العامل المعزول.
تتضمن الأمثلة الافتراضية Program.cs أعلاه إعداد تكامل Application Insights لنموذج العامل المعزول. Program.csفي ، يجب عليك أيضا تكوين أي تصفية سجل يجب أن تنطبق على السجلات القادمة من التعليمات البرمجية في مشروعك. في نموذج العامل المعزول، يتحكم الملف فقط في host.json الأحداث المنبعثة من وقت تشغيل مضيف الوظائف. إذا لم تقم بتكوين قواعد التصفية في Program.cs، فقد ترى اختلافات في مستويات السجل الموجودة لفئات مختلفة في بيانات تتبع الاستخدام.
على الرغم من أنه يمكنك تسجيل مصادر التكوين المخصصة كجزء من HostBuilder، لاحظ أن هذه تنطبق بالمثل فقط على التعليمات البرمجية في مشروعك. يلزم أيضا تكوين المشغل والربط من قبل النظام الأساسي، ويجب توفير ذلك من خلال إعدادات التطبيق أو مراجع Key Vault أو ميزات مراجع تكوين التطبيق.
بمجرد نقل كل شيء من أي موجود FunctionsStartup إلى Program.cs الملف، يمكنك حذف السمة FunctionsStartup والفئة التي تم تطبيقها عليها.
الملف local.settings.json
يتم استخدام ملف local.settings.json فقط عند التشغيل محليا. للحصول على معلومات، راجع ملف الإعدادات المحلية.
عند الترحيل إلى الإصدار 4.x، تأكد من أن ملف local.settings.json يحتوي على العناصر التالية على الأقل:
{
"IsEncrypted": false,
"Values": {
"AzureWebJobsStorage": "AzureWebJobsStorageConnectionStringValue",
"FUNCTIONS_WORKER_RUNTIME": "dotnet-isolated"
}
}
إشعار
عند الترحيل من التشغيل قيد التشغيل إلى التشغيل في عملية عامل معزولة، تحتاج إلى تغيير FUNCTIONS_WORKER_RUNTIME القيمة إلى "dotnet-isolated".
ملف host.json
لا يلزم إجراء أي تغييرات على host.json الملف. ومع ذلك، إذا كان تكوين Application Insights الخاص بك في هذا الملف من مشروع النموذج قيد المعالجة، فقد تحتاج إلى إجراء تغييرات إضافية في ملفك Program.cs . host.json يتحكم الملف فقط في التسجيل من وقت تشغيل مضيف الوظائف، وفي نموذج العامل المعزول، تأتي بعض هذه السجلات من التطبيق الخاص بك مباشرة، مما يمنحك المزيد من التحكم. راجع إدارة مستويات السجل في نموذج العامل المعزول للحصول على تفاصيل حول كيفية تصفية هذه السجلات.
تغييرات اسم الفئة
غيرت بعض الفئات الرئيسية الأسماء بين الإصدارات. هذه التغييرات هي نتيجة للتغييرات في واجهات برمجة التطبيقات .NET أو في الاختلافات بين عملية العامل قيد المعالجة والعامل المعزول. يشير الجدول التالي إلى فئات .NET الرئيسية التي تستخدمها الدالات التي يمكن أن تتغير عند الترحيل:
| .NET Core 3.1 | .NET 5 | .NET 8 |
|---|---|---|
FunctionName (سمة) |
Function (سمة) |
Function (سمة) |
ILogger |
ILogger |
ILogger, ILogger<T> |
HttpRequest |
HttpRequestData |
HttpRequestData، HttpRequest (باستخدام تكامل ASP.NET Core) |
IActionResult |
HttpResponseData |
HttpResponseData، IActionResult (باستخدام تكامل ASP.NET Core) |
FunctionsStartup (سمة) |
يستخدم Program.cs بدلا من ذلك |
يستخدم Program.cs بدلا من ذلك |
قد تكون هناك أيضا اختلافات في اسم الفئة في الروابط. لمزيد من المعلومات، راجع المقالات المرجعية للروابط المحددة.
تغييرات أخرى في التعليمات البرمجية
يسلط هذا القسم الضوء على تغييرات التعليمات البرمجية الأخرى التي يجب مراعاتها أثناء العمل من خلال الترحيل. هذه التغييرات غير مطلوبة من قبل جميع التطبيقات، ولكن يجب تقييم ما إذا كانت هناك أي تغييرات ذات صلة بسيناريوهاتك. تأكد من التحقق من التغييرات العاجلة بين 3.x و4.x للحصول على تغييرات إضافية قد تحتاج إلى إجراءها على مشروعك.
تسلسل JSON
بشكل افتراضي، يستخدم System.Text.Json نموذج العامل المعزول لتسلسل JSON. لتخصيص خيارات التسلسل أو التبديل إلى JSON.NET (Newtonsoft.Json)، راجع هذه الإرشادات.
مستويات سجل Application Insights والتصفية
يمكن إرسال السجلات إلى Application Insights من كل من وقت تشغيل مضيف الوظائف والرمز في مشروعك. host.json يسمح لك بتكوين قواعد لتسجيل المضيف، ولكن للتحكم في السجلات القادمة من التعليمات البرمجية الخاصة بك، ستحتاج إلى تكوين قواعد التصفية كجزء من .Program.cs راجع إدارة مستويات السجل في نموذج العامل المعزول للحصول على تفاصيل حول كيفية تصفية هذه السجلات.
قالب مشغل HTTP
يمكن رؤية الاختلافات بين عملية العامل قيد المعالجة وعملية العامل المعزولة في الوظائف التي يتم تشغيلها من قبل HTTP. يبدو قالب مشغل HTTP للإصدار 3.x (قيد المعالجة) مثل المثال التالي:
using System;
using System.IO;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Azure.WebJobs;
using Microsoft.Azure.WebJobs.Extensions.Http;
using Microsoft.AspNetCore.Http;
using Microsoft.Extensions.Logging;
using Newtonsoft.Json;
namespace Company.Function
{
public static class HttpTriggerCSharp
{
[FunctionName("HttpTriggerCSharp")]
public static async Task<IActionResult> Run(
[HttpTrigger(AuthorizationLevel.AuthLevelValue, "get", "post", Route = null)] HttpRequest req,
ILogger log)
{
log.LogInformation("C# HTTP trigger function processed a request.");
string name = req.Query["name"];
string requestBody = await new StreamReader(req.Body).ReadToEndAsync();
dynamic data = JsonConvert.DeserializeObject(requestBody);
name = name ?? data?.name;
string responseMessage = string.IsNullOrEmpty(name)
? "This HTTP triggered function executed successfully. Pass a name in the query string or in the request body for a personalized response."
: $"Hello, {name}. This HTTP triggered function executed successfully.";
return new OkObjectResult(responseMessage);
}
}
}
يبدو قالب مشغل HTTP للإصدار الذي تم ترحيله مثل المثال التالي:
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using Microsoft.Azure.Functions.Worker;
using Microsoft.Extensions.Logging;
namespace Company.Function
{
public class HttpTriggerCSharp
{
private readonly ILogger<HttpTriggerCSharp> _logger;
public HttpTriggerCSharp(ILogger<HttpTriggerCSharp> logger)
{
_logger = logger;
}
[Function("HttpTriggerCSharp")]
public IActionResult Run(
[HttpTrigger(AuthorizationLevel.Function, "get")] HttpRequest req)
{
_logger.LogInformation("C# HTTP trigger function processed a request.");
return new OkObjectResult($"Welcome to Azure Functions, {req.Query["name"]}!");
}
}
}
لتحديث مشروعك إلى Azure Functions 4.x:
تحديث التثبيت المحلي لـ Azure Functions Core Tools إلى الإصدار 4.x.
قم بتحديث مجموعة ملحقات Azure Functions لتطبيقك إلى الإصدار 2.x أو إصدار أحدث. لمزيد من المعلومات، اطلع على التغييرات العاجلة.
إذا لزم الأمر، فانتقل إلى أحد إصدارات Java المدعومة في الإصدار 4.x.
قم بتحديث ملف التطبيق
POM.xmlلتعديلFUNCTIONS_EXTENSION_VERSIONالإعداد إلى~4، كما في المثال التالي:<configuration> <resourceGroup>${functionResourceGroup}</resourceGroup> <appName>${functionAppName}</appName> <region>${functionAppRegion}</region> <appSettings> <property> <name>WEBSITE_RUN_FROM_PACKAGE</name> <value>1</value> </property> <property> <name>FUNCTIONS_EXTENSION_VERSION</name> <value>~4</value> </property> </appSettings> </configuration>
- إذا لزم الأمر، فانتقل إلى أحد إصدارات Node.js المعتمدة على الإصدار 4.x.
- اغتنم هذه الفرصة للترقية إلى PowerShell 7.2، وهو أمر مستحسن. لمزيد من المعلومات، راجع إصدارات PowerShell.
- إذا كنت تستخدم الإصدار Python 3.6، فانتقل إلى أحد الإصدارات المدعمة.
تشغيل مدقق ما قبل الترقية
يوفر Azure Functions مدقق ما قبل الترقية لمساعدتك في تحديد المشكلات المحتملة عند ترحيل تطبيق الوظائف إلى الإصدار 4.x. لتشغيل مدقق ما قبل الترقية:
انتقل إلى تطبيق الوظائف الجديد في مدخل Azure.
افتح صفحة تشخيص المشاكل وحلها.
في تشخيصات تطبيق الوظائف، ابدأ كتابة
Functions 4.x Pre-Upgrade Validatorثم اختره من القائمة.بعد اكتمال التحقق من الصحة، راجع التوصيات وعالج أي مشكلات في تطبيقك. إذا كنت بحاجة إلى إجراء تغييرات على تطبيقك، فتأكد من التحقق من صحة التغييرات مقابل الإصدار 4.x من وقت تشغيل الوظائف، إما محلياً باستخدام Azure Functions Core Tools v4 أو باستخدام فتحة التقسيم المرحلي.
تحديث تطبيق الوظائف في Azure
تحتاج إلى تحديث وقت تشغيل مضيف تطبيق الوظائف في Azure إلى الإصدار 4.x قبل نشر المشروع الذي تم ترحيله. يتم التحكم في إصدار وقت التشغيل المستخدم من قبل مضيف الوظائف بواسطة FUNCTIONS_EXTENSION_VERSION إعداد التطبيق، ولكن في بعض الحالات يجب أيضا تحديث الإعدادات الأخرى. يتطلب كل من تغييرات التعليمات البرمجية والتغييرات في إعدادات التطبيق إعادة تشغيل تطبيق الوظائف.
أسهل طريقة هي التحديث بدون فتحات ثم إعادة نشر مشروع التطبيق الخاص بك. يمكنك أيضا تقليل وقت التعطل في تطبيقك وتبسيط العودة إلى الحالة السابقة عن طريق التحديث باستخدام الفتحات.
التحديث بدون فتحات
أبسط طريقة للتحديث إلى v4.x هي تعيين FUNCTIONS_EXTENSION_VERSION إعداد التطبيق على ~4 تطبيق الوظائف في Azure. يجب اتباع إجراء مختلف على موقع به فتحات.
az functionapp config appsettings set --settings FUNCTIONS_EXTENSION_VERSION=~4 -g <RESOURCE_GROUP_NAME> -n <APP_NAME>
يجب عليك أيضا تعيين إعداد آخر، والذي يختلف بين Windows وLinux.
عند التشغيل على Windows، تحتاج أيضاً إلى تمكين.NET 6.0، وهو مطلوب بواسطة الإصدار 4.x من وقت التشغيل.
az functionapp config set --net-framework-version v6.0 -g <RESOURCE_GROUP_NAME> -n <APP_NAME>
.NET 6 مطلوب لتطبيقات الوظائف بأي لغة تعمل على Windows.
في هذا المثال، استبدل <APP_NAME> باسم تطبيق الوظائف واسم <RESOURCE_GROUP_NAME> مجموعة الموارد.
يمكنك الآن إعادة نشر مشروع التطبيق الذي تم ترحيله للتشغيل على الإصدار 4.x.
التحديث باستخدام الفتحات
يعد استخدام فتحات النشر طريقة جيدة لتحديث تطبيق الوظائف إلى وقت تشغيل v4.x من إصدار سابق. باستخدام فتحة التقسيم المرحلي، يمكنك تشغيل تطبيقك على إصدار وقت التشغيل الجديد في فتحة التقسيم المرحلي والتبديل إلى الإنتاج بعد التحقق. توفر الفتحات أيضا طريقة لتقليل وقت التعطل أثناء التحديث. إذا كنت بحاجة إلى تقليل وقت التعطل، فاتبع الخطوات الواردة في الحد الأدنى لتحديث وقت التعطل.
بعد التحقق من تطبيقك في الفتحة المحدثة، يمكنك تبديل التطبيق وإعدادات الإصدار الجديد إلى الإنتاج. يتطلب هذا التبديل إعداد WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS=0 في فتحة الإنتاج. تؤثر كيفية إضافة هذا الإعداد على مقدار وقت التعطل المطلوب للتحديث.
تحديث قياسي
إذا كان تطبيق الوظائف الممكنة للفتحة يمكنه معالجة وقت تعطل إعادة التشغيل الكاملة، يمكنك تحديث WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS الإعداد مباشرةً في فتحة الإنتاج. نظراً لأن تغيير هذا الإعداد مباشرةً في فتحة الإنتاج يؤدي إلى إعادة التشغيل التي تؤثر على التوفر، ففكر في إجراء هذا التغيير في وقت انخفاض نسبة استخدام الشبكة. يمكنك بعد ذلك التبديل في الإصدار المحدث من فتحة التقسيم المرحلي.
لا يدعم PowerShell cmdlet Update-AzFunctionAppSetting حالياً الفتحات. يجب استخدام Azure CLI أو مدخل Azure.
استخدم الأمر التالي لتعيينه
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS=0في فتحة الإنتاج:az functionapp config appsettings set --settings WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS=0 -g <RESOURCE_GROUP_NAME> -n <APP_NAME>في هذا المثال، استبدل
<APP_NAME>باسم تطبيق الوظائف واسم<RESOURCE_GROUP_NAME>مجموعة الموارد. يؤدي هذا الأمر إلى إعادة تشغيل التطبيق قيد التشغيل في فتحة الإنتاج.استخدم الأمر التالي لتعيين
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONSأيضاً في فتحة التقسيم المرحلي:az functionapp config appsettings set --settings WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS=0 -g <RESOURCE_GROUP_NAME> -n <APP_NAME> --slot <SLOT_NAME>استخدم الأمر التالي لتغيير
FUNCTIONS_EXTENSION_VERSIONوتحديث فتحة التقسيم المرحلي إلى إصدار وقت التشغيل الجديد:az functionapp config appsettings set --settings FUNCTIONS_EXTENSION_VERSION=~4 -g <RESOURCE_GROUP_NAME> -n <APP_NAME> --slot <SLOT_NAME>يتطلب الإصدار 4.x من وقت تشغيل الوظائف .NET 6 في Windows. على Linux، يجب أيضا تحديث تطبيقات .NET إلى .NET 6. استخدم الأمر التالي بحيث يمكن تشغيل وقت التشغيل على .NET 6:
عند التشغيل على Windows، تحتاج أيضاً إلى تمكين.NET 6.0، وهو مطلوب بواسطة الإصدار 4.x من وقت التشغيل.
az functionapp config set --net-framework-version v6.0 -g <RESOURCE_GROUP_NAME> -n <APP_NAME>.NET 6 مطلوب لتطبيقات الوظائف بأي لغة تعمل على Windows.
في هذا المثال، استبدل
<APP_NAME>باسم تطبيق الوظائف واسم<RESOURCE_GROUP_NAME>مجموعة الموارد.إذا كان مشروع التعليمات البرمجية يتطلب أي تحديثات لتشغيله على الإصدار 4.x، فقم بنشر هذه التحديثات إلى فتحة التقسيم المرحلي الآن.
تأكد من أن تطبيق الوظائف يعمل بشكل صحيح في بيئة التقسيم المرحلي المحدثة قبل التبديل.
استخدم الأمر التالي لتبديل فتحة التقسيم المرحلي المحدثة إلى الإنتاج:
az functionapp deployment slot swap -g <RESOURCE_GROUP_NAME> -n <APP_NAME> --slot <SLOT_NAME> --target-slot production
الحد الأدنى لتحديث وقت التعطل
لتقليل وقت التعطل في تطبيق الإنتاج، يمكنك تبديل الإعداد WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS من فتحة التقسيم المرحلي إلى الإنتاج. بعد ذلك، يمكنك التبديل في الإصدار المحدث من فتحة تشغيل مرحلي مسبقة البدء.
استخدم الأمر التالي لتعيين
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS=0في فتحة التقسيم المرحلي:az functionapp config appsettings set --settings WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS=0 -g <RESOURCE_GROUP_NAME> -n <APP_NAME> --slot <SLOT_NAME>استخدم الأوامر التالية للتبديل بين الفتحة والإعداد الجديد في الإنتاج، وفي الوقت نفسه استعادة إعداد الإصدار في فتحة التقسيم المرحلي.
az functionapp deployment slot swap -g <RESOURCE_GROUP_NAME> -n <APP_NAME> --slot <SLOT_NAME> --target-slot production az functionapp config appsettings set --settings FUNCTIONS_EXTENSION_VERSION=~3 -g <RESOURCE_GROUP_NAME> -n <APP_NAME> --slot <SLOT_NAME>قد ترى أخطاء من فتحة التقسيم المرحلي خلال الفترة ما بين التبديل وإصدار وقت التشغيل الذي تتم استعادته عند التقسيم المرحلي. يمكن أن يحدث هذا الخطأ لأن وجود
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS=0في التقسيم المرحلي فقط أثناء التبديل يزيلFUNCTIONS_EXTENSION_VERSIONالإعداد في التقسيم المرحلي. بدون إعداد الإصدار، ستكون الفتحة في حالة سيئة. يجب أن يؤدي تحديث الإصدار في فتحة التقسيم المرحلي مباشرةً بعد التبديل إلى إعادة الفتحة إلى حالة جيدة، ويمكنك استدعاء التراجع عن تغييراتك إذا لزم الأمر. ولكن يتطلب أي تراجع للمبادلة أيضاً إزالةWEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS=0مباشرةً من الإنتاج قبل التبديل مرة أخرى لمنع حدوث نفس الأخطاء في الإنتاج التي تظهر في التقسيم المرحلي. سيؤدي هذا التغيير في إعداد الإنتاج بعد ذلك إلى إعادة تشغيل.استخدم الأمر التالي لتعيين
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS=0أيضاً في فتحة التقسيم المرحلي:az functionapp config appsettings set --settings WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS=0 -g <RESOURCE_GROUP_NAME> -n <APP_NAME> --slot <SLOT_NAME>عند هذه النقطة، تم
WEBSITE_OVERRIDE_STICKY_EXTENSION_VERSIONS=0تعيين كلا الفتحتين.استخدم الأمر التالي لتغيير
FUNCTIONS_EXTENSION_VERSIONوتحديث فتحة التقسيم المرحلي إلى إصدار وقت التشغيل الجديد:az functionapp config appsettings set --settings FUNCTIONS_EXTENSION_VERSION=~4 -g <RESOURCE_GROUP_NAME> -n <APP_NAME> --slot <SLOT_NAME>يتطلب الإصدار 4.x من وقت تشغيل الوظائف .NET 6 في Windows. على Linux، يجب أيضا تحديث تطبيقات .NET إلى .NET 6. استخدم الأمر التالي بحيث يمكن تشغيل وقت التشغيل على .NET 6:
عند التشغيل على Windows، تحتاج أيضاً إلى تمكين.NET 6.0، وهو مطلوب بواسطة الإصدار 4.x من وقت التشغيل.
az functionapp config set --net-framework-version v6.0 -g <RESOURCE_GROUP_NAME> -n <APP_NAME>.NET 6 مطلوب لتطبيقات الوظائف بأي لغة تعمل على Windows.
في هذا المثال، استبدل
<APP_NAME>باسم تطبيق الوظائف واسم<RESOURCE_GROUP_NAME>مجموعة الموارد.إذا كان مشروع التعليمات البرمجية يتطلب أي تحديثات لتشغيله على الإصدار 4.x، فقم بنشر هذه التحديثات إلى فتحة التقسيم المرحلي الآن.
تأكد من أن تطبيق الوظائف يعمل بشكل صحيح في بيئة التقسيم المرحلي المحدثة قبل التبديل.
استخدم الأمر التالي لتبديل فتحة التقسيم المرحلي المحدثة والمقدمة مسبقا إلى الإنتاج:
az functionapp deployment slot swap -g <RESOURCE_GROUP_NAME> -n <APP_NAME> --slot <SLOT_NAME> --target-slot production
تغييرات عاجلة بين 3.x و4.x
فيما يلي التغييرات المقاطعة الخاصة بالمفاتيح التي يجب أن تكون على دراية بها قبل ترقية تطبيق 3.x إلى 4.x، بما في ذلك التغييرات المقاطعة الخاصة باللغة. للحصول على قائمة كاملة، راجع Azure Functions GitHub المسماة التغيير العاجل: المعتمد.
إذا كنت لا ترى لغة البرمجة الخاصة بك، فقم بتحديدها من أعلى الصفحة.
وقت التشغيل
Azure Functions Proxies هي ميزة قديمة للإصدارات من 1.x إلى 3.x من وقت تشغيل Azure Functions. يمكن إعادة تمكين دعم وكلاء الوظائف في الإصدار 4.x بحيث يمكنك تحديث تطبيقات الوظائف بنجاح إلى أحدث إصدار من وقت التشغيل. في أقرب وقت ممكن، يجب عليك بدلا من ذلك التبديل إلى دمج تطبيقات الوظائف الخاصة بك مع Azure API Management. تتيح لك APIM الاستفادة من مجموعة أكثر اكتمالا من الميزات لتحديد واجهات برمجة التطبيقات المستندة إلى الوظائف وتأمينها وإدارتها والاستفادة منها. لمزيد من المعلومات، راجع تكامل APIM. لمعرفة كيفية إعادة تمكين دعم الوكلاء في الإصدار 4.x من Functions، راجع إعادة تمكين الوكلاء في Functions v4.x.
تسجيل الدخول إلى Azure Storage باستخدام AzureWebJobsDashboard لم يعد مدعومًا في 4.x. يجب عليك بدلًا من ذلك استخدام تطبيق Insights. (#1923)
يفرض Azure Functions 4.x الأن الحد الأدنى من متطلبات الإصدار للملحقات. التحديث إلى أحدث إصدار من الملحقات المتأثرة. بالنسبة للغات non-.NET، قم بتحديث الإصدار 2.x أو أحدث من حزمة الملحقات. (#1987)
يتم الآن فرض المهلات الافتراضية والحد الأقصى في 4.x لتطبيقات الوظائف التي تعمل على Linux في خطة الاستهلاك. (#1915)
تستخدم
Azure.IdentityAzure Functions 4.x وAzure.Security.KeyVault.Secretsلموفر Key Vault وإيقافت استخدام Microsoft.Azure.KeyVault. لمزيد من المعلومات حول كيفية تكوين إعدادات تطبيق الوظائف، راجع خيار Key Vault في المستودعات السرية. (#2048)يفشل الآن بدء تشغيل تطبيقات الدوال التي تشارك حسابات التخزين عندما تكون معرفات مضيفها هي نفسها. لمزيد من المعلومات، راجع اعتبارات معرّف المضيف. (#2049)
- تم تحديث عدد مؤشرات الترابط الافتراضية. قد تتأثر الوظائف غير الآمنة لمترابط الرسائل أو ذات الاستخدام العالي للذاكرة. (#1962)
الخطوات التالية
الملاحظات
قريبًا: خلال عام 2024، سنتخلص تدريجيًا من GitHub Issues بوصفها آلية إرسال ملاحظات للمحتوى ونستبدلها بنظام ملاحظات جديد. لمزيد من المعلومات، راجع https://aka.ms/ContentUserFeedback.
إرسال الملاحظات وعرضها المتعلقة بـ