الترقية إلى إصدار جديد

تعرف على كيفية ترقية توزيع Azure IoT Operations إلى إصدار أحدث.

المتطلبات الأساسية

• حساب Azure مع اشتراك نشط. إذا لم يكن لديك حساب، يمكنك إنشاء حساب مجاني.
• Azure CLI الإصدار 2.53.0 أو أعلى. استخدم az --version للتحقق من الإصدار وتحديثه az upgrade إذا لزم الأمر. لمزيد من المعلومات، راجع بدء استخدام Azure CLI.

فهم دعم الترقية

يمكن معاينة إصدارات إصدار Azure IoT Operations أو الإتاحة بشكل عام (GA)، يمكنك العثور على أحدث إصدار في مستند إصدارات Azure IoT Operations . يرتبط إصدار ملحق Azure IoT Operations CLI بإصدار Azure IoT Operations، لذلك تحتاج إلى التأكد من تثبيت إصدار ملحق CLI الصحيح لإجراء ترقية.

تدعم Azure IoT Operations سيناريوهات الترقية التالية:

• يمكنك ترقية مثيل عمليات Azure IoT موجود إلى أي تصحيح من نفس الإصدار الثانوي، أو إلى الإصدار الثانوي التالي.
• لا يمكنك الرجوع إلى إصدار أقدم بين الإصدارات. للانتقال إلى إصدار أقدم، قم بإلغاء تثبيت Azure IoT Operations وأعد تثبيت الإصدار المطلوب.
• لا يمكنك الترقية من أي إصدار معاينة إلى إصدار GA. تحتاج إلى إلغاء تثبيت Azure IoT Operations وإعادة تثبيت الإصدار الجديد.
• لا يمكنك الترقية من أي إصدار من GA إلى إصدار معاينة. لمزيد من المعلومات حول كيفية تثبيت إصدار معاينة، راجع الترقية إلى إصدار المعاينة.

إشعار

لا تدعم عمليات Azure IoT الترقيات المباشرة. يرجى توقع بعض التوقف أثناء عملية الترقية.

إصلاح

تدعم عمليات Azure IoT ترقية المثيلات إلى إصدارات GA الجديدة عند إصدارها. إذا كان مثيل Azure IoT Operations مؤهلا للترقية، فيمكنك استخدام مدخل Microsoft Azure أو Azure CLI لإجراء الترقية.

إذا كان أحدث إصدار من Azure IoT Operations قيد المعاينة، فراجع الترقية إلى إصدار المعاينة.

مدخل Microsoft Azure

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

1. في مدخل Microsoft Azure، انتقل إلى مثيل عمليات Azure IoT.

2. حدد ترقية في صفحة نظرة عامة على المثيل الخاص بك.

   

3. تحتاج إلى استخدام أحدث إصدار من ملحق Azure IoT Operations CLI للحصول على أحدث إصدار من عمليات Azure IoT. إذا لم تقم بتحديث الملحق كجزء من المتطلبات الأساسية، فقم بذلك الآن.

   az extension add --upgrade --name azure-iot-ops
   

   أو، إذا كنت تريد ترقية النشر إلى إصدار أحدث ولكن ليس الأحدث، فقم بتعيين إصدار ملحق CLI إلى الإصدار المقترن بإصدارات عمليات Azure IoT المطلوبة في إصدارات عمليات IoT.

   az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>
   

4. يقدم المدخل أمر Azure CLI لترقية المثيل الخاص بك، ملء مسبقا مع اشتراكك ومجموعة الموارد وتفاصيل المثيل. حدد أيقونة النسخ بجوار أمر CLI.

5. قم بتشغيل الأمر المنسخ az iot ops upgrade .

6. بعد اكتمال أمر الترقية بنجاح، قم بتحديث المثيل الخاص بك لمشاهدة التغييرات.

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

استخدم الأمر az iot ops upgrade لترقية توزيع عمليات Azure IoT الموجودة إلى إصدار أحدث.

يقوم أمر الترقية بتقييم نشر عمليات Azure IoT بأكملها للتحديثات المتوفرة، بما في ذلك ملحقات arc المثبتة az iot ops init في الأمر ومثيل عمليات Azure IoT.

استخدم الخطوات التالية لترقية النشر إلى أحدث إصدار:

1. أضف أحدث إصدار من ملحق Azure IoT Operations CLI.

   az extension add --upgrade --name azure-iot-ops
   

2. شغّل az iot ops upgrade

   az iot ops upgrade --resource-group <RESOURCE_GROUP_NAME> --name <INSTANCE_NAME>
   

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

إذا كنت ترغب في الترقية إلى إصدار معين من Azure IoT Operations ليس الأحدث، فيمكنك تشغيل az iot ops get-versionsإصدارات IoT Operations أو الرجوع إليها للعثور على إصدار ملحق CLI المقترن بإصدار Azure IoT Operations الذي تريده. احصل على رقم الإصدار وقم بتشغيل الأمر التالي للترقية إلى هذا الإصدار:

az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>

الترقية إلى إصدار المعاينة

في بعض الأحيان يكون أحدث إصدار من Azure IoT Operations قيد المعاينة. تحقق من إصدارات Azure IoT Operations للاطلاع على أحدث إصدار. أثناء إصدارات المعاينة، يتم حظر ترقية الإصدار، وتحتاج إلى إلغاء تثبيت Azure IoT Operations وإعادة تثبيت إصدار المعاينة.

يمكنك فقط تثبيت إصدار معاينة باستخدام Azure CLI.

1. إذا كان لديك مثيل Azure IoT Operations موجود، فأنت بحاجة إلى إلغاء تثبيت Azure IoT Operations لإجراء توزيع جديد.

2. أضف أحدث إصدار من ملحق Azure IoT Operations CLI مع العلامة --allow-preview .

   az extension add --upgrade --name azure-iot-ops --allow-preview
   

إذا كنت ترغب في الترقية إلى إصدار معين من Azure IoT Operations ليس الأحدث، فيمكنك تشغيل az iot ops get-versionsإصدارات IoT Operations أو الرجوع إليها للعثور على إصدار ملحق CLI المقترن بإصدار Azure IoT Operations الذي تريده. احصل على رقم الإصدار وقم بتشغيل الأمر التالي للترقية إلى هذا الإصدار:

az extension add --upgrade --name azure-iot-ops --version <VERSION_NUMBER>

اعتبارات ترقية وسيط MQTT

لضمان عدم فقدان البيانات والتوافر العالي أثناء ترقيات النشر، ينفذ وسيط MQTT تحديثات متجددة عبر قرون وسيط MQTT. تنسق جراب إدارة الصحة عملية ترقية تزايدية لقرون وسيط MQTT لضمان ما يلي:

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

إذا حدث فشل أثناء عملية الترقية، تعيد وحدة إدارة الصحة تلقائيا تشغيل عملية الترقية مع ضمان عدم فقدان البيانات أو الاتصال.

يمكن أن تحدث التحديثات المتداولة فقط إذا تم نشر وسيط MQTT مع نسختين متماثلتين أو أكثر من النسخ المتماثلة الخلفية. ترقيات وسيط MQTT غير مدعومة لنشر النسخة المتماثلة الواحدة. عند نشر عمليات Azure IoT، يمكنك تحديد عدد النسخ المتماثلة الخلفية لإنشائها في الأمر az iot ops create مع المعلمة --broker-backend-rf .

الإصدارات المدعومة

تدعم Microsoft ثلاثة إصدارات متوفرة بشكل عام (GA) من Azure IoT Operations في أي وقت: أحدث إصدار، والإصدارين الثانويين السابقين. بالإضافة إلى ذلك، تتوفر إصدارات المعاينة لاختبار الميزات الجديدة.

حاليا، يتوفر دعم Azure للإصدارات التالية:

Version	نوع	التصحيح الحالي الإصدار (YYMM)	حالي إصدار CLI	ملاحظات الإصدار
1.2.x	التوفر العام	1.2.112 (2510)	2.0.1	ملاحظات الإصدار
1.1.x	التوفر العام	1.1.59 (2506)	1.7.0	ملاحظات الإصدار
1.0.x	التوفر العام	1.0.34 (2503)	1.3.0	ملاحظات الإصدار

للتعرف على الترقيات بين الإصدارات، راجع الترقية إلى إصدار جديد.

هام

لا تتلقى الإصدارات الثانوية السابقة تصحيحات الأمان. قم بالترقية إلى أحدث إصدار للحصول على آخر تحديثات وميزات الأمان.

تحذير

لا تستخدم إصدارات المعاينة في بيئات الإنتاج.

للتحقق من الإصدار الحالي، انتقل إلى صفحة النظرة العامة لمثيل Azure IoT Operations في مدخل Microsoft Azure أو استخدم الأمر Azure IoT Operations CLI az iot ops instance show .