الاتصال مثيل Azure Database for MySQL إلى تطبيقك في Azure Spring Apps

إشعار

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

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

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

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

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

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

تحضير مشروعك

Java

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

   <dependency>
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-starter-data-jpa</artifactId>
   </dependency>
   <dependency>
       <groupId>com.azure.spring</groupId>
       <artifactId>spring-cloud-azure-starter-jdbc-mysql</artifactId>
   </dependency>
   

2. في ملف application.properties، قم بإزالة أي spring.datasource.* خصائص.

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

بوليغلوت

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

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

الاتصال تطبيقك إلى قاعدة بيانات Azure لمثيل MySQL

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

إشعار

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

اتبع هذه الخطوات لتكوين تطبيق Spring للاتصال بقاعدة بيانات Azure لخادم MySQL المرن بهوية مدارة يعينها النظام.

1. استخدم الأمر التالي لتثبيت ملحق الخدمة الاتصال أو بدون كلمة مرور ل Azure CLI.

   az extension add --name serviceconnector-passwordless --upgrade
   

2. ثم استخدم الأمر التالي لإنشاء هوية مدارة معينة من قبل المستخدم لمصادقة Microsoft Entra. تأكد من استبدال المتغيرات في المثال بقيم فعلية. لمزيد من المعلومات، راجع إعداد مصادقة Microsoft Entra لقاعدة بيانات Azure ل MySQL - الخادم المرن.

   export AZ_IDENTITY_RESOURCE_ID=$(az identity create \
       --name $AZURE_USER_IDENTITY_NAME \
       --resource-group $AZURE_IDENTITY_RESOURCE_GROUP \
       --query id \
       --output tsv)
   

3. az spring connection create قم بتشغيل الأمر، كما هو موضح في المثال التالي. تأكد من استبدال المتغيرات في المثال بقيم فعلية.

   az spring connection create mysql-flexible \
       --resource-group $AZURE_SPRING_APPS_RESOURCE_GROUP \
       --service $AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME \
       --app $APP_NAME \
       --target-resource-group $MYSQL_RESOURCE_GROUP \
       --server $MYSQL_SERVER_NAME \
       --database $DATABASE_NAME \
       --system-identity mysql-identity-id=$AZ_IDENTITY_RESOURCE_ID
   

Terraform

يوضح البرنامج النصي «Terraform» التالي كيفية إعداد تطبيق Azure Spring Apps باستخدام Azure Database for MySQL.

provider "azurerm" {
  features {}
}

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

variable "administrator_login" {
  type        = string
  description = "The MySQL administrator login"
  default     = "myadmin"
}

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

resource "random_password" "password" {
  length           = 32
  special          = true
  override_special = "_%@"
}

resource "azurerm_mysql_server" "database" {
  name                = "mysql-${var.application_name}-001"
  resource_group_name = azurerm_resource_group.example.name
  location            = azurerm_resource_group.example.location

  administrator_login          = var.administrator_login
  administrator_login_password = random_password.password.result

  sku_name                          = "B_Gen5_1"
  storage_mb                        = 5120
  version                           = "5.7"
  auto_grow_enabled                 = true
  backup_retention_days             = 7
  geo_redundant_backup_enabled      = false
  infrastructure_encryption_enabled = false
  public_network_access_enabled     = true
  ssl_enforcement_enabled           = true
  ssl_minimal_tls_version_enforced  = "TLS1_2"
}

resource "azurerm_mysql_database" "database" {
  name                = "mysqldb-${var.application_name}-001"
  resource_group_name = azurerm_resource_group.example.name
  server_name         = azurerm_mysql_server.database.name
  charset             = "utf8"
  collation           = "utf8_unicode_ci"
}

# This rule is to enable the 'Allow access to Azure services' checkbox
resource "azurerm_mysql_firewall_rule" "database" {
  name                = "mysqlfw-${var.application_name}-001"
  resource_group_name = azurerm_resource_group.example.name
  server_name         = azurerm_mysql_server.database.name
  start_ip_address    = "0.0.0.0"
  end_ip_address      = "0.0.0.0"
}

resource "azurerm_spring_cloud_service" "example" {
  name                = "example-springcloud"
  resource_group_name = azurerm_resource_group.example.name
  location            = azurerm_resource_group.example.location
}

resource "azurerm_spring_cloud_app" "example" {
  name                = "example-springcloudapp"
  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.datasource.url" : "jdbc:mysql://${azurerm_mysql_server.database.fqdn}:3306/${azurerm_mysql_database.database.name}?useSSL=true&requireSSL=false&useLegacyDatetimeCode=false&serverTimezone=UTC"
    "spring.datasource.username" : "${var.administrator_login}@${azurerm_mysql_server.database.name}"
    "spring.datasource.password" : random_password.password.result
    "spring.jpa.properties.hibernate.dialect" : "org.hibernate.dialect.MySQL5InnoDBDialect"
  }
}

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 Database for MySQL. لمعرفة المزيد حول توصيل الخدمات بتطبيق، راجع الاتصال قاعدة بيانات Azure Cosmos DB بتطبيق في Azure Spring Apps.