Skip to content

Commit 4d770ed

Browse files
vbotbuildovichgithub-actions[bot]
vbotbuildovich
authored and
github-actions[bot]
committed
auto-docs: Update property docs for v26.1.8
1 parent 846d8f5 commit 4d770ed

6 files changed

Lines changed: 180 additions & 40 deletions

File tree

‎antora.yml‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,8 @@ asciidoc:
1717
# Fallback versions
1818
# We try to fetch the latest versions from GitHub at build time
1919
# --
20-
full-version: 26.1.6
21-
latest-redpanda-tag: 'v26.1.6'
20+
full-version: 26.1.8
21+
latest-redpanda-tag: 'v26.1.8'
2222
latest-console-tag: 'v3.3.1'
2323
latest-release-commit: '35a825c9c1880ebeedf4c18bb8c6cceaa63566c1'
2424
latest-operator-version: 'v2.3.8-24.3.6'

‎docs-data/property-overrides.json‎

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1020,6 +1020,9 @@
10201020
"description": "Secret used with the client ID to query the OAuth token endpoint for Iceberg REST catalog authentication. Required if catalog type is set to `rest` and `iceberg_rest_catalog_authentication_mode` is set to `oauth2`.",
10211021
"config_scope": "cluster"
10221022
},
1023+
"iceberg_rest_catalog_credentials_host": {
1024+
"version": "v26.1.8"
1025+
},
10231026
"iceberg_rest_catalog_credentials_source": {
10241027
"related_topics": [
10251028
"xref:reference:properties/object-storage-properties.adoc#cloud_storage_credentials_source[`cloud_storage_credentials_source`]"
@@ -1300,7 +1303,10 @@
13001303
"leader_balancer_mode": {
13011304
"_comment": "greedy mode excluded from docs - internal use only (added in v26.1.2)",
13021305
"description": "Mode of the leader balancer optimization strategy.\n\nAccepted values:\n\n* `calibrated` (default): An adaptive strategy that samples potential moves and prioritizes high-impact transfers. Minimizes unnecessary leader movement while achieving balance over time. Best for most production workloads.\n* `random`: Accepts the first random move that improves balance. Less efficient than `calibrated` because it doesn't prioritize high-impact moves. Available as a fallback if `calibrated` causes unexpected behavior.\n\nLegacy values `greedy_balanced_shards` and `random_hill_climbing` are treated as `calibrated`.",
1303-
"accepted_values": ["calibrated", "random"],
1306+
"accepted_values": [
1307+
"calibrated",
1308+
"random"
1309+
],
13041310
"config_scope": "cluster"
13051311
},
13061312
"leader_balancer_mute_timeout": {
@@ -1540,6 +1546,9 @@
15401546
"oidc_group_claim_path": {
15411547
"version": "v26.1.1"
15421548
},
1549+
"oidc_http_proxy_url": {
1550+
"version": "v26.1.8"
1551+
},
15431552
"oidc_principal_mapping": {
15441553
"description": "Rule for mapping JWT payload claim to a Redpanda user principal.",
15451554
"related_topics": [
@@ -2269,4 +2278,4 @@
22692278
"description": "The default write caching mode to apply to user topics. Write caching acknowledges a message as soon as it is received and acknowledged on a majority of brokers, without waiting for it to be written to disk. With `acks=all`, this provides lower latency while still ensuring that a majority of brokers acknowledge the write. \n\nFsyncs follow <<raft_replica_max_pending_flush_bytes,`raft_replica_max_pending_flush_bytes`>> and <<raft_replica_max_flush_delay_ms,`raft_replica_max_flush_delay_ms`>>, whichever is reached first.\n\nThe `write_caching_default` cluster property can be overridden with the xref:reference:properties/topic-properties.adoc#writecaching[`write.caching`] topic property."
22702279
}
22712280
}
2272-
}
2281+
}

‎docs-data/redpanda-property-changes-v26.1.5-to-v26.1.6.json‎

Lines changed: 0 additions & 36 deletions
This file was deleted.

‎docs-data/redpanda-property-changes-v26.1.6-to-v26.1.8.json‎

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
{
2+
"comparison": {
3+
"oldVersion": "v26.1.6",
4+
"newVersion": "v26.1.8",
5+
"timestamp": "2026-05-14T12:22:53.155Z"
6+
},
7+
"summary": {
8+
"newProperties": 2,
9+
"changedDefaults": 0,
10+
"changedDescriptions": 0,
11+
"changedTypes": 0,
12+
"deprecatedProperties": 0,
13+
"removedDeprecatedProperties": 0,
14+
"removedProperties": 0,
15+
"emptyDescriptions": 2
16+
},
17+
"details": {
18+
"newProperties": [
19+
{
20+
"name": "iceberg_rest_catalog_credentials_host",
21+
"type": "string",
22+
"default": null,
23+
"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."
24+
},
25+
{
26+
"name": "oidc_http_proxy_url",
27+
"type": "string",
28+
"default": null,
29+
"description": "URL of the HTTP forward proxy used for OIDC discovery and JWKS fetches. Accepts http://host:port or https://host:port. When set, oidc_discovery_url must use https:// — plaintext OIDC origins cannot be routed through a forward proxy."
30+
}
31+
],
32+
"changedDefaults": [],
33+
"changedDescriptions": [],
34+
"changedTypes": [],
35+
"deprecatedProperties": [],
36+
"removedDeprecatedProperties": [],
37+
"removedProperties": [],
38+
"emptyDescriptions": [
39+
{
40+
"name": "redpanda.remote.allowgaps",
41+
"type": "boolean"
42+
},
43+
{
44+
"name": "redpanda.virtual.cluster.id",
45+
"type": "string"
46+
}
47+
]
48+
}
49+
}

modules/reference/attachments/redpanda-properties-v26.1.6.json renamed to modules/reference/attachments/redpanda-properties-v26.1.8.json

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7174,6 +7174,24 @@
71747174
"type": "string",
71757175
"visibility": "user"
71767176
},
7177+
"iceberg_rest_catalog_credentials_host": {
7178+
"c_type": "ss::sstring",
7179+
"cloud_byoc_only": false,
7180+
"cloud_editable": false,
7181+
"cloud_readonly": false,
7182+
"cloud_supported": false,
7183+
"config_scope": "cluster",
7184+
"default": null,
7185+
"defined_in": "src/v/config/configuration.cc",
7186+
"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.",
7187+
"is_deprecated": false,
7188+
"is_enterprise": false,
7189+
"name": "iceberg_rest_catalog_credentials_host",
7190+
"needs_restart": true,
7191+
"nullable": true,
7192+
"type": "string",
7193+
"visibility": "user"
7194+
},
71777195
"iceberg_rest_catalog_credentials_source": {
71787196
"cloud_byoc_only": true,
71797197
"cloud_editable": true,
@@ -10103,6 +10121,24 @@
1010310121
"version": "v26.1.1",
1010410122
"visibility": "user"
1010510123
},
10124+
"oidc_http_proxy_url": {
10125+
"c_type": "ss::sstring",
10126+
"cloud_byoc_only": false,
10127+
"cloud_editable": false,
10128+
"cloud_readonly": false,
10129+
"cloud_supported": false,
10130+
"config_scope": "cluster",
10131+
"default": null,
10132+
"defined_in": "src/v/config/configuration.cc",
10133+
"description": "URL of the HTTP forward proxy used for OIDC discovery and JWKS fetches. Accepts http://host:port or https://host:port. When set, oidc_discovery_url must use https:// \u2014 plaintext OIDC origins cannot be routed through a forward proxy.",
10134+
"is_deprecated": false,
10135+
"is_enterprise": false,
10136+
"name": "oidc_http_proxy_url",
10137+
"needs_restart": false,
10138+
"nullable": true,
10139+
"type": "string",
10140+
"visibility": "user"
10141+
},
1010610142
"oidc_keys_refresh_interval": {
1010710143
"c_type": "std::chrono::seconds",
1010810144
"cloud_byoc_only": false,

‎modules/reference/partials/properties/cluster-properties.adoc‎

Lines changed: 82 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8376,6 +8376,47 @@ endif::[]
83768376

83778377
// end::redpanda-cloud[]
83788378

8379+
=== iceberg_rest_catalog_credentials_host
8380+
8381+
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.
8382+
8383+
[cols="1s,2a"]
8384+
|===
8385+
| Property | Value
8386+
8387+
| Type
8388+
| `string`
8389+
8390+
8391+
8392+
| Default
8393+
|
8394+
ifdef::env-cloud[]
8395+
Available in the Redpanda Cloud Console
8396+
endif::[]
8397+
ifndef::env-cloud[]
8398+
`null`
8399+
endif::[]
8400+
8401+
| Nullable
8402+
| Yes
8403+
8404+
| Requires restart
8405+
| Yes
8406+
8407+
ifndef::env-cloud[]
8408+
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
8409+
| Yes
8410+
endif::[]
8411+
8412+
ifndef::env-cloud[]
8413+
| Visibility
8414+
| User
8415+
endif::[]
8416+
8417+
|===
8418+
8419+
83798420
// tag::redpanda-cloud[]
83808421
=== iceberg_rest_catalog_crl
83818422

@@ -14083,6 +14124,47 @@ endif::[]
1408314124
|===
1408414125

1408514126

14127+
=== oidc_http_proxy_url
14128+
14129+
URL of the HTTP forward proxy used for OIDC discovery and JWKS fetches. Accepts http://host:port or https://host:port. When set, oidc_discovery_url must use https:// — plaintext OIDC origins cannot be routed through a forward proxy.
14130+
14131+
[cols="1s,2a"]
14132+
|===
14133+
| Property | Value
14134+
14135+
| Type
14136+
| `string`
14137+
14138+
14139+
14140+
| Default
14141+
|
14142+
ifdef::env-cloud[]
14143+
Available in the Redpanda Cloud Console
14144+
endif::[]
14145+
ifndef::env-cloud[]
14146+
`null`
14147+
endif::[]
14148+
14149+
| Nullable
14150+
| Yes
14151+
14152+
| Requires restart
14153+
| No
14154+
14155+
ifndef::env-cloud[]
14156+
| Restored on xref:manage:whole-cluster-restore.adoc[Whole Cluster Restore]
14157+
| Yes
14158+
endif::[]
14159+
14160+
ifndef::env-cloud[]
14161+
| Visibility
14162+
| User
14163+
endif::[]
14164+
14165+
|===
14166+
14167+
1408614168
=== oidc_keys_refresh_interval
1408714169

1408814170
The frequency of refreshing the JSON Web Keys (JWKS) used to validate access tokens.

0 commit comments

Comments
 (0)