Azure Cosmos DB-adatbázis csatlakoztatása az alkalmazáshoz az Azure Spring Appsben

1. Adja hozzá az alábbi függőségek egyikét az alkalmazás pom.xml fájljához. Válassza ki az API-típusnak megfelelő függőséget.

   • API-típus: NoSQL

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

   • API-típus: MongoDB

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

   • API-típus: Cassandra

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

2. Frissítse az aktuális alkalmazást a futtatással az spring app deploy, vagy hozzon létre egy új üzembe helyezést ehhez a módosításhoz a futtatással az spring app deployment create.

A rendszer az összes kapcsolati sztring és hitelesítő adatot környezeti változóként injektálja, amelyre az alkalmazáskódban hivatkozhat.

Az alapértelmezett környezeti változók neveiért tekintse meg a következő cikkeket:

• Azure Cosmos DB for Table
• Azure Cosmos DB for NoSQL
• Azure Cosmos DB a MongoDB-hez
• Azure Cosmos DB a Gremlinhez
• Azure Cosmos DB a Cassandra-hoz

Az Azure parancssori felületének használata

Az Azure CLI használatával konfigurálhatja a Spring-alkalmazást a Cosmos NoSQL-adatbázishoz való csatlakozáshoz a az spring connection create parancs használatával, ahogyan az az alábbi példában látható. A példában szereplő változókat mindenképpen cserélje le tényleges értékekre.

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 Azure Portal használata

Másik lehetőségként az Azure Portallal konfigurálhatja ezt a kapcsolatot az alábbi lépések végrehajtásával. Az Azure Portal ugyanazokat a képességeket biztosítja, mint az Azure CLI, és interaktív élményt nyújt.

1. Válassza ki az Azure Spring Apps-példányt az Azure Portalon, és válassza az Alkalmazások lehetőséget a navigációs menüben. Válassza ki a csatlakoztatni kívánt alkalmazást, és válassza a Service Connector lehetőséget a navigációs menüben.

2. Válassza a Létrehozás lehetőséget.

3. Az Alapszintű szolgáltatások lapon válassza a Cosmos DB lehetőséget, majd válasszon egy előfizetést. AZ API-típushoz válassza a Core (SQL) lehetőséget, válasszon egy Cosmos DB-fiókot és egy adatbázist. Ügyféltípus esetén válassza a Java, majd a Tovább: Hitelesítés lehetőséget. Ha még nem hozta létre az adatbázist, olvassa el a rövid útmutatót: Azure Cosmos DB-fiók, adatbázis, tároló és elemek létrehozása az Azure Portalról.

4. A Hitelesítés lapon válassza a Kapcsolati sztring lehetőséget. A Service Connector automatikusan lekéri a hozzáférési kulcsot a Cosmos DB-fiókból. Válassza a Tovább: Hálózatkezelés lehetőséget.

5. A Hálózatkezelés lapon válassza a Tűzfalszabályok konfigurálása a célszolgáltatáshoz való hozzáférés engedélyezéséhez, majd a Tovább: Véleményezés + Létrehozás lehetőséget.

6. A Véleményezés + Létrehozás lapon várja meg, amíg az ellenőrzés sikeres lesz, majd válassza a Létrehozás lehetőséget. A létrehozás eltarthat néhány percig.

7. Miután létrejött a Kapcsolat a Spring-alkalmazások és a Cosmos DB-adatbázis között, a Service Connector lapon láthatja, és a kibontás gombra kattintva megtekintheti a konfigurált kapcsolatváltozókat.

Az alábbi Terraform-szkript bemutatja, hogyan állíthat be egy Azure Cosmos DB-fiókkal üzembe helyezett alkalmazást az Azure Spring Appsben.

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
}