Azure SDK-ügyfelek automatikus konfigurálása

A Spring Boot leegyszerűsíti a Spring Cloud Azure fejlesztési élményét. A Spring Cloud Azure starters kényelmes függőségi leírók készlete, amelyeket az alkalmazás tartalmaz. A kezdőmodulok kezelik az objektumpéldányosítás és a konfiguráció logikáját, így neked nem kell. Minden starter a(z) spring-cloud-azure-starter elemre támaszkodik a kritikus konfigurációs adatok, például az Azure felhőkörnyezet és a hitelesítési információk biztosításában. Ezeket tulajdonságokként konfigurálhatja például egy YAML-fájlban, ahogy az alábbi példában látható:

spring:
  cloud:
    azure:
      profile:
        tenant-id: <tenant>
        cloud-type: Azure
      credential:
        client-id: ${AZURE_CLIENT_ID}

Jegyzet

A cloud tulajdonság megadása nem kötelező.

A tenant-id engedélyezett értékek a következők: common, organizations, consumersvagy bérlőazonosító. Ezekről az értékekről további információt az AADSTS50020 hiba – Az identitásszolgáltatótól származó felhasználói fiók nem létezik a bérlőben című cikk Rossz végpont (személyes és szervezeti fiókok) szakaszában talál. Az egybérlős alkalmazás átalakításával kapcsolatos információkért lásd: Egybérlős alkalmazás átalakítása több-bérlős alkalmazássá a Microsoft Entra ID-ban.

Ezek a tulajdonságok nem kötelezőek. Ha nem adja meg őket, a Spring Boot megpróbálja automatikusan megtalálni őket. Arról, hogy a Spring Boot hogyan találja meg ezeket a tulajdonságokat, tekintse meg a dokumentációt.

Függőségek beállítása

A Spring Cloud Azure kezdőket kétféleképpen használhatja. Az első módszer az Azure SDK-k használata a spring-cloud-azure-starter függőséggel az alábbi példában látható módon:

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

A második módszer a Azure SDK függőségek hozzáadásának elkerülése, és a Spring Cloud Azure Starter hozzáadása közvetlenül az egyes szolgáltatásokhoz. A Azure Cosmos DB például a következő függőséget adja hozzá:

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

Tipp

A támogatott kezdők listáját a Spring Cloud Azure fejlesztői útmutatójánakStarter-függőségek szakaszában találja.

Konfiguráció

Jegyzet

Ha egy Azure-erőforrás eléréséhez biztonsági identitást használ a Microsoft Entra ID-val történő hitelesítéshez és engedélyezéshez, győződjön meg arról, hogy a biztonsági identitás megfelelő jogosultságokkal rendelkezik az Azure-erőforrás eléréséhez. További információ: Hozzáférés engedélyezése a Microsoft Entra-azonosítóval.

Az egyes Azure szolgáltatások konfigurációs tulajdonságai az előtag spring.cloud.azure.<azure-service>alatt találhatók.

Tipp

Az összes Spring Cloud Azure-konfigurációs tulajdonság listáját Spring Cloud Azure-konfigurációs tulajdonságokcímű cikkben találja.

Alapszintű használat

Adja hozzá az alábbi tulajdonságokat az application.yaml fájlhoz a Azure Cosmos DB-ügyfél automatikus konfigurálásához.

spring:
  cloud:
    azure:
      cosmos:
        database: ${AZURE_COSMOS_DATABASE_NAME}
        endpoint: ${AZURE_COSMOS_ENDPOINT}
        consistency-level: eventual
        connection-mode: direct

Ezután a(z) CosmosClient és CosmosAsyncClient is elérhető a környezetben, és automatikusan befecskendezheti őket, ahogyan az alábbi példa mutatja:

class Demo {
@Autowired
private CosmosClient cosmosClient;

    @Override
    public void run() {
        User item = User.randomUser();
        CosmosContainer container = cosmosClient.getDatabase(databaseName).getContainer(containerName);
        container.createItem(item);
    }
}

Minták

Tekintse meg a azure-spring-boot-samples GitHub adattárát.