From 6f28e8166ad3689480dfb909124d67722b608845 Mon Sep 17 00:00:00 2001 From: vbotbuildovich <62446873+vbotbuildovich@users.noreply.github.com> Date: Fri, 22 May 2026 12:46:59 +0000 Subject: [PATCH] auto-docs: Update property docs for v26.1.9 --- antora.yml | 4 +- docs-data/property-overrides.json | 3 + ...a-property-changes-v26.1.7-to-v26.1.8.json | 43 --------------- ...a-property-changes-v26.1.8-to-v26.1.9.json | 43 +++++++++++++++ ....json => redpanda-properties-v26.1.9.json} | 26 +++++++++ .../properties/cluster-properties.adoc | 55 +++++++++++++++++++ 6 files changed, 129 insertions(+), 45 deletions(-) delete mode 100644 docs-data/redpanda-property-changes-v26.1.7-to-v26.1.8.json create mode 100644 docs-data/redpanda-property-changes-v26.1.8-to-v26.1.9.json rename modules/reference/attachments/{redpanda-properties-v26.1.8.json => redpanda-properties-v26.1.9.json} (99%) diff --git a/antora.yml b/antora.yml index f8607e1ab1..d5bd56ef68 100644 --- a/antora.yml +++ b/antora.yml @@ -17,8 +17,8 @@ asciidoc: # Fallback versions # We try to fetch the latest versions from GitHub at build time # -- - full-version: 26.1.8 - latest-redpanda-tag: 'v26.1.8' + full-version: 26.1.9 + latest-redpanda-tag: 'v26.1.9' latest-console-tag: 'v3.3.1' latest-release-commit: 'ebee215fdb2b8004735c6f800e532564cdcc05e1' latest-operator-version: 'v2.3.8-24.3.6' diff --git a/docs-data/property-overrides.json b/docs-data/property-overrides.json index c45533cf89..dd0828afe2 100644 --- a/docs-data/property-overrides.json +++ b/docs-data/property-overrides.json @@ -879,6 +879,9 @@ "description": "Enable creating shadow links from this cluster to a remote source cluster for data replication.", "config_scope": "cluster" }, + "features_auto_finalization": { + "version": "v26.1.9" + }, "fetch_max_read_concurrency": { "version": "v25.3.3" }, diff --git a/docs-data/redpanda-property-changes-v26.1.7-to-v26.1.8.json b/docs-data/redpanda-property-changes-v26.1.7-to-v26.1.8.json deleted file mode 100644 index 4f7d42a771..0000000000 --- a/docs-data/redpanda-property-changes-v26.1.7-to-v26.1.8.json +++ /dev/null @@ -1,43 +0,0 @@ -{ - "comparison": { - "oldVersion": "v26.1.7", - "newVersion": "v26.1.8", - "timestamp": "2026-05-14T16:16:34.287Z" - }, - "summary": { - "newProperties": 1, - "changedDefaults": 0, - "changedDescriptions": 0, - "changedTypes": 0, - "deprecatedProperties": 0, - "removedDeprecatedProperties": 0, - "removedProperties": 0, - "emptyDescriptions": 2 - }, - "details": { - "newProperties": [ - { - "name": "iceberg_rest_catalog_credentials_host", - "type": "string", - "default": null, - "description": "The hostname to connect to for retrieving role based credentials for the Iceberg REST catalog. Derived from iceberg_rest_catalog_credentials_source if not set. Only required when using IAM role based access on AWS; does not apply to OAuth-based authentication schemes. Independent of cloud_storage_credentials_host." - } - ], - "changedDefaults": [], - "changedDescriptions": [], - "changedTypes": [], - "deprecatedProperties": [], - "removedDeprecatedProperties": [], - "removedProperties": [], - "emptyDescriptions": [ - { - "name": "redpanda.remote.allowgaps", - "type": "boolean" - }, - { - "name": "redpanda.virtual.cluster.id", - "type": "string" - } - ] - } -} \ No newline at end of file diff --git a/docs-data/redpanda-property-changes-v26.1.8-to-v26.1.9.json b/docs-data/redpanda-property-changes-v26.1.8-to-v26.1.9.json new file mode 100644 index 0000000000..3305b105a7 --- /dev/null +++ b/docs-data/redpanda-property-changes-v26.1.8-to-v26.1.9.json @@ -0,0 +1,43 @@ +{ + "comparison": { + "oldVersion": "v26.1.8", + "newVersion": "v26.1.9", + "timestamp": "2026-05-22T12:46:58.695Z" + }, + "summary": { + "newProperties": 1, + "changedDefaults": 0, + "changedDescriptions": 0, + "changedTypes": 0, + "deprecatedProperties": 0, + "removedDeprecatedProperties": 0, + "removedProperties": 0, + "emptyDescriptions": 2 + }, + "details": { + "newProperties": [ + { + "name": "features_auto_finalization", + "type": "boolean", + "default": true, + "description": "Whether the cluster active logical version is advanced automatically once all nodes have been upgraded (true), or only in response to an explicit request via the Admin API (false). When false, the cluster remains able to downgrade to the previous version until finalization is requested. Setting this to false is an Enterprise feature and requires a valid license. Note: if upgrade was performed with this set to false and the cluster is ready to finalize, flipping this to true does not reliably trigger finalization. Leave this set to false and use the Admin API to finalize; once the upgrade is complete this can be set back to true to restore automatic finalization for future upgrades." + } + ], + "changedDefaults": [], + "changedDescriptions": [], + "changedTypes": [], + "deprecatedProperties": [], + "removedDeprecatedProperties": [], + "removedProperties": [], + "emptyDescriptions": [ + { + "name": "redpanda.remote.allowgaps", + "type": "boolean" + }, + { + "name": "redpanda.virtual.cluster.id", + "type": "string" + } + ] + } +} \ No newline at end of file diff --git a/modules/reference/attachments/redpanda-properties-v26.1.8.json b/modules/reference/attachments/redpanda-properties-v26.1.9.json similarity index 99% rename from modules/reference/attachments/redpanda-properties-v26.1.8.json rename to modules/reference/attachments/redpanda-properties-v26.1.9.json index 5b72a71753..02a8431b14 100644 --- a/modules/reference/attachments/redpanda-properties-v26.1.8.json +++ b/modules/reference/attachments/redpanda-properties-v26.1.9.json @@ -6177,6 +6177,31 @@ "type": "boolean", "visibility": "tunable" }, + "features_auto_finalization": { + "c_type": "bool", + "cloud_byoc_only": false, + "cloud_editable": false, + "cloud_readonly": false, + "cloud_supported": false, + "config_scope": "cluster", + "default": true, + "defined_in": "src/v/config/configuration.cc", + "description": "Whether the cluster active logical version is advanced automatically once all nodes have been upgraded (true), or only in response to an explicit request via the Admin API (false). When false, the cluster remains able to downgrade to the previous version until finalization is requested. Setting this to false is an Enterprise feature and requires a valid license. Note: if upgrade was performed with this set to false and the cluster is ready to finalize, flipping this to true does not reliably trigger finalization. Leave this set to false and use the Admin API to finalize; once the upgrade is complete this can be set back to true to restore automatic finalization for future upgrades.", + "enterprise_constructor": "restricted_only", + "enterprise_restricted_value": [ + "false" + ], + "enterprise_value": [ + "false" + ], + "is_deprecated": false, + "is_enterprise": true, + "name": "features_auto_finalization", + "needs_restart": false, + "nullable": false, + "type": "boolean", + "visibility": "user" + }, "fetch_max_bytes": { "c_type": "size_t", "cloud_byoc_only": false, @@ -7190,6 +7215,7 @@ "needs_restart": true, "nullable": true, "type": "string", + "version": "v26.1.8", "visibility": "user" }, "iceberg_rest_catalog_credentials_source": { diff --git a/modules/reference/partials/properties/cluster-properties.adoc b/modules/reference/partials/properties/cluster-properties.adoc index 998af7ce72..79a2e58ddc 100644 --- a/modules/reference/partials/properties/cluster-properties.adoc +++ b/modules/reference/partials/properties/cluster-properties.adoc @@ -6266,6 +6266,57 @@ endif::[] |=== +=== features_auto_finalization + +Whether the cluster active logical version is advanced automatically once all nodes have been upgraded (true), or only in response to an explicit request via the Admin API (false). When false, the cluster remains able to downgrade to the previous version until finalization is requested. Setting this to false is an Enterprise feature and requires a valid license. Note: if upgrade was performed with this set to false and the cluster is ready to finalize, flipping this to true does not reliably trigger finalization. Leave this set to false and use the Admin API to finalize; once the upgrade is complete this can be set back to true to restore automatic finalization for future upgrades. + +ifndef::env-cloud[] +.Enterprise license required +[NOTE] +==== +The following values require an Enterprise license: `false` + +For license details, see xref:get-started:licensing/index.adoc[Redpanda Licensing]. +==== +endif::[] + +[cols="1s,2a"] +|=== +| Property | Value + +| Type +| `boolean` + + + +| Default +| +ifdef::env-cloud[] +Available in the Redpanda Cloud Console +endif::[] +ifndef::env-cloud[] +`true` +endif::[] + +| Nullable +| No + +| Requires restart +| No + +ifndef::env-cloud[] +| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore] +| Yes +endif::[] + +ifndef::env-cloud[] +| Visibility +| User +endif::[] + +|=== + + === fetch_max_bytes Maximum number of bytes returned in a fetch request. @@ -8378,6 +8429,10 @@ endif::[] === iceberg_rest_catalog_credentials_host +ifndef::env-cloud[] +*Introduced in v26.1.8* +endif::[] + The hostname to connect to for retrieving role based credentials for the Iceberg REST catalog. Derived from iceberg_rest_catalog_credentials_source if not set. Only required when using IAM role based access on AWS; does not apply to OAuth-based authentication schemes. Independent of cloud_storage_credentials_host. [cols="1s,2a"]