Azure Cache for Redis를 Azure Spring Apps의 애플리케이션에 연결

1. 프로젝트의 pom.xml 파일에 다음 종속성을 추가합니다.

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

2. application.properties 파일에서 속성 spring.redis.* 제거

3. az spring app update를 사용하여 현재 배포를 업데이트하거나 az spring app deployment create를 사용하여 새 배포를 만듭니다.

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

기본 환경 변수 이름은 Azure Cache for Redis를 서비스 커넥터와 통합을 참조하세요.

1. Azure CLI를 사용하면 다음 예제와 같이 az spring connection create 명령을 사용하여 액세스 키로 Redis 데이터베이스에 연결하도록 Spring 앱을 구성할 수 있습니다.

   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
   

   참고 항목

   서비스 커넥터를 처음 사용하는 경우 먼저 az provider register --namespace Microsoft.ServiceLinker 명령을 실행하여 서비스 커넥터 리소스 공급자를 등록합니다.

   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. 또는 Azure Portal을 사용해 다음 단계를 완료하여 이 연결을 구성할 수 있습니다. Azure Portal은 Azure CLI와 동일한 기능을 제공하고 대화형 환경을 제공합니다.

   1. Azure Portal에서 Azure Spring Apps 인스턴스를 선택한 후 탐색 메뉴에서 앱을 선택합니다. 연결하려는 앱을 선택한 후 탐색 메뉴에서 서비스 커넥터를 선택합니다.

   2. 만들기를 실행합니다.

   3. 기본 탭의 서비스 유형에서 Cache for Redis를 선택합니다. 구독 및 Redis 캐시 서버를 선택합니다. Redis 데이터베이스 이름(이 예제에서는 ‘0’)을 채우고 클라이언트 유형에서 Java를 선택합니다. 다음: 인증을 선택합니다.

   4. 인증 탭에서 연결 문자열을 선택합니다. 서비스 커넥터는 Redis 데이터베이스 계정에서 액세스 키를 자동으로 검색합니다. 다음: 네트워킹을 선택합니다.

   5. 네트워킹 탭에서 대상 서비스에 대한 액세스를 사용하도록 방화벽 규칙 구성을 선택한 후 검토 + 만들기를 선택합니다.

   6. 검토 + 만들기 탭에서 유효성 검사가 통과되기를 기다린 다음, 만들기를 선택합니다. 생성을 완료하는 데 몇 분 정도 걸릴 수 있습니다.

   7. Spring 앱과 Redis 데이터베이스 간의 연결이 생성되면 서비스 커넥터 페이지에서 이를 확인하고 확장 단추를 선택하여 구성된 연결 변수를 볼 수 있습니다.

다음 Terraform 스크립트는 Azure Cache for Redis를 사용하여 Azure Spring Apps 앱을 설정하는 방법을 보여 줍니다.

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
}