الاتصال قاعدة بيانات Azure Cosmos DB إلى تطبيقك في Azure Spring Apps

إشعار

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

تنطبق هذه المقالة على: ✔️ Java ✔️ C#‎

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

بدلا من تكوين تطبيقات Spring Boot يدويا، يمكنك توصيل خدمات Azure المحددة تلقائيا بتطبيقاتك باستخدام Azure Spring Apps. توضح هذه المقالة كيفية توصيل التطبيق الخاص بك بقاعدة بيانات Azure Cosmos DB.

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

• تطبيق تم نشره في Azure Spring Apps. لمزيد من المعلومات، راجع التشغيل السريع: توزيع التطبيق الأول الخاص بك على تطبيقات Azure Spring.
• مثيل قاعدة بيانات Azure Cosmos DB.
• إصدار Azure CLI 2.45.0 أو أعلى.

تحضير مشروعك

Java

1. أضف إحدى التبعيات التالية إلى ملف pom.xml التطبيق الخاص بك. اختر التبعية المناسبة لنوع واجهة برمجة التطبيقات لديك.

   • نوع واجهة برمجة التطبيقات: NoSQL

     <dependency>
         <groupId>com.azure.spring</groupId>
         <artifactId>spring-cloud-azure-starter-data-cosmos</artifactId>
     </dependency>
     

   • نوع واجهة برمجة التطبيقات: MongoDB

     <dependency>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter-data-mongodb</artifactId>
     </dependency>
     

   • نوع واجهة برمجة التطبيقات: Cassandra

     <dependency>
         <groupId>org.springframework.boot</groupId>
         <artifactId>spring-boot-starter-data-cassandra</artifactId>
     </dependency>
     

2. حدّث التطبيق الحالي عن طريق تشغيل az spring app deploy، أو أنشئ توزيعًا جديدًا لهذا التغيير عن طريق تشغيل az spring app deployment create.

بوليغلوت

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

للحصول على أسماء متغيرات البيئة الافتراضية، راجع المقالات التالية:

• Azure Cosmos DB للجدول
• Azure Cosmos DB ل NoSQL
• Azure Cosmos DB ل MongoDB
• Azure Cosmos DB ل Gremlin
• Azure Cosmos DB ل Cassandra

الاتصال تطبيقك إلى Azure Cosmos DB

الاتصال الخدمة

إشعار

بشكل افتراضي، يتم إنشاء الاتصال الخدمة على مستوى التطبيق. لتجاوز الاتصالات، يمكنك إنشاء اتصالات أخرى مرة أخرى في عمليات التوزيع.

استخدام Azure CLI

استخدم Azure CLI لتكوين تطبيق Spring للاتصال بقاعدة بيانات Cosmos NoSQL باستخدام az spring connection create الأمر ، كما هو موضح في المثال التالي. تأكد من استبدال المتغيرات في المثال بقيم فعلية.

إشعار

قد يستغرق تحديث إعدادات قاعدة بيانات Azure Cosmos DB بضع دقائق حتى يكتمل.

إشعار

إذا كنت تستخدم Cosmos Cassandra، فاستخدم --key_space بدلا من --database. إذا كنت تستخدم Cosmos Table، فاستخدم --table بدلا من --database. لمزيد من المعلومات، راجع التشغيل السريع: إنشاء اتصال خدمة في Azure Spring Apps باستخدام Azure CLI.

az spring connection create cosmos-sql \
    --resource-group $AZURE_SPRING_APPS_RESOURCE_GROUP \
    --service $AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME \
    --app $APP_NAME \
    --target-resource-group $COSMOSDB_RESOURCE_GROUP \
    --account $COSMOSDB_ACCOUNT_NAME \
    --database $DATABASE_NAME \
    --secret

إشعار

إذا كنت تستخدم Service الاتصال or للمرة الأولى، فابدأ بتشغيل الأمر az provider register --namespace Microsoft.ServiceLinker لتسجيل موفر موارد Service الاتصال or.

تلميح

قم بتشغيل الأمر az spring connection list-support-types --output table للحصول على قائمة بالخدمات المستهدفة المدعومة وأساليب المصادقة ل Azure Spring Apps. az spring إذا لم يتعرف النظام على الأمر، فتحقق من تثبيت الملحق المطلوب عن طريق تشغيل az extension add --name spring.

استخدام مدخل Microsoft Azure

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

1. حدد مثيل Azure Spring Apps في مدخل Microsoft Azure وحدد التطبيقات من قائمة التنقل. اختر التطبيق الذي تريد توصيله وحدد الخدمة الاتصال أو في قائمة التنقل.

2. حدد إنشاء.

3. في علامة التبويب Basics ، لنوع الخدمة، حدد Cosmos DB، ثم اختر اشتراكا. بالنسبة إلى نوع واجهة برمجة التطبيقات، حدد Core (SQL)، واختر حساب Cosmos DB، وقاعدة بيانات. بالنسبة لنوع العميل، حدد Java، ثم حدد Next: Authentication. إذا لم تكن قد أنشأت قاعدة البيانات الخاصة بك بعد، فشاهد التشغيل السريع: إنشاء حساب Azure Cosmos DB وقاعدة بيانات وحاوية وعناصر من مدخل Microsoft Azure.

4. في علامة التبويب Authentication، اختر الاتصال سلسلة. تقوم الخدمة الاتصال أو باسترداد مفتاح الوصول تلقائيا من حساب Cosmos DB الخاص بك. حدد Next: Networking.

5. في علامة التبويب Networking ، حدد Configure firewall rules لتمكين الوصول إلى الخدمة المستهدفة، ثم حدد Next: Review + Create.

6. في علامة التبويب مراجعة + إنشاء ، انتظر حتى يتم تمرير التحقق من الصحة ثم حدد إنشاء. قد يستغرق الإنشاء بضع دقائق حتى يكتمل.

7. بمجرد إنشاء الاتصال بين تطبيقات Spring وقاعدة بيانات Cosmos DB الخاصة بك، يمكنك رؤيتها في صفحة Service الاتصال or وتحديد زر الكشف لعرض متغيرات الاتصال المكونة.

Terraform

يوضح البرنامج النصي Terraform التالي كيفية إعداد تطبيق تم نشره في Azure Spring Apps باستخدام حساب Azure Cosmos DB.

provider "azurerm" {
  features {}
}

variable "application_name" {
  type        = string
  description = "The name of your application"
  default     = "demo-cosmosdb"
}

resource "azurerm_resource_group" "example" {
  name     = "example-resources"
  location = "West Europe"
}

resource "azurerm_cosmosdb_account" "cosmosdb" {
  name                = "cosmosacct-${var.application_name}-001"
  resource_group_name = azurerm_resource_group.example.name
  location            = azurerm_resource_group.example.location
  offer_type          = "Standard"
  kind                = "GlobalDocumentDB"

  consistency_policy {
    consistency_level = "Session"
  }

  geo_location {
    failover_priority = 0
    location          = azurerm_resource_group.example.location
  }
}

resource "azurerm_cosmosdb_sql_database" "cosmosdb" {
  name                = "cosmos-${var.application_name}-001"
  resource_group_name = azurerm_cosmosdb_account.cosmosdb.resource_group_name
  account_name        = azurerm_cosmosdb_account.cosmosdb.name
}

resource "azurerm_spring_cloud_service" "example" {
  name                = "${var.application_name}"
  resource_group_name = azurerm_resource_group.example.name
  location            = azurerm_resource_group.example.location
}

resource "azurerm_spring_cloud_app" "example" {
  name                = "${var.application_name}-app"
  resource_group_name = azurerm_resource_group.example.name
  service_name        = azurerm_spring_cloud_service.example.name
  is_public           = true
  https_only          = true
}

resource "azurerm_spring_cloud_java_deployment" "example" {
  name                = "default"
  spring_cloud_app_id = azurerm_spring_cloud_app.example.id
  quota {
    cpu    = "2"
    memory = "4Gi"
  }
  instance_count      = 1
  jvm_options         = "-XX:+PrintGC"
  runtime_version     = "Java_11"

  environment_variables = {
    "spring.cloud.azure.cosmos.endpoint" : azurerm_cosmosdb_account.cosmosdb.endpoint
    "spring.cloud.azure.cosmos.key" : azurerm_cosmosdb_account.cosmosdb.primary_key
    "spring.cloud.azure.cosmos.database" : azurerm_cosmosdb_sql_database.cosmosdb.name
  }
}

resource "azurerm_spring_cloud_active_deployment" "example" {
  spring_cloud_app_id = azurerm_spring_cloud_app.example.id
  deployment_name     = azurerm_spring_cloud_java_deployment.example.name
}

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

في هذه المقالة، تعلمت كيفية توصيل تطبيقك في Azure Spring Apps بقاعدة بيانات Azure Cosmos DB. لمعرفة المزيد حول توصيل الخدمات بتطبيقك، راجع الاتصال إلى ذاكرة التخزين المؤقت Azure ل Redis.