ترقية إصدار Service Fabric الذي يتم تشغيله على نظام مجموعتك
قدرة أي نظام حديث على الترقية هو السبب الأساسي لنجاح منتجك على المدى الطويل. مجموعة Azure Service Fabric هي مورد تملكه. توضح هذه المقالة كيفية ترقية إصدار Service Fabric قيد التشغيل على نظام المجموعة المستقلة الخاص بك.
إشعار
تأكد من أن نظام مجموعتك يعمل دائمًا على إصدار Service Fabric مدعوم. عندما تعلن Microsoft عن إصدار جديد من Service Fabric، يتم تمييز الإصدار السابق بانتهاء الدعم بعد 60 يومًا على الأقل من تاريخ الإعلان. يُعلن عن الإصدارات الجديدة في مدونة فريق Service Fabric. أصبح الإصدار الجديد متاحًا للاختيار في تلك المرحلة.
يمكنك ترقية نظام مجموعتك إلى الإصدار الجديد إذا كنت تستخدم تكوين عقدة نمط الإنتاج، حيث يتم تخصيص كل عقدة Service Fabric على جهاز فعلي أو ظاهري منفصل. إذا كنت تمتلك نظام مجموعة تطوير ويحتوي كل جهاز فعلي أو ظاهري على أكثر من عقدة Service Fabric، فيجب عليك إعادة إنشاء نظام المجموعة باستخدام الإصدار الجديد.
توجد مهمتان مختلفتان لسير العمل يمكنك اتباع أحدهما لترقية نظام مجموعتك إلى أحدث إصدار أو إصدار Service Fabric مدعوم. مهمة سير العمل الأولى هي لنظم المجموعات التي لديها اتصالية لتنزيل أحدث إصدار تلقائيا. المهمة الأخرى هي مخصصة لنظم المجموعات التي ليس لديها اتصالية لتنزيل أحدث إصدار من Service Fabric.
تمكين الترقية التلقائية لإصدار Service Fabric لنظام مجموعتك
لتعيين نظام المجموعة الخاص بك لتنزيل تحديثات Service Fabric عندما تصدر Microsoft إصدارا جديدا، قم بتعيين fabricClusterAutoupgradeEnabled
تكوين نظام المجموعة إلى true. لاختيار الطريقة اليدوية لتحديد إصدار مدعوم من Service Fabric تريد تشغيل نظام المجموعة عليه، قم بتعيين fabricClusterAutoupgradeEnabled
تكوين نظام المجموعة إلى false.
ترقية نظم المجموعات التي لديها اتصالية لتنزيل أحدث التعليمات البرمجية والتكوين
اتبع هذه الخطوات لترقية نظام المجموعة إلى إصدار مدعوم إذا كانت عقد نظام المجموعة لديك متصلة بالإنترنت بـ Microsoft Download Center.
بالنسبة للمجموعات التي لديها اتصال بـ Microsoft Download Center، تتحقق Microsoft بشكل دوري من توافر إصدارات Service Fabric الجديدة.
عند توافر إصدار جديد من Service Fabric، يتم تنزيل الحزمة محليا إلى المجموعة وتوفيرها للترقية. وأيضا، لإعلام العميل بهذا الإصدار الجديد، يعرض النظام تحذيرا صريحا لحماية نظام المجموعة يشبه التحذير التالي:
"ينتهي دعم إصدار نظام المجموعة الحالي [الإصدار #] في [التاريخ]."
يختفي التحذير بعد تشغيل نظام مجموعة لأحدث إصدار.
عند رؤية تحذير حماية نظام المجموعة، قم بترقية نظام المجموعة:
قم بالاتصال بنظام المجموعة من أي جهاز لديه حق الوصول كمسؤول إلى كافة الأجهزة المسردة كعقد في نظام المجموعة. لا يلزم أن يكون الجهاز الذي يتم تشغيل هذا البرنامج النصي عليه جزءا من المجموعة.
###### connect to the secure cluster using certs $ClusterName= "mysecurecluster.something.com:19000" $CertThumbprint= "70EF5E22ADB649799DA3C8B6A6BF7FG2D630F8F3" Connect-serviceFabricCluster -ConnectionEndpoint $ClusterName -KeepAliveIntervalInSec 10 ` -X509Credential ` -ServerCertThumbprint $CertThumbprint ` -FindType FindByThumbprint ` -FindValue $CertThumbprint ` -StoreLocation CurrentUser ` -StoreName My
احصل على قائمة بإصدارات Service Fabric التي يمكنك الترقية إليها.
###### Get the list of available Service Fabric versions Get-ServiceFabricRegisteredClusterCodeVersion
يجب أن تحصل على إخراج يشبه:
بدء ترقية نظام مجموعة إلى إصدار متوفر باستخدام الأمر Windows PowerShell التالي Start-ServiceFabricClusterUpgrade.
Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion <codeversion#> -Monitored -FailureAction Rollback ###### Here is a filled-out example Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion 5.3.301.9590 -Monitored -FailureAction Rollback
لمراقبة تقدم الترقية، يمكنك استخدام Service Fabric Explorer أو تشغيل الأمر PowerShell التالي:
Get-ServiceFabricClusterUpgrade
إذا لم يتم استيفاء نُهج حماية نظام مجموعة، ستفشل الترقية وتعود للحالة السابقة. لتحديد نهج الحماية المخصصة للأمر Start-ServiceFabricClusterUpgrade، راجع الوثائق الخاصة بـ Start-ServiceFabricClusterUpgrade.
بعد إصلاح المشكلات التي أدت إلى التراجع، ابدأ الترقية مرة أخرى باتباع نفس الخطوات الموضحة سابقا.
ترقية نظم المجموعات التي ليس لديها اتصالية لتنزيل أحدث التعليمات البرمجية والتكوين
اتبع هذه الخطوات لترقية نظام المجموعة إلى إصدار مدعوم إذا كانت عقد نظام المجموعة لديك غير متصلة بالإنترنت بـ Microsoft Download Center.
إشعار
إذا كنت تقوم بتشغيل مجموعة غير متصلة بالإنترنت، فيجب عليك تفقد مدونة فريق Service Fabric للتعرف على الإصدارات الجديدة. لا يعرض النظام تحذير السلامة لنظام مجموعتك لتنبيهك بالإصدارات الجديدة.
إعدادات تشغيل الخدمة التلقائي مقابل اليدوي
لتمكين التنزيل والتسجيل التلقائيين لأحدث إصدار من التعليمات البرمجية، قم بإعداد خدمة Service Fabric Update. للحصول على التعليمات، راجع Tools\ServiceFabricUpdateService.zip\Readme_InstructionsAndHowTos.txt في الحزمة المستقلة.
لإتمام العملية يدويا، اتبع هذه التعليمات.
تعديل تكوين نظام المجموعة الخاص بك لتعيين الخاصية التالية إلى false قبل بدء ترقية التكوين:
"fabricClusterAutoupgradeEnabled": false,
للحصول على تفاصيل الاستخدام، راجع الأمر PowerShell Start-ServiceFabricClusterConfigurationUpgrade PowerShell. تأكد من تحديث "clusterConfigurationVersion" في JSON قبل بدء ترقية التكوين.
Start-ServiceFabricClusterConfigurationUpgrade -ClusterConfigPath <Path to Configuration File>
سير عمل ترقية نظام المجموعة
قم بتشغيل Get-ServiceFabricClusterUpgrade من إحدى العقد في نظام المجموعة ولاحظ TargetCodeVersion.
قم بتشغيل ما يلي من جهاز متصل بالإنترنت لسرد جميع الإصدارات المتوافقة مع الترقية مع الإصدار الحالي وتنزيل الحزمة المتوافقة من روابط التنزيل المقترنة:
###### Get list of all upgrade compatible packages Get-ServiceFabricRuntimeUpgradeVersion -BaseVersion <TargetCodeVersion as noted in Step 1>
قم بالاتصال بنظام المجموعة من أي جهاز لديه حق الوصول كمسؤول إلى كافة الأجهزة المسردة كعقد في نظام المجموعة. لا يلزم أن يكون الجهاز الذي يتم تشغيل هذا البرنامج النصي عليه جزءا من المجموعة.
###### Get the list of available Service Fabric versions Copy-ServiceFabricClusterPackage -Code -CodePackagePath <name of the .cab file including the path to it> -ImageStoreConnectionString "fabric:ImageStore" ###### Here is a filled-out example Copy-ServiceFabricClusterPackage -Code -CodePackagePath .\MicrosoftAzureServiceFabric.5.3.301.9590.cab -ImageStoreConnectionString "fabric:ImageStore"
انسخ الحزمة التي تم تنزيلها إلى مخزن صور نظام المجموعة.
سجل الحزمة المنسوخة.
###### Get the list of available Service Fabric versions Register-ServiceFabricClusterPackage -Code -CodePackagePath <name of the .cab file> ###### Here is a filled-out example Register-ServiceFabricClusterPackage -Code -CodePackagePath MicrosoftAzureServiceFabric.5.3.301.9590.cab
بدء ترقية نظام المجموعة إلى إصدار متوفر.
Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion <codeversion#> -Monitored -FailureAction Rollback ###### Here is a filled-out example Start-ServiceFabricClusterUpgrade -Code -CodePackageVersion 5.3.301.9590 -Monitored -FailureAction Rollback
لمراقبة تقدم الترقية باستخدام Service Fabric Explorer أو تشغيل الأمر PowerShell التالي:
Get-ServiceFabricClusterUpgrade
إذا لم يتم استيفاء نُهج حماية نظام مجموعة، ستفشل الترقية وتعود للحالة السابقة. لتحديد نهج الحماية المخصصة للأمر Start-ServiceFabricClusterUpgrade، راجع الوثائق الخاصة بـ Start-ServiceFabricClusterUpgrade.
بعد إصلاح المشكلات التي أدت إلى التراجع، ابدأ الترقية مرة أخرى باتباع نفس الخطوات الموضحة سابقا.