Używanie platformy Spring Kafka z usługą Azure Event Hubs dla interfejsu API platformy Kafka
W tym samouczku przedstawiono sposób konfigurowania opartego na języku Java powiązania strumienia Spring Cloud w celu używania usługi Azure Event Hubs dla platformy Kafka do wysyłania i odbierania komunikatów za pomocą usługi Azure Event Hubs. Aby uzyskać więcej informacji, zobacz Use Azure Event Hubs from Apache Kafka applications (Korzystanie z usługi Azure Event Hubs z aplikacji platformy Apache Kafka)
W tym samouczku uwzględnimy dwie metody uwierzytelniania: uwierzytelnianie firmy Microsoft Entra i uwierzytelnianie sygnatur dostępu współdzielonego (SAS). Karta Bez hasła zawiera uwierzytelnianie firmy Microsoft Entra, a karta Parametry połączenia zawiera uwierzytelnianie sygnatury dostępu współdzielonego.
Uwierzytelnianie Entra firmy Microsoft to mechanizm łączenia się z usługą Azure Event Hubs dla platformy Kafka przy użyciu tożsamości zdefiniowanych w identyfikatorze Entra firmy Microsoft. Dzięki uwierzytelnieniu firmy Microsoft Entra można zarządzać tożsamościami użytkowników bazy danych i innymi usługi firmy Microsoft w centralnej lokalizacji, co upraszcza zarządzanie uprawnieniami.
Uwierzytelnianie sygnatury dostępu współdzielonego używa parametry połączenia przestrzeni nazw usługi Azure Event Hubs dla delegowanego dostępu do usługi Event Hubs dla platformy Kafka. Jeśli zdecydujesz się używać sygnatur dostępu współdzielonego jako poświadczeń, musisz samodzielnie zarządzać parametry połączenia.
Wymagania wstępne
Subskrypcja platformy Azure — utwórz bezpłatnie.
Zestaw Java Development Kit (JDK) w wersji 8 lub nowszej.
Apache Maven, wersja 3.2 lub nowsza.
cURL lub podobne narzędzie HTTP do testowania funkcjonalności.
Usługa Azure Cloud Shell lub interfejs wiersza polecenia platformy Azure w wersji 2.37.0 lub nowszej.
Centrum zdarzeń platformy Azure. Jeśli go nie masz, utwórz centrum zdarzeń przy użyciu witryny Azure Portal.
Aplikacja Spring Boot. Jeśli go nie masz, utwórz projekt Maven za pomocą narzędzia Spring Initializr. Pamiętaj, aby wybrać pozycję Projekt Maven i w obszarze Zależności dodaj platformę Spring Web, spring for Apache Kafka i zależności usługi Cloud Stream , a następnie wybierz pozycję Java w wersji 8 lub nowszej.
Ważne
Do wykonania kroków opisanych w tym samouczku jest wymagana wersja 2.5 lub nowsza.
Przygotowywanie poświadczeń
Usługa Azure Event Hubs obsługuje używanie identyfikatora Entra firmy Microsoft do autoryzowania żądań do zasobów usługi Event Hubs. Za pomocą identyfikatora Entra firmy Microsoft możesz użyć kontroli dostępu opartej na rolach (RBAC) platformy Azure, aby udzielić uprawnień jednostce zabezpieczeń, która może być użytkownikiem lub jednostką usługi aplikacji.
Jeśli chcesz uruchomić ten przykład lokalnie z uwierzytelnianiem firmy Microsoft Entra, upewnij się, że twoje konto użytkownika zostało uwierzytelnione za pośrednictwem zestawu narzędzi Azure Toolkit for IntelliJ, wtyczki konta platformy Azure programu Visual Studio Code lub interfejsu wiersza polecenia platformy Azure. Upewnij się również, że konto otrzymało wystarczające uprawnienia.
Uwaga
W przypadku korzystania z połączeń bez hasła należy udzielić kontu dostępu do zasobów. W usłudze Azure Event Hubs przypisz Azure Event Hubs Data Receiver
rolę i Azure Event Hubs Data Sender
do aktualnie używanego konta Microsoft Entra. Aby uzyskać więcej informacji na temat udzielania ról dostępu, zobacz Przypisywanie ról platformy Azure przy użyciu witryny Azure Portal i Autoryzowanie dostępu do zasobów usługi Event Hubs przy użyciu identyfikatora Entra firmy Microsoft.
Wysyłanie i odbieranie komunikatów z usługi Azure Event Hubs
Za pomocą centrum zdarzeń platformy Azure można wysyłać i odbierać komunikaty przy użyciu platformy Spring Cloud Azure.
Aby zainstalować moduł Spring Cloud Azure Starter, dodaj następujące zależności do pliku pom.xml :
Projekt Spring Cloud Azure Bill of Materials (BOM):
<dependencyManagement> <dependencies> <dependency> <groupId>com.azure.spring</groupId> <artifactId>spring-cloud-azure-dependencies</artifactId> <version>5.19.0</version> <type>pom</type> <scope>import</scope> </dependency> </dependencies> </dependencyManagement>
Uwaga
Jeśli używasz środowiska Spring Boot 2.x, pamiętaj, aby ustawić
spring-cloud-azure-dependencies
wersję na4.19.0
. Ten rachunek materiału (BOM) należy skonfigurować w<dependencyManagement>
sekcji pliku pom.xml . Gwarantuje to, że wszystkie zależności platformy Azure platformy Spring Cloud korzystają z tej samej wersji. Aby uzyskać więcej informacji na temat wersji używanej dla tego modelu BOM, zobacz Która wersja platformy Spring Cloud platformy Azure powinna być używana.Artefakt spring cloud Azure Starter:
<dependency> <groupId>com.azure.spring</groupId> <artifactId>spring-cloud-azure-starter</artifactId> </dependency>
Kodowanie aplikacji
Wykonaj poniższe kroki, aby skonfigurować aplikację do tworzenia i używania komunikatów przy użyciu usługi Azure Event Hubs.
Skonfiguruj poświadczenia centrum zdarzeń, dodając następujące właściwości do pliku application.properties .
spring.cloud.stream.kafka.binder.brokers=${AZ_EVENTHUBS_NAMESPACE_NAME}.servicebus.windows.net:9093 spring.cloud.function.definition=consume;supply spring.cloud.stream.bindings.consume-in-0.destination=${AZ_EVENTHUB_NAME} spring.cloud.stream.bindings.consume-in-0.group=$Default spring.cloud.stream.bindings.supply-out-0.destination=${AZ_EVENTHUB_NAME}
Napiwek
Jeśli używasz wersji
spring-cloud-azure-dependencies:4.3.0
, dodaj właściwośćspring.cloud.stream.binders.<kafka-binder-name>.environment.spring.main.sources
z wartościącom.azure.spring.cloud.autoconfigure.kafka.AzureKafkaSpringCloudStreamConfiguration
.Ponieważ
4.4.0
ta właściwość zostanie dodana automatycznie, więc nie trzeba jej dodawać ręcznie.W poniższej tabeli opisano pola w konfiguracji:
Pole opis spring.cloud.stream.kafka.binder.brokers
Określa punkt końcowy usługi Azure Event Hubs. spring.cloud.stream.bindings.consume-in-0.destination
Określa wejściowe centrum zdarzeń docelowego, które dla tego samouczka jest centrum utworzone wcześniej. spring.cloud.stream.bindings.consume-in-0.group
Określa grupę odbiorców z usługi Azure Event Hubs, którą można ustawić $Default
w celu użycia podstawowej grupy odbiorców utworzonej podczas tworzenia wystąpienia usługi Azure Event Hubs.spring.cloud.stream.bindings.supply-out-0.destination
Określa wyjściowe docelowe centrum zdarzeń, które dla tego samouczka jest takie samo jak miejsce docelowe danych wejściowych. Uwaga
Jeśli włączysz automatyczne tworzenie tematu, pamiętaj, aby dodać element
spring.cloud.stream.kafka.binder.replicationFactor
konfiguracji z wartością ustawioną na co najmniej 1. Aby uzyskać więcej informacji, zobacz Spring Cloud Stream Kafka Binder Reference Guide (Przewodnik referencyjny dotyczący narzędzia binder platformy Kafka w usłudze Spring Cloud Stream).Edytuj plik klasy uruchamiania, aby wyświetlić następującą zawartość.
import org.slf4j.Logger; import org.slf4j.LoggerFactory; import org.springframework.boot.CommandLineRunner; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.context.annotation.Bean; import org.springframework.messaging.Message; import org.springframework.messaging.support.GenericMessage; import reactor.core.publisher.Flux; import reactor.core.publisher.Sinks; import java.util.function.Consumer; import java.util.function.Supplier; @SpringBootApplication public class EventHubKafkaBinderApplication implements CommandLineRunner { private static final Logger LOGGER = LoggerFactory.getLogger(EventHubKafkaBinderApplication.class); private static final Sinks.Many<Message<String>> many = Sinks.many().unicast().onBackpressureBuffer(); public static void main(String[] args) { SpringApplication.run(EventHubKafkaBinderApplication.class, args); } @Bean public Supplier<Flux<Message<String>>> supply() { return ()->many.asFlux() .doOnNext(m->LOGGER.info("Manually sending message {}", m)) .doOnError(t->LOGGER.error("Error encountered", t)); } @Bean public Consumer<Message<String>> consume() { return message->LOGGER.info("New message received: '{}'", message.getPayload()); } @Override public void run(String... args) { many.emitNext(new GenericMessage<>("Hello World"), Sinks.EmitFailureHandler.FAIL_FAST); } }
Napiwek
W tym samouczku nie ma żadnych operacji uwierzytelniania w konfiguracjach ani kodzie. Jednak nawiązywanie połączenia z usługami platformy Azure wymaga uwierzytelniania. Aby ukończyć uwierzytelnianie, musisz użyć usługi Azure Identity. Platforma Spring Cloud na platformie Azure używa
DefaultAzureCredential
biblioteki tożsamości platformy Azure, która ułatwia uzyskiwanie poświadczeń bez żadnych zmian w kodzie.DefaultAzureCredential
obsługuje wiele metod uwierzytelniania i określa, która metoda ma być używana w czasie wykonywania. Takie podejście umożliwia aplikacji używanie różnych metod uwierzytelniania w różnych środowiskach (takich jak środowiska lokalne i produkcyjne) bez implementowania kodu specyficznego dla środowiska. Aby uzyskać więcej informacji, zobacz DefaultAzureCredential.Aby ukończyć uwierzytelnianie w lokalnych środowiskach deweloperskich, możesz użyć interfejsu wiersza polecenia platformy Azure, programu Visual Studio Code, programu PowerShell lub innych metod. Aby uzyskać więcej informacji, zobacz Uwierzytelnianie platformy Azure w środowiskach deweloperskich Java. Aby ukończyć uwierzytelnianie w środowiskach hostingu platformy Azure, zalecamy użycie tożsamości zarządzanej przypisanej przez użytkownika. Aby uzyskać więcej informacji, zobacz Co to są tożsamości zarządzane dla zasobów platformy Azure?
Uruchom aplikację. Komunikaty podobne do poniższego przykładu zostaną opublikowane w dzienniku aplikacji:
Kafka version: 3.0.1 Kafka commitId: 62abe01bee039651 Kafka startTimeMs: 1622616433956 New message received: 'Hello World'
Wdrażanie w usłudze Azure Spring Apps
Teraz, gdy aplikacja Spring Boot działa lokalnie, nadszedł czas, aby przenieść ją do środowiska produkcyjnego. Usługa Azure Spring Apps ułatwia wdrażanie aplikacji Spring Boot na platformie Azure bez żadnych zmian w kodzie. Usługa zarządza infrastrukturą aplikacji Spring, aby deweloperzy mogli skupić się na swoim kodzie. Usługa Azure Spring Apps zapewnia zarządzanie cyklem życia przy użyciu kompleksowego monitorowania i diagnostyki, zarządzania konfiguracją, odnajdywania usług, integracji/ciągłego wdrażania, wdrożeń niebieskich zielonych i nie tylko. Aby wdrożyć aplikację w usłudze Azure Spring Apps, zobacz Wdrażanie pierwszej aplikacji w usłudze Azure Spring Apps.