Azure Spring Apps에서 애플리케이션에 Azure Cosmos DB 데이터베이스 연결

아티클
10/01/2024

참고 항목

기본, 표준 및 엔터프라이즈 계획은 2025년 3월 중순부터 사용되지 않으며 3년의 은퇴 기간이 있습니다. Azure Container Apps로 전환하는 것이 좋습니다. 자세한 내용은 Azure Spring Apps 사용 중지 공지 사항을 참조하세요.

표준 소비 및 전용 계획은 2024년 9월 30일부터 사용되지 않으며 6개월 후에 완전히 종료됩니다. Azure Container Apps로 전환하는 것이 좋습니다. 자세한 내용은 Azure Spring Apps 표준 사용량 및 전용 계획을 Azure Container Apps로 마이그레이션을 참조 하세요.

이 문서는 다음에 적용됩니다. ✔️ Java ✔️ C#

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

Spring Boot 애플리케이션을 수동으로 구성하는 대신 Azure Spring 앱을 사용하여 선택한 Azure 서비스를 애플리케이션에 자동으로 연결할 수 있습니다. 이 문서에서는 애플리케이션을 Azure Cosmos DB 데이터베이스에 연결하는 방법을 보여 줍니다.

필수 조건

Azure Spring Apps에 배포된 애플리케이션입니다. 자세한 내용은 빠른 시작: Azure Spring Apps에 첫 번째 애플리케이션 배포를 참조하세요.
Azure Cosmos DB 데이터베이스 인스턴스.
Azure CLI: 버전 2.45.0 이상

애플리케이션의 pom.xml 파일에 다음 종속성 중 하나를 추가합니다. API 유형에 적합한 종속성을 선택합니다.

API 형식: NoSQL

<dependency>
    <groupId>com.azure.spring</groupId>
    <artifactId>spring-cloud-azure-starter-data-cosmos</artifactId>
</dependency>

API 유형: MongoDB

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

API 유형: Cassandra

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

az spring app deploy를 실행하여 현재 앱을 업데이트하거나, az spring app deployment create를 실행하여 이 변경 사항에 대한 새 배포를 만듭니다.

Azure Cosmos DB에 앱 연결

서비스 커넥터
Terraform

참고 항목

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

Azure CLI 사용

다음 예와 같이 Azure CLI를 통해 az spring connection create 명령을 사용하여 Cosmos NoSQL Database에 연결하도록 Spring 앱을 구성합니다. 이 예의 변수를 실제 값으로 바꿉니다.

참고 항목

Azure Cosmos DB 데이터베이스 설정을 업데이트하는 작업을 완료하는 데 몇 분 정도 걸릴 수 있습니다.

참고 항목

Cosmos Cassandra를 사용하는 경우 --database 대신 --key_space를 사용합니다. Cosmos 테이블을 사용하는 경우 --database 대신 --table을 사용합니다. 자세한 내용은 빠른 시작: Azure CLI를 사용하여 Azure Spring 앱에서 서비스 연결 만들기를 참조하세요.

az spring connection create cosmos-sql \
    --resource-group $AZURE_SPRING_APPS_RESOURCE_GROUP \
    --service $AZURE_SPRING_APPS_SERVICE_INSTANCE_NAME \
    --app $APP_NAME \
    --target-resource-group $COSMOSDB_RESOURCE_GROUP \
    --account $COSMOSDB_ACCOUNT_NAME \
    --database $DATABASE_NAME \
    --secret

참고 항목

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

팁

az spring connection list-support-types --output table 명령을 실행하여 Azure Spring Apps에 지원되는 대상 서비스와 인증 방법의 목록을 가져옵니다. 시스템에서 az spring 명령을 인식하지 못하는 경우 az extension add --name spring을 실행하여 필요한 확장을 설치했는지 확인합니다.

Azure Portal 사용

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

Azure Portal에서 Azure Spring Apps 인스턴스를 선택하고 탐색 메뉴에서 앱을 선택합니다. 연결하려는 앱을 선택하고 탐색 메뉴에서 서비스 커넥터를 선택합니다.
만들기를 실행합니다.
기본 탭에서 서비스 유형에 대해 Cosmos DB를 선택한 다음, 구독을 선택합니다. API 유형의 경우 Core(SQL), Cosmos DB 계정 및 데이터베이스를 선택합니다. 클라이언트 유형의 경우 Java를 선택한 후, 다음: 인증을 선택합니다. 데이터베이스를 아직 만들지 않은 경우 빠른 시작: Azure Portal에서 Azure Cosmos DB 계정, 데이터베이스, 컨테이너 및 항목 만들기를 참조하세요.
인증 탭에서 연결 문자열을 선택합니다. 서비스 커넥터는 Cosmos DB 계정에서 액세스 키를 자동으로 검색합니다. 다음: 네트워킹을 선택합니다.
네트워킹 탭에서 대상 서비스에 대한 액세스를 사용하도록 방화벽 규칙 구성을 선택한 후, 다음: 검토 + 만들기를 선택합니다.
검토 + 만들기 탭에서 유효성 검사가 통과되기를 기다린 다음, 만들기를 선택합니다. 생성을 완료하는 데 몇 분 정도 걸릴 수 있습니다.
Spring 앱과 Cosmos DB 데이터베이스 간의 연결이 생성되면 서비스 커넥터 페이지에서 이를 확인하고 확장 단추를 선택하여 구성된 연결 변수를 볼 수 있습니다.

다음 Terraform 스크립트는 Azure Cosmos DB 계정을 사용하여 Azure Spring Apps에 배포된 앱을 설정하는 방법을 보여 줍니다.

provider "azurerm" {
  features {}
}

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

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

resource "azurerm_cosmosdb_account" "cosmosdb" {
  name                = "cosmosacct-${var.application_name}-001"
  resource_group_name = azurerm_resource_group.example.name
  location            = azurerm_resource_group.example.location
  offer_type          = "Standard"
  kind                = "GlobalDocumentDB"

  consistency_policy {
    consistency_level = "Session"
  }

  geo_location {
    failover_priority = 0
    location          = azurerm_resource_group.example.location
  }
}

resource "azurerm_cosmosdb_sql_database" "cosmosdb" {
  name                = "cosmos-${var.application_name}-001"
  resource_group_name = azurerm_cosmosdb_account.cosmosdb.resource_group_name
  account_name        = azurerm_cosmosdb_account.cosmosdb.name
}

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      = 1
  jvm_options         = "-XX:+PrintGC"
  runtime_version     = "Java_11"

  environment_variables = {
    "spring.cloud.azure.cosmos.endpoint" : azurerm_cosmosdb_account.cosmosdb.endpoint
    "spring.cloud.azure.cosmos.key" : azurerm_cosmosdb_account.cosmosdb.primary_key
    "spring.cloud.azure.cosmos.database" : azurerm_cosmosdb_sql_database.cosmosdb.name
  }
}

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 Cosmos DB 데이터베이스에 연결하는 방법을 알아보았습니다. 서비스를 애플리케이션에 연결하는 방법에 대해 자세히 알아보려면 Azure Cache for Redis Cache에 연결을 참조하세요.

다음을 통해 공유

Azure Spring Apps에서 애플리케이션에 Azure Cosmos DB 데이터베이스 연결

필수 조건

프로젝트 준비

Azure Cosmos DB에 앱 연결

Azure CLI 사용

Azure Portal 사용

다음 단계

피드백

추가 리소스