@@ -8,7 +8,7 @@ This test verifies that the current build of Data Prepper can successfully read
88
99### Phase 1: Write with Released Version
10101 . Start Kafka container
11- 2 . Start ** released** Data Prepper from Docker Hub (e.g., ` opensearchproject/data-prepper:2.10.0 ` )
11+ 2 . Start ** released** Data Prepper from Docker Hub (e.g., ` opensearchproject/data-prepper:2 ` )
12123 . Send 2 test records via HTTP endpoint
13134 . Records are written to Kafka buffer using the released version's format
14145 . Stop the released Data Prepper container
@@ -33,23 +33,23 @@ This test verifies that the current build of Data Prepper can successfully read
3333
3434``` bash
3535# From the repository root
36- ./gradlew :e2e-test:kafka-backward-compatibility:kafkaBackwardCompatibilityTest
36+ ./gradlew :e2e-test:kafka-buffer- backward-compatibility:kafkaBufferBackwardCompatibilityTest
3737```
3838
3939### Run with Specific Version
4040
4141You can test backward compatibility with a specific Data Prepper version:
4242
4343``` bash
44- ./gradlew :e2e-test:kafka-backward-compatibility:kafkaBackwardCompatibilityTest \
45- -PbackwardCompatVersion =2.9.0
44+ ./gradlew :e2e-test:kafka-buffer- backward-compatibility:kafkaBufferBackwardCompatibilityTest \
45+ -PreleasedVersion =2.9.0
4646```
4747
4848## Test Components
4949
5050### Docker Containers
5151
52- 1 . ** Kafka** (` kafka-backward-compat -test ` )
52+ 1 . ** Kafka** (` kafka-buffer- backward-compatibility -test ` )
5353 - Confluent Kafka 3.6.0
5454 - KRaft mode (no ZooKeeper)
5555 - Port: 9092
@@ -74,16 +74,16 @@ You can test backward compatibility with a specific Data Prepper version:
7474
7575## What This Tests
7676
77- ✅ ** Kafka message format compatibility**
77+ ** Kafka message format compatibility**
7878- Protobuf serialization format
7979- Message envelope structure
8080- Field naming and types
8181
82- ✅ ** Consumer offset management**
82+ ** Consumer offset management**
8383- Offset commits and reads
8484- Consumer group handling
8585
86- ✅ ** Data integrity**
86+ ** Data integrity**
8787- Messages written by old version can be read by new version
8888- No data loss or corruption
8989- Field values preserved correctly
@@ -94,7 +94,7 @@ You can test backward compatibility with a specific Data Prepper version:
9494
9595``` bash
9696# Kafka logs
97- docker logs kafka-backward-compat -test
97+ docker logs kafka-buffer- backward-compatibility -test
9898
9999# Released Data Prepper logs
100100docker logs data-prepper-writer
@@ -110,30 +110,30 @@ docker logs node-0.example.com
110110
111111``` bash
112112# Start Kafka manually
113- ./gradlew :e2e-test:kafka-backward-compatibility:startKafkaDockerContainer
113+ ./gradlew :e2e-test:kafka-buffer- backward-compatibility:startKafkaDockerContainer
114114
115115# Start released Data Prepper manually
116- ./gradlew :e2e-test:kafka-backward-compatibility:startReleasedDataPrepperContainer
116+ ./gradlew :e2e-test:kafka-buffer- backward-compatibility:startReleasedDataPrepperContainer
117117
118118# Start current Data Prepper manually
119- ./gradlew :e2e-test:kafka-backward-compatibility:startCurrentDataPrepperContainer
119+ ./gradlew :e2e-test:kafka-buffer- backward-compatibility:startCurrentDataPrepperContainer
120120
121121# Stop all
122- ./gradlew :e2e-test:kafka-backward-compatibility:stopKafkaDockerContainer
123- ./gradlew :e2e-test:kafka-backward-compatibility:stopReleasedDataPrepperContainer
124- ./gradlew :e2e-test:kafka-backward-compatibility:stopCurrentDataPrepperContainer
122+ ./gradlew :e2e-test:kafka-buffer- backward-compatibility:stopKafkaDockerContainer
123+ ./gradlew :e2e-test:kafka-buffer- backward-compatibility:stopReleasedDataPrepperContainer
124+ ./gradlew :e2e-test:kafka-buffer- backward-compatibility:stopCurrentDataPrepperContainer
125125```
126126
127127### Check Kafka Topics
128128
129129``` bash
130- docker exec kafka-backward-compat -test kafka-topics --list --bootstrap-server localhost:9092
130+ docker exec kafka-buffer- backward-compatibility -test kafka-topics --list --bootstrap-server localhost:9092
131131```
132132
133133### Query OpenSearch Directly
134134
135135``` bash
136- curl -k -u admin:admin " https://localhost:9200/backward-compat -test-index/_search?pretty"
136+ curl -k -u admin:admin " https://localhost:9200/kafka- backward-compatibility -test-index/_search?pretty"
137137```
138138
139139## Expected Behavior
@@ -142,19 +142,11 @@ When the test passes:
1421421 . Released Data Prepper successfully writes 2 messages to Kafka
1431432 . Current Data Prepper successfully reads both messages from Kafka
1441443 . Both messages appear in OpenSearch with correct content
145- 4 . Test completes with ✅ SUCCESS message
146-
147- ## CI/CD Integration
148-
149- This test should be run:
150- - ✅ Before releasing new versions
151- - ✅ When making changes to Kafka buffer serialization
152- - ✅ When upgrading Kafka client libraries
153- - ✅ As part of the release candidate verification process
145+ 4 . Test completes with SUCCESS message
154146
155147## Notes
156148
157149- The test uses ** unencrypted** Kafka messages for simplicity
158150- If you need to test encrypted backward compatibility, modify the pipeline configs to enable encryption
159- - The released version can be configured via ` -PbackwardCompatVersion ` property
160- - Default released version is ` 2.10.0 ` (configured in ` build.gradle ` )
151+ - The released version can be configured via ` -PreleasedVersion ` property
152+ - Default released version is ` 2 ` (configured in ` build.gradle ` )
0 commit comments