ترحيل مثيل خطة Azure Spring Apps Basic أو Standard إلى خطة المؤسسة

إشعار

سيتم إهمال الخطط الأساسية والقياسية والمؤسسة بدءا من منتصف مارس 2025، مع فترة تقاعد 3 سنوات. نوصي بالانتقال إلى Azure Container Apps. لمزيد من المعلومات، راجع إعلان إيقاف Azure Spring Apps.

سيتم إهمال الاستهلاك القياسي والخطة المخصصة بدءا من 30 سبتمبر 2024، مع إيقاف التشغيل الكامل بعد ستة أشهر. نوصي بالانتقال إلى Azure Container Apps. لمزيد من المعلومات، راجع ترحيل استهلاك Azure Spring Apps القياسي وخطة مخصصة إلى Azure Container Apps.

تنطبق هذه المقالة على: ✔️ Basic/Standard ✔️ Enterprise

توضح لك هذه المقالة كيفية ترحيل تطبيق موجود في الخطة الأساسية أو القياسية إلى خطة المؤسسة. عند الترحيل من الخطة الأساسية أو القياسية إلى خطة المؤسسة، تحل مكونات VMware Tanzu محل مكونات Spring Cloud للبرامج مفتوحة المصدر (OSS) لتوفير المزيد من دعم الميزات.

تستخدم هذه المقالة تطبيقات عينة Pet Clinic كأمثلة على كيفية الترحيل.

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

• اشتراك Azure. في حال لم يكن لديك اشتراك Azure، أنشئ حسابًا مجانيًا قبل البدء.
• إصدار Azure CLI 2.45.0 أو أعلى.
• ملحق خطة Azure Spring Apps Enterprise. استخدم الأمر التالي لإزالة الإصدارات السابقة وتثبيت أحدث ملحق لخطة المؤسسة. إذا قمت بتثبيت الملحق spring-cloud مسبقًا، قم بإلغاء تثبيته لتجنب عدم تطابق التكوين والإصدار.

  az extension add --upgrade --name spring
  az extension remove --name spring-cloud
  

• Git.

توفير مثيل خدمة

في خطة Azure Spring Apps Enterprise، تحل مكونات VMware Tanzu محل مكونات OSS Spring Cloud لتوفير المزيد من دعم الميزات. يتم تمكين مكونات Tanzu عند الطلب وفقًا لاحتياجاتك. يجب تمكين المكونات التي تحتاجها قبل إنشاء مثيل خدمة Azure Spring Apps.

إشعار

لاستخدام مكونات Tanzu، لابد من تمكينها عند تكوين إعدادات تشغيل خدمة مثيل خدمة تطبيقات Azure Spring. لا يمكنك تمكينها بعد التوفير في هذا الوقت.

قم باستخدام الخطوات التالية لتوفير مثيل خدمة Azure Spring Apps:

مدخل Microsoft Azure

1. افتح مدخل Azure.

2. في مربع البحث العلوي، ابحث عن Azure Spring Apps.

3. حدد Azure Spring Apps من النتائج ثم حدد Create.

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

5. بالنسبة إلى الخطة في تفاصيل الخدمة، حدد تغيير.

   

6. في صفحة اختيار خطتك ، حدد صف المؤسسة في الجدول، ثم حدد تحديد.

   

7. مرة أخرى في صفحة Create Azure Spring Apps ، حدد Terms للموافقة على الشروط القانونية وبيانات الخصوصية الخاصة بعرض خطة Enterprise في Azure Marketplace.

8. حدد Next: VMware Tanzu settings.

9. في علامة التبويب إعدادات VMWare Tanzu، قم بالتمرير عبر القائمة لمراجعة مكونات Tanzu. يتم تمكين جميع المكونات بشكل افتراضي.

   

   إشعار

   فكر بعناية في مكونات Tanzu التي تريد استخدامها أو تمكينها أثناء مرحلة التزويد. بعد توفير مثيل Azure Spring Apps، لا يمكنك تمكين أو تعطيل مكونات Tanzu.

10. حدد علامة التبويب Application Insights ثم حدد Enable Application Insights. راجع الإعدادات التالية:

    • يجب تحديد تمكين Application Insights .
    • اختر مثيل Application Insights الحالي أو قم بإنشاء مثيل Application Insights جديد.
    • أدخل معدل أخذ العينات في نطاق 0-100، أو استخدم القيمة الافتراضية 10.

    يمكنك أيضًا تمكين Application Insights بعد توفير مثيل Azure Spring Apps. لمزيد من المعلومات حول تسعير Application Insights، راجع قسم فوترة Application Insights في حسابات وخيارات تكلفة سجلات Azure Monitor.

    إشعار

    ستدفع مقابل استخدام Application Insights عند دمجها مع Azure Spring Apps.

11. حدد المراجعة والإنشاء وانتظر حتى يكتمل التحقق من الصحة، ثم حدد الإنشاء لبدء توفير مثيل الخدمة.

يستغرق الأمر حوالي 5 دقائق لإنهاء توفير الموارد.

Azure CLI

1. استخدم الأمر التالي لتحديث Azure CLI بملحق Azure Spring Apps:

   az extension add --upgrade --name spring
   

2. استخدم الأوامر التالية لتسجيل الدخول إلى Azure CLI واختيار اشتراكك النشط:

   az login
   az account list --output table
   az account set --subscription <subscription-ID>
   

3. استخدم الأمر التالي لقبول الشروط القانونية وبيانات الخصوصية لخطة المؤسسة. هذه الخطوة مطلوبة فقط في المرة الأولى التي تقوم فيها بإنشاء مثيل Azure Spring Apps على خطة المؤسسة.

   az provider register --namespace Microsoft.SaaS
   az term accept --publisher vmware-inc --product azure-spring-cloud-vmware-tanzu-2 --plan asa-ent-hr-mtr
   

4. إنشاء اسم لمثيل خدمة Azure Spring Apps. يجب أن يتراوح الاسم بين 4 أحرف و32 حرفاً، ويجب أن يحتوي على أحرف صغيرة وأرقام وواصلات فقط. يجب أن يكون الحرف الأول من اسم الخدمة حرفاً ويجب أن يكون الحرف الأخير إما حرفاً أو رقماً.

5. استخدم الأمر التالي لإنشاء مجموعة موارد ومثيل خدمة Azure Spring Apps:

   az spring create \
       --resource-group <resource-group-name> \
       --name <Azure-Spring-Apps-service-instance-name> \
       --sku enterprise
   

   لمزيد من المعلومات حول مجموعات الموارد، انظر ما هو Azure Resource Manager ؟ .

إنشاء التطبيقات وتكوينها

خطوات إنشاء التطبيق هي نفسها الخطة القياسية.

1. استخدم الأمر التالي لتعيين الإعدادات الافتراضية ل Azure CLI. تأكد من استبدل العناصر النائبة بقيمتك الخاصة.

   az config set defaults.group=<resource-group-name>
   az config set defaults.spring=<Azure-Spring-Apps-service-instance-name>
   

2. استخدم الأوامر التالية لإنشاء التطبيقين الأساسيين ل PetClinic، api-gateway و customers-service:

   az spring app create --name api-gateway --instance-count 1 --memory 2Gi --assign-endpoint
   az spring app create --name customers-service --instance-count 1 --memory 2Gi
   

استخدام خدمة تكوين التطبيق للتكوين الخارجي

للتكوين الخارجي في نظام موزع، يتوفر خادم تكوين Spring Cloud المدار (OSS) فقط في الخطط الأساسية والقياسية. في خطة المؤسسة، توفر خدمة تكوين التطبيق ل Tanzu وظائف مماثلة لتطبيقاتك. يصف الجدول التالي بعض الاختلافات في الاستخدام بين خادم تكوين OSS وخدمة تكوين التطبيق.

المكون	خطط الدعم	مُمَكّن	الربط بتطبيق	ملف التعريف
خادم تكوين Spring Cloud	أساسي/قياسي	ممكن دائما.	ربط تلقائي	تم تكوينه في التعليمات البرمجية المصدر للتطبيق.
خدمة تكوين التطبيق لـ Tanzu	المؤسسة	تمكين عند الطلب.	ربط يدوي	يتم توفيره كما هو الحال config-file-pattern في توزيع Azure Spring Apps.

على عكس وضع خادم العميل في خادم تكوين OSS، تدير خدمة تكوين التطبيق التكوين باستخدام Kubernetes-native ConfigMap، الذي يتم ملؤه من الخصائص المحددة في مستودعات Git الخلفية. لا يمكن لخدمة تكوين التطبيق الحصول على ملف التعريف النشط الذي تم تكوينه في التعليمات البرمجية المصدر للتطبيق لمطابقة التكوين الصحيح، لذلك يجب تحديد التكوين config-file-pattern الصريح على مستوى نشر Azure Spring Apps.

تكوين خدمة تكوين التطبيق ل Tanzu

اتبع هذه الخطوات لاستخدام خدمة تكوين التطبيقات لـ Tanzu كخدمة تكوين مركزية.

مدخل Microsoft Azure

1. في مثيل Azure Spring Apps Enterprise، حدد خدمة تكوين التطبيق في جزء التنقل. عرض حالة التشغيل والموارد المخصصة لخدمة تكوين التطبيق ل Tanzu.

   

2. حدد الإعدادات وأكمل النموذج في المستودعات لإضافة إدخال جديد بالمعلومات التالية:

   • الاسم: default
   • الأنماط: api-gateway,customers-service
   • معرف الموارد المنتظم URI: https://github.com/Azure-Samples/spring-petclinic-microservices-config
   • التسمية: master

   

3. قم بتحديد التحقق من الصحة للتحقق من صحة الوصول إلى معرف URI المستهدف.

4. بعد اكتمال التحقق من الصحة بنجاح، قم بتحديد تطبيق لتحديث إعدادات التكوين.

Azure CLI

استخدم الأمر التالي لتعيين المستودع الافتراضي:

az spring application-configuration-service git repo add \
    --name default \
    --patterns api-gateway,customers-service \
    --uri https://github.com/Azure-Samples/spring-petclinic-microservices-config.git \
    --label master

ربط التطبيقات بخدمة تكوين التطبيق ل Tanzu

عند استخدام خدمة تكوين التطبيقات لـ Tanzu مع واجهة خلفية Git، يجب عليك ربط التطبيق بخدمة تكوين التطبيقات لـ Tanzu. بعد ربط التطبيق، ستحتاج إلى تكوين النمط الذي يستخدمه التطبيق. استخدم الخطوات التالية لربط وتكوين نمط التطبيق.

مدخل Microsoft Azure

استخدم الخطوات التالية لربط التطبيقات بخدمة تكوين التطبيق ل VMware Tanzu.

1. في مثيل Azure Spring Apps Enterprise، حدد خدمة تكوين التطبيق في جزء التنقل.

2. حدد ربط التطبيق ثم حدد ربط التطبيق.

   

3. حدد تطبيقا في القائمة المنسدلة ثم حدد Apply لربط التطبيق بخدمة تكوين التطبيق ل Tanzu.

Azure CLI

استخدم الأوامر التالية لربط التطبيقات بخدمة تكوين التطبيق ل VMware Tanzu وسجل خدمة VMware Tanzu:

az spring application-configuration-service bind --app api-gateway
az spring application-configuration-service bind --app customers-service

لمزيد من المعلومات، راجع استخدام خدمة تكوين التطبيق لـ Tanzania .

استخدام سجل الخدمة لـ Tanzu

سجل الخدمات هو أحد مكونات VMware Tanzu المسجلة الملكية. إنه يزود تطبيقاتك بتنفيذ نمط Service Discovery، أحد المفاهيم الرئيسية للبنية القائمة على الخدمة الدقيقة. في خطة المؤسسة، يوفر سجل الخدمة ل Tanzu سجل الخدمة واكتشاف الدعم لتطبيقاتك. تتوفر سحابة الربيع المدارة يوريكا فقط في الخطة الأساسية والقياسية ولا تتوفر في خطة المؤسسة.

المكون	الخطة القياسية	خطة المؤسسة
سجل الخدمة	OSS eureka ربط تلقائي (الحقن دائما) يتم توفيره دائمًا	سجل الخدمة ل Tanzu يحتاج إلى ربط يدوي للتطبيق التمكين حسب الطلب

ربط طلب إلى Tanzu Service Registry

لربط التطبيقات بخدمة تكوين التطبيق ل VMware Tanzu، اتبع الخطوات التالية.

مدخل Microsoft Azure

1. في مثيل Azure Spring Apps Enterprise، حدد Service Registry.

2. حدد ربط التطبيق. تظهر التطبيقات المرتبطة حاليا ضمن اسم التطبيق.

3. حدد ربط التطبيق.

4. حدد تطبيقا في القائمة المنسدلة ثم حدد Apply لربط التطبيق ب Tanzu Service Registry.

   

Azure CLI

استخدم الأوامر التالية لربط التطبيقات بخدمة تكوين التطبيق ل VMware Tanzu وسجل خدمة VMware Tanzu:

az spring service-registry bind --app api-gateway
az spring service-registry bind --app customers-service

إشعار

عند تغيير حالة الربط/إلغاء الربط، يجب إعادة تشغيل التطبيق أو إعادة توزيعه لجعل التغيير ساري المفعول.

لمزيد من المعلومات، انظر استخدم سجل خدمات Tanzu .

إنشاء التطبيقات وتوزيعها

في خطة المؤسسة، يتم استخدام Tanzu Build Service لإنشاء التطبيقات. يوفر المزيد من الميزات مثل تطبيقات polyglot للتوزيع من البيانات الاصطناعية، مثل التعليمات البرمجية المصدر وملفات zip.

لاستخدام Tanzu Build Service، تحتاج إلى تحديد مورد لمهمة البناء والمنشئ لاستخدامه. يمكنك أيضًا تحديد المعلمة --build-env لتعيين بيئات الإنشاء.

إذا كان التطبيق يرتبط بخدمة تكوين التطبيق ل Tanzu، فستحتاج إلى تحديد وسيطة —config-file-patternإضافية .

لمزيد من المعلومات، راجع استخدام خدمة بناء Tanzu.

إنشاء التطبيقات محليا

استخدم الخطوات التالية للبناء محليا:

1. استخدم الأوامر التالية لنسخ نموذج مستودع التطبيق في حساب Azure الخاص بك، وتغيير الدليل، وإنشاء المشروع:

   git clone -b enterprise https://github.com/azure-samples/spring-petclinic-microservices
   cd spring-petclinic-microservices
   mvn clean package -DskipTests
   

   قد يستغرق تجميع المشروع عدة دقائق. عند الانتهاء، لديك ملفات JAR فردية لكل خدمة في المجلد الخاص بها.

2. استخدم الأوامر التالية لنشر ملفات JAR المضمنة في الخطوة السابقة:

   az spring app deploy \
       --name api-gateway \
       --artifact-path spring-petclinic-api-gateway/target/spring-petclinic-api-gateway-2.3.6.jar \
       --config-file-patterns api-gateway
   az spring app deploy \
       --name customers-service \
       --artifact-path spring-petclinic-customers-service/target/spring-petclinic-customers-service-2.3.6.jar \
       --config-file-patterns customers-service
   

3. استخدم الأمر التالي للاستعلام عن حالة التطبيق بعد النشر:

   az spring app list --output table
   

   تنتج عن هذا الأمر مخرجات مشابهة للمثال التالي:

   Name                  Location    ResourceGroup       Public Url                                                 Production Deployment    Provisioning State    CPU    Memory    Running Instance    Registered Instance    Persistent Storage    Bind Service Registry    Bind Application Configuration Service
   --------------------  ----------  ---------------  ---------------------------------------------------------  -----------------------  --------------------  -----  --------  ------------------  ---------------------  --------------------  -----------------------  ----------------------------------------
   api-gateway           eastus      <resource group>   https://<service_name>-api-gateway.asc-test.net                    default                  Succeeded             1      2Gi       1/1                1/1                    -                     True                     True
   customers-service     eastus      <resource group>                                                                      default                  Succeeded             1      2Gi       1/1                1/1                    -                     True                     True
   

استخدام Application Insights

تستخدم خطة Azure Spring Apps Enterprise روابط buildpack لدمج Application Insights مع النوع ApplicationInsights بدلا من In-Process Agent. لمزيد من المعلومات، راجع كيفية تكوين تكامل APM وشهادات CA.

يسرد الجدول التالي موفري APM المتوفرين للخطط.

الخطة القياسية	خطة المؤسسة
Application insight بقايا جديدة Dynatrace AppDynamics	Application insight بقايا جديدة Dynatrace AppDynamics ElasticAPM

مدخل Microsoft Azure

لفحص الإعدادات الحالية أو تحديثها في Application Insights، استخدم الخطوات التالية:

1. في مثيل Azure Spring Apps Enterprise، حدد Application Insights.

2. تمكين Application Insights أو تعطيله عن طريق تحديد Edit binding أو Unbind binding.

   

3. حدد تحرير الربط. قم بتحرير إعدادات الربط ثم حدد حفظ.

   

Azure CLI

توضح لك الأوامر التالية كيفية التحقق من الإعدادات الحالية أو تحديثها في Application Insights.

استخدم الأمر التالي لإنشاء ربط حزمة بناء Application Insights:

az spring build-service builder buildpack-binding create \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \
    --type ApplicationInsights \
    --properties sampling-percentage=<your-sampling-percentage> \
                 connection-string=<your-connection-string>

استخدم الأمر التالي لسرد كافة روابط buildpack، والعثور على روابط Application Insights للنوع ApplicationInsights:

az spring build-service builder buildpack-binding list \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --builder-name <your-builder-name>

استخدم الأمر التالي لاستبدال ربط حزمة بناء Application Insights:

az spring build-service builder buildpack-binding set \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \
    --type ApplicationInsights \
    --properties sampling-percentage=<your-sampling-percentage> \
                 connection-string=<your-connection-string>

استخدم الأمر التالي للحصول على ربط حزمة بناء Application Insights:

az spring build-service builder buildpack-binding show \
    --resource-group <resource-group-name> \
    --service <Azure-Spring-Apps-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \

استخدم الأمر التالي لحذف ربط حزمة بناء Application Insights:

az spring build-service builder buildpack-binding delete \
    --resource-group <your-resource-group-name> \
    --service <your-service-instance-name> \
    --name <your-binding-name> \
    --builder-name <your-builder-name> \

لمزيد من المعلومات، راجع عامل Application Insights Java قيد المعالجة في Azure Spring Apps.

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

• Azure Spring Apps
• مدخل واجهة برمجة التطبيقات لخدمة VMware Tanzu
• استخدام بوابة Spring Cloud