Skip to content

Commit 03f9fe2

Browse files
committed
DOC-1602
1 parent 55eff36 commit 03f9fe2

File tree

1 file changed

+65
-0
lines changed

1 file changed

+65
-0
lines changed
Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
= Cloud Topics
2+
:description: Cloud Topics are Kafka topics that enable users to trade off latency for lower costs.
3+
:page-beta: true
4+
:page-categories: Clients, Development
5+
// tag::single-source[]
6+
7+
ifndef::env-cloud[]
8+
[NOTE]
9+
====
10+
include::shared:partial$enterprise-license.adoc[]
11+
====
12+
endif::[]
13+
14+
While standard Kafka glossterm:topics[] are ideal for high-throughput, cost-sensitive workloads, Cloud Topics are optimized for high-throughput, cost-sensitive workloads. Instead of replicating every byte across expensive network links, Cloud Topics leverage durable, inexpensive Cloud object storage (S3, GCS, MinIO) as the primary mechanism for backing up data. The difference in response time is typically 500ms, which is only impactful for latency-sensitive applications. So when using Cloud Topics, you get the same durability that you have with standard topics, but you also eliminate the significant cross-AZ costs typically incurred when you have high-throughput workloads (for example, for audit logs).
15+
16+
== Prerequisites
17+
18+
- rpk v25.3.1: See xref:get-started:rpk-install.adoc[].
19+
ifndef::env-cloud[]
20+
- xref:manage:tiered-storage.adoc#set-up-tiered-storage[Set up] and xref:manage:tiered-storage.adoc#enable-tiered-storage[enable Tiered Storage] on your Redpanda cluster.
21+
- xref:manage:tiered-storage.adoc#configure-object-storage[Configure object storage]
22+
- include::shared:partial$enterprise-license.adoc[]
23+
24+
To check if you already have a license key applied to your cluster:
25+
26+
[,bash]
27+
----
28+
rpk cluster license info
29+
----
30+
endif::[]
31+
32+
== Limitations
33+
34+
Not all Redpanda features are available when using Cloud Topics (beta). The following features are not supported in this beta release:
35+
36+
- Kafka compaction
37+
- Iceberg topics
38+
- Topic recovery
39+
- Remote Read Replicas
40+
41+
IMPORTANT: You should expect to throw away any cluster running the Cloud Topics (beta) after it becomes generally available (GA). Redpanda will be unable to continue using data that was generated by the beta version of this feature. Also, any topic specified to be Cloud Topic cannot subsequently be converted back to a standard, or non-Cloud Topic.
42+
43+
== Create Cloud Topics
44+
45+
To create a Cloud Topic:
46+
47+
[,bash]
48+
----
49+
rpk topic create -c redpanda.cloud_topic.enable=true <new-cloud-topic-name>
50+
----
51+
+
52+
[,bash,role=no-copy]
53+
----
54+
TOPIC STATUS
55+
audit.analytics.may2025 OK
56+
----
57+
58+
To enable a Cloud Topic in a cluster:
59+
60+
[,bash]
61+
----
62+
rpk topic create -c redpanda.cloud_topic.enabled=true <cloud-topic-name>
63+
----
64+
65+
// end::single-source[]

0 commit comments

Comments
 (0)