Skip to content

Create 2.528.1 changelog and upgrade guide #8458

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 17 commits into from
Oct 13, 2025
+258 −1
Merged

Create 2.528.1 changelog and upgrade guide #8458

Show file tree
Hide file tree
Changes from 16 commits
Commits
Show all changes
17 commits
Select commit Hold shift + click to select a range
d8634c4
Create 2.528.1 changelog and upgrade guide
Sep 30, 2025
dcad3c9
Merge branch 'master' into create-2.528.1-changelog-upgrade-guide
kmartens27 Sep 30, 2025
81da52f
fix spelling typo
kmartens27 Sep 30, 2025
5192392
Merge branch 'master' into create-2.528.1-changelog-upgrade-guide
gounthar Oct 5, 2025
e3d74f1
Add entry for Debian 13 update
kmartens27 Oct 8, 2025
dcb9290
add trxie and timestamper entries
kmartens27 Oct 8, 2025
8e2a5c0
Merge branch 'master' into create-2.528.1-changelog-upgrade-guide
kmartens27 Oct 8, 2025
d3f0d6e
fix spelling
kmartens27 Oct 8, 2025
0dd6cb6
Merge branch 'master' into create-2.528.1-changelog-upgrade-guide
kmartens27 Oct 9, 2025
9c37abd
Merge branch 'master' into create-2.528.1-changelog-upgrade-guide
kmartens27 Oct 13, 2025
8c419d6
Minor phrasing for container images update
MarkEWaite Oct 13, 2025
7b9283a
Alternate phrasing of the class caching improvement
MarkEWaite Oct 13, 2025
039b49c
Remove enhancement entries that are not visible to users
MarkEWaite Oct 13, 2025
831a93c
Clarify the description of the label log message fix
MarkEWaite Oct 13, 2025
ffdd1ac
Minor changes to upgrade guide
MarkEWaite Oct 13, 2025
920c0bc
Remove some trailing spaces
MarkEWaite Oct 13, 2025
5f9a2bb
Better phrasing for EdDSA improvement
MarkEWaite Oct 13, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
238 changes: 237 additions & 1 deletion content/_data/changelogs/lts.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -12768,7 +12768,7 @@
pr_title: Improve the appearance of user avatars in Jenkins
message: |-
Improve the appearance of user avatars in Jenkins.
Custom avatars are also available through the <a href="https://plugins.jenkins.io/avatar/">Avatar plugin</a>.
Custom avatars are also available through the <a href="https://plugins.jenkins.io/avatar/">Avatar plugin</a>.
- type: rfe
category: rfe
pull: 10198
Expand Down Expand Up @@ -13554,6 +13554,242 @@
message: |-
Position the <strong>Save</strong> and <strong>Apply</strong> buttons for views under the header instead of over it.
- version: "2.528.1"
date: 2025-10-15
lts_predecessor: "2.516.3"
lts_baseline: "2.528"
changes: # compared to lts_baseline 2.528 - extracted from the RC commit(s)

- type: bug
category: bug
pull: 11087
issue: 76135
authors:
- jtnord
pr_title: "[JENKINS-76135] work around eclipse compiler bug"
message: |-
Remove Eclipse modifier class to ensure code compiles as expected.
- type: bug
category: bug
pull: 11070
issue: 76114
authors:
- jeromepochat
pr_title: "[JENKINS-76114] Bring back the All/None/Suggested buttons in the plugin configuration wizard"
message: |-
Fix <strong>All/None/Suggested</strong> buttons visibility in plugin setup wizard.
- type: bug
category: bug
pull: 11059
issue: 76002
authors:
- jeromepochat
pr_title: "[JENKINS-76002] Apply number instead of string comparison"
message: |-
Fix number comparison in min/max form validator.
lts_changes: # compared to lts_predecessor 2.516.3 (selected by personal review)

- type: major rfe
category: rfe
authors:
- jonesbusy
references:
- url: https://github.com/jenkinsci/docker/pull/2063
title: Docker pull request 2063
message: |-
Update Debian container images to Debian 13 (Trixie).
- type: major rfe
category: rfe
authors:
- janfaracik
references:
- pull: 10814
- pull: 10806
- pull: 10853
- pull: 10901
- pull: 10913
pr_title: "Refine header, app bar, and side panel alignment"
message: |-
Updates to various UI elements.
Refine the header, app bar, and side panel.
Refine colors, borders, and buttons.
Use secondary text color for dropdowns.
- type: major rfe
category: rfe
pull: 10803
issue: 75851
authors:
- scherler
pr_title: "[JENKINS-75851] implement a dropdown indicator"
message: |-
Breadcrumbs now have a visual indicator and are compatible with accessibility guidelines.
- type: rfe
category: rfe
pull: 10979
authors:
- dukhlov
pr_title: Move common caching class loading functionality to the
separate class
message: |-
Improve performance with additional caching of Java classes.
- type: rfe
category: rfe
pull: 10945
authors:
- mawinter69
pr_title: Make shutdown and safe-restart messages theme aware
message: |-
Apply the current theme color palette to shutdown and safe-restart messages.
- type: rfe
category: rfe
pull: 10752
authors:
- daniel-beck
- MarkEWaite
pr_title: Remove `/extensionList/` URL
message: |-
Remove the <code>/extensionList/</code> HTTP endpoint and related telemetry.
Users of the Timestamper plugin should update to version 1.29 or newer.
- type: rfe
category: rfe
pull: 10926
authors:
- jglick
pr_title: Deprecate `UserIdMapper` and just use an HMAC
message: |-
Use a new name format for subdirectories of <code>$JENKINS_HOME/users/</code>.
Stop creating redundant <code>$JENKINS_HOME/users/users.xml</code>.
- type: rfe
category: rfe
pull: 10855
authors:
- jglick
pr_title: "`AdministrativeMonitorsDecorator` cleanup; `ManageJenkinsAction.getBadge`
optimization"
message: |-
Minor performance optimization for administrative monitors badge display.
- type: rfe
category: rfe
pull: 10807
authors:
- janfaracik
- krisstern
pr_title: Refine User page
message: |-
Refine <strong>User</strong> page UI.
- type: rfe
category: rfe
pull: 10839
authors:
- janfaracik
pr_title: Refine Console URL Provider UI
message: |-
Refine the Console URL Provider UI.
- type: rfe
category: rfe
pull: 10941
authors:
- mawinter69
pr_title: show parameters of a run with readOnlyMode
message: |-
Show parameters of a run in read-only mode.
- type: rfe
category: rfe
pull: 10927
authors:
- jglick
pr_title: Avoid printing stack trace for `ClosedChannelException` in
agent launch log
message: |-
Reduce agent launch log stack trace noise for <code>ClosedChannelException</code>s.
- type: rfe
category: rfe
pull: 10788
authors:
- olamy
pr_title: "Remove net.i2p.crypto:eddsa which is not supported anymore and
use support of EdDSA natively provided now by Apache Mina via Bouncycastle"
message: |-
SSH cli now uses support of EdDSA natively provided by Apache Mina via Bouncycastle.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"uses support of" sounds a bit strange to my ears, then it might just be me.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Good observation. Fixed in 5f9a2bb

- type: rfe
category: rfe
authors:
- dukhlov
- jasssonpet
- StefanSpieker
references:
- pull: 11025
- pull: 10835
- pull: 10943
pr_title: Adds Polish translations
message: |-
Add Polish localization.
Adjust Bulgarian localization spacing.
Add German localization for Global Build Discarder.
- type: bug
category: bug
pull: 11039
authors:
- gbhat618
pr_title: "Initialize `transport` at the beginning of `opened`"
message: |-
Fix a race condition in WebSocket agent connection initialization.
- type: bug
category: bug
pull: 10954
authors:
- jglick
pr_title: Better error response from `doBuildWithParameters`
message: |-
Create friendlier HTTP response for an attempt to <code>buildWithParameters</code> a disabled or nonparameterized job.
- type: bug
category: bug
pull: 10965
issue: 75991
authors:
- stephane-chazelas
pr_title: "[JENKINS-75991] Fix name of reason query parameter in online help
for quietDown"
Comment on lines +13752 to +13753
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
pr_title: "[JENKINS-75991] Fix name of reason query parameter in online help
for quietDown"
pr_title: "[JENKINS-75991] Fix name of reason query parameter in online help for quietDown"

Is there a rule for having long PR titles on multiple lines? If not, suggesting putting it on a single line (nit)

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typically the longer titles get formatted in this way where the last few words/later half of the title are moved to the next line as so. There's not necessarily any rule saying it can't be on one line as far as I'm aware. The weekly automation usually splits the title & message in such a way if it's longer.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The core changelog generator creates the PR title that way and we rely on it to retain the same formatting. I don't plan to change this one.

message: |-
Fix incorrect parameter name in <code>quietDown</code> API online help.
- type: bug
category: bug
pull: 10881
authors:
- lewisbirks
pr_title: Fix word breaking in pre tags and help classes
message: |-
Correct <code>word-wrap</code> and <code>word-break</code> CSS properties to use supported values.
- type: bug
category: bug
pull: 10863
authors:
- jglick
pr_title: Avoid warning about `labelAtomSet` during `Slave.readResolve`
message: |-
Stop printing an incorrect log message when retrieving agent labels.
- type: bug
category: bug
pull: 10390
issue: 75252
authors:
- singghh
- krisstern
- MarkEWaite
pr_title: "JENKINS-75252: Remove pointer-events:none from .jenkins-menu-dropdown-chevron"
message: |-
Enable the chevron button in job tables by removing <code>pointerevents:none</code> from its CSS styling.
- type: bug
category: bug
pull: 10756
authors:
- Vlatombe
pr_title: When a pending item lost its executor, it should be
rescheduled
Comment on lines +13788 to +13789
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
pr_title: When a pending item lost its executor, it should be
rescheduled
pr_title: When a pending item lost its executor, it should be rescheduled

Same as above (nit)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No change, same as above

message: |-
Avoid queue items being lost if the node disconnects at a bad time during allocation.
# DO NOT EDIT THIS FILE DIRECTLY
# ALL CHANGES MUST GO THROUGH PULL REQUESTS
# MALFORMED FILE CONTENTS WILL BREAK THE SITE BUILD
21 changes: 21 additions & 0 deletions content/_data/upgrades/2-528-1.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
==== Configuration as code entry for 'myViewsTabBar' is deprecated.

As of 2.528.1, the configuration as code entry for 'myViewsTabBar' has been deprecated.
In its place, a new user property has been introduced that makes it possible for a user to override what is configured for the global dashboard or a folder.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should the new user property name be mentioned?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

When I was looking to add this entry I think I may have missed the property. It can definitely be updated to share the actual name of the property though.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The property is modified by the user through the Jenkins web pages, without needing to know the name of the property. Sharing the name of the property with the user won't help them in this case,

This will be seen as the Views Tab Bar in Jenkins.
Instead of the 'myViewsTabBar', users can now select one of the implementations of 'ViewsTabBar' to be used for the My Views dashboard.
The default view on the *My Views* configuration is a selectable option instead of checking if the user enters a valid view name.

==== Container images update Debian from Bookworm to Trixie

With the release of 2.528.1, the container images based on Debian are now using Debian 13 ("Trixie") instead of Debian 12 ("Bookworm").
The upgrade to Trixie includes performance improvements and upgrades to Linux kernel 6.12 LTS for enhanced performance and hardware support.

Users of the Debian based Jenkins container images may need to adjust their custom container images to adapt to the Debian upgrade.
Please keep this in mind when using any Debian based Jenkins images and report issues in the link:https://github.com/jenkinsci/docker/issues[Jenkins Docker issue tracker].

==== Timestamper plugin update

If you have the plugin:timestamper[Timestamper] plugin installed, it must be upgraded to the link:https://plugins.jenkins.io/timestamper/releases/[latest version] before upgrading to Jenkins LTS 2.528.1.
If the plugin is not updated prior to the Jenkins upgrade, you may encounter issues with the plugin compatibility and dependencies.
If you mistakenly update to Jenkins 2.528.1 before updating the plugin, you will need to revert to the previous Jenkins version and update the Timestamper plugin before you can upgrade Jenkins again.