ترقية إصدار 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، يتم تنزيل الحزمة محليا إلى المجموعة وتوفيرها للترقية. وأيضا، لإعلام العميل بهذا الإصدار الجديد، يعرض النظام تحذيرا صريحا لحماية نظام المجموعة يشبه التحذير التالي:

"ينتهي دعم إصدار نظام المجموعة الحالي [الإصدار #] في [التاريخ]."

يختفي التحذير بعد تشغيل نظام مجموعة لأحدث إصدار.

عند رؤية تحذير حماية نظام المجموعة، قم بترقية نظام المجموعة:

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

    ###### 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
    
  2. احصل على قائمة بإصدارات Service Fabric التي يمكنك الترقية إليها.

    ###### Get the list of available Service Fabric versions
    Get-ServiceFabricRegisteredClusterCodeVersion
    

    يجب أن تحصل على إخراج يشبه:

    الحصول على إصدارات Service Fabric

  3. بدء ترقية نظام مجموعة إلى إصدار متوفر باستخدام الأمر 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>

سير عمل ترقية نظام المجموعة

  1. قم بتشغيل Get-ServiceFabricClusterUpgrade من إحدى العقد في نظام المجموعة ولاحظ TargetCodeVersion.

  2. قم بتشغيل ما يلي من جهاز متصل بالإنترنت لسرد جميع الإصدارات المتوافقة مع الترقية مع الإصدار الحالي وتنزيل الحزمة المتوافقة من روابط التنزيل المقترنة:

    ###### Get list of all upgrade compatible packages  
    Get-ServiceFabricRuntimeUpgradeVersion -BaseVersion <TargetCodeVersion as noted in Step 1> 
    
  3. قم بالاتصال بنظام المجموعة من أي جهاز لديه حق الوصول كمسؤول إلى كافة الأجهزة المسردة كعقد في نظام المجموعة. لا يلزم أن يكون الجهاز الذي يتم تشغيل هذا البرنامج النصي عليه جزءا من المجموعة.

    ###### 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"
    
  4. انسخ الحزمة التي تم تنزيلها إلى مخزن صور نظام المجموعة.

  5. سجل الحزمة المنسوخة.

    ###### 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
    
  6. بدء ترقية نظام المجموعة إلى إصدار متوفر.

    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.

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

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