Průvodce migrací pro Spring Cloud Azure 4.0

Tato příručka vám pomůže s migrací na Spring Cloud Azure 4.0 ze starších knihoven Azure Spring.

Úvod

Budeme volat knihovny, jejichž ID skupiny a ID artefaktu se řídí vzorem com.azure.spring:spring-cloud-azure-*moderní knihovny a knihovny se vzorem com.azure.spring:azure-spring-boot-*, com.azure.spring:azure-spring-cloud-*nebo com.azure.spring:azure-spring-integration-*starších knihoven.

Tato příručka se zaměří na souběžná porovnání podobných konfigurací mezi moderními a staršími knihovnami.

Předpokládá se znalost com.azure.spring:azure-spring-boot-*, com.azure.spring:azure-spring-cloud-* nebo balíčku com.azure.spring:azure-spring-integration-*.

Pokud s knihovnami Spring Cloud Azure 4.0 začínáte, podívejte se na příručku pro vývojáře Spring Cloud Azure než tuto příručku.

Výhody migrace

Při zvažování, jestli chcete přijmout novou verzi nebo knihovnu, je její výhoda přirozeným otazníkem. Vzhledem k tomu, že Azure zrala a přijala různorodější skupina vývojářů, zaměřili jsme se na učení vzorů a postupů, abychom co nejlépe podporovali produktivitu vývojářů a pochopili mezery, které mají knihovny Spring Cloud Azure.

V knihovnách spring cloudových Azure bylo vyjádřeno několik oblastí konzistentní zpětné vazby. Nejdůležitější je, že knihovny pro různé Azure služby nepovolily úplnou sadu konfigurací. Kromě toho nekonzistence pojmenování projektu, ID artefaktů, verzí a konfigurací udělala křivku učení strmou.

Za účelem zlepšení vývojového prostředí v knihovnách Azure Spring Cloudu byla zavedena sada pokynů pro návrh, které zajistí, aby knihovny Spring Cloud Azure měly přirozený a idiomatické pocity s ohledem na ekosystém Spring. Další podrobnosti najdete v dokumentu design pro zájemce.

Spring Cloud Azure 4.0 poskytuje sdílené prostředí napříč knihovnami integrujícími s různými projekty Spring, například Spring Boot, Spring Integration, Spring Cloud Stream atd. Sdílené prostředí zahrnuje:

• Sjednocená bom, která zahrnuje všechny knihovny Spring Cloud Azure 4.0.
• Konzistentní konvence vytváření názvů pro artefakty
• Jednotný způsob konfigurace přihlašovacích údajů, proxy serveru, opakování, cloudového prostředí a nastavení přenosové vrstvy
• Podpora všech metod ověřování, které Azure Služba nebo Azure Service SDK podporuje.

Přehled

Tento průvodce migrací se skládá z následujících částí:

• Změny názvů pro Spring Cloud Azure 4.0
• Změny artefaktů: přejmenováno / přidáno / odstraněno
• Změny závislostí
• Změny ověřování
• Vlastnosti konfigurace
• Zásadní změny rozhraní API
• Změny knihovny

Změny pojmenování

Nikdy nebylo konzistentní ani oficiální jméno pro volání všech knihoven spring cloudových Azure. Některé z nich byly volány Azure Spring Boot a některé z nich Spring on Azure. Od verze 4.0 jsme začali používat název projektu Spring Cloud Azure k reprezentaci všech knihoven Azure Spring.

KUSOVNÍK

Použili jsme k odeslání dvou kusovníků pro naše knihovny, azure-spring-boot-bom a azure-spring-cloud-dependencies, ale tyto dvě kusovníky jsme zkombinovali do jednoho kusovníku od 4,0, spring-cloud-azure-dependencies. Přidejte do dependencyManagement části projektu položku, která bude těžit ze správy závislostí.

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

Změny artefaktů: přejmenováno / přidáno / odstraněno

ID skupin jsou stejná pro moderní a starší knihovny Spring Cloud Azure. Všichni jsou com.azure.spring. ID artefaktů pro moderní knihovny Azure Spring Cloudu se změnila. Podle toho, do jakého projektu Spring patří, spring boot, integrace Springu nebo Spring Cloud Streamu, může být vzor ID artefaktů spring-cloud-azure-starter-[service], spring-integration-azure-[service]nebo spring-cloud-azure-stream-binder-[service]. Starší počáteční verze pro každou z nich mají ID artefaktu podle vzoru azure-spring-*. To poskytuje rychlé a přístupné prostředky, které vám pomůžou pochopit, ať už používáte moderní nebo starší úvodní sady.

V procesu vývoje Spring Cloudu Azure 4.0 jsme některé artefakty přejmenovali, aby se dodržovaly nové zásady vytváření názvů, odstranili některé artefakty, aby se funkce mohly vložit do vhodnějšího artefaktu a přidali některé nové artefakty, aby lépe sloužily některým scénářům.

Následující tabulka ukazuje mapování mezi starším ID artefaktu a moderním ID artefaktu:

Změny závislostí

Některé nepotřebné závislosti byly zahrnuty do starších artefaktů, které jsme odebrali v moderních knihovnách Spring Cloud Azure 4.0. Nezapomeňte do projektu přidat odebrané závislosti ručně, abyste zabránili chybám.

Mezi knihovny, které mají změny závislostí, patří:

• spring-cloud-azure-starter
• spring-cloud-azure-starter-active-directory
• spring-cloud-azure-starter-active-directory-b2c

Změny ověřování

Spring Cloud Azure 4.0 podporuje všechny metody ověřování, které podporuje každá sada SDK služby Azure. Umožňuje nakonfigurovat přihlašovací údaje globálního tokenu a zadat přihlašovací údaje tokenu na každé úrovni služby. Přihlašovací údaje ale nejsou potřeba ke konfiguraci Spring Cloudu Azure 4.0, protože můžou použít přihlašovací údaje uložené v místním vývojovém prostředí nebo spravované identitě ve službě Azure Services. Ujistěte se, že objekt zabezpečení má dostatečná oprávnění pro přístup k cílovému Azure prostředků.

Zřetězený přihlašovací údaje, DefaultAzureCredential bean je ve výchozím nastavení automaticky nakonfigurovaný a budou je používat všechny komponenty, pokud nejsou zadány žádné další ověřovací informace. Další informace najdete v části DefaultAzureCredential klientské knihovny Azure Identita pro Java.

Vlastnosti konfigurace

Migrace vlastností

Vytvořili additional-spring-configuration-metadata.json jsme soubor pro vyhlazení migrace vlastností při použití s spring-boot-properties-migrator. Nejprve do aplikace přidejte následující migraci vlastností:

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-properties-migrator</artifactId>
    <scope>runtime</scope>
</dependency>

Nebo pokud používáte Gradle:

runtime("org.springframework.boot:spring-boot-properties-migrator")

Pokud aplikaci spustíte, identifikuje vlastnosti, které už Azure Spring Cloud nespravuje. Pokud dojde k nahrazení, vlastnost se dočasně znovu namapuje s upozorněním. Pokud nedojde k nahrazení, zobrazí se další informace zpráva o chybě. V obou směrech se konfigurace musí aktualizovat a po aktualizaci konfigurace se závislost odebere.

Než budete pokračovat, je vhodné použít funkci vyhledávání integrovaného vývojového prostředí (IDE) a pečlivě zkontrolovat, že nepoužíváte některou z vlastností, které jste migrovali v integračním testu.

Globální konfigurace

Moderní spring-cloud-azure-starter umožňuje definovat vlastnosti, které se vztahují na všechny Sady Azure SDK v oboru názvů spring.cloud.azure. Tato funkce nebyla podporována ve starší verzi azure-spring-boot-starter. Globální konfigurace je možné rozdělit do pěti kategorií, jak je znázorněno v následující tabulce:

Úplný seznam konfigurací najdete v tématu Spring Cloud Azure vlastnosti konfigurace.

Konfigurace jednotlivých sad SDK

Podrobnosti o možnostech konfigurace na úrovni sady SDK najdete na následujících odkazech:

• Od azure-spring-boot-starter-active-directory do spring-cloud-azure-starter-active-directory
• Od azure-spring-boot-starter-active-directory-b2c do spring-cloud-azure-starter-active-directory-b2c
• Od azure-spring-boot-starter-cosmos do spring-cloud-azure-starter-data-cosmos
• Od azure-spring-boot-starter-keyvault-secrets do spring-cloud-azure-starter-keyvault-secrets
• Od azure-spring-boot-starter-servicebus-jms do spring-cloud-azure-starter-servicebus-jms
• Od azure-spring-boot-starter-storage do spring-cloud-azure-starter-storage-blob
• Od azure-spring-boot-starter-storage do spring-cloud-azure-starter-storage-file-share
• Od azure-spring-cloud-starter-eventhubs do spring-cloud-azure-starter-integration-eventhubs
• Od azure-spring-cloud-starter-servicebus do spring-cloud-azure-starter-integration-servicebus
• Od azure-spring-cloud-starter-storage-queue do spring-cloud-azure-starter-integration-storage-queue
• Od azure-spring-cloud-stream-binder-eventhubs do spring-cloud-azure-stream-binder-eventhubs
• Od azure-spring-cloud-stream-binder-servicebus-* do spring-cloud-azure-stream-binder-servicebus

Zásadní změny rozhraní API

Podrobnostioch

• Od azure-spring-boot-starter-active-directory do spring-cloud-azure-starter-active-directory
• Od azure-spring-boot-starter-active-directory-b2c do spring-cloud-azure-starter-active-directory-b2c
• Od azure-spring-boot-starter-storage do spring-cloud-azure-starter-storage-blob
• Od azure-spring-boot-starter-storage do spring-cloud-azure-starter-storage-file-share
• Od azure-spring-cloud-starter-eventhubs do spring-cloud-azure-starter-integration-eventhubs
• Od azure-spring-integration-eventhubs do spring-integration-azure-eventhubs
• Od azure-spring-cloud-starter-servicebus do spring-cloud-azure-starter-integration-servicebus
• Od azure-spring-integration-servicebus do spring-integration-azure-servicebus
• Od azure-spring-cloud-starter-storage-queue do spring-cloud-azure-starter-integration-storage-queue
• Od azure-spring-integration-storage-queue do spring-integration-azure-storage-queue
• Od azure-spring-cloud-stream-binder-eventhubs do spring-cloud-azure-stream-binder-eventhubs
• Od azure-spring-cloud-stream-binder-servicebus-* do spring-cloud-azure-stream-binder-servicebus

Změny knihovny

Zásadní změny v každé knihovně se zavádějí následujícím způsobem.

Od azure-spring-boot-starter do spring-cloud-azure-starter

Tento průvodce má pomoct s migrací z spring-cloud-azure-starter verze 3 .azure-spring-boot-starter

Obecné informace najdete na následujících odkazech:

• Přehled změn ve verzi 4.0 najdete v částech Úvod a Výhody migrace.
• Další informace o změnách strategie v pojmenování projektu najdete v části Změny názvů.
• Informace o použití jednoho kusovníku pro všechny knihovny Azure Spring Cloud najdete v části BOM.
• Informace o zpracování ověřování ve spring cloudu Azure 4.0 najdete v části Změny ověřování.
• Informace o využití spring-boot-properties-migrator během migrace najdete v části Konfigurace jednotlivých sad SDK.
• Další informace o globálních a běžných změnách konfigurace najdete v části Globální konfigurace.

Změny závislostí

Některé nepotřebné závislosti byly zahrnuty do starších artefaktů, které jsme odebrali v moderních knihovnách Spring Cloud Azure 4.0. Nezapomeňte do projektu přidat odebrané závislosti ručně, abyste zabránili neúmyslnému chybovému ukončení.

Následující tabulka ukazuje odebrané závislosti:

Od azure-spring-boot-starter-active-directory do spring-cloud-azure-starter-active-directory

Tento průvodce má pomoct s migrací z spring-cloud-azure-starter-active-directory verze 3 verze azure-spring-boot-starter-active-directory.

Obecné informace najdete na následujících odkazech:

• Přehled změn ve verzi 4.0 najdete v částech Úvod a Výhody migrace.
• Další informace o změnách strategie v pojmenování projektu najdete v části Změny názvů.
• Informace o použití jednoho kusovníku pro všechny knihovny Azure Spring Cloud najdete v části BOM.
• Informace o zpracování ověřování ve spring cloudu Azure 4.0 najdete v části Změny ověřování.
• Informace o využití spring-boot-properties-migrator během migrace najdete v části Konfigurace jednotlivých sad SDK.
• Další informace o globálních a běžných změnách konfigurace najdete v části Globální konfigurace.

Změny závislostí

Některé zbytečné závislosti ve starší verzi artefaktu byly odebrány od moderní knihovny Spring Cloud Azure 4.0. Přidejte tyto odebrané závislosti do projektu, abyste zabránili neúmyslnému chybovému ukončení.

Následující tabulka ukazuje odebrané závislosti:

Změny konfigurace sady SDK

Tato část obsahuje změny o přidaných, odebraných a změněných vlastnostech.

• Následující dva body jsou hlavním cílem věnovat pozornost:

1. Předpona všech názvů vlastností konfigurace se změnila z azure.activedirectory na spring.cloud.azure.active-directory.
2. Přidá se nová vlastnost spring.cloud.azure.active-directory.enabled pro povolení nebo zakázání Microsoft Entra souvisejících funkcí. Výchozí hodnota je false.

Následující tabulka uvádí mapování vlastností mezi azure-spring-boot-starter-active-directory a spring-cloud-azure-starter-active-directory:

• Typ hodnoty následujících vlastností se změní z long na Duration:

  • jwt-connect-timeout
  • jwt-read-timeout
  • jwk-set-cache-lifespan
  • jwk-set-cache-refresh-time.

• Odeberou se následující vlastnosti:

  • azure.activedirectory.allow-telemetry
  • azure.activedirectory.user-group.enable-full-list
  • azure.activedirectory.graph-base-uri
  • azure.activedirectory.graph-membership-uri

• Přidají se následující vlastnosti:

  • spring.cloud.azure.active-directory.enabled
  • spring.cloud.azure.active-directory.profile.environment.microsoft-graph-endpoint
  • spring.cloud.azure.active-directory.user-group.use-transitive-members

Tady je několik příkladů migrace:

• Příklad 1. Případ 1

  • Starší verze: azure.activedirectory.graph-membership-uri=https://graph.microsoft.com/v1.0/me/memberOf

  • Moderní: spring.cloud.azure.active-directory.profile.environment.microsoft-graph-endpoint=https://graph.microsoft.com/ + spring.cloud.azure.active-directory.user-group.use-transitive-members=false

• Příklad 2. Případ 2

  • Starší verze: azure.activedirectory.graph-membership-uri=https://graph.microsoft.com/v1.0/me/transitiveMemberOf

  • Moderní: spring.cloud.azure.active-directory.profile.environment.microsoft-graph-endpoint=https://graph.microsoft.com/ + spring.cloud.azure.active-directory.user-group.use-transitive-members=true

Změny rozhraní API

Následující tabulka ukazuje mapování tříd z azure-spring-boot-starter-active-directory na spring-cloud-azure-starter-active-directory:

Tato část obsahuje seznam odebraných tříd z azure-spring-boot-starter-active-directory.

• Odebrání starší třídy

  • com.azure.spring.aad.webapp.AADHandleConditionalAccessFilter
  • com.azure.spring.aad.webapi.validator.AADJwtAudienceValidator
  • com.azure.spring.aad.webapi.validator.AADJwtClaimValidator

Od azure-spring-boot-starter-active-directory-b2c do spring-cloud-azure-starter-active-directory-b2c

Tento průvodce má pomoct s migrací z spring-cloud-azure-starter-active-directory-b2c verze 3 .azure-spring-boot-starter-active-directory-b2c

Obecné informace najdete na následujících odkazech:

• Přehled změn ve verzi 4.0 najdete v částech Úvod a Výhody migrace.
• Další informace o změnách strategie v pojmenování projektu najdete v části Změny názvů.
• Informace o použití jednoho kusovníku pro všechny knihovny Azure Spring Cloud najdete v části BOM.
• Informace o zpracování ověřování ve spring cloudu Azure 4.0 najdete v části Změny ověřování.
• Informace o využití spring-boot-properties-migrator během migrace najdete v části Konfigurace jednotlivých sad SDK.
• Další informace o globálních a běžných změnách konfigurace najdete v části Globální konfigurace.

Změny závislostí

Některé nepotřebné závislosti byly zahrnuty do starších artefaktů, které jsme odebrali v moderních knihovnách Spring Cloud Azure 4.0. Nezapomeňte do projektu přidat odebrané závislosti ručně, abyste zabránili neúmyslnému chybovému ukončení.

Následující tabulka ukazuje odebrané závislosti:

Změny konfigurace sady SDK

Tato část obsahuje změny o přidaných, odebraných a změněných vlastnostech.

• Následující dva body jsou hlavním cílem věnovat pozornost:

1. Všechny názvy vlastností konfigurace změnily předponu z azure.activedirectory.b2c na spring.cloud.azure.active-directory.b2c.
2. Přidá se nová vlastnost spring.cloud.azure.active-directory.b2c.enabled pro povolení nebo zakázání Azure souvisejících funkcí AD B2C. Výchozí hodnota je false.

Následující tabulka ukazuje mapování vlastností z azure-spring-boot-starter-active-directory-b2c na spring-cloud-azure-starter-active-directory-b2c:

• Odebrané vlastnosti z azure-spring-boot-starter-active-directory-b2c:

  • azure.activedirectory.b2c.allow-telemetry
  • azure.activedirectory.b2c.tenant

• Typ hodnoty následujících vlastností se změní z long na Duration:

  • jwt-connect-timeout
  • jwt-read-timeout

Změny rozhraní API

Následující tabulka ukazuje mapování tříd z azure-spring-boot-starter-active-directory-b2c na spring-cloud-azure-starter-active-directory-b2c:

Od azure-spring-boot-starter-cosmos do spring-cloud-azure-starter-data-cosmos

Tento průvodce má pomoct s migrací z spring-cloud-azure-starter-data-cosmos verze 3 .azure-spring-boot-starter-cosmos

Obecné informace najdete na následujících odkazech:

• Přehled změn ve verzi 4.0 najdete v částech Úvod a Výhody migrace.
• Další informace o změnách strategie v pojmenování projektu najdete v části Změny názvů.
• Informace o použití jednoho kusovníku pro všechny knihovny Azure Spring Cloud najdete v části BOM.
• Informace o zpracování ověřování ve spring cloudu Azure 4.0 najdete v části Změny ověřování.
• Informace o využití spring-boot-properties-migrator během migrace najdete v části Konfigurace jednotlivých sad SDK.
• Další informace o globálních a běžných změnách konfigurace najdete v části Globální konfigurace.

Změny konfigurace sady SDK

Všechny názvy vlastností konfigurace změnily předponu z azure.cosmos na spring.cloud.azure.cosmos.

Následující tabulka ukazuje mapování tříd z azure-spring-boot-starter-cosmos na spring-cloud-azure-starter-data-cosmos:

Od azure-spring-boot-starter-keyvault-secrets do spring-cloud-azure-starter-keyvault-secrets

Tento průvodce má pomoct s migrací z spring-cloud-azure-starter-keyvault-secrets verze 3 .azure-spring-boot-starter-keyvault-secrets

Obecné informace najdete na následujících odkazech:

• Přehled změn ve verzi 4.0 najdete v částech Úvod a Výhody migrace.
• Další informace o změnách strategie v pojmenování projektu najdete v části Změny názvů.
• Informace o použití jednoho kusovníku pro všechny knihovny Azure Spring Cloud najdete v části BOM.
• Informace o zpracování ověřování ve spring cloudu Azure 4.0 najdete v části Změny ověřování.
• Informace o využití spring-boot-properties-migrator během migrace najdete v části Konfigurace jednotlivých sad SDK.
• Další informace o globálních a běžných změnách konfigurace najdete v části Globální konfigurace.

Změny konfigurace sady SDK

Tato část obsahuje změny o přidaných, odebraných a změněných vlastnostech.

Následující tabulka ukazuje mapování vlastností z azure-spring-boot-starter-keyvault-secrets na spring-cloud-azure-starter-keyvault-secrets:

• Odebrané vlastnosti z spring-cloud-azure-starter-keyvault-secrets:

  • azure.keyvault.allow-telemetry
  • azure.keyvault.order

Na tyto body byste měli věnovat pozornost:

1. Všechny názvy vlastností konfigurace změnily předponu z azure.keyvault na spring.cloud.azure.keyvault.secret.
2. spring.cloud.azure.keyvault.secret.enabled slouží k povolení všech funkcí tajných kódů Key Vault, včetně konfigurace Key Vault tajných klientských fazolí (například SecretClient a SecretAsyncClient) a přidání KeyVaultPropertySource do ConfigurableEnvironment.
3. spring.cloud.azure.keyvault.secret.property-source-enabled slouží k povolení všech KeyVaultPropertySource. Projeví se pouze v spring.cloud.azure.keyvault.secret.enabled=true.
4. Pro Azure běžné vlastnosti (například client, proxy, retry, credential, profile) a Key Vault vlastnosti (například endpoint, service-version). Pokud spring.cloud.azure.keyvault.secret.property-sources[n].PROPERTY_NAME není nakonfigurovaný, použije se spring.cloud.azure.keyvault.secret.PROPERTY_NAME.
5. spring.cloud.azure.keyvault.secret.property-sources[n].resource je specifický pro jedinečný prostředek Azure, takže pokud není nakonfigurovaný, nezíská hodnotu z jiných míst.

Od azure-spring-boot-starter-servicebus-jms do spring-cloud-azure-starter-servicebus-jms

Tento průvodce má pomoct s migrací z spring-cloud-azure-starter-servicebus-jms verze 3 .azure-spring-boot-starter-servicebus-jms

Obecné informace najdete na následujících odkazech:

• Přehled změn ve verzi 4.0 najdete v částech Úvod a Výhody migrace.
• Další informace o změnách strategie v pojmenování projektu najdete v části Změny názvů.
• Informace o použití jednoho kusovníku pro všechny knihovny Azure Spring Cloud najdete v části BOM.
• Informace o zpracování ověřování ve spring cloudu Azure 4.0 najdete v části Změny ověřování.
• Informace o využití spring-boot-properties-migrator během migrace najdete v části Konfigurace jednotlivých sad SDK.
• Další informace o globálních a běžných změnách konfigurace najdete v části Globální konfigurace.

Změny konfigurace sady SDK

Typ konfigurace pro spring.jms.servicebus.idle-timeout změny z long (milisekund) na Duration vzor pro čitelnost

Od azure-spring-boot-starter-storage do spring-cloud-azure-starter-storage-blob

Tento průvodce má pomoct s migrací z spring-cloud-azure-starter-storage-blob verze 3 .azure-spring-boot-starter-storage

Obecné informace najdete na následujících odkazech:

• Přehled změn ve verzi 4.0 najdete v částech Úvod a Výhody migrace.
• Další informace o změnách strategie v pojmenování projektu najdete v části Změny názvů.
• Informace o použití jednoho kusovníku pro všechny knihovny Azure Spring Cloud najdete v části BOM.
• Informace o zpracování ověřování ve spring cloudu Azure 4.0 najdete v části Změny ověřování.
• Informace o využití spring-boot-properties-migrator během migrace najdete v části Konfigurace jednotlivých sad SDK.
• Další informace o globálních a běžných změnách konfigurace najdete v části Globální konfigurace.

Změny konfigurace sady SDK

Všechny názvy vlastností konfigurace změnily předponu z azure.storage na spring.cloud.azure.storage.blob.

Následující tabulka ukazuje mapování vlastností z azure-spring-boot-starter-storage na spring-cloud-azure-starter-storage-blob:

Změny rozhraní API

Následující tabulka ukazuje mapování tříd z azure-spring-boot-starter-storage na spring-cloud-azure-starter-storage-blob:

Od azure-spring-boot-starter-storage do spring-cloud-azure-starter-storage-file-share

Tento průvodce má pomoct s migrací z spring-cloud-azure-starter-storage-file-share verze 3 .azure-spring-boot-starter-storage

Obecné informace najdete na následujících odkazech:

• Přehled změn ve verzi 4.0 najdete v částech Úvod a Výhody migrace.
• Další informace o změnách strategie v pojmenování projektu najdete v části Změny názvů.
• Informace o použití jednoho kusovníku pro všechny knihovny Azure Spring Cloud najdete v části BOM.
• Informace o zpracování ověřování ve spring cloudu Azure 4.0 najdete v části Změny ověřování.
• Informace o využití spring-boot-properties-migrator během migrace najdete v části Konfigurace jednotlivých sad SDK.
• Další informace o globálních a běžných změnách konfigurace najdete v části Globální konfigurace.

Změny konfigurace sady SDK

Všechny názvy vlastností konfigurace změnily předponu z azure.storage na spring.cloud.azure.storage.fileshare.

Následující tabulka ukazuje mapování vlastností z azure-spring-boot-starter-storage na spring-cloud-azure-starter-storage-file-share:

Změny rozhraní API

Následující tabulka ukazuje mapování tříd z azure-spring-boot-starter-storage na spring-cloud-azure-starter-storage-file-share:

Od azure-spring-cloud-starter-eventhubs do spring-cloud-azure-starter-integration-eventhubs

Tento průvodce má pomoct s migrací z spring-cloud-azure-starter-integration-eventhubs verze 2 nástroje azure-spring-cloud-starter-eventhubs.

Obecné informace najdete na následujících odkazech:

• Přehled změn ve verzi 4.0 najdete v částech Úvod a Výhody migrace.
• Další informace o změnách strategie v pojmenování projektu najdete v části Změny názvů.
• Informace o použití jednoho kusovníku pro všechny knihovny Azure Spring Cloud najdete v části BOM.
• Informace o zpracování ověřování ve spring cloudu Azure 4.0 najdete v části Změny ověřování.
• Informace o využití spring-boot-properties-migrator během migrace najdete v části Konfigurace jednotlivých sad SDK.
• Další informace o globálních a běžných změnách konfigurace najdete v části Globální konfigurace.

Změny konfigurace sady SDK

Změny podřízených položek pro tuto předponu najdete v následujících tabulkách:

Následující tabulka ukazuje mapování vlastností z azure-spring-cloud-starter-eventhubs na spring-cloud-azure-starter-integration-eventhubs:

Můžete například změnit z:

spring:
  cloud:
    azure:
      eventhub:
        connection-string: ${AZURE_EVENTHUBS_CONNECTION_STRING}
        checkpoint-storage-account: ${AZURE_CHECKPOINT_STORAGE_ACCOUNT_NAME}
        checkpoint-access-key: ${AZURE_CHECKPOINT_ACCOUNT_KEY}
        checkpoint-container: ${AZURE_CHECKPOINT_CONTAINER_NAME}

k:

spring:
  cloud:
    azure:
      eventhubs:
        connection-string: ${AZURE_EVENTHUBS_CONNECTION_STRING}
        processor:
          checkpoint-store:
            container-name: ${AZURE_STORAGE_CONTAINER_NAME}
            account-name: ${AZURE_STORAGE_ACCOUNT_NAME}
            account-key: ${AZURE_STORAGE_ACCOUNT_KEY}

Změny rozhraní API

• Změny poznámek k naslouchacímu procesu najdete v průvodci migrací <<migration-azure-spring-cloud-messaging, azure-spring-cloud-messaging>> knihovny.
• Odstraňte EventHubOperation s funkcí přihlášení k odběru přesunutou do EventHubsMessageListenerContainer třídy a odesílající funkce se přesunula do EventHubsTemplate.
• Přejmenujte EventHubInboundChannelAdapter na EventHubsInboundChannelAdapter, aby byla konzistentní se službou Azure Event Hubs.
• Změňte konstruktor z EventHubInboundChannelAdapter(String, SubscribeByGroupOperation, String) na EventHubsInboundChannelAdapter(EventHubsMessageListenerContainer) a EventHubsInboundChannelAdapter(EventHubsMessageListenerContainer, ListenerMode).
• Změňte styl vytváření instancí CheckpointConfig na jednoduchý konstruktor místo stylu sestavení.
• Drop API EventHubOperation#setCheckpointConfig. Chcete-li nastavit konfiguraci kontrolního bodu pro adaptér příchozího kanálu, mohou uživatelé volat metodu EventHubsContainerProperties#setCheckpointConfig.
• Drop API EventHubOperation#setBatchConsumerConfig. Pokud chcete nastavit konfiguraci dávkového využití pro adaptér příchozího kanálu, můžou uživatelé volat dvě metody EventHubsContainerProperties#getBatch#setMaxSize a EventHubsContainerProperties#getBatch#setMaxWaitTime mezitím.
• V režimu dávkového využívání změňte názvy záhlaví zpráv převedené z dávkových zpráv.
  • Změňte záhlaví zprávy z azure_eventhub_enqueued_time na azure_eventhubs_batch_converted_enqueued_time.
  • Změňte záhlaví zprávy z azure_eventhub_offset na azure_eventhubs_batch_converted_offset.
  • Změňte záhlaví zprávy z azure_eventhub_sequence_number na azure_eventhubs_batch_converted_sequence_number.
  • Změňte záhlaví zprávy z azure_partition_key na azure_batch_converted_partition_key.
• Při publikování zpráv do služby Event Hubs ignorujte všechna záhlaví zpráv převedená z dávkových zpráv. Záhlaví zahrnují:
  • azure_batch_converted_partition_key
  • azure_eventhubs_batch_converted_enqueued_time
  • azure_eventhubs_batch_converted_offset
  • azure_eventhubs_batch_converted_sequence_number
  • azure_eventhubs_batch_converted_system_properties
  • azure_eventhubs_batch_converted_application_properties
• Režim kontrolního bodu BATCH teď funguje pouze v dávkovém režimu, který lze povolit předáním ListenerMode.BATCH do konstruktoru EventHubsInboundChannelAdapter.

Následující tabulka ukazuje mapování tříd z azure-spring-cloud-starter-eventhubs na spring-cloud-azure-starter-integration-eventhubs:

Ukázkový fragment kódu

• EventHubsInboundChannelAdapter vzorový kód:

  Starší verze kódu:

  public class Demo {
      @Bean
      public EventHubInboundChannelAdapter messageChannelAdapter(
          @Qualifier("INPUT_CHANNEL") MessageChannel inputChannel, EventHubOperation   eventhubOperation) {
          eventhubOperation.setCheckpointConfig(CheckpointConfig.builder().checkpointMode  (CheckpointMode.MANUAL).build());
          EventHubInboundChannelAdapter adapter = new EventHubInboundChannelAdapter("EVENTHUB_NAME",
              eventhubOperation, "CONSUMER_GROUP");
          adapter.setOutputChannel(inputChannel);
          return adapter;
      }
  }
  

  Moderní kód:

  public class Demo {
      @Bean
      public EventHubsMessageListenerContainer messageListenerContainer(EventHubsProcessorFactory processorFactory) {
          EventHubsContainerProperties containerProperties = new EventHubsContainerProperties();
          containerProperties.setEventHubName("EVENTHUB_NAME");
          containerProperties.setConsumerGroup("CONSUMER_GROUP");
          CheckpointConfig config = new CheckpointConfig(CheckpointMode.MANUAL);
          containerProperties.setCheckpointConfig(config);
          return new EventHubsMessageListenerContainer(processorFactory, containerProperties);
      }
  
      @Bean
      public EventHubsInboundChannelAdapter messageChannelAdapter(@Qualifier("INPUT_CHANNEL") MessageChannel inputChannel,
                                                                  EventHubsMessageListenerContainer listenerContainer) {
          EventHubsInboundChannelAdapter adapter = new EventHubsInboundChannelAdapter(listenerContainer);
          adapter.setOutputChannel(inputChannel);
          return adapter;
      }
  }
  

• DefaultMessageHandler vzorový kód:

  Starší verze kódu:

  public class Demo {
      @Bean
      @ServiceActivator(inputChannel = "OUTPUT_CHANNEL")
      public MessageHandler messageSender(EventHubOperation eventhubOperation) {
          DefaultMessageHandler handler = new DefaultMessageHandler("EVENTHUB_NAME", eventhubOperation);
          handler.setSendCallback(new ListenableFutureCallback<Void>() {
              @Override
              public void onSuccess(Void result) {
                  LOGGER.info("Message was sent successfully.");
              }
  
              @Override
              public void onFailure(Throwable ex) {
                  LOGGER.error("There was an error sending the message.", ex);
              }
          });
          return handler;
      }
  }
  

  Moderní kód:

  public class Demo {
      @Bean
      @ServiceActivator(inputChannel = "OUTPUT_CHANNEL")
      public MessageHandler messageSender(EventHubsTemplate eventhubOperation) {
          DefaultMessageHandler handler = new DefaultMessageHandler("EVENTHUB_NAME", eventhubOperation);
          handler.setSendCallback(new ListenableFutureCallback<Void>() {
              @Override
              public void onSuccess(Void result) {
                  LOGGER.info("Message was sent successfully.");
              }
  
              @Override
              public void onFailure(Throwable ex) {
                  LOGGER.error("There was an error sending the message.", ex);
              }
          });
  
          return handler;
      }
  }
  

Od azure-spring-integration-eventhubs do spring-integration-azure-eventhubs

Tento průvodce má pomoct s migrací z spring-integration-azure-eventhubs verze 2 nástroje azure-spring-integration-eventhubs.

• Přehled změn ve verzi 4.0 najdete v částech Úvod a Výhody migrace.
• Další informace o změnách strategie v pojmenování projektu najdete v části Změny názvů.
• Informace o použití jednoho kusovníku pro všechny knihovny Azure Spring Cloud najdete v části BOM.

Změny rozhraní API

• Odstraňte EventHubOperation s funkcí přihlášení k odběru přesunutou do EventHubsMessageListenerContainer třídy a odesílající funkce se přesunula do EventHubsTemplate.
• Přejmenujte EventHubInboundChannelAdapter na EventHubsInboundChannelAdapter, aby byla konzistentní se službou Azure Event Hubs.
• Změňte konstruktor z EventHubInboundChannelAdapter(String, SubscribeByGroupOperation, String) na EventHubsInboundChannelAdapter(EventHubsMessageListenerContainer) a EventHubsInboundChannelAdapter(EventHubsMessageListenerContainer, ListenerMode).
• Změňte styl vytváření instancí CheckpointConfig na jednoduchý konstruktor místo stylu sestavení.
• Drop API EventHubOperation#setCheckpointConfig. Chcete-li nastavit konfiguraci kontrolního bodu pro adaptér příchozího kanálu, mohou uživatelé volat metodu EventHubsContainerProperties#setCheckpointConfig.
• Drop API EventHubOperation#setBatchConsumerConfig. Pokud chcete nastavit konfiguraci dávkového využití pro adaptér příchozího kanálu, můžou uživatelé volat dvě metody EventHubsContainerProperties#getBatch#setMaxSize a EventHubsContainerProperties#getBatch#setMaxWaitTime mezitím.
• V režimu dávkového využívání změňte názvy záhlaví zpráv převedené z dávkových zpráv.
  • Změňte záhlaví zprávy z azure_eventhub_enqueued_time na azure_eventhubs_batch_converted_enqueued_time.
  • Změňte záhlaví zprávy z azure_eventhub_offset na azure_eventhubs_batch_converted_offset.
  • Změňte záhlaví zprávy z azure_eventhub_sequence_number na azure_eventhubs_batch_converted_sequence_number.
  • Změňte záhlaví zprávy z azure_partition_key na azure_batch_converted_partition_key.
• Při publikování zpráv do služby Event Hubs ignorujte všechna záhlaví zpráv převedená z dávkových zpráv. Záhlaví zahrnují:
  • azure_batch_converted_partition_key
  • azure_eventhubs_batch_converted_enqueued_time
  • azure_eventhubs_batch_converted_offset
  • azure_eventhubs_batch_converted_sequence_number
  • azure_eventhubs_batch_converted_system_properties
  • azure_eventhubs_batch_converted_application_properties
• Režim kontrolního bodu BATCH teď funguje pouze v dávkovém režimu, který lze povolit předáním ListenerMode.BATCH do konstruktoru EventHubsInboundChannelAdapter.

Následující tabulka ukazuje mapování tříd z azure-spring-integration-eventhubs na spring-integration-azure-eventhubs:

Od azure-spring-cloud-starter-servicebus do spring-cloud-azure-starter-integration-servicebus

Tento průvodce má pomoct s migrací z spring-cloud-azure-starter-integration-servicebus verze 2 nástroje azure-spring-cloud-starter-servicebus.

Obecné informace najdete na následujících odkazech:

• Přehled změn ve verzi 4.0 najdete v částech Úvod a Výhody migrace.
• Další informace o změnách strategie v pojmenování projektu najdete v části Změny názvů.
• Informace o použití jednoho kusovníku pro všechny knihovny Azure Spring Cloud najdete v části BOM.
• Informace o zpracování ověřování ve spring cloudu Azure 4.0 najdete v části Změny ověřování.
• Informace o využití spring-boot-properties-migrator během migrace najdete v části Konfigurace jednotlivých sad SDK.
• Další informace o globálních a běžných změnách konfigurace najdete v části Globální konfigurace.

Změny konfigurace sady SDK

U všech možností konfigurace podporovaných v spring-cloud-azure-starter-integration-servicebuszůstane předpona spring.cloud.azure.servicebus.

Následující tabulka ukazuje mapování vlastností z azure-spring-cloud-starter-servicebus na spring-cloud-azure-starter-integration-servicebus:

Změny rozhraní API

• Odstraňte ServiceBusQueueOperation a ServiceBusTopicOperation s funkcí přihlášení k odběru přesunutou do ServiceBusMessageListenerContainer třídy a odesílající funkce se přesunula do ServiceBusTemplate.
• Odstraňte ServiceBusQueueInboundChannelAdapter a ServiceBusTopicInboundChannelAdapter a přesuňte funkce pro naslouchání entitě fronty nebo tématu Service Bus serviceBusInboundChannelAdapter.
• Změňte konstruktor z ServiceBusQueueInboundChannelAdapter(String, SubscribeByGroupOperation, String) na ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer) a ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer, ListenerMode).
• Změňte konstruktor z ServiceBusTopicInboundChannelAdapter(String, SubscribeByGroupOperation, String) na ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer) a ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer, ListenerMode).
• Přetažení rozhraní API ServiceBusQueueOperation#setCheckpointConfig a ServiceBusTopicOperation#setCheckpointConfig. Pokud chcete nastavit konfiguraci kontrolního bodu pro adaptér příchozího kanálu, můžou uživatelé místo toho volat metodu ServiceBusContainerProperties#setAutoComplete. Chcete-li zakázat režim automatického dokončování, je ekvivalentní MANUAL režimu kontrolního bodu a k jeho povolení se aktivuje režim RECORD.
• Přetažení rozhraní API ServiceBusQueueOperatio#setClientConfig a ServiceBusTopicOperation#setClientConfig. Pokud chcete nakonfigurovat podkladové ServiceBusProcessorClient používané adaptérem příchozího kanálu, můžou uživatelé místo toho použít ServiceBusContainerProperties.
• Zahoďte podporu CompletableFuture v ServiceBusTemplate a DefaultMessageHandler, místo toho podporu Reactor.
• Přidáním nového rozhraní API ServiceBusTemplate#setDefaultEntityType zadejte typ entity, který se vyžaduje, pokud pro PropertiesSupplier<String, ProducerProperties>není k dispozici žádná ProducerProperties#entityType.
• Přetažení záhlaví zprávy AzureHeaders.RAW_ID. Místo toho použijte ServiceBusMessageHeaders.MESSAGE_ID.

Následující tabulka ukazuje mapování tříd z azure-spring-cloud-starter-servicebus na spring-cloud-azure-starter-integration-servicebus:

Ukázkový fragment kódu

• ServiceBusInboundChannelAdapter vzorový kód:

  Starší kód použití ServiceBusQueueInboundChannelAdapter nebo ServiceBusTopicInboundChannelAdapter:

  public class Demo {
      @Bean
      public ServiceBusQueueInboundChannelAdapter queueMessageChannelAdapter(
          @Qualifier("INPUT_CHANNEL_NAME") MessageChannel inputChannel, ServiceBusQueueOperation queueOperation) {
          queueOperation.setCheckpointConfig(CheckpointConfig.builder().checkpointMode(CheckpointMode.MANUAL).build());
          ServiceBusQueueInboundChannelAdapter adapter = new ServiceBusQueueInboundChannelAdapter("QUEUE_NAME",
              queueOperation);
          adapter.setOutputChannel(inputChannel);
          return adapter;
      }
  
      @Bean
      public ServiceBusTopicInboundChannelAdapter topicMessageChannelAdapter(
          @Qualifier("INPUT_CHANNEL_NAME") MessageChannel inputChannel, ServiceBusTopicOperation topicOperation) {
          topicOperation.setCheckpointConfig(CheckpointConfig.builder().checkpointMode(CheckpointMode.MANUAL).build());
          ServiceBusTopicInboundChannelAdapter adapter = new ServiceBusTopicInboundChannelAdapter("TOPIC_NAME",
              topicOperation, "SUBSCRIPTION_NAME");
          adapter.setOutputChannel(inputChannel);
          return adapter;
      }
  
  }
  

  Moderní kód:

  public class Demo {
      @Bean("queue-listener-container")
      public ServiceBusMessageListenerContainer messageListenerContainer(ServiceBusProcessorFactory processorFactory) {
          ServiceBusContainerProperties containerProperties = new ServiceBusContainerProperties();
          containerProperties.setEntityName("QUEUE_NAME");
          containerProperties.setAutoComplete(false);
          return new ServiceBusMessageListenerContainer(processorFactory, containerProperties);
      }
  
      @Bean
      public ServiceBusInboundChannelAdapter queueMessageChannelAdapter(
          @Qualifier("INPUT_CHANNEL") MessageChannel inputChannel,
          @Qualifier("queue-listener-container") ServiceBusMessageListenerContainer listenerContainer) {
          ServiceBusInboundChannelAdapter adapter = new ServiceBusInboundChannelAdapter(listenerContainer);
          adapter.setOutputChannel(inputChannel);
          return adapter;
      }
  
      @Bean("topic-listener-container")
      public ServiceBusMessageListenerContainer messageListenerContainer(ServiceBusProcessorFactory processorFactory) {
          ServiceBusContainerProperties containerProperties = new ServiceBusContainerProperties();
          containerProperties.setEntityName("TOPIC_NAME");
          containerProperties.setSubscriptionName("SUBSCRIPTION_NAME");
          containerProperties.setAutoComplete(false);
          return new ServiceBusMessageListenerContainer(processorFactory, containerProperties);
      }
  
      @Bean
      public ServiceBusInboundChannelAdapter topicMessageChannelAdapter(
          @Qualifier("INPUT_CHANNEL") MessageChannel inputChannel,
          @Qualifier("topic-listener-container") ServiceBusMessageListenerContainer listenerContainer) {
          ServiceBusInboundChannelAdapter adapter = new ServiceBusInboundChannelAdapter(listenerContainer);
          adapter.setOutputChannel(inputChannel);
          return adapter;
      }
  }
  

• DefaultMessageHandler vzorový kód:

  Starší verze kódu, který jako příklad přebírá frontu:

  public class Demo {
      @Bean
      @ServiceActivator(inputChannel = "OUTPUT_CHANNEL_NAME")
      public MessageHandler queueMessageSender(ServiceBusQueueOperation queueOperation) {
          DefaultMessageHandler handler = new DefaultMessageHandler("QUEUE_NAME", queueOperation);
          handler.setSendCallback(new ListenableFutureCallback<Void>() {
              @Override
              public void onSuccess(Void result) {
                  LOGGER.info("Message was sent successfully.");
              }
              @Override
              public void onFailure(Throwable ex) {
                  LOGGER.info("There was an error sending the message.");
              }
          });
          return handler;
      }
  }
  

  Moderní kód:

  public class Demo {
  
      @Bean
      @ServiceActivator(inputChannel = "OUTPUT_CHANNEL_NAME")
      public MessageHandler queueMessageSender(ServiceBusTemplate serviceBusTemplate) {
          serviceBusTemplate.setDefaultEntityType(ServiceBusEntityType.QUEUE);
          DefaultMessageHandler handler = new DefaultMessageHandler("QUEUE_NAME", serviceBusTemplate);
          handler.setSendCallback(new ListenableFutureCallback<Void>() {
              @Override
              public void onSuccess(Void result) {
                  LOGGER.info("Message was sent successfully for {}.", "QUEUE_NAME");
              }
  
              @Override
              public void onFailure(Throwable ex) {
                  LOGGER.info("There was an error sending the message.");
              }
          });
  
          return handler;
      }
  }
  

Od azure-spring-integration-servicebus do spring-integration-azure-servicebus

Tento průvodce má pomoct s migrací z spring-integration-azure-servicebus verze 2 nástroje azure-spring-integration-servicebus.

• Přehled změn ve verzi 4.0 najdete v částech Úvod a Výhody migrace.
• Další informace o změnách strategie v pojmenování projektu najdete v části Změny názvů.
• Informace o použití jednoho kusovníku pro všechny knihovny Azure Spring Cloud najdete v části BOM.

Změny rozhraní API

• Odstraňte ServiceBusQueueOperation a ServiceBusTopicOperation s funkcí přihlášení k odběru přesunutou do ServiceBusMessageListenerContainer třídy a odesílající funkce se přesunula do ServiceBusTemplate.
• Odstraňte ServiceBusQueueInboundChannelAdapter a ServiceBusTopicInboundChannelAdapter a přesuňte funkce pro naslouchání entitě fronty nebo tématu Service Bus serviceBusInboundChannelAdapter.
• Změňte konstruktor z ServiceBusQueueInboundChannelAdapter(String, SubscribeByGroupOperation, String) na ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer) a ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer, ListenerMode).
• Změňte konstruktor z ServiceBusTopicInboundChannelAdapter(String, SubscribeByGroupOperation, String) na ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer) a ServiceBusInboundChannelAdapter(ServiceBusMessageListenerContainer, ListenerMode).
• Přetažení rozhraní API ServiceBusQueueOperation#setCheckpointConfig a ServiceBusTopicOperation#setCheckpointConfig. Pokud chcete nastavit konfiguraci kontrolního bodu pro adaptér příchozího kanálu, můžou uživatelé místo toho volat metodu ServiceBusContainerProperties#setAutoComplete. Chcete-li zakázat režim automatického dokončování, je ekvivalentní MANUAL režimu kontrolního bodu a k jeho povolení se aktivuje režim RECORD.
• Přetažení rozhraní API ServiceBusQueueOperation#setClientConfig a ServiceBusTopicOperation#setClientConfig. Pokud chcete nakonfigurovat podkladové ServiceBusProcessorClient používané adaptérem příchozího kanálu, můžou uživatelé místo toho použít ServiceBusContainerProperties.
• Zahoďte podporu CompletableFuture v ServiceBusTemplate a DefaultMessageHandler, místo toho podporu Reactor.
• Přidáním nového rozhraní API ServiceBusTemplate#setDefaultEntityType zadejte typ entity, který se vyžaduje, pokud pro PropertiesSupplier<String, ProducerProperties>není k dispozici žádná ProducerProperties#entityType.
• Přetažení záhlaví zprávy AzureHeaders.RAW_ID. Místo toho použijte ServiceBusMessageHeaders.MESSAGE_ID.

Následující tabulka ukazuje mapování tříd z azure-spring-integration-servicebus na spring-integration-azure-servicebus:

Od azure-spring-cloud-starter-storage-queue do spring-cloud-azure-starter-integration-storage-queue

Tento průvodce má pomoct s migrací z spring-cloud-azure-starter-integration-storage-queue verze 2 nástroje azure-spring-cloud-starter-storage-queue.

Obecné informace najdete na následujících odkazech:

• Přehled změn ve verzi 4.0 najdete v částech Úvod a Výhody migrace.
• Další informace o změnách strategie v pojmenování projektu najdete v části Změny názvů.
• Informace o použití jednoho kusovníku pro všechny knihovny Azure Spring Cloud najdete v části BOM.
• Informace o zpracování ověřování ve spring cloudu Azure 4.0 najdete v části Změny ověřování.
• Informace o využití spring-boot-properties-migrator během migrace najdete v části Konfigurace jednotlivých sad SDK.
• Další informace o globálních a běžných změnách konfigurace najdete v části Globální konfigurace.

Změny konfigurace sady SDK

Všechny názvy vlastností konfigurace změnily předponu z spring.cloud.azure.storage na spring.cloud.azure.storage.queue.

Následující tabulka ukazuje mapování vlastností z azure-spring-cloud-starter-storage-queue na spring-cloud-azure-starter-integration-storage-queue:

Změny rozhraní API

• Odstraňte StorageQueueOperation a místo toho zadejte StorageQueueTemplate.
• Zahoďte konfiguraci checkpoint-mode v StorageQueueTemplate, podporují pouze režim MANUAL.

Následující tabulka ukazuje mapování tříd z azure-spring-cloud-starter-storage-queue na spring-cloud-azure-starter-integration-storage-queue.

Od azure-spring-integration-storage-queue do spring-integration-azure-storage-queue

Tento průvodce má pomoct s migrací z spring-integration-azure-storage-queue verze 2 nástroje azure-spring-integration-storage-queue.

• Přehled změn ve verzi 4.0 najdete v částech Úvod a Výhody migrace.
• Další informace o změnách strategie v pojmenování projektu najdete v části Změny názvů.
• Informace o použití jednoho kusovníku pro všechny knihovny Azure Spring Cloud najdete v části BOM.

Změny rozhraní API

• Odstraňte StorageQueueOperation a místo toho zadejte StorageQueueTemplate.
• Zahoďte konfiguraci checkpoint-mode v StorageQueueTemplate, podporují pouze režim MANUAL.

Následující tabulka ukazuje mapování tříd z azure-spring-integration-storage-queue na spring-integration-azure-storage-queue.

Od azure-spring-cloud-stream-binder-eventhubs do spring-cloud-azure-stream-binder-eventhubs

Tento průvodce má pomoct s migrací z spring-cloud-azure-stream-binder-eventhubs verze 2 nástroje azure-spring-cloud-stream-binder-eventhubs.

Obecné informace najdete na následujících odkazech:

• Přehled změn ve verzi 4.0 najdete v částech Úvod a Výhody migrace.
• Další informace o změnách strategie v pojmenování projektu najdete v části Změny názvů.
• Informace o použití jednoho kusovníku pro všechny knihovny Azure Spring Cloud najdete v části BOM.
• Informace o zpracování ověřování ve spring cloudu Azure 4.0 najdete v části Změny ověřování.
• Informace o využití spring-boot-properties-migrator během migrace najdete v části Konfigurace jednotlivých sad SDK.
• Další informace o globálních a běžných změnách konfigurace najdete v části Globální konfigurace.

Změny konfigurace sady SDK

Změny podřízených položek pro následující předponu najdete v následující tabulce.

Následující tabulka ukazuje mapování vlastností z azure-spring-cloud-stream-binder-eventhubs na spring-cloud-azure-stream-binder-eventhubs:

Příklady migrace konfigurace

Pokud chcete použít připojovací řetězec pro ověřování a migrovat výše uvedené vlastnosti, jsou změny konfigurace uvedeny takto:

Starší konfigurace:

spring:
  cloud:
    azure:
      eventhub:
        connection-string: ${AZURE_EVENTHUBS_CONNECTION_STRING}
        checkpoint-storage-account: ${AZURE_CHECKPOINT_STORAGE_ACCOUNT_NAME}
        checkpoint-access-key: ${AZURE_CHECKPOINT_ACCOUNT_KEY}
        checkpoint-container: ${AZURE_CHECKPOINT_CONTAINER_NAME}
    stream:
      eventhub:
        bindings:
          <binding-name>:
            consumer:
              max-batch-size: ${AZURE_MAX_BATCH_SIZE}
              max-wait-time: ${AZURE_MAX_WAIT_TIME}
              checkpoint-mode: ${AZURE_CHECKPOINT_MODE}
              checkpoint-count: ${AZURE_CHECKPOINT_COUNT}
              checkpoint-interval: ${AZURE_CHECKPOINT_INTERVAL}
              start-position: EARLIEST

Moderní konfigurace:

spring:
  cloud:
    azure:
      eventhubs:
        connection-string: ${AZURE_EVENTHUBS_CONNECTION_STRING}
        processor:
          checkpoint-store:
            container-name: ${AZURE_STORAGE_CONTAINER_NAME}
            account-name:  ${AZURE_STORAGE_ACCOUNT_NAME}
            account-key: ${AZURE_STORAGE_ACCOUNT_KEY}
    stream:
      eventhubs:
        bindings:
          <binding-name>:
            consumer:
              batch:
                max-size: ${AZURE_MAX_BATCH_SIZE}
                max-wait-time: ${AZURE_MAX_WAIT_TIME}
              checkpoint:
                mode: ${AZURE_CHECKPOINT_MODE}
                count: ${AZURE_CHECKPOINT_COUNT}
                interval: ${AZURE_CHECKPOINT_INTERVAL}
              initial-partition-event-position:
                0:
                  offset: earliest
                1:
                  sequence-number: 100
                2:
                  enqueued-date-time: 2022-01-12T13:32:47.650005Z
                4:
                  inclusive: false

Pokud použijete objekty zabezpečení místo připojovacích řetězců, ve verzích před 4.0 se aplikace nejprve připojí k Azure Resource Manager (ARM) s poskytnutým objektem zabezpečení a pak načte připojovací řetězec zadaného oboru názvů pomocí ARM. Na konci aplikace používá načtené připojovací řetězec pro připojení k Azure Event Hubs. Tímto způsobem by měl být poskytnut zadaný objekt zabezpečení s rolí Contributor pro načtení přidruženého oboru názvů Azure Event Hubs.

Pro Azure Spring Apps 4.0 poskytujeme dva způsoby využití objektů zabezpečení pro ověřování. Jeden stále používá objekty zabezpečení pro připojení k ARM a načtení připojovacích řetězců, ve kterých se pro objekty zabezpečení vyžaduje Contributor role. Druhý využívá objekty zabezpečení k ověření v Microsoft Entra ID a pak se připojují k Azure Event Hubs přímo. V tomto případě už není Contributor role nutná, zatímco jiné Data související role jsou vyžadovány pro operace zasílání zpráv. Pokud chcete zajistit, aby objekt zabezpečení získal dostatečná oprávnění pro přístup k prostředku Azure, přečtěte si téma Authorize přístupu pomocí Microsoft Entra ID.

V případě ověřování založeného na ARM je například migrace instančního objektu uvedená v následujícím seznamu, kde by se přiřazená role neměla měnit:

Starší konfigurace:

spring:
  cloud:
    azure:
      client-id: ${AZURE_CLIENT_ID}
      client-secret: ${AZURE_CLIENT_SECRET}
      tenant-id: <tenant>
      resource-group: ${EVENTHUB_RESOURCE_GROUP}
      eventhub:
        namespace: ${EVENTHUB_NAMESPACE}

Vyžaduje se moderní konfigurace, vlastnosti id Azure předplatného a skupiny prostředků:

spring:
  cloud:
    azure:
      credential:
        client-id: ${AZURE_CLIENT_ID}
        client-secret: ${AZURE_CLIENT_SECRET}
      profile:
        tenant-id: <tenant>
        subscription-id: ${AZURE_SUBSCRIPTION_ID}
      eventhubs:
        namespace: ${EVENTHUB_NAMESPACE}
        resource:
          resource-group: ${RESOURCE_GROUP}

Můžete také migrovat na ověřování a autorizaci pomocí Microsoft Entra ID přímo bez nutnosti objíždět se do ARM. Ujistěte se, že objekt zabezpečení potřebný Data rolím pro operace zasílání zpráv. Příklady konfigurace instančního objektu a spravované identity jsou uvedené takto:

• S instančním objektem

  spring:
    cloud:
      azure:
        credential:
          client-id: ${AZURE_CLIENT_ID}
          client-secret: ${AZURE_CLIENT_SECRET}
        profile:
          tenant-id: <tenant>
        eventhubs:
          namespace: ${EVENTHUB_NAMESPACE}
  

• Se spravovanou identitou

  spring:
    cloud:
      azure:
        credential:
          managed-identity-enabled: true
          client-id: ${AZURE_MANAGED_IDENTITY_CLIENT_ID} # Only needed when using a user-assigned managed identity
        eventhubs:
          namespace: ${EVENTHUB_NAMESPACE}
  

Změny rozhraní API

Následující tabulka ukazuje mapování tříd z azure-spring-cloud-stream-binder-eventhubs na spring-cloud-azure-stream-binder-eventhubs.

Od azure-spring-cloud-stream-binder-servicebus-* do spring-cloud-azure-stream-binder-servicebus

Tento průvodce má pomoct s migrací z spring-cloud-azure-stream-binder-servicebus verze 2 nebo azure-spring-cloud-stream-binder-servicebus-queueazure-spring-cloud-stream-binder-servicebus-topic.

Obecné informace najdete na následujících odkazech:

• Přehled změn ve verzi 4.0 najdete v částech Úvod a Výhody migrace.
• Další informace o změnách strategie v pojmenování projektu najdete v části Změny názvů.
• Informace o použití jednoho kusovníku pro všechny knihovny Azure Spring Cloud najdete v části BOM.
• Informace o zpracování ověřování ve spring cloudu Azure 4.0 najdete v části Změny ověřování.
• Informace o využití spring-boot-properties-migrator během migrace najdete v části Konfigurace jednotlivých sad SDK.
• Další informace o globálních a běžných změnách konfigurace najdete v části Globální konfigurace.

Změny konfigurace sady SDK

Následující tabulka uvádí nové vlastnosti konfigurace spring-cloud-azure-stream-binder-servicebus:

Následující tabulka ukazuje mapování vlastností z azure-spring-cloud-stream-binder-servicebus-* na spring-cloud-azure-stream-binder-servicebus:

Příklady migrace konfigurace

Starší konfigurace, například fronta:

spring:
  cloud:
    azure:
      servicebus:
        connection-string: ${AZURE_SERVICEBUS_BINDER_CONNECTION_STRING}
    stream:
      function:
        definition: consume;supply
      bindings:
        consume-in-0:
          destination: ${AZURE_SERVICEBUS_QUEUE_NAME}
        supply-out-0:
          destination: ${AZURE_SERVICEBUS_QUEUE_NAME}
      servicebus:
        queue:
          bindings:
            consume-in-0:
              consumer:
                checkpoint-mode: MANUAL

Moderní konfigurace:

spring:
  cloud:
    azure:
      servicebus:
        connection-string: ${AZURE_SERVICEBUS_BINDER_CONNECTION_STRING}
    stream:
      function:
        definition: consume;supply
      bindings:
        consume-in-0:
          destination: ${AZURE_SERVICEBUS_QUEUE_NAME}
        supply-out-0:
          destination: ${AZURE_SERVICEBUS_QUEUE_NAME}
      servicebus:
        bindings:
          consume-in-0:
            consumer:
              auto-complete: false
          supply-out-0:
            producer:
              entity-type: queue #set as topic if needed

Pokud použijete objekty zabezpečení místo připojovacích řetězců, ve verzích před 4.0 se aplikace nejprve připojí k Azure Resource Manager (ARM) s poskytnutým objektem zabezpečení a pak načte připojovací řetězec zadaného oboru názvů pomocí ARM. Na konci aplikace používá načtené připojovací řetězec pro připojení k Azure Service Bus. Tímto způsobem by měl být poskytnut zadaný objekt zabezpečení s rolí Contributor pro načtení přidruženého oboru názvů Azure Service Bus.

Pro Azure Spring Apps 4.0 poskytujeme dva způsoby využití objektů zabezpečení pro ověřování. Jeden stále používá objekty zabezpečení pro připojení k ARM a načtení připojovacích řetězců, ve kterých se pro objekty zabezpečení vyžaduje Contributor role. Druhý využívá objekty zabezpečení k ověření Microsoft Entra ID a pak se připojují k Azure Service Bus přímo. V tomto případě už není Contributor role nutná, zatímco jiné Data související role jsou vyžadovány pro operace zasílání zpráv. Pokud chcete zajistit, aby objekt zabezpečení získal dostatečná oprávnění pro přístup k prostředku Azure, přečtěte si téma Authorize přístupu pomocí Microsoft Entra ID.

V případě ověřování založeného na ARM je například migrace instančního objektu uvedená v následujícím seznamu, kde by se přiřazená role neměla měnit:

Starší konfigurace:

spring:
  cloud:
    azure:
      client-id: ${AZURE_CLIENT_ID}
      client-secret: ${AZURE_CLIENT_SECRET}
      tenant-id: <tenant>
      resource-group: ${SERVICEBUS_RESOURCE_GROUP}
      servicebus:
        namespace: ${SERVICEBUS_NAMESPACE}

Vyžaduje se moderní konfigurace, vlastnosti id Azure předplatného a skupiny prostředků:

spring:
  cloud:
    azure:
      credential:
        client-id: ${AZURE_CLIENT_ID}
        client-secret: ${AZURE_CLIENT_SECRET}
      profile:
        tenant-id: <tenant>
        subscription-id: ${AZURE_SUBSCRIPTION_ID}
      servicebus:
        namespace: ${SERVICEBUS_NAMESPACE}
        resource:
          resource-group: ${SERVICEBUS_RESOURCE_GROUP}

Můžete také migrovat na ověřování a autorizaci pomocí Microsoft Entra ID přímo bez nutnosti objíždět se do ARM. Ujistěte se, že objekt zabezpečení potřebný Data rolím pro operace zasílání zpráv. Příklady konfigurace instančního objektu a spravované identity jsou uvedené takto:

• S instančním objektem

  spring:
    cloud:
      azure:
        credential:
          client-id: ${AZURE_CLIENT_ID}
          client-secret: ${AZURE_CLIENT_SECRET}
        profile:
          tenant-id: <tenant>
        servicebus:
          namespace: ${SERVICEBUS_NAMESPACE}
  

• Se spravovanou identitou

  spring:
    cloud:
      azure:
        credential:
          managed-identity-enabled: true
          client-id: ${AZURE_MANAGED_IDENTITY_CLIENT_ID} # Only needed when using a user-assigned   managed identity
        servicebus:
          namespace: ${SERVICEBUS_NAMESPACE}
  

Změny rozhraní API

• Přetažení záhlaví zprávy AzureHeaders.RAW_ID. Místo toho použijte ServiceBusMessageHeaders.MESSAGE_ID.

Následující tabulka ukazuje mapování tříd z azure-spring-cloud-stream-binder-eventhubs na spring-cloud-azure-stream-binder-eventhubs.

azure-spring-cloud-messaging

Knihovna com.azure.spring:azure-spring-cloud-messaging není připravená na verzi 4.0. Funkce poznámek naslouchacího procesu je přepracovaná, takže @AzureMessageListener, @AzureMessageListenersa @EnableAzureMessaging poznámky se v současné době nepodporují.