Skip to content
This repository was archived by the owner on Mar 17, 2025. It is now read-only.

Commit adc6869

Browse files
committed
use kafkacat name
1 parent 1ee6c1c commit adc6869

File tree

42 files changed

+66
-64
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

42 files changed

+66
-64
lines changed

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,7 @@ Options:
7575
| [grpc.kafka.proxy](grpc.kafka.proxy) | Correlates gRPC requests and responses over separate Kafka topics |
7676
| [grpc.proxy](grpc.proxy) | Proxies gRPC requests and responses sent to the gRPC server from a gRPC client |
7777
| [http.filesystem](http.filesystem) | Serves files from a directory on the local filesystem |
78-
| [http.json.validate](http.json.validate) | Proxy request sent to the HTTP server from an HTTP client with schema enforcement |
78+
| [http.json.schema](http.json.schema) | Proxy request sent to the HTTP server from an HTTP client with schema enforcement |
7979
| [http.jwt](http.jwt) | Echoes request sent to the HTTP server from a JWT-authorized HTTP client |
8080
| [http.kafka.async](http.kafka.async) | Correlates HTTP requests and responses over separate Kafka topics, asynchronously |
8181
| [http.kafka.avro.json](http.kafka.avro.json) | Validate messages while produce and fetch to a Kafka topic |

asyncapi.http.kafka.proxy/README.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -132,7 +132,7 @@ output:
132132
```
133133

134134
Copy the location, and create a `GET` async request using the location as the path.
135-
Note that the response will not return until you complete the following step to produce the response with `kcat`.
135+
Note that the response will not return until you complete the following step to produce the response with `kafkacat`.
136136

137137
```bash
138138
curl -v --location 'http://localhost:7114/customer;cid={correlationId}' \
@@ -158,15 +158,15 @@ output:
158158
{"id":200000,"username":"fehguy","status":"approved","address":[{"street":"437 Lytton","city":"Palo Alto","state":"CA","zip":"94301"}]}%
159159
```
160160

161-
Using `kcat` and the copied `correlation-id` produce the correlated message:
161+
Using `kafkacat` and the copied `correlation-id` produce the correlated message:
162162

163163
```sh
164-
echo '{"id":200000,"username":"fehguy","status":"approved","address":[{"street":"437 Lytton","city":"Palo Alto","state":"CA","zip":"94301"}]}' | docker compose -p zilla-asyncapi-http-kafka-proxy exec -T kcat \
165-
kafkacat -P \
166-
-b kafka:29092 \
167-
-k "c234d09b-2fdf-4538-9d31-27c8e2912d4e" \
168-
-t petstore-verified-customers \
169-
-H "zilla:correlation-id={correlationId}"
164+
echo '{"id":200000,"username":"fehguy","status":"approved","address":[{"street":"437 Lytton","city":"Palo Alto","state":"CA","zip":"94301"}]}' | docker compose -p zilla-asyncapi-http-kafka-proxy exec -T kafkacat \
165+
kafkacat -P \
166+
-b kafka:29092 \
167+
-k "c234d09b-2fdf-4538-9d31-27c8e2912d4e" \
168+
-t petstore-verified-customers \
169+
-H "zilla:correlation-id={correlationId}"
170170
```
171171

172172
## Teardown

asyncapi.http.kafka.proxy/compose.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -78,7 +78,7 @@ services:
7878
KAFKA_CLUSTERS_0_NAME: local
7979
KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS: kafka:29092
8080

81-
kcat:
81+
kafkacat:
8282
image: confluentinc/cp-kafkacat:7.1.9
8383
command: "bash"
8484
stdin_open: true

asyncapi.mqtt.kafka.proxy/compose.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -79,7 +79,7 @@ services:
7979
KAFKA_CLUSTERS_0_NAME: local
8080
KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS: kafka:29092
8181

82-
kcat:
82+
kafkacat:
8383
image: confluentinc/cp-kafkacat:7.1.9
8484
command: "bash"
8585
stdin_open: true

asyncapi.sse.kafka.proxy/README.md

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -22,6 +22,7 @@ docker compose up -d
2222
### Verify behaviour
2323

2424
Using `curl` client connect to the SSE stream.
25+
2526
```bash
2627
curl -N --http2 -H "Accept:text/event-stream" -v "http://localhost:7114/events"
2728
```
@@ -48,12 +49,13 @@ id:AQIAAg==
4849
data:{ "id": 1, "name": "Hello World!"}
4950
```
5051

51-
In another terminal window use `kcat` to publish to the `events` Kafka topic
52+
In another terminal window use `kafkacat` to publish to the `events` Kafka topic.
53+
5254
```bash
53-
echo '{ "id": 1, "name": "Hello World!"}' | docker compose -p zilla-asyncapi-sse-kafka-proxy exec -T kcat \
54-
kafkacat -P \
55-
-b kafka:29092 \
56-
-k "1" -t events
55+
echo '{ "id": 1, "name": "Hello World!"}' | docker compose -p zilla-asyncapi-sse-kafka-proxy exec -T kafkacat \
56+
kafkacat -P \
57+
-b kafka:29092 \
58+
-k "1" -t events
5759
```
5860

5961
On the `curl` client, the event should appear.

asyncapi.sse.kafka.proxy/compose.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -76,7 +76,7 @@ services:
7676
KAFKA_CLUSTERS_0_NAME: local
7777
KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS: kafka:29092
7878

79-
kcat:
79+
kafkacat:
8080
image: confluentinc/cp-kafkacat:7.1.9
8181
command: "bash"
8282
stdin_open: true

grpc.kafka.echo/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -43,7 +43,7 @@ output:
4343
Verify the message payload, followed by a tombstone to mark the end of the request.
4444

4545
```bash
46-
docker compose -p zilla-grpc-kafka-echo exec kcat \
46+
docker compose -p zilla-grpc-kafka-echo exec kafkacat \
4747
kafkacat -C -b kafka:29092 -t echo-messages -J -u | jq .
4848
```
4949

@@ -112,7 +112,7 @@ Paste below message.
112112
Verify the message payloads, followed by a tombstone to mark the end of each request.
113113

114114
```bash
115-
docker compose -p zilla-grpc-kafka-echo exec kcat \
115+
docker compose -p zilla-grpc-kafka-echo exec kafkacat \
116116
kafkacat -C -b kafka:29092 -t echo-messages -J -u | jq .
117117
```
118118

grpc.kafka.echo/compose.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -76,7 +76,7 @@ services:
7676
KAFKA_CLUSTERS_0_NAME: local
7777
KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS: kafka:29092
7878

79-
kcat:
79+
kafkacat:
8080
image: confluentinc/cp-kafkacat:7.1.9
8181
command: "bash"
8282
stdin_open: true

grpc.kafka.fanout/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -34,7 +34,7 @@ echo 'message: "test"' | protoc --encode=example.FanoutMessage proto/fanout.prot
3434
Produce protobuf message to Kafka topic, repeat to produce multiple messages.
3535

3636
```bash
37-
docker compose -p zilla-grpc-kafka-fanout exec kcat \
37+
docker compose -p zilla-grpc-kafka-fanout exec kafkacat \
3838
kafkacat -P -b kafka:29092 -t messages -k -e ./binary.data
3939
```
4040

@@ -93,7 +93,7 @@ docker compose -p zilla-grpc-kafka-fanout start zilla
9393
Then produce another protobuf message to Kafka, repeat to produce multiple messages.
9494

9595
```bash
96-
docker compose -p zilla-grpc-kafka-fanout exec kcat \
96+
docker compose -p zilla-grpc-kafka-fanout exec kafkacat \
9797
kafkacat -P -b kafka:29092 -t messages -k -e ./binary.data
9898
```
9999

grpc.kafka.fanout/compose.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -76,7 +76,7 @@ services:
7676
KAFKA_CLUSTERS_0_NAME: local
7777
KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS: kafka:29092
7878

79-
kcat:
79+
kafkacat:
8080
image: confluentinc/cp-kafkacat:7.1.9
8181
command: "bash"
8282
stdin_open: true

grpc.kafka.proxy/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -42,7 +42,7 @@ output:
4242
Verify the message payload, followed by a tombstone to mark the end of the request.
4343

4444
```bash
45-
docker compose -p zilla-grpc-kafka-proxy exec kcat \
45+
docker compose -p zilla-grpc-kafka-proxy exec kafkacat \
4646
kafkacat -C -b kafka:29092 -t echo-requests -J -u | jq .
4747
```
4848

@@ -129,7 +129,7 @@ output:
129129
Verify the message payloads arrived in order, followed by a tombstone to mark the end of the response.
130130

131131
```bash
132-
docker compose -p zilla-grpc-kafka-proxy exec kcat \
132+
docker compose -p zilla-grpc-kafka-proxy exec kafkacat \
133133
kafkacat -C -b kafka:29092 -t echo-responses -J -u | jq .
134134
```
135135

grpc.kafka.proxy/compose.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -91,7 +91,7 @@ services:
9191
KAFKA_CLUSTERS_0_NAME: local
9292
KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS: kafka:29092
9393

94-
kcat:
94+
kafkacat:
9595
image: confluentinc/cp-kafkacat:7.1.9
9696
command: "bash"
9797
stdin_open: true

http.json.validate/README.md renamed to http.json.schema/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# http.json.validate
1+
# http.json.schema
22

33
Listens on https port `7114` and will response back whatever is hosted in `nginx` on that path after enforcing validation.
44

http.json.validate/compose.yaml renamed to http.json.schema/compose.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
name: ${NAMESPACE:-zilla-http-schema-validate}
1+
name: ${NAMESPACE:-zilla-http-json-schema}
22
services:
33
zilla:
44
image: ghcr.io/aklivity/zilla:${ZILLA_VERSION:-latest}
File renamed without changes.
File renamed without changes.

http.json.schema/teardown.sh

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
#!/bin/sh
2+
set -e
3+
4+
docker compose -p "${NAMESPACE:-zilla-http-json-schema}" down --remove-orphans
File renamed without changes.
File renamed without changes.
File renamed without changes.
File renamed without changes.

http.json.validate/teardown.sh

Lines changed: 0 additions & 4 deletions
This file was deleted.

http.kafka.async/README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -68,7 +68,7 @@ output:
6868
```
6969

7070
Use the returned location with correlation id specified by the `cid` param to attempt completion of the asynchronous request within `60 seconds`.
71-
Note that the response will not return until you complete the following step to produce the response with `kcat`.
71+
Note that the response will not return until you complete the following step to produce the response with `kafkacat`.
7272

7373
```bash
7474
curl -v \
@@ -90,7 +90,7 @@ output:
9090
Verify the request, then send the correlated response via the kafka `items-responses` topic.
9191

9292
```bash
93-
docker compose -p zilla-http-kafka-async exec kcat \
93+
docker compose -p zilla-http-kafka-async exec kafkacat \
9494
kafkacat -C -b kafka:29092 -t items-requests -J -u | jq .
9595
```
9696

@@ -135,7 +135,7 @@ output:
135135
Make sure to propagate the request message `zilla:correlation-id` header verbatim as a response message `zilla:correlation-id` header.
136136

137137
```bash
138-
echo "{\"greeting\":\"Hello, world `date`\"}" | docker compose -p zilla-http-kafka-async exec -T kcat \
138+
echo "{\"greeting\":\"Hello, world `date`\"}" | docker compose -p zilla-http-kafka-async exec -T kafkacat \
139139
kafkacat -P \
140140
-b kafka:29092 \
141141
-t items-responses \
@@ -157,7 +157,7 @@ The previous asynchronous request will complete with `200 OK` if done within `60
157157
Verify the response via the kafka `items-responses` topic.
158158

159159
```bash
160-
docker compose -p zilla-http-kafka-async exec kcat \
160+
docker compose -p zilla-http-kafka-async exec kafkacat \
161161
kafkacat -C -b kafka:29092 -t items-responses -J -u | jq .
162162
```
163163

http.kafka.async/compose.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,7 @@ services:
7575
KAFKA_CLUSTERS_0_NAME: local
7676
KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS: kafka:29092
7777

78-
kcat:
78+
kafkacat:
7979
image: confluentinc/cp-kafkacat:7.1.9
8080
command: "bash"
8181
stdin_open: true

http.kafka.avro.json/compose.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -105,7 +105,7 @@ services:
105105
KAFKA_CLUSTERS_0_NAME: local
106106
KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS: kafka:29092
107107

108-
kcat:
108+
kafkacat:
109109
image: confluentinc/cp-kafkacat:7.1.9
110110
command: "bash"
111111
stdin_open: true

http.kafka.cache/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@ output:
8383
Produce an item snapshot to the kafka topic.
8484

8585
```bash
86-
echo "{\"greeting\":\"Hello, world `date`\"}" | docker compose -p zilla-http-kafka-cache exec -T kcat \
86+
echo "{\"greeting\":\"Hello, world `date`\"}" | docker compose -p zilla-http-kafka-cache exec -T kafkacat \
8787
kafkacat -P \
8888
-b kafka:29092 \
8989
-t items-snapshots \
@@ -181,7 +181,7 @@ Before the 60 seconds elapses, produce an updated item snapshot to the kafka top
181181
The prefer wait http request returns the new item snapshot with updated `etag` as shown above.
182182

183183
```bash
184-
echo "{\"greeting\":\"Hello, world `date`\"}" | docker compose -p zilla-http-kafka-cache exec -T kcat \
184+
echo "{\"greeting\":\"Hello, world `date`\"}" | docker compose -p zilla-http-kafka-cache exec -T kafkacat \
185185
kafkacat -P \
186186
-b kafka:29092 \
187187
-t items-snapshots \

http.kafka.cache/compose.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ services:
7474
KAFKA_CLUSTERS_0_NAME: local
7575
KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS: kafka:29092
7676

77-
kcat:
77+
kafkacat:
7878
image: confluentinc/cp-kafkacat:7.1.9
7979
command: "bash"
8080
stdin_open: true

http.kafka.crud/compose.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ services:
7474
KAFKA_CLUSTERS_0_NAME: local
7575
KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS: kafka:29092
7676

77-
kcat:
77+
kafkacat:
7878
image: confluentinc/cp-kafkacat:7.1.9
7979
command: "bash"
8080
stdin_open: true

http.kafka.oneway/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ output:
4545
Verify that the event has been produced to the `events` Kafka topic.
4646

4747
```bash
48-
docker compose -p zilla-http-kafka-oneway exec kcat \
48+
docker compose -p zilla-http-kafka-oneway exec kafkacat \
4949
kafkacat -C -b kafka:29092 -t events -J -u | jq .
5050
```
5151

http.kafka.oneway/compose.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,7 @@ services:
7575
KAFKA_CLUSTERS_0_NAME: local
7676
KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS: kafka:29092
7777

78-
kcat:
78+
kafkacat:
7979
image: confluentinc/cp-kafkacat:7.1.9
8080
command: "bash"
8181
stdin_open: true

http.kafka.proto.json/compose.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,7 @@ services:
7575
KAFKA_CLUSTERS_0_NAME: local
7676
KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS: kafka:29092
7777

78-
kcat:
78+
kafkacat:
7979
image: confluentinc/cp-kafkacat:7.1.9
8080
command: "bash"
8181
stdin_open: true

http.kafka.proto.oneway/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -18,10 +18,10 @@ docker compose up -d
1818

1919
## Watch kafka
2020

21-
Open the [Kafka UI](http://localhost:8080/ui/clusters/local/all-topics/my-requests/messages?limit=100&mode=TAILING) or run the kcat command:
21+
Open the [Kafka UI](http://localhost:8080/ui/clusters/local/all-topics/my-requests/messages?limit=100&mode=TAILING) or run the kafkacat command:
2222

2323
```bash
24-
docker compose -p zilla-http-kafka-proto-oneway exec kcat \
24+
docker compose -p zilla-http-kafka-proto-oneway exec kafkacat \
2525
kafkacat -b kafka:29092 -C -f 'Key:Message | %k:%s\n Headers | %h \n\n' -t my-requests
2626
```
2727

http.kafka.proto.oneway/compose.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,7 @@ services:
7575
KAFKA_CLUSTERS_0_NAME: local
7676
KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS: kafka:29092
7777

78-
kcat:
78+
kafkacat:
7979
image: confluentinc/cp-kafkacat:7.1.9
8080
command: "bash"
8181
stdin_open: true

http.kafka.sync/README.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -24,7 +24,7 @@ This will:
2424
## Verify behavior
2525

2626
Send a `PUT` request for a specific item.
27-
Note that the response will not return until you complete the following step to produce the response with `kcat`.
27+
Note that the response will not return until you complete the following step to produce the response with `kafkacat`.
2828

2929
```bash
3030
curl -v \
@@ -53,7 +53,7 @@ Fetch the request message, then send the correlated response via the Kafka UI [i
5353
- or from the command line
5454

5555
```bash
56-
docker compose -p zilla-http-kafka-sync exec kcat \
56+
docker compose -p zilla-http-kafka-sync exec kafkacat \
5757
kafkacat -b kafka:29092 -C -f 'Key:Message | %k:%s\n Headers | %h \n\n' -t items-requests
5858
```
5959

@@ -67,7 +67,7 @@ Produce the the correlated response message via the Kafka UI [items-responses](h
6767
Make sure to propagate the request message `zilla:correlation-id` header, found in the request message, verbatim as a response message `zilla:correlation-id` header.
6868

6969
```bash
70-
echo "{\"greeting\":\"Hello, world `date`\"}" | docker compose -p zilla-http-kafka-sync exec -T kcat \
70+
echo "{\"greeting\":\"Hello, world `date`\"}" | docker compose -p zilla-http-kafka-sync exec -T kafkacat \
7171
kafkacat -P \
7272
-b kafka:29092 \
7373
-t items-responses \
@@ -92,7 +92,7 @@ Verify the response response via the Kafka UI [items-responses](http://localhost
9292
- or from the command line
9393

9494
```bash
95-
docker compose -p zilla-http-kafka-sync exec kcat \
95+
docker compose -p zilla-http-kafka-sync exec kafkacat \
9696
kafkacat -b kafka:29092 -C -f 'Key:Message | %k:%s\n Headers | %h \n\n' -t items-responses
9797
```
9898

http.kafka.sync/compose.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -75,7 +75,7 @@ services:
7575
KAFKA_CLUSTERS_0_NAME: local
7676
KAFKA_CLUSTERS_0_BOOTSTRAPSERVERS: kafka:29092
7777

78-
kcat:
78+
kafkacat:
7979
image: confluentinc/cp-kafkacat:7.1.9
8080
command: "bash"
8181
stdin_open: true

0 commit comments

Comments
 (0)