ترحيل مثيل API Management غير المحقون ب VNet إلى النظام الأساسي لحساب stv2

ينطبق على: المطور | أساسي | قياسي | بريميوم

توفر هذه المقالة خطوات لترحيل مثيل API Management المستضاف على stv1 النظام الأساسي للحساب في مكانه إلى stv2 النظام الأساسي عندما لا يتم إدخال المثيل (نشره) في VNet خارجية أو داخلية. بالنسبة لهذا السيناريو، قم بترحيل المثيل الخاص بك باستخدام مدخل Microsoft Azure أو ترحيل إلى stv2 REST API. تعرف على ما إذا كنت بحاجة إلى القيام بذلك.

إذا كنت بحاجة إلى ترحيل إدارة واجهة برمجة التطبيقات المحقونة من VNnet المستضافة stv1 على النظام الأساسي، فشاهد ترحيل مثيل إدارة واجهة برمجة التطبيقات المحقونة من VNet إلى النظام الأساسي stv2.

هام

سيتم إيقاف دعم مثيلات API Management المستضافة على النظام الأساسي stv1 بحلول 31 أغسطس 2024. إذا كانت لديك مثيلات مستضافة stv1 على النظام الأساسي، فرحلها إلى stv2 النظام الأساسي قبل ذلك التاريخ لتجنب انقطاع الخدمة. اعرف المزيد.

تنبيه

• ترحيل مثيل APIM الخاص بك إلى بنية أساسية جديدة عملية طويلة الأمد.
• اعتمادا على عملية الترحيل الخاصة بك، قد يكون لديك وقت توقف مؤقت أثناء الترحيل، وقد تحتاج إلى تحديث تبعيات الشبكة بعد الترحيل للوصول إلى مثيل API Management. خطط لترحيلك وفقا لذلك.
• الترحيل إلى stv2 غير قابل للعكس.

ماذا يحدث أثناء الترحيل؟

يتضمن ترحيل النظام الأساسي لإدارة واجهة برمجة التطبيقات من stv1 إلى stv2 تحديث الحساب الأساسي وحده وليس له أي تأثير على تكوين الخدمة/واجهة برمجة التطبيقات المستمر في طبقة التخزين. بالنسبة لمثيل لم يتم نشره في VNet:

• يمكنك اختيار ما إذا كان سيتم تغيير عنوان VIP للمثيل، أو ما إذا كان يتم الاحتفاظ بعنوان VIP الأصلي.
• تتضمن عملية الترقية إنشاء حساب جديد بالتوازي مع الحساب القديم.
• ستكون حالة API Management في المدخل عبارة عن تحديث.
• إذا اخترت الاحتفاظ بعنوان VIP، يتضمن الترحيل خطوة إضافية لنقل VIP من الحساب القديم إلى الحساب الجديد الذي لن تستجيب واجهات برمجة التطبيقات خلاله.
• يدير Azure DNS لنقطة نهاية الإدارة، ويحدث الحساب الجديد على الفور عند الترحيل الناجح.
• تشير البوابة الافتراضية ومدخل DNS إلى الحساب الجديد على الفور.
• إذا اخترت أن يتلقى مثيل APIM عنوان VIP جديدا، فستحتاج إلى تحديث تبعيات الشبكة لاستخدام عنوان VIP الجديد.

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

• مثيل APIM مستضاف على stv1 النظام الأساسي للحساب. للتأكد من استضافة المثيل الخاص بك على stv1 النظام الأساسي، راجع كيف أعمل معرفة النظام الأساسي الذي يستضيف مثيل APIM الخاص بي؟

• استخدم بيئة Bash في Azure Cloud Shell. لمزيد من المعلومات، راجع التشغيل السريع ل Bash في Azure Cloud Shell.

  

• إذا كنت تفضل تشغيل أوامر مرجع CLI محلياً قم بتثبيت CLI Azure. إذا كنت تعمل على نظام تشغيل Windows أو macOS، ففكر في تشغيل Azure CLI في حاوية Docker. لمزيد من المعلومات، راجع كيفية تشغيل Azure CLI في حاوية Docker.

  • إذا كنت تستخدم تثبيت محلي، يُرجى تسجيل الدخول إلى Azure CLI مستخدمًا أمر az login. لإنهاء عملية المصادقة، اتبع الخطوات المعروضة في جهازك. للحصول على خيارات أخرى لتسجيل دخول، راجع تسجيل الدخول باستخدام Azure CLI.

  • عندما يُطلب منك، قم بتثبيت ملحق Azure CLI عند الاستخدام لأول مرة. لمزيد من المعلومات بشأن الامتدادات، راجع استخدام امتدادات مع Azure CLI.

  • يُرجى تشغيل إصدار az للوصول إلى الإصدار والمكتبات التابعة التي تم تثبيتها. للتحديث لآخر إصدار، يُرجى تشغيل تحديث az.

ترحيل المثيل إلى النظام الأساسي stv2

يمكنك اختيار ما إذا كان عنوان IP الظاهري لإدارة واجهة برمجة التطبيقات سيتغير، أو ما إذا كان يتم الاحتفاظ بعنوان VIP الأصلي.

• عنوان IP الظاهري الجديد - إذا اخترت هذا الوضع، تظل طلبات واجهة برمجة التطبيقات مستجيبة أثناء الترحيل. سيتم تأمين تكوين البنية الأساسية (مثل المجالات المخصصة والمواقع وشهادات المرجع المصدق) لمدة 30 دقيقة. بعد الترحيل، ستحتاج إلى تحديث أي تبعيات للشبكة بما في ذلك DNS وقواعد جدار الحماية وVNets لاستخدام عنوان VIP الجديد.

• الاحتفاظ بعنوان IP - إذا قمت بالاحتفاظ بعنوان VIP، فلن تستجيب طلبات واجهة برمجة التطبيقات لمدة 15 دقيقة تقريبا أثناء ترحيل عنوان IP إلى البنية الأساسية الجديدة. سيتم تأمين تكوين البنية الأساسية (مثل المجالات المخصصة والمواقع وشهادات المرجع المصدق) لمدة 45 دقيقة. لا يلزم إجراء أي تكوين آخر بعد الترحيل.

المدخل

1. في مدخل Azure، انتقل إلى مثيل API Management الخاص بك.

2. في القائمة اليسرى، ضمن الإعدادات، حدد ترحيل النظام الأساسي.

3. في صفحة ترحيل النظام الأساسي، حدد أحد خياري الترحيل:

   • عنوان IP ظاهري جديد. سيتغير عنوان VIP لمثيل API Management تلقائيا. لن يكون للخدمة وقت تعطل، ولكن بعد الترحيل ستحتاج إلى تحديث أي تبعيات للشبكة بما في ذلك DNS وقواعد جدار الحماية والشبكات الظاهرية لاستخدام عنوان VIP الجديد.

   • الاحتفاظ بعنوان IP - لن يتغير عنوان VIP لمثيل APIM. سيكون لدى المثيل الخاص بك وقت تعطل لمدة تصل إلى 15 دقيقة.

     

4. راجع إرشادات عملية الترحيل، وقم بإعداد بيئتك.

5. بعد الانتهاء من خطوات الإعداد، حدد لقد قرأت وفهمت تأثير عملية الترحيل. حدد ترحيل.

Azure CLI

قم بتشغيل أوامر Azure CLI التالية، مع تعيين المتغيرات حيث يشار إليها باسم مثيل APIM واسم مجموعة الموارد التي تم إنشاؤها فيها.

إشعار

يتوفر الترحيل إلى stv2 REST API بدءا من إصدار 2022-04-01-previewAPI Management REST API .

إشعار

تمت كتابة البرنامج النصي التالي ل bash shell. لتشغيل البرنامج النصي في PowerShell، قم ببادئة أسماء المتغيرات بالحرف $ . مثال:$APIM_NAME.

APIM_NAME={name of your API Management instance}
RG_NAME={name of your resource group}
# Get resource ID of API Management instance
APIM_RESOURCE_ID=$(az apim show --name $APIM_NAME --resource-group $RG_NAME --query id --output tsv)
# Call REST API to migrate to stv2 and change VIP address
az rest --method post --uri "$APIM_RESOURCE_ID/migrateToStv2?api-version=2023-03-01-preview" --body '{"mode": "NewIp"}'
# Alternate call to migrate to stv2 and preserve VIP address
# az rest --method post --uri "$APIM_RESOURCE_ID/migrateToStv2?api-version=2023-03-01-preview" --body '{"mode": "PreserveIp"}'

التحقق من الترحيل

للتحقق من نجاح الترحيل، عندما تتغير الحالة إلى Online، تحقق من إصدار النظام الأساسي لمثيل API Management. بعد الترحيل الناجح، تكون القيمة هي stv2 أو stv2.1.

العودة تلقائيا إذا فشل الترحيل

إذا كان هناك فشل أثناء عملية الترحيل، فسيعود المثيل تلقائيا إلى النظام stv1 الأساسي. إذا اكتمل الترحيل بنجاح (يظهر إصدار النظام الأساسي للمثيل ك stv2 أو stv2.1 والحالة متصل)، فلا يمكنك العودة إلى stv1 النظام الأساسي.

للحصول على المساعدة في حالة فشل الترحيل، اتصل بدعم Azure.

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

تحديث تبعيات الشبكة

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

الدعم والتعليمات

نحن هنا لمساعدتك على الترحيل إلى النظام stv2 الأساسي بأقل قدر من التعطيل لخدماتك.

إذا كانت لديك أسئلة، فاحصل على إجابات سريعة من خبراء المجتمع في Microsoft Q&A. في حالة امتلاكك خطة دعم وتحتاج إلى مساعدة تقنية، أنشئ طلب الدعم.

1. اكتب وصفًا لمشكلتك في الملخص، على سبيل المثال، "إيقاف stv1".
2. ضمن Issue type، حدد Technical.
3. ضمن Subscription، حدد اشتراكك.
4. ضمن الخدمة، حدد خدماتي، ثم حدد خدمة API Management.
5. ضمن المورد، حدد "مورد Azure" الذي تُنشئ طلب دعم من أجله.
6. بالنسبة إلى نوع المشكلة، حدد الإدارة.
7. بالنسبة إلى النوع الفرعي للمشكلة، حدد ترقية أو تغيير حجم أو تغييرات SKU.

الأسئلة الشائعة

• ما هي المعلومات التي نحتاجها لاختيار مسار ترحيل؟

  • ما هو وضع الشبكة لمثيل APIM؟
  • هل تم تكوين المجالات المخصصة؟
  • هل هناك جدار حماية؟
  • هل هناك أي تبعيات معروفة مأخوذة من المصدر/انتقال البيانات من الخادم على عناوين IP المعنية؟
  • هل هو نشر متعدد المناطق؟
  • هل يمكننا تعديل المثيل الحالي أم أن الإعداد المتوازي مطلوب؟
  • هل يمكن أن يكون هناك وقت تعطل؟
  • هل يمكن إجراء الترحيل في ساعات العمل؟

• ما هي المتطلبات الأساسية للترحيل؟

  بالنسبة للمثيلات غير المحقونة من VNet، لا توجد متطلبات أساسية مطلوبة. إذا قمت بترحيل الاحتفاظ بعنوان IP العام الخاص بك، فسيعرض هذا مثيل APIM الخاص بك غير مستجيب لمدة 15 دقيقة تقريبا. قد لا يكون هناك وقت تعطل إذا اخترت خيار عنوان IP الظاهري الجديد الذي يجعل إدارة واجهة برمجة التطبيقات متاحة على عنوان IP جديد. المثيلات التي تم تكوينها باستخدام مجال مخصص باستخدام سجل A و/أو وجود تبعيات للشبكة على عنوان IP الظاهري العام سيكون لها وقت تعطل عند طلب عنوان IP ظاهري جديد.

• هل سيؤدي الترحيل إلى وقت تعطل؟

  بالنسبة إلى المثيلات غير المحقونة من VNet، هناك وقت توقف لمدة 15 دقيقة تقريبا فقط إذا اخترت الاحتفاظ بعنوان IP الأصلي. ومع ذلك، لا يوجد وقت تعطل إذا قمت بالترحيل باستخدام عنوان IP جديد وليس لديك تبعيات شبكة على IP الجديد. تتضمن تبعيات الشبكة اسم مجال مخصص بدون CNAME وIP allow-listing وقواعد جدار الحماية وVNets.

• هل يمكن أن تحدث خسائر في البيانات أو التكوين بحلول/أثناء الترحيل؟

  stv1 إلى stv2 الترحيل يتضمن تحديث النظام الأساسي للحوسبة وحدها ولا يتم تغيير طبقة التخزين الداخلية. ومن ثم فإن جميع التكوينات آمنة أثناء عملية الترحيل. يتضمن ذلك الهوية المدارة المعينة من قبل النظام، والتي إذا تم تمكينها يتم الاحتفاظ بها.

• كيفية تأكيد اكتمال الترحيل ونجاحه؟

  يعتبر الترحيل كاملا وناجحا عندما تقرأ الحالة في صفحة النظرة العامة Online مع إصدار النظام الأساسي إما stv2 أو stv2.1. تحقق أيضا من أن حالة الشبكة في شفرة الشبكة تظهر باللون الأخضر لجميع الاتصالات المطلوبة.

• هل يمكنني إجراء الترحيل باستخدام المدخل؟

  نعم، يرشد جزء ترحيل النظام الأساسي في مدخل Microsoft Azure من خلال الترحيل للمثيلات غير المحقونة من VNet.

• هل يمكنني الاحتفاظ بعنوان IP للمثيل؟

  نعم، يمكن الاحتفاظ بعنوان IP، ولكن سيكون هناك وقت توقف لمدة 15 دقيقة تقريبا.

• هل هناك مسار ترحيل دون تعديل المثيل الموجود؟

  نعم، تحتاج إلى ترحيل جنبا إلى جنب. وهذا يعني إنشاء مثيل APIM جديد بالتوازي مع المثيل الحالي ونسخ التكوين إلى المثيل الجديد.

• ماذا يحدث إذا فشل الترحيل؟

  إذا لم يظهر مثيل API Management إصدار النظام الأساسي ك stv2 أو stv2.1 وحالة على أنه متصل بعد بدء الترحيل، فمن المحتمل أن يكون قد فشل. يتم التراجع عن الخدمة تلقائيا إلى المثيل القديم ولا يتم إجراء أي تغييرات. إذا كانت لديك مشاكل (مثل إذا كانت الحالة هي التحديث لأكثر من ساعتين)، فاتصل بدعم Azure.

• ما هي الوظائف غير المتوفرة أثناء الترحيل؟

  بالنسبة للمثيلات غير المحقونة من VNet:

  • إذا اخترت الاحتفاظ بعنوان IP الأصلي: طلبات واجهة برمجة التطبيقات غير مستجيبة لمدة 15 دقيقة تقريبا أثناء ترحيل عنوان IP إلى البنية الأساسية الجديدة. يتم تأمين تكوين البنية الأساسية (مثل المجالات المخصصة والمواقع وشهادات المرجع المصدق) لمدة 45 دقيقة.
  • إذا اخترت الترحيل إلى عنوان IP جديد: تظل طلبات واجهة برمجة التطبيقات مستجيبة أثناء الترحيل. يتم تأمين تكوين البنية الأساسية (مثل المجالات المخصصة والمواقع وشهادات المرجع المصدق) لمدة 30 دقيقة. بعد الترحيل، ستحتاج إلى تحديث أي تبعيات للشبكة بما في ذلك DNS وقواعد جدار الحماية وVNets لاستخدام عنوان VIP الجديد.

• كم من الوقت سيستغرق الترحيل؟

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

• هل يمكنني التراجع عن الترحيل إذا لزم الأمر؟

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

• هل هناك أي تغيير مطلوب في المجالات المخصصة/ مناطق DNS الخاصة؟

  بالنسبة للمثيلات التي تم إدخالها غير VNet، لا يلزم إجراء أي تغييرات إذا تم الاحتفاظ ب IP. إذا تم اختيار IP جديد، يجب تحديث المجالات المخصصة التي تشير إلى IP.

• يتم نشر مثيل stv1 الخاص بي إلى مناطق Azure متعددة (متعددة المناطق). كيف أعمل الترقية إلى stv2؟

  بالنسبة لإدارة واجهة برمجة التطبيقات التي لا يتم إدخالها في VNet، اتبع خطوات الترحيل باستخدام المدخل أو Azure CLI. سيتم ترحيل جميع المناطق إلى stv2.

• ما الذي يجب أن نأخذه بعين الاعتبار للبوابات المستضافة ذاتيا؟

  لا تحتاج إلى القيام بأي شيء في البوابات المستضافة ذاتيا. تحتاج فقط إلى ترحيل مثيلات إدارة واجهة برمجة التطبيقات التي تعمل في Azure التي تتأثر بإيقاف stv1 النظام الأساسي. لاحظ أنه قد يكون هناك IP جديد لنقطة نهاية التكوين لمثيل APIM، ويجب تحديث أي قيود على الشبكة مثبتة على IP.

• كيف يتأثر مدخل المطور بالترحيل؟

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

• هل هناك أي تأثير على التكلفة بمجرد ترحيلنا إلى stv2؟

  يظل نموذج الفوترة كما هو بالنسبة stv2 ولن تكون هناك أي تكلفة إضافية يتم تكبدها أثناء الترحيل وبعده.

• ما هي أذونات التحكم في الوصول استنادا إلى الدور المطلوبة لترحيل stv1 إلى stv2؟

  يحتاج المستخدم/العملية التي تقوم بالترحيل إلى الوصول للكتابة إلى مثيل APIM.

فيديو

المحتوى ذو الصلة

• كيف أعمل تعرف النظام الأساسي الذي يستضيف مثيل APIM الخاص بي؟

• فوائد النظام الأساسي لحساب stv2 لإدارة واجهة برمجة التطبيقات

• تعرف على إيقاف منصة stv1 في أغسطس 2024