Create 2.528.1 changelog and upgrade guide #8458

kmartens27 · 2025-09-30T13:51:28Z

This PR is to create the changelog & upgrade guide for 2.528.1. The upgrade guide only contains 1 entry at this time based on the Jenkins github issues list. It has been compared to the already released changelogs to prevent any duplicate entries.

Changelog

Upgrade Guide

MarkEWaite · 2025-10-04T23:53:06Z

@kmartens27 the upgrade guide needs to mention that users of the timestamper plugin must upgrade to the correct version before upgrading to Jenkins 2.528.1. Also, we need to note in the upgrade guide and in the changelog that the container images based on Debian are now using Debian 13 ("Trixie") instead of Debian 12 ("bookworm").

lemeurherve · 2025-10-05T14:34:40Z

WDYT about also mentionning the availability of JDK25 images for all agents (pending jenkinsci/docker-ssh-agent#549), and for the controller (pending jenkinsci/docker#2072 - this one might not make the cut for the 15th October release, tests are failing and require additional work)

MarkEWaite · 2025-10-05T14:39:01Z

WDYT about also mentioning the availability of JDK25 images for all agents (pending jenkinsci/docker-ssh-agent#549), and for the controller (pending jenkinsci/docker#2072 - this one might not make the cut for the 15th October release, tests are failing and require additional work)

I'm hesitant to mention Java 25 support in this LTS because Jenkins 2.528.1 requires the command line flag to allow Java 25 to run. I don't expect LTS users to experiment with new Java versions as readily as weekly users and weekly users still must use the command line flag. Let's wait a quarter for the Jan 2026 LTS release and hope that we're ready to announce Java 25 support at that time.

lemeurherve · 2025-10-05T14:41:37Z

Jenkins 2.528.1 requires the command line flag to allow Java 25 to run

TIL. Make sense to wait then.

Do you have more info or references about that flag by any chance?

MarkEWaite · 2025-10-05T15:04:30Z

Jenkins 2.528.1 requires the command line flag to allow Java 25 to run

TIL. Make sense to wait then.

Do you have more info or references about that flag by any chance?

Sure. When I try to run a current Jenkins version (up to 2.530) with Java 25, I see the following output:

$ /opt/jdk-25/bin/java -jar jenkins.war
Running with Java 25 from /opt/jdk-25, which is not yet fully supported.
Run the command again with the --enable-future-java flag to enable preview support for future Java versions.
Supported Java versions are: [17, 21]
See https://jenkins.io/redirect/java-support/ for more information.

lemeurherve · 2025-10-05T15:16:38Z

Got it, tried a build with this option but it fails. Needs jenkinsci/jenkins#11148

Thanks for the info!

kmartens27 · 2025-10-08T15:59:54Z

Hi @MarkEWaite, thanks for the feedback and providing the screenshots! I've updated the upgrade guide to have two additional entries (for trixie and timestamper), and made sure to add the Debian update to the changelog. Please let me know if those are sufficient or if any of the uprade guide text needs to be adjusted before this can be merged!

The additions are valuable but the changelog is focused on the user and their experience rather than internal changes.

Debian container image phrasing changes. Other minor changes to phrasing

MarkEWaite

Thanks! @kmartens27 I made several changes and pushed them directly to your branch. If any of them need changes or should be removed, let me know and I'll make the changes.

@lemeurherve this is ready for another review by you as well.

timja · 2025-10-13T15:49:42Z

@MarkEWaite I think your push failed

lemeurherve

Some optional comments & questions.

lemeurherve · 2025-10-13T18:53:30Z

content/_data/changelogs/lts.yml

+    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.


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

Good observation. Fixed in 5f9a2bb

lemeurherve · 2025-10-13T18:55:46Z

content/_data/changelogs/lts.yml

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


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)

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.

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.

lemeurherve · 2025-10-13T18:56:12Z

content/_data/changelogs/lts.yml

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


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)

No change, same as above

lemeurherve · 2025-10-13T18:58:11Z

content/_data/upgrades/2-528-1.adoc

+==== 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.


Should the new user property name be mentioned?

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.

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,

Create 2.528.1 changelog and upgrade guide

d8634c4

kmartens27 requested a review from a team as a code owner September 30, 2025 13:51

probot-autolabeler bot added the changelog Jenkins changelogs label Sep 30, 2025

Merge branch 'master' into create-2.528.1-changelog-upgrade-guide

dcad3c9

kmartens27 mentioned this pull request Sep 30, 2025

LTS 2.528.1 release checklist jenkins-infra/release#762

Open

45 tasks

infra-ci-jenkins-io bot deployed to preview September 30, 2025 13:59 View deployment

fix spelling typo

81da52f

infra-ci-jenkins-io bot deployed to preview September 30, 2025 15:37 View deployment

MarkEWaite mentioned this pull request Oct 4, 2025

Test of LTS 2.528.1 RC backport incremental jenkinsci/bom#5770

Closed

6 tasks

lemeurherve mentioned this pull request Oct 5, 2025

feat(linux): add support on Linux for JDK 25 preview in Docker build configurations jenkinsci/docker#2072

Closed

6 tasks

Merge branch 'master' into create-2.528.1-changelog-upgrade-guide

5192392

infra-ci-jenkins-io bot deployed to preview October 5, 2025 15:37 View deployment

Add entry for Debian 13 update

e3d74f1

infra-ci-jenkins-io bot deployed to preview October 8, 2025 15:55 View deployment

kmartens27 added 2 commits October 8, 2025 11:58

add trxie and timestamper entries

dcb9290

Merge branch 'master' into create-2.528.1-changelog-upgrade-guide

8e2a5c0

infra-ci-jenkins-io bot deployed to preview October 8, 2025 16:06 View deployment

fix spelling

d3f0d6e

infra-ci-jenkins-io bot deployed to preview October 8, 2025 16:16 View deployment

Merge branch 'master' into create-2.528.1-changelog-upgrade-guide

0dd6cb6

infra-ci-jenkins-io bot deployed to preview October 9, 2025 15:43 View deployment

Merge branch 'master' into create-2.528.1-changelog-upgrade-guide

9c37abd

infra-ci-jenkins-io bot deployed to preview October 13, 2025 12:43 View deployment

MarkEWaite added 5 commits October 13, 2025 07:16

Minor phrasing for container images update

8c419d6

Alternate phrasing of the class caching improvement

7b9283a

Remove enhancement entries that are not visible to users

039b49c

The additions are valuable but the changelog is focused on the user and their experience rather than internal changes.

Clarify the description of the label log message fix

831a93c

Minor changes to upgrade guide

ffdd1ac

Debian container image phrasing changes. Other minor changes to phrasing

MarkEWaite approved these changes Oct 13, 2025

View reviewed changes

Remove some trailing spaces

920c0bc

infra-ci-jenkins-io bot deployed to preview October 13, 2025 16:20 View deployment

lemeurherve approved these changes Oct 13, 2025

View reviewed changes

Better phrasing for EdDSA improvement

5f9a2bb

MarkEWaite merged commit 17577b8 into jenkins-infra:master Oct 13, 2025
2 of 4 checks passed

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

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

Uh oh!

Create 2.528.1 changelog and upgrade guide #8458

Create 2.528.1 changelog and upgrade guide #8458

Uh oh!

Conversation

kmartens27 commented Sep 30, 2025 • edited by MarkEWaite Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Changelog

Upgrade Guide

Uh oh!

MarkEWaite commented Oct 4, 2025

Uh oh!

lemeurherve commented Oct 5, 2025

Uh oh!

MarkEWaite commented Oct 5, 2025

Uh oh!

lemeurherve commented Oct 5, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

MarkEWaite commented Oct 5, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

lemeurherve commented Oct 5, 2025

Uh oh!

kmartens27 commented Oct 8, 2025

Uh oh!

MarkEWaite left a comment

Choose a reason for hiding this comment

Uh oh!

timja commented Oct 13, 2025

Uh oh!

lemeurherve left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

kmartens27 commented Sep 30, 2025 •

edited by MarkEWaite

Loading

lemeurherve commented Oct 5, 2025 •

edited

Loading

MarkEWaite commented Oct 5, 2025 •

edited

Loading