Azure Database for MySQL 인스턴스를 Azure Spring Apps의 애플리케이션에 연결

참고

Basic, Standard및 Enterprise 계획은 2025년 3월 17일에 사용 중지 기간에 들어갔습니다. 자세한 내용은 Azure Spring 앱 사용 중지 공지 사항을 참조하세요.

이 문서의 적용 대상:✅ Java ✅ C#

이 문서의 적용 대상:✅ 기본/표준 ✅ 엔터프라이즈

Azure Spring Apps를 사용하면 Spring Boot 애플리케이션을 수동으로 구성하는 대신, 선택한 Azure 서비스를 애플리케이션에 자동으로 연결할 수 있습니다. 이 문서에서는 애플리케이션을 Azure Database for MySQL 인스턴스에 연결하는 방법을 보여줍니다.

필수 구성 요소

• Azure Spring Apps에 배포된 애플리케이션입니다. 자세한 내용은 빠른 시작: Azure Spring Apps에 첫 번째 애플리케이션 배포를 참조하세요.
• Azure Database for 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를 실행하여 이 변경 사항에 대한 새 배포를 만듭니다.

다국어

모든 연결 문자열과 자격 증명은 애플리케이션 코드에서 참조할 수 있는 환경 변수로 삽입됩니다.

기본 환경 변수 이름은 Service Connector와 Azure Database for MySQL 통합을 참조하세요.

Azure Database for MySQL 인스턴스에 앱 연결

서비스 커넥터

참고

기본적으로 서비스 커넥터는 애플리케이션 수준에서 만들어집니다. 연결을 재정의하려면 배포에서 다른 연결을 다시 만들면 됩니다.

시스템 할당 관리 ID를 사용하여 Azure Database for MySQL 유연한 서버에 연결하도록 Spring 앱을 구성하려면 다음 단계를 따릅니다.

1. 다음 명령을 사용하여 Azure CLI용 서비스 커넥터 암호 없는 확장을 설치합니다.

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

2. 그런 다음, 다음 명령을 사용하여 Microsoft Entra 인증에 사용할 사용자가 할당한 관리 ID를 만듭니다. 이 예의 변수를 실제 값으로 바꿉니다. 자세한 내용은 Azure Database for MySQL - 유연한 서버에 대한 Microsoft Entra 인증 설정을 참조하세요.

   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 Database for MySQL을 사용하여 Azure Spring Apps 앱을 설정하는 방법을 보여 줍니다.

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 Spring Apps에서 Azure Cosmos DB 데이터베이스를 애플리케이션에 연결을 참조하세요.