Skip to content

Commit 88edfce

Browse files
authored
Merge pull request #47994 from spelluru/kaftatut1template
applying Tutorial template
2 parents 20f24c4 + 79dc7b6 commit 88edfce

File tree

1 file changed

+28
-12
lines changed

1 file changed

+28
-12
lines changed

articles/event-hubs/event-hubs-kafka-mirror-maker-tutorial.md

Lines changed: 28 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -16,16 +16,26 @@ ms.author: bahariri
1616

1717
# Use Kafka MirrorMaker with Event Hubs for Apache Kafka
1818

19+
This tutorial shows how to mirror a Kafka broker in a Kafka enabled event hub using Kafka MirrorMaker.
20+
21+
![Kafka MirrorMaker with Event Hubs](./media/event-hubs-kafka-mirror-maker-tutorial/evnent-hubs-mirror-maker1.png)
22+
1923
> [!NOTE]
2024
> This sample is available on [GitHub](https://github.com/Azure/azure-event-hubs)
2125
22-
One major consideration for modern cloud scale apps is the ability to update, improve, and change infrastructure without interrupting service. This tutorial shows how a Kafka-enabled event hub and Kafka MirrorMaker can integrate an existing Kafka pipeline into Azure by "mirroring" the Kafka input stream in the Event Hubs service.
2326

24-
An Azure Event Hubs Kafka endpoint enables you to connect to Azure Event Hubs using the Kafka protocol (that is, Kafka clients). By making minimal changes to a Kafka application, you can connect to Azure Event Hubs and enjoy the benefits of the Azure ecosystem. Kafka enabled Event Hubs currently supports Kafka versions 1.0 and later.
27+
In this tutorial, you learn how to:
28+
> [!div class="checklist"]
29+
> * Create an Event Hubs namespace
30+
> * Clone the example project
31+
> * Set up a Kafka cluster
32+
> * Configure Kafka MirrorMaker
33+
> * Run Kafka MirrorMaker
2534
26-
This example shows how to mirror a Kafka broker in a Kafka enabled event hub using Kafka MirrorMaker.
35+
## Introduction
36+
One major consideration for modern cloud scale apps is the ability to update, improve, and change infrastructure without interrupting service. This tutorial shows how a Kafka-enabled event hub and Kafka MirrorMaker can integrate an existing Kafka pipeline into Azure by "mirroring" the Kafka input stream in the Event Hubs service.
2737

28-
![Kafka MirrorMaker with Event Hubs](./media/event-hubs-kafka-mirror-maker-tutorial/evnent-hubs-mirror-maker1.png)
38+
An Azure Event Hubs Kafka endpoint enables you to connect to Azure Event Hubs using the Kafka protocol (that is, Kafka clients). By making minimal changes to a Kafka application, you can connect to Azure Event Hubs and enjoy the benefits of the Azure ecosystem. Kafka enabled Event Hubs currently supports Kafka versions 1.0 and later.
2939

3040
## Prerequisites
3141

@@ -57,14 +67,12 @@ cd azure-event-hubs/samples/kafka/mirror-maker
5767

5868
Use the [Kafka quickstart guide](https://kafka.apache.org/quickstart) to set up a cluster with the desired settings (or use an existing Kafka cluster).
5969

60-
## Kafka MirrorMaker
70+
## Configure Kafka MirrorMaker
6171

6272
Kafka MirrorMaker enables the "mirroring" of a stream. Given source and destination Kafka clusters, MirrorMaker ensures any messages sent to the source cluster are received by both the source and destination clusters. This example shows how to mirror a source Kafka cluster with a destination Kafka-enabled event hub. This scenario can be used to send data from an existing Kafka pipeline to Event Hubs without interrupting the flow of data.
6373

6474
For more detailed information on Kafka MirrorMaker, see the [Kafka Mirroring/MirrorMaker guide](https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=27846330).
6575

66-
### Configuration
67-
6876
To configure Kafka MirrorMaker, give it a Kafka cluster as its consumer/source and a Kafka-enabled event hub as its producer/destination.
6977

7078
#### Consumer configuration
@@ -96,7 +104,7 @@ security.protocol=SASL_SSL
96104
sasl.jaas.config=org.apache.kafka.common.security.plain.PlainLoginModule required username="$ConnectionString" password="{YOUR.EVENTHUBS.CONNECTION.STRING}";
97105
```
98106

99-
### Run MirrorMaker
107+
## Run Kafka MirrorMaker
100108

101109
Run the Kafka MirrorMaker script from the root Kafka directory using the newly updated configuration files. Make sure to either copy the config files to the root Kafka directory, or update their paths in the following command.
102110

@@ -110,7 +118,15 @@ With MirrorMaker running, any events sent to the source Kafka cluster are receiv
110118

111119
## Next steps
112120

113-
* [Learn about Event Hubs](event-hubs-what-is-event-hubs.md)
114-
* [Learn about Event Hubs for Kafka](event-hubs-for-kafka-ecosystem-overview.md)
115-
* Learn more about [MirrorMaker](https://cwiki.apache.org/confluence/pages/viewpage.action?pageId=27846330) to stream events from Kafka on-premises to Kafka enabled event hubs on cloud.
116-
* Learn how to stream into Kafka enabled Event Hubs using [native Kafka applications](event-hubs-quickstart-kafka-enabled-event-hubs.md), [Apache Flink](event-hubs-kafka-flink-tutorial.md), or [Akka Streams](event-hubs-kafka-akka-streams-tutorial.md).
121+
In this tutorial, you learn how to:
122+
> [!div class="checklist"]
123+
> * Create an Event Hubs namespace
124+
> * Clone the example project
125+
> * Set up a Kafka cluster
126+
> * Configure Kafka MirrorMaker
127+
> * Run Kafka MirrorMaker
128+
129+
Advance to the next article to learn more about Event Hubs for Apache Kafka:
130+
131+
> [!div class="nextstepaction"]
132+
> [Use Apache Flink with Azure Event Hubs for Kafka](event-hubs-kafka-flink-tutorial.md)

0 commit comments

Comments
 (0)