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

Not

Temel, Standart ve Kurumsal planları, 3 yıllık kullanımdan kaldırma süresiyle Mart 2025 ortasından itibaren kullanımdan kaldırılacaktır. Azure Container Apps'e geçiş yapmanızı öneririz. Daha fazla bilgi için bkz . Azure Spring Apps kullanımdan kaldırma duyurusu.

Standart tüketim ve ayrılmış plan, altı ay sonra tamamen kapatılarak 30 Eylül 2024'den itibaren kullanımdan kaldırılacaktır. Azure Container Apps'e geçiş yapmanızı öneririz. Daha fazla bilgi için bkz . Azure Spring Apps Standart tüketimini ve ayrılmış planı Azure Container Apps'e geçirme.

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.

Önkoşullar

• 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.
• MySQL için Azure Veritabanı Esnek Sunucu ö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.

Çokdilli

Tüm bağlantı dizesi 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ı Service Connector ile tümleştirme.

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

Hizmet Bağlayıcısı

Not

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 Sunucuya 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ı bir 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.