الاتصال ذاكرة التخزين المؤقت Azure ل Redis إلى تطبيقك في Azure Spring Apps

إشعار

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

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

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

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

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

• مثيل Azure Spring Apps المنشور
• مثيل خدمة Azure Cache لـRedis
• ملحق Azure Spring Apps لـ Azure CLI

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

تحضير مشروعك

Java

1. أضف التبعية التالية إلى ملف pom.xml الخاص بمشروعك:

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

2. إزالة أي spring.redis.* خصائص من ملف application.properties

3. قم بتحديث التوزيع الحالي باستخدام az spring app update أو إنشاء توزيع جديد باستخدام az spring app deployment create.

بوليغلوت

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

للحصول على أسماء متغيرات البيئة الافتراضية، راجع دمج ذاكرة التخزين المؤقت Azure ل Redis مع خدمة الاتصال أو.

الاتصال تطبيقك إلى ذاكرة التخزين المؤقت Azure ل Redis

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

إشعار

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

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

   az spring connection create redis \
       --resource-group $AZURE_SPRING_APPS_RESOURCE_GROUP \
       --service $AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME \
       --app $APP_NAME \
       --deployment $DEPLOYMENT_NAME \
       --target-resource-group $REDIS_RESOURCE_GROUP \
       --server $REDIS_SERVER_NAME\
       --database $REDIS_DATABASE_NAME \
       --secret
   

   إشعار

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

   إذا كنت تستخدم Redis Enterprise، فاستخدم az spring connection create redis-enterprise الأمر بدلا من ذلك.

   تلميح

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

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

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

   2. حدد إنشاء.

   3. في علامة التبويب Basics ، لنوع الخدمة، حدد Cache for Redis. اختر اشتراكا وخادم ذاكرة التخزين المؤقت Redis. املأ اسم قاعدة بيانات Redis ("0" في هذا المثال) وضمن نوع العميل، حدد Java. حدد التالي: المصادقة.

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

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

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

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

Terraform

يوضح البرنامج النصي Terraform التالي كيفية إعداد تطبيق Azure Spring Apps باستخدام ذاكرة التخزين المؤقت Azure لـRedis.

provider "azurerm" {
  features {}
}

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

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

resource "azurerm_redis_cache" "redis" {
  name                = "redis-${var.application_name}-001"
  resource_group_name = azurerm_resource_group.example.name
  location            = azurerm_resource_group.example.location
  capacity            = 0
  family              = "C"
  sku_name            = "Standard"
  enable_non_ssl_port = false
  minimum_tls_version = "1.2"
}

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      = 2
  jvm_options         = "-XX:+PrintGC"
  runtime_version     = "Java_11"

  environment_variables = {
    "spring.redis.host"     = azurerm_redis_cache.redis.hostname
    "spring.redis.password" = azurerm_redis_cache.redis.primary_access_key
    "spring.redis.port"     = "6380"
    "spring.redis.ssl"      = "true"
  }
}

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 ل Redis. لمعرفة المزيد حول توصيل الخدمات بتطبيقك، راجع الاتصال إلى قاعدة بيانات Azure لمثيل MySQL.