Skip to content

Commit 7186ebe

Browse files
committed
Merge branch 'main' into DOC-1602
2 parents c4dbb04 + dc4cfcb commit 7186ebe

File tree

94 files changed

+4413
-269
lines changed

Some content is hidden

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

94 files changed

+4413
-269
lines changed

antora.yml

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
name: ROOT
22
title: Self-Managed
3-
version: 25.2
3+
version: 25.3
44
start_page: home:index.adoc
55
nav:
66
- modules/ROOT/nav.adoc
77
asciidoc:
88
attributes:
99
# Date of release in the format YYYY-MM-DD
10-
page-release-date: 2025-07-31
10+
page-release-date: 2025-11-19
1111
# Only used in the main branch (latest version)
1212
page-header-data:
1313
order: 2
@@ -17,18 +17,18 @@ asciidoc:
1717
# Fallback versions
1818
# We try to fetch the latest versions from GitHub at build time
1919
# --
20-
full-version: 25.2.1
21-
latest-redpanda-tag: 'v25.2.1'
22-
latest-console-tag: 'v2.8.5'
23-
latest-release-commit: '68c64fd'
20+
full-version: 25.3.1
21+
latest-redpanda-tag: 'v25.3.1'
22+
latest-console-tag: '3.30.1'
23+
latest-release-commit: '6aa5af28b020b66e5caa966094882b7260497a53'
2424
latest-operator-version: 'v2.3.8-24.3.6'
25-
operator-beta-tag: 'v25.1.1-beta1'
26-
helm-beta-tag: 'v25.1.1-beta1'
27-
latest-redpanda-helm-chart-version: 5.10.1
28-
redpanda-beta-version: '25.1.1-rc3'
29-
redpanda-beta-tag: '25.1.1-rc3'
30-
console-beta-version: '3.0.0-beta.1'
31-
console-beta-tag: 'v3.0.0-beta.1'
25+
operator-beta-tag: ''
26+
helm-beta-tag: ''
27+
latest-redpanda-helm-chart-version: ''
28+
redpanda-beta-version: '25.3.1-rc4'
29+
redpanda-beta-tag: 'v25.3.1-rc4'
30+
console-beta-version: ''
31+
console-beta-tag: ''
3232
# --
3333
supported-kubernetes-version: 1.27.0-0
3434
supported-helm-version: 3.10.0

local-antora-playbook.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
site:
22
title: Redpanda Docs
3-
start_page: 25.2@ROOT:get-started:intro-to-events.adoc
3+
start_page: ROOT:get-started:intro-to-events.adoc
44
url: http://localhost:5002
55
robots: disallow
66
keys:

modules/ROOT/nav.adoc

Lines changed: 32 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -86,7 +86,6 @@
8686
***** xref:deploy:redpanda/manual/production/production-deployment-automation.adoc[]
8787
***** xref:deploy:redpanda/manual/production/production-deployment.adoc[]
8888
***** xref:deploy:redpanda/manual/production/production-readiness.adoc[]
89-
**** xref:deploy:redpanda/manual/high-availability.adoc[High Availability]
9089
**** xref:deploy:redpanda/manual/sizing-use-cases.adoc[Sizing Use Cases]
9190
**** xref:deploy:redpanda/manual/sizing.adoc[Sizing Guidelines]
9291
**** xref:deploy:redpanda/manual/linux-system-tuning.adoc[System Tuning]
@@ -163,7 +162,7 @@
163162
*** xref:manage:cluster-maintenance/disk-utilization.adoc[]
164163
*** xref:manage:cluster-maintenance/manage-throughput.adoc[Manage Throughput]
165164
*** xref:manage:cluster-maintenance/compaction-settings.adoc[Compaction Settings]
166-
*** xref:manage:cluster-maintenance/configure-availability.adoc[]
165+
*** xref:manage:cluster-maintenance/configure-client-connections.adoc[]
167166
*** xref:manage:cluster-maintenance/partition-recovery.adoc[Forced Partition Recovery]
168167
*** xref:manage:cluster-maintenance/nodewise-partition-recovery.adoc[Node-wise Partition Recovery]
169168
** xref:manage:security/index.adoc[Security]
@@ -179,16 +178,14 @@
179178
*** xref:manage:tiered-storage.adoc[]
180179
*** xref:manage:fast-commission-decommission.adoc[]
181180
*** xref:manage:mountable-topics.adoc[]
182-
*** xref:manage:remote-read-replicas.adoc[Remote Read Replicas]
183-
*** xref:manage:topic-recovery.adoc[Topic Recovery]
184-
*** xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
185181
** xref:manage:iceberg/index.adoc[Iceberg]
186182
*** xref:manage:iceberg/about-iceberg-topics.adoc[About Iceberg Topics]
187183
*** xref:manage:iceberg/specify-iceberg-schema.adoc[Specify Iceberg Schema]
188184
*** xref:manage:iceberg/use-iceberg-catalogs.adoc[Use Iceberg Catalogs]
189185
*** xref:manage:iceberg/rest-catalog/index.adoc[Integrate with REST Catalogs]
190186
**** xref:manage:iceberg/iceberg-topics-aws-glue.adoc[AWS Glue]
191187
**** xref:manage:iceberg/iceberg-topics-databricks-unity.adoc[Databricks Unity Catalog]
188+
**** xref:manage:iceberg/iceberg-topics-gcp-biglake.adoc[GCP BigLake]
192189
**** xref:manage:iceberg/redpanda-topics-iceberg-snowflake-catalog.adoc[Snowflake and Open Catalog]
193190
*** xref:manage:iceberg/query-iceberg-topics.adoc[Query Iceberg Topics]
194191
** xref:manage:schema-reg/index.adoc[Schema Registry]
@@ -199,6 +196,21 @@
199196
*** xref:manage:schema-reg/schema-reg-authorization.adoc[Schema Registry Authorization]
200197
*** xref:manage:schema-reg/schema-id-validation.adoc[]
201198
*** xref:console:ui/schema-reg.adoc[Manage in Redpanda Console]
199+
** xref:manage:high-availability.adoc[High Availability]
200+
** xref:manage:disaster-recovery/index.adoc[Disaster Recovery]
201+
*** xref:manage:disaster-recovery/shadowing/index.adoc[Shadowing]
202+
**** xref:manage:disaster-recovery/shadowing/overview.adoc[Overview]
203+
**** xref:manage:disaster-recovery/shadowing/setup.adoc[Configure Shadowing]
204+
**** xref:manage:disaster-recovery/shadowing/monitor.adoc[Monitor Shadowing]
205+
**** xref:manage:disaster-recovery/shadowing/failover.adoc[Configure Failover]
206+
**** xref:manage:disaster-recovery/shadowing/failover-runbook.adoc[Failover Runbook]
207+
*** xref:manage:disaster-recovery/whole-cluster-restore.adoc[Whole Cluster Restore]
208+
*** xref:manage:disaster-recovery/topic-recovery.adoc[Topic Recovery]
209+
** xref:manage:remote-read-replicas.adoc[Remote Read Replicas]
210+
** xref:manage:recovery-mode.adoc[Recovery Mode]
211+
** xref:manage:rack-awareness.adoc[Rack Awareness]
212+
** xref:manage:raft-group-reconfiguration.adoc[Raft Group Reconfiguration]
213+
** xref:manage:io-optimization.adoc[]
202214
** xref:manage:console/index.adoc[Redpanda Console]
203215
*** xref:console:config/configure-console.adoc[Configure Redpanda Console]
204216
*** xref:console:config/enterprise-license.adoc[Add an Enterprise License]
@@ -212,18 +224,16 @@
212224
*** xref:console:config/topic-documentation.adoc[Topic Documentation]
213225
*** xref:console:config/analytics.adoc[Telemetry]
214226
*** xref:console:config/kafka-connect.adoc[Kafka Connect]
215-
** xref:manage:recovery-mode.adoc[Recovery Mode]
216-
** xref:manage:rack-awareness.adoc[Rack Awareness]
227+
** xref:manage:use-admin-api.adoc[Use the Admin API]
217228
** xref:manage:monitoring.adoc[]
218-
** xref:manage:io-optimization.adoc[]
219-
** xref:manage:raft-group-reconfiguration.adoc[Raft Group Reconfiguration]
220229
* xref:upgrade:index.adoc[Upgrade]
221230
** xref:upgrade:rolling-upgrade.adoc[Upgrade Redpanda in Linux]
222231
** xref:upgrade:k-rolling-upgrade.adoc[Upgrade Redpanda in Kubernetes]
223232
** xref:upgrade:k-upgrade-operator.adoc[Upgrade the Redpanda Operator]
224233
** xref:upgrade:k-compatibility.adoc[]
225234
** xref:manage:kubernetes/k-upgrade-kubernetes.adoc[Migrate Node Pools]
226235
** xref:upgrade:deprecated/index.adoc[Deprecated Features]
236+
** xref:upgrade:iceberg-schema-changes-and-migration-guide.adoc[Iceberg Schema Changes in v25.3]
227237
* xref:migrate:index.adoc[Migrate]
228238
** xref:migrate:console-v3.adoc[Migrate to Redpanda Console v3.0.x]
229239
** xref:migrate:data-migration.adoc[]
@@ -261,6 +271,7 @@
261271
*** link:/api/doc/http-proxy/[HTTP Proxy API]
262272
*** link:/api/doc/schema-registry/[Schema Registry API]
263273
*** link:/api/doc/admin/[Admin API]
274+
*** link:/api/doc/admin/v2[Admin API (ConnectRPC)]
264275
** xref:reference:data-transforms/sdks.adoc[]
265276
*** xref:reference:data-transforms/golang-sdk.adoc[Golang]
266277
*** xref:reference:data-transforms/rust-sdk.adoc[Rust]
@@ -293,6 +304,8 @@
293304
***** xref:reference:rpk/rpk-cluster/rpk-cluster-config-lint.adoc[]
294305
***** xref:reference:rpk/rpk-cluster/rpk-cluster-config-set.adoc[]
295306
***** xref:reference:rpk/rpk-cluster/rpk-cluster-config-status.adoc[]
307+
**** xref:reference:rpk/rpk-cluster/rpk-cluster-connections.adoc[]
308+
***** xref:reference:rpk/rpk-cluster/rpk-cluster-connections-list.adoc[]
296309
**** xref:reference:rpk/rpk-cluster/rpk-cluster-health.adoc[]
297310
**** xref:reference:rpk/rpk-cluster/rpk-cluster-license.adoc[]
298311
***** xref:reference:rpk/rpk-cluster/rpk-cluster-license-info.adoc[]
@@ -431,6 +444,7 @@
431444
****** xref:reference:rpk/rpk-redpanda/rpk-redpanda-admin-config-log-level-set.adoc[]
432445
****** xref:reference:rpk/rpk-redpanda/rpk-redpanda-admin-config-log-level.adoc[]
433446
****** xref:reference:rpk/rpk-redpanda/rpk-redpanda-admin-config-print.adoc[]
447+
***** xref:reference:rpk/rpk-redpanda/rpk-redpanda-config-print.adoc[]
434448
***** xref:reference:rpk/rpk-redpanda/rpk-redpanda-admin-partitions.adoc[]
435449
****** xref:reference:rpk/rpk-redpanda/rpk-redpanda-admin-partitions.adoc[]
436450
****** xref:reference:rpk/rpk-redpanda/rpk-redpanda-admin-partitions-list.adoc[]
@@ -463,6 +477,15 @@
463477
***** xref:reference:rpk/rpk-security/rpk-security-user-delete.adoc[]
464478
***** xref:reference:rpk/rpk-security/rpk-security-user-update.adoc[]
465479
***** xref:reference:rpk/rpk-security/rpk-security-user-list.adoc[]
480+
*** xref:reference:rpk/rpk-shadow/rpk-shadow.adoc[]
481+
**** xref:reference:rpk/rpk-shadow/rpk-shadow-config-generate.adoc[]
482+
**** xref:reference:rpk/rpk-shadow/rpk-shadow-create.adoc[]
483+
**** xref:reference:rpk/rpk-shadow/rpk-shadow-delete.adoc[]
484+
**** xref:reference:rpk/rpk-shadow/rpk-shadow-describe.adoc[]
485+
**** xref:reference:rpk/rpk-shadow/rpk-shadow-failover.adoc[]
486+
**** xref:reference:rpk/rpk-shadow/rpk-shadow-list.adoc[]
487+
**** xref:reference:rpk/rpk-shadow/rpk-shadow-status.adoc[]
488+
**** xref:reference:rpk/rpk-shadow/rpk-shadow-update.adoc[]
466489
*** xref:reference:rpk/rpk-topic/rpk-topic.adoc[]
467490
**** xref:reference:rpk/rpk-topic/rpk-topic-add-partitions.adoc[]
468491
**** xref:reference:rpk/rpk-topic/rpk-topic-alter-config.adoc[]
1.6 KB
Loading
28 KB
Loading

modules/console/images/topic.png

2.19 KB
Loading

modules/console/pages/index.adoc

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,8 @@ Explore a comprehensive overview of your cluster, including:
1616
* *Broker monitoring*: View and manage the health, status, and configurations of your brokers.
1717
* *Topic management*: Create, configure, and monitor topics, including detailed information on partitions, replicas, and message counts.
1818
* *Consumer group insights*: Track the activity and performance of your consumer groups, manage offsets, and identify potential bottlenecks.
19+
* xref:manage:disaster-recovery/shadowing/overview.adoc[*Shadow link management*]: Create shadow links for asynchronous, offset-preserving replication between distinct Redpanda clusters. The shadow cluster operates in read-only mode while continuously receiving updates from the source cluster. During a disaster, you can failover individual topics or an entire shadow link to make resources fully writable for production traffic.
20+
1921

2022
image::broker-overview.png[]
2123

modules/deploy/pages/console/linux/deploy.adoc

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ This page shows you how to deploy Redpanda Console on Linux using Docker or the
77

88
== Prerequisites
99

10-
* You must have a running Redpanda or Kafka cluster available to connect to. Redpanda Console requires a cluster to function. For instructions on deploying a Redpanda cluster, see xref:deploy:redpanda/manual/index.adoc[].
10+
* You must have a running Redpanda or Kafka cluster available to connect to. Redpanda Console requires a cluster to function. For instructions on deploying a Redpanda cluster, see xref:deploy:redpanda/manual/production/index.adoc[].
1111
* Review the xref:deploy:console/linux/requirements.adoc[system requirements for Redpanda Console on Linux].
1212

1313
== Deploy with Docker

modules/deploy/pages/redpanda/manual/production/production-readiness.adoc

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -318,6 +318,15 @@ In the logs, verify `enabled: 1`.
318318

319319
See also: xref:manage:security/listener-configuration.adoc#multiple-listeners[Multiple listeners]
320320

321+
[NOTE]
322+
====
323+
You can also use the link:api/doc/admin/operation/operation-get_security_report[`/v1/security/report`] Admin API endpoint to generate a security report for your cluster and verify TLS, authentication, and authorization settings:
324+
325+
```bash
326+
curl 'http://localhost:9644/v1/security/report'
327+
```
328+
====
329+
321330
[[redpanda-tuners]]
322331
=== Run Redpanda tuners
323332

@@ -643,6 +652,11 @@ Review your deployment automation. Specifically, if you need to reprovision a cl
643652

644653
Check that your xref:manage:audit-logging.adoc#audit-log-flow[audit logs] are forwarded to an enterprise security information and event management (SIEM) system.
645654

655+
=== Monitor security settings
656+
657+
Regularly review your cluster's security settings using the link:api/doc/admin/operation/operation-get_security_report[`/v1/security/report`] Admin API endpoint. Investigate and address any issues identified in the alerts section.
658+
659+
include::manage:partial$security-report.adoc[]
646660

647661
== Suggested reading
648662

modules/deploy/partials/high-availability.adoc

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ ifdef::env-kubernetes[]
55
:tiered-storage: manage:kubernetes/storage/tiered-storage/k-tiered-storage.adoc
66
endif::[]
77
ifndef::env-kubernetes[]
8-
:remote-read-replicas: manage:remote-read-replicas.adoc
8+
:remote-read-replicas: deploy:redpanda/manual/remote-read-replicas.adoc
99
:rack-awareness: manage:rack-awareness.adoc
1010
:tiered-storage: manage:tiered-storage.adoc
1111
endif::[]
@@ -48,7 +48,7 @@ Consider the following Redpanda deployment strategies for the most common types
4848
| Offline backups
4949
|===
5050

51-
ifndef::env-kubernetes[See also: xref:./production/production-deployment.adoc[Deploy for Production]]
51+
ifndef::env-kubernetes[See also: xref:deploy:redpanda/manual/production/production-deployment.adoc[Deploy for Production]]
5252

5353
== HA deployment options
5454

@@ -253,7 +253,7 @@ rpk redpanda config set redpanda.rack <rackid>
253253

254254
The modified Ansible playbooks take a per-instance rack variable from the Terraform output and use that to set the relevant cluster and broker configuration. Redpanda deployment automation can provision public cloud infrastructure with discrete failure domains (`-var=ha=true`) and use the resulting inventory to provision rack-aware clusters using Ansible.
255255

256-
See also: xref:./production/production-deployment-automation.adoc[Automated Deployment]
256+
See also: xref:deploy:redpanda/manual/production/production-deployment-automation.adoc[Automated Deployment]
257257

258258
=== Single-AZ example
259259

0 commit comments

Comments
 (0)