Skip to content

Commit 9b9dae4

Browse files
committed
fix(kafka): add info
1 parent 874f754 commit 9b9dae4

File tree

4 files changed

+25
-16
lines changed

4 files changed

+25
-16
lines changed

pages/clusters-for-kafka/faq.mdx

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18,6 +18,10 @@ Clusters for Apache Kafka® is currently in [Private Beta](https://www.scaleway.
1818

1919
Clusters for Apache Kafka® is Scaleway's product to provide a secure, fully-managed infrastructure for your Apache Kafka® deployments. With our clusters, you can create data pipelines and event-driven architectures that run natively on Apache Kafka®, without having to manage the underlying infrastructure. This product is currently in Private Beta.
2020

21+
### How do I use my cluster, and how can I connect to it?
22+
23+
To use your cluster, you first [connect](/clusters-for-kafka/how-to/connect-to-cluster/) via the Kafka CLI or any supported programming language. The connection is secured, and requires the appropriate credentials, certificate, and endpoint provided by Scaleway. All configuration is done through a Kafka client, allowing you to manage topics, producers, and consumers easily. This flexibility ensures seamless integration with your applications and workflows.
24+
2125
### What limitations apply during the Private Beta?
2226

2327
Private Beta is aimed at providing an early version of a future product, to allow users to test and validate it during its development. The following limitations apply to Clusters for Apache Kafka® in its current Private Beta phase:
@@ -33,6 +37,20 @@ Private Beta is aimed at providing an early version of a future product, to allo
3337

3438
We aim to improve and develop the product based on feedback received during the beta stage.
3539

40+
### Is Scaleway's Clusters for Apache Kafka® based on the open-source Kafka framework?
41+
42+
Yes, Scaleway's Clusters for Apache Kafka is built on the open-source Apache Kafka framework. We use the Kafka API to ensure compatibility and leverage the robust features of the open-source ecosystem.
43+
44+
## How is Apache Kafka® different to RabbitMQ and NATS?
45+
46+
Apache Kafka, RabbitMQ, and NATS are all messaging systems but serve different purposes and have distinct architectures.
47+
48+
- Apache Kafka is designed for high-throughput, real-time data streaming, and is topic-based, using the pull model. It can process large amounts of data in real-time with high concurrency and fault tolerance, and is ideal for stream processing, event sourcing, and big data applications.
49+
- RabbitMQ is a versatile message broker that supports multiple protocols, and offers strong support for message delivery guarantees and reliability. It uses the push model, and is well-suited for traditional message queuing and task distribution.
50+
- [NATS](/nats/) is a lightweight, high-performance subject-based messaging system focused on speed and simplicity, making it great for microservices.
51+
52+
Each system has its own strengths and is suited to different use cases depending on the requirements of the application.
53+
3654
## Billing
3755

3856
### How am I billed for Clusters for Apache Kafka®?

pages/clusters-for-kafka/how-to/connect-to-cluster.mdx

Lines changed: 5 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -34,24 +34,15 @@ All clients that want to connect to your cluster must:
3434

3535
3. In the **Connectivity** panel, click **Download** next to the TLS certificate.
3636

37-
The TLS certificate is downloaded to your local device. If using Java, import it into a truststore and configure your `client.properties` appropriately. For other types of client (e.g. Python, Go, CLI), you may be able to use the certificate directly by setting its location in your Kafka consumer configuration code (e.g. `'ssl.ca.location': '/path/to/ca.crt'`).
37+
The TLS certificate in `.pem` format is downloaded to your local device. If using Java, import it into a truststore and configure your `client.properties` appropriately. For other types of client (e.g. Python, Go, CLI), you may be able to use the certificate directly by setting its location in your Kafka consumer configuration code.
3838

39-
TODO CHECK:
40-
- Check all of the info above
41-
- Add more info to help users with whatever else is likely to be problematic
42-
- Server side TLS only? (no client cert needed?)
43-
- What CA is used? Is it well known or private? Is the TLS cert in crt or pem format?
39+
<Message type="note">
40+
TLS is server-side only, and no client certificate is required.
41+
</Message>
4442

4543
## How to ensure clients have network access
4644

47-
Any clients wanting to connect to the cluster must either be attached to a Private Network in the same VPC as the cluster, or connect via a Public Gateway in the VPC.
48-
49-
TODO set up static NAT to map ports/IP address?
50-
51-
See the following pages for help:
52-
- [How to attach a resource to a Private Network](/vpc/how-to/attach-resources-to-pn/)
53-
- [How to create a Public Gateway](/public-gateways/how-to/create-a-public-gateway/)
54-
- [Getting the most from Private Networks](/vpc/reference-content/getting-most-private-networks/)
45+
Any clients wanting to connect to the cluster must be [attached to a Private Network](/vpc/how-to/attach-resources-to-pn/) in the same VPC as the cluster.
5546

5647
## How to access the username and password
5748

pages/clusters-for-kafka/how-to/manage-cluster.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Clusters for Apache Kafka® is currently in [Private Beta](https://www.scaleway.
1414

1515
After creating your cluster, you can renew its TLS certificate, change the attached Private Network, and change its password.
1616

17-
Other management actions, such as creating topics and events, and configuring partitions and replication factors, must be carried out via TODO HOW.
17+
Other management actions for internally configuring your cluster, such as creating topics and events, and configuring partitions and replication factors, can be carried out via a client library or Kafka CLI.
1818

1919
<Requirements />
2020

pages/clusters-for-kafka/quickstart.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -74,7 +74,7 @@ Configuration actions that cannot currently be carried out via the Scaleway cons
7474
- Configuring cluster parameters, such as replication factors, retention policies, and partitions
7575
- Integrating clients and consumers
7676

77-
These actions can be done via TODO HOW?
77+
All such actions for internally configuring your cluster can be carried out via a client library or Kafka CLI.
7878

7979
## How to delete a cluster
8080

0 commit comments

Comments
 (0)