Utvecklarguide för Spring Cloud Azure

Spring är ett programramverk med öppen källkod som utvecklats av VMware och som ger en förenklad, modulär metod för att skapa Java program. Spring Cloud Azure är ett projekt med öppen källkod som ger sömlös Spring-integrering med Azure.

Mer information om versioner som stöds finns i Spring Versionsmappning.

Få hjälp

Om du har frågor om den här dokumentationen skapar du ett GitHub problem i någon av följande GitHub lagringsplatser. Pull-begäranden är också välkomna.

Komma igång

Konfigurera beroenden

Strukturliste (BOM)

Om du använder Maven lägger du till bommen i din pom.xml-fil i avsnittet dependencyManagement, som du ser i följande exempel. När du använder strukturlistan behöver du inte ange versioner för något av Maven-beroendena eftersom versionshantering delegeras till bommen.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.azure.spring</groupId>
      <artifactId>spring-cloud-azure-dependencies</artifactId>
      <version>7.1.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

Med Gradle kan du importera spring-cloud-azure-dependencies bom på följande sätt:

• Använd Gradles inbyggda strukturlistestöd genom att lägga till beroenden enligt följande exempel:

  import org.springframework.boot.gradle.plugin.SpringBootPlugin
  
  plugins {
    id("java")
    id("org.springframework.boot") version "4.0.1"
  }
  
  dependencies {
      implementation(platform(SpringBootPlugin.BOM_COORDINATES))
      implementation(platform("com.azure.spring:spring-cloud-azure-dependencies:{version}"))
  }
  

• Använd plugin-programmet io.spring.dependency-management och importera bommen i dependencyManagement, som du ser i följande exempel:

  plugins {
      id("io.spring.dependency-management") version "1.1.7"
  }
  
  dependencyManagement {
      imports {
          mavenBom("com.azure.spring:spring-cloud-azure-dependencies:{version}")
      }
  }
  

Mer information finns i referensguiden för Spring Boot Gradle Plugin.

Startberoenden

Spring Cloud Azure Starter är en uppsättning praktiska beroendebeskrivningar som ska ingå i ditt program. Varje starter innehåller alla beroenden och transitiva beroenden som behövs för att börja använda motsvarande Spring Cloud-Azure modul. Dessa startprogram ökar din Spring Boot-programutveckling med Azure tjänster.

Om du till exempel vill komma igång med Spring och Azure Cosmos DB för datapersistens inkluderar du beroendet spring-cloud-azure-starter-cosmos i projektet.

I följande tabell visas startprogram som tillhandahålls av Spring Cloud Azure under gruppen com.azure.spring:

I följande tabell visas startpunkter för Spring Data-stöd:

I följande tabell visas startpunkter för Stöd för Spring Data Redis:

I följande tabell visas startpunkter för Spring Integration-stöd:

I följande tabell visas startpunkter för Spring Cloud Stream-stöd:

I följande tabell visas startpunkter för MySQL-stöd:

I följande tabell visas startpunkter för PostgreSQL-stöd:

Learning Spring Cloud Azure

En fullständig lista över exempel som visar användning finns i Spring Cloud Azure Samples.

Nyheter i 4.0 sedan 3.10.x

Den här dokumentationen beskriver ändringar som gjorts i 4.0 sedan 3.10. Den här stora versionen ger bättre säkerhet, smalare beroenden, stöd för produktionsberedskap med mera.

I följande lista sammanfattas några av de ändringar som Spring Cloud Azure 4.0 innehåller:

• En enhetlig utvecklingsupplevelse med enhetligt projektnamn, artefakt-ID och egenskaper.
• Förenklad beroendehantering med en enda spring-cloud-azure-dependencies bom.
• Expanderade Azure support på Spring Initializr för att täcka Kafka, Event Hubs, Azure Cache for Redis och Azure App Configuration.
• Omskapade Spring-modulberoenden för att ta bort överflödiga lager och sammanflätning.
• Stöd för hanterad identitet för Azure App Configuration, Event Hubs, Service Bus, Azure Cosmos DB, Key Vault, Storage Blob och Storage Queue.
• Fortsatt stöd för autentiseringsmetoder i underliggande Azure SDK från våra Spring-bibliotek, till exempel SAS-token och tokenautentisering med Service Bus och Event Hubs.
• Autentiseringskedjan är nu aktiverad som standard, vilket gör det möjligt för program att hämta autentiseringsuppgifter från programegenskaper, miljövariabler, hanterad identitet, IDE:er och så vidare. Mer information finns i avsnittet DefaultAzureCredential i klientbiblioteket Azure Identity för Java.
• Detaljerad åtkomstkontroll på resursnivå (till exempel Service Bus kö) för bättre säkerhetsstyrning och efterlevnad av IT-principer.
• Fler alternativ som exponeras på ett Spring-idiomatiskt sätt genom förbättrad automatisk konfigurationstäckning av Azure SDK klienter för både synkrona och asynkrona scenarier.
• Hälsoindikatorer har lagts till för Azure App Configuration, Event Hubs, Azure Cosmos DB, Key Vault, Storage Blob, Storage Queue och Storage File.
• Stöd för Spring Cloud Sleuth för alla HTTP-baserade Azure SDKs.