التشغيل السريع: إنشاء اتصال خدمة في Azure Spring Apps باستخدام Azure CLI

يوضح لك هذا التشغيل السريع كيفية توصيل Azure Spring Apps بموارد السحابة الأخرى باستخدام Azure CLI وموصل الخدمة.

يتيح لك Service Connector توصيل خدمات الحوسبة بالخدمات السحابية بسرعة، أثناء إدارة إعدادات مصادقة الاتصال والشبكات.

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

• اشتراك Azure. إذا لم يكن لديك اشتراك في Azure، فأنشئ حساب Azure مجاني قبل أن تبدأ.

• تطبيق واحد على الأقل تستضيفه Azure Spring Apps في منطقة يدعمها Service Connector. إذا لم يكن لديك واحد، فوزع تطبيقك الأول إلى Azure Spring Apps.

• استخدم بيئة 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.

• الإصدار 2.37.0 أو أعلى من Azure CLI. للترقية إلى أحدث إصدار، قم بتشغيل az upgrade. إذا كنت تستخدم Azure Cloud Shell، يتم تثبيت أحدث إصدار بالفعل.

• يجب تثبيت ملحق Azure Spring Apps في Azure CLI أو Cloud Shell. لتثبيته، قم بتشغيل az extension add --name spring.

الإعداد الأولي

1. إذا كنت تستخدم Service Connector للمرة الأولى، فابدأ بتشغيل الأمر az provider register لتسجيل موفر موارد Service Connector.

   az provider register -n Microsoft.ServiceLinker
   

   تلميح

   يمكنك التحقق مما إذا كان موفر الموارد قد تم تسجيله بالفعل عن طريق تشغيل الأمر az provider show -n "Microsoft.ServiceLinker" --query registrationState. إذا كان الإخراج هو Registered، فقد تم تسجيل Service Connector بالفعل.

2. اختياريا، قم بتشغيل الأمر az spring connection list-support-types للحصول على قائمة بالخدمات المستهدفة المدعومة ل Azure Spring Apps.

   az spring connection list-support-types --output table
   

   تلميح

   az spring إذا لم يتعرف النظام على الأمر، فتحقق من تثبيت الملحق المطلوب عن طريق تشغيل az extension add --name spring.

إنشاء اتصال خدمة

إنشاء اتصال من Azure Spring Apps باستخدام هوية مدارة أو مفتاح وصول.

الهوية المدارة

هام

لاستخدام هوية مدارة، يجب أن يكون لديك الإذن لتعديل تعيينات الأدوار في معرف Microsoft Entra. بدون هذا الإذن، سيفشل إنشاء الاتصال. اطلب من مالك الاشتراك منحك إذن تعيين دور أو استخدام مفتاح وصول لإنشاء الاتصال.

1. az spring connection create قم بتشغيل الأمر لإنشاء اتصال خدمة إلى Blob Storage بهوية مدارة معينة من قبل النظام

2. قدم المعلومات التالية بناء على طلب CLI أو Cloud Shell:

   az spring connection create storage-blob --system-identity
   

   الإعدادات	‏‏الوصف
   The resource group which contains the spring-cloud	اسم مجموعة الموارد التي تحتوي على تطبيق مستضاف بواسطة Azure Spring Apps.
   Name of the spring-cloud service	اسم مورد Azure Spring Apps.
   Name of the spring-cloud app	اسم التطبيق الذي تستضيفه Azure Spring Apps الذي يتصل بالخدمة الهدف.
   The resource group which contains the storage account	اسم مجموعة الموارد مع حساب التخزين.
   Name of the storage account	اسم حساب التخزين الذي تريد الاتصال به. في هذا الدليل، نستخدم Blob Storage.

تلميح

إذا لم يكن لديك Blob Storage، يمكنك تشغيل az spring connection create storage-blob --new --system-identity لتوفير Blob Storage جديد وتوصيله مباشرة بتطبيقك الذي تستضيفه Azure Spring Apps باستخدام هوية مدارة.

مفتاح الوصول

تحذير

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

1. az spring connection create قم بتشغيل الأمر لإنشاء اتصال خدمة بين Azure Spring Apps وAzure Blob Storage باستخدام مفتاح وصول.

   az spring connection create storage-blob --secret
   

2. قدم المعلومات التالية بناء على طلب CLI أو Cloud Shell:

   الإعدادات	‏‏الوصف
   The resource group which contains the spring-cloud	اسم مجموعة الموارد التي تحتوي على تطبيق تستضيفه Azure Spring Apps.
   Name of the spring-cloud service	اسم مورد Azure Spring Apps.
   Name of the spring-cloud app	اسم التطبيق الذي تستضيفه Azure Spring Apps الذي يتصل بالخدمة الهدف.
   The resource group which contains the storage account	اسم مجموعة الموارد مع حساب التخزين.
   Name of the storage account	اسم حساب التخزين الذي تريد الاتصال به. في هذا الدليل، نستخدم Blob Storage.

تلميح

إذا لم يكن لديك Blob Storage، يمكنك تشغيل az spring connection create storage-blob --new --secret لتوفير Blob Storage جديد وتوصيله مباشرة بتطبيقك الذي تستضيفه Azure Spring Apps باستخدام سلسلة الاتصال.

عرض الاتصالات

قم بتشغيل az spring connection list الأمر لسرد جميع الاتصالات المتوفرة في Azure Spring Apps.

استبدل العناصر النائبة <azure-spring-apps-resource-group>و <azure-spring-apps-name>و <app-name> من الأمر أدناه باسم مجموعة موارد Azure Spring Apps واسم مورد Azure Spring Apps واسم التطبيق الخاص بك. يمكنك أيضا إزالة --output table الخيار لعرض مزيد من المعلومات حول اتصالاتك.

az spring connection list --resource-group <azure-spring-apps-resource-group> --service <azure-spring-apps-name> --app <app-name>--output table

يعرض الإخراج أيضا حالة توفير الاتصالات الخاصة بك: فشل أو نجح.

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

تحقق من الدلائل أدناه لمزيد من المعلومات حول Service Connector وAzure Spring Apps.

البرنامج التعليمي: Azure Spring Apps + MySQL

البرنامج التعليمي: Azure Spring Apps + Apache Kafka على Confluent Cloud