التشغيل السريع: توصيل Azure Spring Apps بقواعد البيانات والخدمات باستخدام Service Connector

ابدأ باستخدام Service Connector لتوصيل Azure Spring Apps بقواعد البيانات وحسابات التخزين وخدمات Azure الأخرى. يبسط Service Connector المصادقة والتكوين، مما يتيح لك الاتصال بالموارد باستخدام هويات مدارة أو طرق مصادقة أخرى.

توفر هذه المقالة إرشادات خطوة بخطوة لكل من مدخل Microsoft Azure وAzure CLI. اختر طريقتك المفضلة باستخدام علامات التبويب أعلاه.

إشعار

دخلت الخطط الأساسيةوالقياسيةوالمؤسسية فترة تقاعد في 17 مارس 2025. لمزيد من المعلومات، راجع إعلان إيقاف Azure Spring Apps.

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

حساب Azure مع اشتراك نشط. أنشئ حساب Azure مجانًا.
تطبيق تم نشره في Azure Spring Apps في منطقة يدعمها Service Connector.
مورد هدف لتوصيل Azure Spring Apps به. على سبيل المثال، Azure Key Vault.
الأذونات اللازمة لإنشاء اتصالات الخدمة وإدارتها.

حساب Azure مع اشتراك نشط. أنشئ حساب Azure مجانًا.
تطبيق تم نشره في Azure Spring Apps في منطقة يدعمها Service Connector.
مورد هدف لتوصيل Azure Spring Apps به. على سبيل المثال، Azure Key Vault.
الأذونات اللازمة لإنشاء اتصالات الخدمة وإدارتها.

استخدم بيئة Bash في Azure Cloud Shell. لمزيد من المعلومات، راجع بدء استخدام Azure Cloud Shell.
إذا كنت تفضل تشغيل أوامر مرجع CLI محلياً قم بتثبيت CLI Azure. إذا كنت تعمل على نظام تشغيل Windows أو macOS، ففكر في تشغيل Azure CLI في حاوية Docker. لمزيد من المعلومات، راجع كيفية تشغيل Azure CLI في حاوية Docker.
- إذا كنت تستخدم تثبيت محلي، يُرجى تسجيل الدخول إلى Azure CLI مستخدمًا أمر az login. لإنهاء عملية المصادقة، اتبع الخطوات المعروضة في جهازك. للحصول على خيارات تسجيل الدخول الأخرى، راجع المصادقة على Azure باستخدام 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.

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

إذا كنت تستخدم Service Connector لأول مرة، فابدأ بتشغيل الأمر az provider register لتسجيل موفر موارد Service Connector.
```
az provider register -n Microsoft.ServiceLinker
```
تلميح

يمكنك التحقق مما إذا كان موفر الموارد قد تم تسجيله بالفعل عن طريق تشغيل الأمر az provider show -n "Microsoft.ServiceLinker" --query registrationState. إذا كان Registeredالإخراج هو ، فقد تم تسجيل موصل الخدمة بالفعل.
اختياريا، قم بتشغيل الأمر التالي للحصول على قائمة بالخدمات المستهدفة المدعومة لتطبيقات Azure Spring.
```
az spring connection list-support-types --output table
```
تلميح

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

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

استخدم Service Connector لإنشاء اتصال خدمة آمن بين Azure Spring Apps ومساحة تخزين Azure Blob. يوضح هذا المثال الاتصال ب مخزن البيانات الثنائية الكبيرة، ولكن يمكنك استخدام نفس العملية لخدمات Azure الأخرى المدعومة.

حدد شريط البحث عن الموارد والخدمات والمستندات (G +/) في الجزء العلوي من مدخل Microsoft Azure، واكتب Azure Spring Apps في عامل التصفية وحدد Azure Spring Apps.
حدد اسم مثيل Azure Spring Apps الذي تريد الاتصال بمورد هدف.
ضمن الإعدادات، حدد التطبيقات وحدد التطبيق من القائمة.
حدد Service Connector من قائمة الخدمة وحدد إنشاء.

في علامة التبويب الأساسيات ، حدد الإعدادات التالية أو أدخلها. لقطة شاشة لمدخل Azure، املأ المعلومات الأساسية لإنشاء اتصال.

الإعدادات	مثال	‏‏الوصف
نوع الخدمة	خزنة المفاتيح	نوع الخدمة التي ستقوم بتوصيل تطبيقك بها.
اسم الاتصال	keyvault_17d38	اسم الاتصال الذي يحدد الاتصال بين التطبيق والخدمة المستهدفة. استخدم اسم الاتصال الذي يوفره Service Connector أو أدخل اسم الاتصال الخاص بك.
الاشتراك	اشتراكي	الاشتراك الذي يحتوي على الخدمة المستهدفة (الخدمة التي تريد الاتصال بها). القيمة الافتراضية هي الاشتراك الذي يحتوي على التطبيق المنشور في Azure Spring Apps.
Key Vault	my-keyvault-name	Key Vault الهدف الذي تريد الاتصال به. إذا اخترت نوع خدمة مختلفاً، فحدد مثيل الخدمة الهدف المقابل.
نوع العميل	SpringBoot	مكدس التطبيق الذي يعمل مع الخدمة المستهدفة المحددة. بالإضافة إلى SpringBoot وJava، يتم دعم مكدسات أخرى أيضا.

حدد "Next: Authentication" لتحديد نوع المصادقة. نوصيك باستخدام هوية مدارة مخصصة من قبل النظام للاتصال ب Key Vault الخاص بك.
حدد Next: Networking لتحديد تكوين الشبكة وحدد Configure firewall rules لتمكين الوصول إلى الخدمة الهدف بحيث يمكن لتطبيقك الوصول إلى مخزن البيانات الثنائية الكبيرة.
حدد Next: Review + Create لمراجعة المعلومات المقدمة. انتظر بضع ثوان حتى يقوم Service Connector بالتحقق من صحة المعلومات وحدد Create لإنشاء اتصال الخدمة.

الهوية المدارة (موصى به)
سلسلة الاتصال

قم بتشغيل az spring connection create الأمر لتوصيل تطبيق تم نشره إلى Azure Spring Apps بمورد مخزن البيانات الثنائية الكبيرة، بهوية مدارة معينة من قبل النظام. يمكنك تشغيل هذا الأمر بطريقتين مختلفتين:

قم بإنشاء الاتصال الجديد خطوة بخطوة.

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

قم بإنشاء الاتصال الجديد في الحال. استبدل العناصر النائبة بمعلوماتك الخاصة: <source-subscription>، <source_resource_group><azure-spring-apps-resource><app><target-subscription><target_resource_group>و .<account>

   az spring connection create storage-blob \                         
   --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.AppPlatform/Spring/<azure-spring-apps-resource>/apps/<app> \
   --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
   --system-identity

تلميح

إذا لم يكن لديك حساب مخزن البيانات الثنائية الكبيرة، فقم بتشغيله az spring connection create storage-blob --new --system-identity لإنشاء حساب وتوصيله بتطبيقك المستضاف على Azure Spring Apps باستخدام هوية مدارة.

تحذير

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

قم بتشغيل az spring connection create الأمر لتوصيل تطبيق تم نشره إلى Azure Spring Apps بمورد مخزن البيانات الثنائية الكبيرة، باستخدام سلسلة اتصال. يمكنك تشغيل هذا الأمر بطريقتين مختلفتين:

قم بإنشاء الاتصال الجديد خطوة بخطوة.
```
az spring connection create storage-blob --secret
```

az spring connection create storage-blob \                         
   --source-id /subscriptions/<source-subscription>/resourceGroups/<source_resource_group>/providers/Microsoft.AppPlatform/Spring/<azure-spring-apps-resource>/apps/<app> \
   --target-id /subscriptions/<target-subscription>/resourceGroups/<target_resource_group>/providers/Microsoft.Storage/storageAccounts/<account>/blobServices/default \
    --secret name=<secret-name> secret=<secret>

تلميح

إذا لم يكن لديك حساب مخزن البيانات الثنائية الكبيرة، فقم بتشغيله az spring connection create storage-blob --new --secret لإنشاء حساب وتوصيله بالتطبيق المستضاف على Azure Spring Apps باستخدام سلسلة اتصال.

عرض اتصالات الخدمة

يتم عرض اتصالات Azure Spring Apps ضمن Settings > Service Connector.

حدد > لتوسيع القائمة والوصول إلى الخصائص المطلوبة من قبل التطبيق الخاص بك.
حدد Validate للتحقق من حالة الاتصال، وحدد Learn more لمراجعة تفاصيل التحقق من صحة الاتصال.

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

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

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

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

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

الملاحظات

هل كانت هذه الصفحة مفيدة؟

Last updated on 2026-06-18