Skip to content

Commit 2856b7d

Browse files
authored
docs: architectural flow & key features for IoT & Web streaming (aklivity#291)
1 parent 32e6a02 commit 2856b7d

File tree

6 files changed

+19
-28
lines changed

6 files changed

+19
-28
lines changed
2.23 MB
Loading
2.21 MB
Loading

src/solutions/concepts/kafka-proxies/iot-ingest-control.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,14 @@ You will need to choose a wildcard DNS pattern to use for public internet access
1818

1919
The [Zilla Plus for Amazon MSK](https://aws.amazon.com/marketplace/pp/prodview-jshnzslazfm44) IoT Ingest and Control Broker lets authorized Kafka clients connect, publish messages and subscribe to topics in your Confluent Cloud cluster via the internet.
2020

21+
![MSK IoT Ingest and Control Overview](/iot_ingestion_control.png)
22+
23+
## Key Features
24+
25+
- Enable **IoT clients** to securely connect, publish messages, and subscribe to Kafka topics using **MQTT protocol**.
26+
- **No configuration** changes required to your MSK cluster to function as MQTT broker.
27+
- <ZillaPlus/> supports **Auto-Scaling** and are deployed behind a **Network Load Balancer** for optimal performance.
28+
2129
### Deploy with CDK
2230

2331
Follow the [IOT Ingest and Control deploy with CDK](https://github.com/aklivity/zilla-plus-aws-templates/tree/main/amazon-msk/cdk/iot-ingest-and-control) guide to generate or deploy a custom AWS CDK stack. This stack sets up an MQTT broker using a globally trusted TLS server certificate with a wildcard DNS pattern `*.example.aklivity.io`.

src/solutions/concepts/kafka-proxies/web-streaming.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,14 @@ By automating the configuration of a network load balancer and auto-scaling grou
1414

1515
You will need to choose a wildcard DNS pattern to use for public internet access to the Web Streaming proxies. These wildcard DNS names must resolve to the public IP address(es) where the <ZillaPlus/> proxy is deployed. The <ZillaPlus/> proxy must also be configured with a TLS server certificate representing the same wildcard DNS pattern.
1616

17+
![MSK Web Streaming Overview](/web_streaming.png)
18+
19+
## Key Features
20+
21+
- Enable web clients to publish, update, and stream Kafka messages via **customizable REST and SSE APIs**.
22+
- **No configuration** changes required to your MSK cluster to enable seamless web access.
23+
- <ZillaPlus/> supports **Auto-Scaling** and are deployed behind a **Network Load Balancer** for optimal performance.
24+
1725
## Deploy with CDK
1826

1927
Follow the [Web Streaming with CDK](https://github.com/aklivity/zilla-plus-aws-templates/tree/main/amazon-msk/cdk/web-streaming) guide to generate or deploy a custom AWS CDK stack. This stack exposes a custom `REST` path and uses `SASL/SCRAM` authentication.

src/solutions/how-tos/amazon-msk/index.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -11,15 +11,13 @@ With [Zilla Plus for Amazon MSK](https://aws.amazon.com/marketplace/pp/prodview-
1111

1212
The IoT Ingest and Control MQTT Broker that lets clients publish messages and subscribe to topics proxied to Kafka topics in your Amazon MSK cluster.
1313

14-
> [Amazon MSK IoT Ingest and Control Guide](./iot-ingest-control.md)
14+
> [Amazon MSK IoT Ingest and Control Guide](../../concepts/kafka-proxies/iot-ingest-control.md)
1515
1616
## Secure Public Access
1717

1818
The Secure Public Access Proxy lets authorized Kafka clients connect, publish messages and subscribe to topics in your Amazon MSK cluster via the internet.
1919

20-
> [Amazon MSK Secure Public Access Proxy with SASL/SCRAM Guide](./secure-public-access/production.md)
21-
> [Amazon MSK Secure Public Access Proxy with Mutual TLS (mTLS) Guide](./secure-public-access/production-mutual-tls.md)
22-
> [Amazon MSK Secure Public Access Proxy with Unauthorized access Guide](./secure-public-access/development.md)
20+
> [Amazon MSK Secure Public Access Proxy](../../concepts/kafka-proxies/secure-public-access.md)
2321
2422
## Secure Private Access
2523

@@ -31,4 +29,4 @@ The Secure Private Access proxy enables authorized Kafka clients deployed across
3129

3230
The Web Streaming proxy lets Web clients publish, update, and stream messages to a Kafka topic in your Amazon MSK cluster.
3331

34-
> [Amazon MSK Web Streaming Guide](./web-streaming.md)
32+
> [Amazon MSK Web Streaming Guide](../../concepts/kafka-proxies/web-streaming.md)

src/solutions/how-tos/amazon-msk/web-streaming.md

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

0 commit comments

Comments
 (0)