MySQL için Azure Veritabanı örneğini Azure Spring Apps'te uygulamanıza bağlama

Note

Temel, Standardve Enterprise planları 17 Mart 2025'te kullanımdan kaldırma dönemine girdi. Daha fazla bilgi için, Azure Spring Apps emeklilik duyurusuna bakın.

Bu makale şunlar için geçerlidir:✅ Java ✅ C#

Bu makale şunlar için geçerlidir:✅ Temel/Standart ✅ Kurumsal

Azure Spring Apps ile, Spring Boot uygulamanızı el ile yapılandırmak yerine seçili Azure hizmetlerini uygulamalarınıza otomatik olarak bağlayabilirsiniz. Bu makalede uygulamanızı MySQL için Azure Veritabanı örneğine nasıl bağlayacağınız gösterilmektedir.

Prerequisites

• Azure Spring Apps'e dağıtılan bir uygulama. Daha fazla bilgi için bkz . Hızlı Başlangıç: İlk uygulamanızı Azure Spring Apps'e dağıtma.
• Azure MySQL için Esnek Sunucu veritabanı örneği.
• Azure CLI sürüm 2.45.0 veya üzeri.

Projenizi hazırlama

Java

1. Projenizin pom.xml dosyasına aşağıdaki bağımlılığı ekleyin:

   <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 dosyasında tüm spring.datasource.* özellikleri kaldırın.

3. komutunu çalıştırarak geçerli uygulamayı güncelleştirin veya komutunu çalıştırarak az spring app deployaz spring app deployment createbu değişiklik için yeni bir dağıtım oluşturun.

Polyglot

Tüm bağlantı dizeleri ve kimlik bilgileri, uygulama kodunuzda başvurabileceğiniz ortam değişkenleri olarak eklenir.

Varsayılan ortam değişkeni adları için bkz. MySQL için Azure Veritabanı'nı Hizmet Bağlayıcısı ile tümleştirme.

Uygulamanızı MySQL için Azure Veritabanı örneğine bağlama

Hizmet Bağlayıcısı

Note

Varsayılan olarak, Hizmet Bağlayıcıları uygulama düzeyinde oluşturulur. Bağlantıları geçersiz kılmak için dağıtımlarda yeniden başka bağlantılar oluşturabilirsiniz.

Spring uygulamanızı sistem tarafından atanan yönetilen kimlikle MySQL için Azure Veritabanı Esnek Sunucusuna bağlanacak şekilde yapılandırmak için bu adımları izleyin.

1. Azure CLI için Hizmet Bağlayıcısı parolasız uzantısını yüklemek için aşağıdaki komutu kullanın.

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

2. Ardından aşağıdaki komutu kullanarak Microsoft Entra kimlik doğrulaması için kullanıcı tarafından atanan bir yönetilen kimlik oluşturun. Örnekteki değişkenleri gerçek değerlerle değiştirmeyi unutmayın. Daha fazla bilgi için bkz. MySQL için Azure Veritabanı - Esnek Sunucu için Microsoft Entra kimlik doğrulamasını ayarlama.

   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 Aşağıdaki örnekte gösterildiği gibi komutunu çalıştırın. Örnekteki değişkenleri gerçek değerlerle değiştirmeyi unutmayın.

   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

Aşağıdaki Terraform betiğinde, MySQL için Azure Veritabanı ile bir Azure Spring Apps uygulamasının nasıl ayarlanacağı gösterilmektedir.

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
}

Sonraki Adımlar

Bu makalede, Azure Spring Apps'teki bir uygulamayı MySQL için Azure Veritabanı örneğine bağlamayı öğrendiniz. Hizmetleri bir uygulamaya bağlama hakkında daha fazla bilgi edinmek için bkz. Azure Spring Apps'te Azure Cosmos DB veritabanını bir uygulamaya bağlama.