From b6b85d2f25b72303e8351a7622a75279e3d8b00a Mon Sep 17 00:00:00 2001 From: Joyce Fee Date: Fri, 10 Jul 2026 16:25:05 -0400 Subject: [PATCH 1/7] DOC-2193: Cloud Topics enabled by default via cloud storage in 26.2 The cloud_topics_enabled cluster config is deprecated in v26.2.1 (redpanda#30508). Cloud topics capabilities now activate automatically when cloud_storage_enabled is true. - Remove the enable step from the Cloud Topics and Kubernetes pages - Point verification at cloud_storage_enabled - Add a 26.2.1 entry to the deprecated features index - Drop the obsolete cloud_topics_enabled property override Co-Authored-By: Claude Fable 5 --- docs-data/property-overrides.json | 7 ----- .../pages/manage-topics/cloud-topics.adoc | 18 +++++-------- .../pages/kubernetes/k-cloud-topics.adoc | 26 ++++++++++--------- modules/upgrade/pages/deprecated/index.adoc | 4 +++ 4 files changed, 25 insertions(+), 30 deletions(-) diff --git a/docs-data/property-overrides.json b/docs-data/property-overrides.json index 9d34ab7769..d397fe3cc7 100644 --- a/docs-data/property-overrides.json +++ b/docs-data/property-overrides.json @@ -496,13 +496,6 @@ "cloud_topics_disable_reconciliation_loop": { "config_scope": "cluster" }, - "cloud_topics_enabled": { - "description": "Enable Cloud Topics for the cluster. Cloud Topics are optimized for high-throughput, cost-sensitive workloads that can tolerate higher latencies compared to standard Kafka topics.", - "related_topics": [ - "self-managed-only: xref:develop:manage-topics/cloud-topics.adoc[Cloud Topics]" - ], - "config_scope": "cluster" - }, "cloud_topics_epoch_service_epoch_increment_interval": { "description": "The interval, in milliseconds, at which the cluster epoch is incremented.\n\nThe cluster epoch is a frozen point in time of the committed offset of the controller log, used to coordinate partition creation and track changes in Tiered Storage. This property controls how frequently the epoch is refreshed. More frequent updates provide finer-grained coordination but may increase overhead.\n\nDecrease this interval if you need more frequent epoch updates for faster coordination in Tiered Storage operations, or increase it to reduce coordination overhead in stable clusters.", "version": "v25.3.3" diff --git a/modules/develop/pages/manage-topics/cloud-topics.adoc b/modules/develop/pages/manage-topics/cloud-topics.adoc index 86932e2d5c..6f25a9b3ca 100644 --- a/modules/develop/pages/manage-topics/cloud-topics.adoc +++ b/modules/develop/pages/manage-topics/cloud-topics.adoc @@ -3,7 +3,7 @@ :page-topic-type: how-to :personas: streaming_developer, platform_admin :learning-objective-1: Describe the latency and cost trade-offs of Cloud Topics compared to standard Redpanda topics -:learning-objective-2: Create a Cloud Topic using rpk after enabling Cloud Topics on your cluster +:learning-objective-2: Create a Cloud Topic using rpk on a cluster that has cloud storage enabled :learning-objective-3: Identify Cloud Topics limitations and configurations that reduce cross-AZ networking costs // tag::single-source[] ifdef::env-cloud[:producers-page: develop:topics/configure-producers-for-cloud-topics.adoc] @@ -56,19 +56,15 @@ endif::[] include::develop:partial$cloud-topics-limitations.adoc[tag=limitations] -== Enable Cloud Topics +== Create Cloud Topics -To enable Cloud Topics for a cluster: - -[,bash] ----- -rpk cluster config set cloud_topics_enabled=true ----- - -NOTE: This configuration update requires a restart to take effect. +Cloud Topics don't require a separate cluster property to enable them. When cloud storage is enabled for your cluster, you can create Cloud Topics directly. +ifndef::env-cloud[] +NOTE: In Redpanda versions earlier than 26.2.1, you must also set the `cloud_topics_enabled` cluster property to `true` and restart the cluster. This property is deprecated in 26.2.1 and later. For details, see xref:upgrade:deprecated/index.adoc[Deprecated features]. +endif::[] -After enabling Cloud Topics, you can proceed to create new Cloud Topics: +To create a Cloud Topic, set the topic property `redpanda.storage.mode` to `cloud`: [,bash] ---- diff --git a/modules/manage/pages/kubernetes/k-cloud-topics.adoc b/modules/manage/pages/kubernetes/k-cloud-topics.adoc index b21ab21425..fe8bba72b4 100644 --- a/modules/manage/pages/kubernetes/k-cloud-topics.adoc +++ b/modules/manage/pages/kubernetes/k-cloud-topics.adoc @@ -3,7 +3,7 @@ :page-topic-type: how-to :personas: platform_admin, streaming_developer :learning-objective-1: Configure object storage for Cloud Topics on Kubernetes -:learning-objective-2: Enable and create Cloud Topics using the Redpanda Operator or Helm +:learning-objective-2: Create Cloud Topics using the Redpanda Operator or Helm :learning-objective-3: Verify topic storage mode configuration :env-kubernetes: true @@ -41,7 +41,7 @@ include::develop:partial$cloud-topics-limitations.adoc[tag=latency-limitation] You must have the following: - **kubectl**: Ensure you have the https://kubernetes.io/docs/tasks/tools/#kubectl[`kubectl`^] command-line tool installed and configured to communicate with your cluster. -- **Redpanda**: A xref:deploy:deployment-option/self-hosted/kubernetes/kubernetes-deploy.adoc[Redpanda Operator and a Redpanda resource deployed] in your Kubernetes cluster running Redpanda v26.1 or later. +- **Redpanda**: A xref:deploy:deployment-option/self-hosted/kubernetes/kubernetes-deploy.adoc[Redpanda Operator and a Redpanda resource deployed] in your Kubernetes cluster running Redpanda v26.2.1 or later. - **Object storage**: A configured object storage backend (Amazon S3, Google Cloud Storage, Azure Blob Storage, or an S3-compatible store such as MinIO). - **Enterprise license**: A valid Redpanda Enterprise license applied to the cluster. + @@ -243,7 +243,11 @@ For details on managed identities and account access keys, see xref:manage:kuber == Enable Cloud Topics -To enable Cloud Topics, set the `cloud_topics_enabled` cluster property to `true` and set the default storage mode for all new topics to `cloud`. +Cloud Topics are enabled automatically when cloud storage is enabled for the cluster (xref:reference:properties/object-storage-properties.adoc#cloud_storage_enabled[`cloud_storage_enabled`] set to `true`), which is part of the object storage configuration in <>. No separate cluster property is required. + +NOTE: In Redpanda versions earlier than 26.2.1, you must also set the `cloud_topics_enabled` cluster property to `true`. This property is deprecated in 26.2.1 and later. For details, see xref:upgrade:deprecated/index.adoc[Deprecated features]. + +To make all new topics Cloud Topics by default, set the default storage mode for the cluster to `cloud`. [tabs] ====== @@ -251,7 +255,7 @@ Helm + Operator:: + -- -. Add the following to your Redpanda custom resource to enable Cloud Topics and set the default storage mode: +. Add the following to your Redpanda custom resource to set the default storage mode: + .`redpanda-cluster.yaml` [,yaml] @@ -278,10 +282,9 @@ spec: cloud_storage_bucket: config: cluster: - cloud_topics_enabled: true default_redpanda_storage_mode: cloud # <1> ---- -<1> Optional. Set to `cloud` to make all new topics Cloud Topics by default. Omit this to create Cloud Topics individually. +<1> Set to `cloud` to make all new topics Cloud Topics by default. Omit this to create Cloud Topics individually. . Apply the configuration: + @@ -297,12 +300,12 @@ kubectl apply -f redpanda-cluster.yaml -n kubectl rollout status statefulset redpanda -n --watch ---- -. Verify that Cloud Topics are enabled: +. Verify that cloud storage, which enables Cloud Topics, is turned on: + [,bash] ---- kubectl exec -n redpanda-0 -c redpanda -- \ - rpk cluster config get cloud_topics_enabled + rpk cluster config get cloud_storage_enabled ---- + Expected output: `true` @@ -333,10 +336,9 @@ storage: cloud_storage_bucket: config: cluster: - cloud_topics_enabled: true default_redpanda_storage_mode: cloud # <1> ---- -<1> Optional. Set to `cloud` to make all new topics Cloud Topics by default. Omit this to create Cloud Topics individually. +<1> Set to `cloud` to make all new topics Cloud Topics by default. Omit this to create Cloud Topics individually. . Deploy or upgrade the Helm chart: + @@ -354,12 +356,12 @@ helm upgrade --install redpanda redpanda/redpanda \ kubectl rollout status statefulset redpanda -n --watch ---- -. Verify that Cloud Topics are enabled: +. Verify that cloud storage, which enables Cloud Topics, is turned on: + [,bash] ---- kubectl exec -n redpanda-0 -c redpanda -- \ - rpk cluster config get cloud_topics_enabled + rpk cluster config get cloud_storage_enabled ---- + Expected output: `true` diff --git a/modules/upgrade/pages/deprecated/index.adoc b/modules/upgrade/pages/deprecated/index.adoc index 676b9126be..39150c4486 100644 --- a/modules/upgrade/pages/deprecated/index.adoc +++ b/modules/upgrade/pages/deprecated/index.adoc @@ -13,6 +13,10 @@ This index helps you to identify deprecated features in Redpanda releases and pl |=== | Deprecated in | Feature | Details +| 26.2.1 +| `cloud_topics_enabled` +| Redpanda now enables Cloud Topics automatically when cloud storage is enabled for the cluster, controlled by xref:reference:properties/object-storage-properties.adoc#cloud_storage_enabled[`cloud_storage_enabled`]. Remove `cloud_topics_enabled` from your configuration; setting it has no effect. + | 25.3.1 | The following configuration properties: From 195fe9a04819e1b95030211bf749aa56b86d7824 Mon Sep 17 00:00:00 2001 From: Joyce Fee Date: Fri, 10 Jul 2026 16:35:17 -0400 Subject: [PATCH 2/7] DOC-2193: Use major.minor version references in prose Docs release per minor version, not point releases. The deprecated features index keeps 26.2.1 to match that table's exact-release format. Co-Authored-By: Claude Fable 5 --- modules/develop/pages/manage-topics/cloud-topics.adoc | 2 +- modules/manage/pages/kubernetes/k-cloud-topics.adoc | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/modules/develop/pages/manage-topics/cloud-topics.adoc b/modules/develop/pages/manage-topics/cloud-topics.adoc index 6f25a9b3ca..745ef8c14b 100644 --- a/modules/develop/pages/manage-topics/cloud-topics.adoc +++ b/modules/develop/pages/manage-topics/cloud-topics.adoc @@ -61,7 +61,7 @@ include::develop:partial$cloud-topics-limitations.adoc[tag=limitations] Cloud Topics don't require a separate cluster property to enable them. When cloud storage is enabled for your cluster, you can create Cloud Topics directly. ifndef::env-cloud[] -NOTE: In Redpanda versions earlier than 26.2.1, you must also set the `cloud_topics_enabled` cluster property to `true` and restart the cluster. This property is deprecated in 26.2.1 and later. For details, see xref:upgrade:deprecated/index.adoc[Deprecated features]. +NOTE: In Redpanda versions earlier than 26.2, you must also set the `cloud_topics_enabled` cluster property to `true` and restart the cluster. This property is deprecated in 26.2 and later. For details, see xref:upgrade:deprecated/index.adoc[Deprecated features]. endif::[] To create a Cloud Topic, set the topic property `redpanda.storage.mode` to `cloud`: diff --git a/modules/manage/pages/kubernetes/k-cloud-topics.adoc b/modules/manage/pages/kubernetes/k-cloud-topics.adoc index fe8bba72b4..d06990e570 100644 --- a/modules/manage/pages/kubernetes/k-cloud-topics.adoc +++ b/modules/manage/pages/kubernetes/k-cloud-topics.adoc @@ -41,7 +41,7 @@ include::develop:partial$cloud-topics-limitations.adoc[tag=latency-limitation] You must have the following: - **kubectl**: Ensure you have the https://kubernetes.io/docs/tasks/tools/#kubectl[`kubectl`^] command-line tool installed and configured to communicate with your cluster. -- **Redpanda**: A xref:deploy:deployment-option/self-hosted/kubernetes/kubernetes-deploy.adoc[Redpanda Operator and a Redpanda resource deployed] in your Kubernetes cluster running Redpanda v26.2.1 or later. +- **Redpanda**: A xref:deploy:deployment-option/self-hosted/kubernetes/kubernetes-deploy.adoc[Redpanda Operator and a Redpanda resource deployed] in your Kubernetes cluster running Redpanda v26.2 or later. - **Object storage**: A configured object storage backend (Amazon S3, Google Cloud Storage, Azure Blob Storage, or an S3-compatible store such as MinIO). - **Enterprise license**: A valid Redpanda Enterprise license applied to the cluster. + @@ -245,7 +245,7 @@ For details on managed identities and account access keys, see xref:manage:kuber Cloud Topics are enabled automatically when cloud storage is enabled for the cluster (xref:reference:properties/object-storage-properties.adoc#cloud_storage_enabled[`cloud_storage_enabled`] set to `true`), which is part of the object storage configuration in <>. No separate cluster property is required. -NOTE: In Redpanda versions earlier than 26.2.1, you must also set the `cloud_topics_enabled` cluster property to `true`. This property is deprecated in 26.2.1 and later. For details, see xref:upgrade:deprecated/index.adoc[Deprecated features]. +NOTE: In Redpanda versions earlier than 26.2, you must also set the `cloud_topics_enabled` cluster property to `true`. This property is deprecated in 26.2 and later. For details, see xref:upgrade:deprecated/index.adoc[Deprecated features]. To make all new topics Cloud Topics by default, set the default storage mode for the cluster to `cloud`. From d6fe14e2ed0e88e4106da6e81926e8c5ccf1b129 Mon Sep 17 00:00:00 2001 From: Joyce Fee Date: Fri, 10 Jul 2026 17:02:36 -0400 Subject: [PATCH 3/7] DOC-2193: Rename Enable Cloud Topics heading on K8s page Cloud Topics no longer have an enable step; the section's task is setting the default storage mode. Update the internal cross-reference to the new anchor. Co-Authored-By: Claude Fable 5 --- modules/manage/pages/kubernetes/k-cloud-topics.adoc | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/modules/manage/pages/kubernetes/k-cloud-topics.adoc b/modules/manage/pages/kubernetes/k-cloud-topics.adoc index d06990e570..f51a5cb12b 100644 --- a/modules/manage/pages/kubernetes/k-cloud-topics.adoc +++ b/modules/manage/pages/kubernetes/k-cloud-topics.adoc @@ -59,7 +59,7 @@ rpk cluster license info == Configure object storage -Cloud Topics use the same object storage configuration as Tiered Storage. If you have already configured object storage for Tiered Storage, you can skip this step and proceed to <>. +Cloud Topics use the same object storage configuration as Tiered Storage. If you have already configured object storage for Tiered Storage, you can skip this step and proceed to <>. For detailed instructions including IAM role configuration, access key management, and encryption options, see xref:manage:kubernetes/tiered-storage/k-tiered-storage.adoc#configure-object-storage[Configure object storage] in the Tiered Storage documentation. @@ -241,7 +241,7 @@ storage: For details on managed identities and account access keys, see xref:manage:kubernetes/tiered-storage/k-tiered-storage.adoc#microsoft-absadls[Microsoft ABS/ADLS] in the Tiered Storage documentation. -== Enable Cloud Topics +== Set the default storage mode Cloud Topics are enabled automatically when cloud storage is enabled for the cluster (xref:reference:properties/object-storage-properties.adoc#cloud_storage_enabled[`cloud_storage_enabled`] set to `true`), which is part of the object storage configuration in <>. No separate cluster property is required. From 4e54ea3e2d6b177f8527457f8e33c628aa754d1a Mon Sep 17 00:00:00 2001 From: Joyce Fee <102751339+Feediver1@users.noreply.github.com> Date: Fri, 10 Jul 2026 16:04:07 -0500 Subject: [PATCH 4/7] Apply suggestion from @Feediver1 --- modules/upgrade/pages/deprecated/index.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/upgrade/pages/deprecated/index.adoc b/modules/upgrade/pages/deprecated/index.adoc index 39150c4486..9c71a0b649 100644 --- a/modules/upgrade/pages/deprecated/index.adoc +++ b/modules/upgrade/pages/deprecated/index.adoc @@ -15,7 +15,7 @@ This index helps you to identify deprecated features in Redpanda releases and pl | 26.2.1 | `cloud_topics_enabled` -| Redpanda now enables Cloud Topics automatically when cloud storage is enabled for the cluster, controlled by xref:reference:properties/object-storage-properties.adoc#cloud_storage_enabled[`cloud_storage_enabled`]. Remove `cloud_topics_enabled` from your configuration; setting it has no effect. +| Redpanda now enables Cloud Topics by default when cloud storage is enabled for the cluster, controlled by xref:reference:properties/object-storage-properties.adoc#cloud_storage_enabled[`cloud_storage_enabled`]. Remove `cloud_topics_enabled` from your configuration; setting it has no effect. | 25.3.1 | The following configuration properties: From 00cea78b8bea1adfb8b1ea3d9a4dfbb8f14452a5 Mon Sep 17 00:00:00 2001 From: Joyce Fee <102751339+Feediver1@users.noreply.github.com> Date: Fri, 10 Jul 2026 16:04:16 -0500 Subject: [PATCH 5/7] Apply suggestion from @Feediver1 --- modules/develop/pages/manage-topics/cloud-topics.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/develop/pages/manage-topics/cloud-topics.adoc b/modules/develop/pages/manage-topics/cloud-topics.adoc index 745ef8c14b..4db8b37f32 100644 --- a/modules/develop/pages/manage-topics/cloud-topics.adoc +++ b/modules/develop/pages/manage-topics/cloud-topics.adoc @@ -61,7 +61,7 @@ include::develop:partial$cloud-topics-limitations.adoc[tag=limitations] Cloud Topics don't require a separate cluster property to enable them. When cloud storage is enabled for your cluster, you can create Cloud Topics directly. ifndef::env-cloud[] -NOTE: In Redpanda versions earlier than 26.2, you must also set the `cloud_topics_enabled` cluster property to `true` and restart the cluster. This property is deprecated in 26.2 and later. For details, see xref:upgrade:deprecated/index.adoc[Deprecated features]. +NOTE: In Redpanda versions earlier than v26.2, you must also set the `cloud_topics_enabled` cluster property to `true` and restart the cluster. This property is deprecated in v26.2 and later. For details, see xref:upgrade:deprecated/index.adoc[Deprecated features]. endif::[] To create a Cloud Topic, set the topic property `redpanda.storage.mode` to `cloud`: From f40e12b5e8557998633841fc80e8a51ed5eb366b Mon Sep 17 00:00:00 2001 From: Joyce Fee <102751339+Feediver1@users.noreply.github.com> Date: Fri, 10 Jul 2026 16:04:26 -0500 Subject: [PATCH 6/7] Apply suggestion from @Feediver1 --- modules/manage/pages/kubernetes/k-cloud-topics.adoc | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/modules/manage/pages/kubernetes/k-cloud-topics.adoc b/modules/manage/pages/kubernetes/k-cloud-topics.adoc index f51a5cb12b..3cdc87c876 100644 --- a/modules/manage/pages/kubernetes/k-cloud-topics.adoc +++ b/modules/manage/pages/kubernetes/k-cloud-topics.adoc @@ -245,7 +245,7 @@ For details on managed identities and account access keys, see xref:manage:kuber Cloud Topics are enabled automatically when cloud storage is enabled for the cluster (xref:reference:properties/object-storage-properties.adoc#cloud_storage_enabled[`cloud_storage_enabled`] set to `true`), which is part of the object storage configuration in <>. No separate cluster property is required. -NOTE: In Redpanda versions earlier than 26.2, you must also set the `cloud_topics_enabled` cluster property to `true`. This property is deprecated in 26.2 and later. For details, see xref:upgrade:deprecated/index.adoc[Deprecated features]. +NOTE: In Redpanda versions earlier than v26.2, you must also set the `cloud_topics_enabled` cluster property to `true`. This property is deprecated in v26.2 and later. For details, see xref:upgrade:deprecated/index.adoc[Deprecated features]. To make all new topics Cloud Topics by default, set the default storage mode for the cluster to `cloud`. From 9a29723d6e0710e150dff7c97e1e5475ace00268 Mon Sep 17 00:00:00 2001 From: Joyce Fee Date: Fri, 17 Jul 2026 16:16:41 -0400 Subject: [PATCH 7/7] Remove deprecated cloud_topics_enabled from whole-cluster restore examples The page arrived on beta via the cloud-topics restructure after this PR was drafted. Cloud storage in storage.tiered already enables Cloud Topics in 26.2; fold that explanation into the storage.tiered bullet. Co-Authored-By: Claude Fable 5 --- .../cloud-topics/k-cloud-topics-whole-cluster-restore.adoc | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/modules/manage/pages/kubernetes/cloud-topics/k-cloud-topics-whole-cluster-restore.adoc b/modules/manage/pages/kubernetes/cloud-topics/k-cloud-topics-whole-cluster-restore.adoc index 77667bd4dc..cb515d5d48 100644 --- a/modules/manage/pages/kubernetes/cloud-topics/k-cloud-topics-whole-cluster-restore.adoc +++ b/modules/manage/pages/kubernetes/cloud-topics/k-cloud-topics-whole-cluster-restore.adoc @@ -76,7 +76,6 @@ spec: config: cluster: - cloud_topics_enabled: true cloud_storage_attempt_cluster_restore_on_bootstrap: true ---- @@ -99,7 +98,6 @@ storage: config: cluster: - cloud_topics_enabled: true cloud_storage_attempt_cluster_restore_on_bootstrap: true ---- + @@ -113,15 +111,13 @@ helm upgrade --install redpanda redpanda/redpanda --namespace --crea ```bash helm upgrade --install redpanda redpanda/redpanda --namespace --create-namespace \ --set storage.tiered. \ - --set config.cluster.cloud_topics_enabled=true \ --set config.cluster.cloud_storage_attempt_cluster_restore_on_bootstrap=true ``` ==== -- ====== -* `storage.tiered`: Configure the target cluster with the same object storage settings as the failed source cluster, including the same bucket or container. -* `config.cluster.cloud_topics_enabled`: Enable Cloud Topics on the target cluster so that restored topics can be served in cloud storage mode. +* `storage.tiered`: Configure the target cluster with the same object storage settings as the failed source cluster, including the same bucket or container. Enabling cloud storage also enables Cloud Topics on the target cluster, so restored topics can be served in cloud storage mode without additional configuration. * `config.cluster.cloud_storage_attempt_cluster_restore_on_bootstrap`: Run the restore automatically when the new cluster bootstraps. No manual restore command is required. The restore runs while the cluster starts. Cluster size does not need to match the source cluster, but the target cluster must be empty of user-managed data.