Changelog and upgrade guide 2.289.1

content/_data/changelogs/lts.yml

@@ -5298,6 +5298,334 @@
     message: |-
       Upgrade from xstream 1.4.15 to 1.4.16.
 
+- version: "2.289.1"
+  date: 2021-06-02
+  lts_predecessor: "2.277.4"
+  lts_baseline: "2.289"
+  changes: # compared to lts_baseline 2.289 - extracted from the RC commit(s)
+
+  - type: major bug
+    category: regression
+    pull: 5489
+    issue: 65605
+    authors:
+    - jtnord
+    message: |-
+      Fix <code>NoSuchMethodError</code> when using plugins that rely on bridge methods for compatibility (regression in 2.278).
+
+  - type: bug
+    category: regression
+    issue: 65585
+    authors:
+    - res0nance
+    message: |-
+      Fix form submission for some specific form validation cases (regression in 2.289).
+
+  - type: bug
+    category: bug
+    pull: 5448
+    issue: 65190
+    authors:
+    - benebsiny
+    message: |-
+      Wrap the build name in the build results list if it is too long.
+
+  - type: bug
+    category: bug
+    pull: 5455
+    issue: 64294
+    authors:
+    - jglick
+    message: |-
+      Improve performance for standard input of the Jenkins CLI, for example with the `install-plugin` command.
+
+  - type: bug
+    category: bug
+    pull: 5435
+    issue: 52356
+    authors:
+    - basil
+    message: |-
+      Fix an issue archiving files greater than 4 GiB in size when creating ZIP64 archives.
+
+  lts_changes: # compared to lts_predecessor 2.277.4 (selected by personal review)
+
+  - type: major rfe
+    category: major rfe
+    pull: 5049
+    issue: 64107
+    authors:
+    - kuisathaverat
+    - timja
+    references:
+      - issue: 55582
+      - issue: 64107
+      - pull: 5049
+      - pull: 5206
+      - url: https://github.com/jenkinsci/sshd-module
+        title: SSHD module repository
+    message: |-
+      SSHD module is no longer bundled in Jenkins core.
+      Provide SSHD as a plugin.
+
+  - type: major rfe
+    category: major rfe
+    pull: 5065
+    authors:
+    - timja
+    - fqueiruga
+    - josephbrueggen
+    message: |-
+      Add modern icons: build status and weather.
+
+  - type: rfe
+    category: rfe
+    pull: 5337
+    authors:
+    - jeffret-b
+    - res0nance
+    message: |-
+      Add administrative monitors recommending no executors are configured on the controller.
+
+  - type: rfe
+    category: rfe
+    pull: 5078
+    authors:
+    - daniel-beck
+    - fqueiruga
+    message: |-
+      Add indicator for security-related entries in the global administrative monitors configuration.
+
+  - type: rfe
+    category: rfe
+    pull: 5424
+    authors:
+    - daniel-beck
+    message: |-
+      Improve UI of slow trigger administrative monitor.
+
+  - type: rfe
+    category: rfe
+    pull: 5192
+    issue: 63855
+    authors:
+    - benebsiny
+    - oleg-nenashev
+    message: |-
+      Support 'min' and 'max' values in field definitions of forms.
+
+  - type: rfe
+    category: rfe
+    pull: 5392
+    authors:
+    - uhafner
+    message: |-
+      Simplify icon for unstable builds (use an exclamation mark).
+
+  - type: rfe
+    category: rfe
+    pull: 5291
+    authors:
+    - fqueiruga
+    message: |-
+      Improve button focus states.
+
+  - type: rfe
+    category: rfe
+    pull: 5311
+    authors:
+    - basil
+    message: |-
+      Do not force plugin upgrades of recently detached plugins.
+
+  - type: rfe
+    category: rfe
+    pull: 5338
+    authors:
+    - basil
+    references:
+      - pull: 5338
+      - url: https://plugins.jenkins.io/ant
+        title: Ant plugin
+      - url: https://plugins.jenkins.io/javadoc
+        title: Javadoc plugin
+      - url: https://plugins.jenkins.io/rad-builder
+        title: RAD Builder plugin
+    message: |-
+      Stop bundling the Ant and Javadoc plugins.
+      Jenkins will no longer automatically install the Ant and Javadoc plugins on startup if a plugin depending on Jenkins (then Hudson) 1.430 or earlier is discovered.
+      If you use such a plugin that also relies on the functionality provided by the Ant or Javadoc plugin (e.g., the RAD Builder and manage plugins outside the Jenkins plugin manager, you will now need to ensure that a recent release of the Ant or Javadoc plugin is installed.
+      Jenkins will attempt to load such plugins but may fail at any time during startup or afterwards with <code>ClassNotFoundException</code> or similar.
+
+  - type: rfe
+    category: rfe
+    pull: 5412
+    issue: 65308
+    authors:
+    - res0nance
+    references:
+      - pull: 5402
+      - pull: 5412
+      - issue: 65308
+    message: |-
+      Improve performance when creating or deleting nodes by reducing queue-lock contention.
+
+  - type: rfe
+    category: rfe
+    pull: 5365
+    issue: 65172
+    authors:
+    - daniel-beck
+    message: |-
+      Improve support for update site-defined setup wizard suggestions.
+
+  - type: rfe
+    category: rfe
+    pull: 4623
+    authors:
+    - daniel-beck
+    message: |-
+      Switch to sending POST requests by default for form validation URLs.
+
+  - type: rfe
+    category: rfe
+    pull: 5368
+    authors:
+    - daniel-beck
+    message: |-
+      Add a Jenkins User-Agent header to outgoing HTTP requests by default.
+      Use <code>jenkins.UserAgentURLConnectionDecorator.disabled</code> to disable it if needed.
+
+  - type: bug
+    category: bug
+    pull: 5359
+    authors:
+    - res0nance
+    message: |-
+      Sort available plugins by name when popularity is equal.
+
+  - type: bug
+    category: bug
+    pull: 5377
+    issue: 56934
+    authors:
+    - jtnord
+    message: |-
+      Honor the current folder when creating new views with the "New View" link.
+
+  - type: bug
+    category: bug
+    pull: 5333
+    issue: 65017
+    authors:
+    - daniel-beck
+    message: |-
+      Do not render full error responses in case of internal errors when validating fields in configuration forms.
+
+  - type: bug
+    category: bug
+    pull: 5341
+    authors:
+    - felfert
+    message: |-
+      Accept negative numbers in number input controls (regression in 2.274).
+
+  - type: bug
+    category: bug
+    pull: 5138
+    issue: 64510
+    authors:
+    - jeffret-b
+    message: |-
+      Improve reconnection behavior for inbound TCP agents.
+
+  - type: rfe
+    category: rfe
+    pull: 5266
+    authors:
+    - gulyaev13
+    message: |-
+      Remove the hardcoded JKS key store so that other key stores can be used, like BCFKS from the FIPS version of Bouncy Castle.
+
+  - type: rfe
+    category: rfe
+    pull: 5292
+    authors:
+    - dependabot
+    references:
+      - pull: 5292
+      - url: "https://github.com/jenkinsci/remoting/releases/tag/remoting-4.7"
+        title: Remoting 4.7 changelog
+    message: |-
+      Upgrade from Remoting 4.6 to Remoting 4.7 with bugfixes and dependency updates.
+
+  - type: rfe
+    category: rfe
+    pull: 5347
+    authors:
+    - jeffret-b
+    references:
+      - pull: 5347
+      - url: https://github.com/jenkinsci/bouncycastle-api-plugin/releases/tag/bouncycastle-api-2.20
+        title: bouncycastle-api 2.20 changelog
+      - url: https://github.com/jenkinsci/bouncycastle-api-plugin/releases/tag/bouncycastle-api-2.18
+        title: bouncycastle-api 2.18 changelog
+      - url: https://github.com/jenkinsci/bouncycastle-api-plugin/blob/master/docs/CHANGELOG.md#217
+        title: bouncycastle-api 2.17 changelog
+      - url: https://github.com/jenkinsci/bouncycastle-api-plugin/blob/master/docs/CHANGELOG.md#2163
+        title: bouncycastle-api 2.16.3 changelog
+      - url: https://github.com/jenkinsci/bouncycastle-api-plugin/blob/master/docs/CHANGELOG.md#2162
+        title: bouncycastle-api 2.16.2 changelog
+      - url: https://github.com/jenkinsci/bouncycastle-api-plugin/blob/master/docs/CHANGELOG.md#2161
+        title: bouncycastle-api 2.16.1 changelog
+      - url: https://www.bouncycastle.org/releasenotes.html
+        title: Bouncy Castle library 1.64 release notes
+    message: |-
+      Upgrade bouncycastle-api plugin from 2.16.0 to 2.20.
+      Upgrade Bouncy Castle library to 1.64.
+
+  - type: rfe
+    category: rfe
+    pull: 5413
+    authors:
+    - dependabot[bot]
+    references:
+      - pull: 5413
+      - url: https://github.com/spring-projects/spring-security/releases/tag/5.4.6
+        title: Spring project spring-security 5.4.6 release notes
+    message: |-
+      Bump spring-security-bom from 5.4.5 to 5.4.6.
+
+  - type: rfe
+    category: internal
+    pull: 5324
+    authors:
+    - daniel-beck
+    - jglick
+    references:
+      - pull: 5324
+      - url: https://github.com/stapler/stapler/releases/tag/stapler-parent-1.263
+        title: Stapler 1.263 release notes
+      - url: https://commons.apache.org/proper/commons-beanutils/changes-report.html#a1.9.4
+        title: Apache commons beanutils 1.9.4 release notes
+    message: |-
+      Internal: Update Stapler from 1.262.1 to 1.263 to use latest Apache commons-beanutils.
+      Update Apache commons-beanutils from 1.9.3 to 1.9.4.
+
+  - type: major rfe
+    category: developer
+    pull: 5065
+    authors:
+    - timja
+    - fqueiruga
+    - josephbrueggen
+    references:
+      - pull: 5065
+      - url: https://github.com/jenkinsci/github-branch-source-plugin/pull/393
+        title: Example external SVG sprite implementation in GitHub Branch Source plugin
+    message: |-
+      Developer: Add support for plugins to use external SVG sprites in their icons.
+
 # DO NOT EDIT THIS FILE DIRECTLY
 # ALL CHANGES MUST GO THROUGH PULL REQUESTS
 # MALFORMED FILE CONTENTS WILL BREAK THE SITE BUILD

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

@@ -0,0 +1,17 @@
+==== New icons
+
+The new icons introduced with Jenkins 2.289.1 replace the previous icons.
+The plugin:greenballs[Green Balls plugin] is not compatible with the new icons.
+The plugin:greenballs[Green Balls plugin] can be disabled or removed.
+
+==== Stop bundling Ant and Javadoc plugins with Jenkins
+
+Certain key Jenkins capabilities were initially created inside the Jenkins core.
+As Jenkins has developed further, capabilities moved from inside Jenkins core to dedicated Jenkins plugins, like the plugin:ant[Ant plugin] and the plugin:javadoc[Javadoc plugin].
+When those plugins were created, the plugins were "bundled" inside the jenkins.war file to retain compatibility for plugins that depended on their functionality to be inside Jenkins core.
+The plugin:ant[Ant plugin] and the plugin:javadoc[Javadoc plugin] are no longer bundled with Jenkins.
+
+In very rare cases, this could result in problems when attempting to install plugins compatible with Jenkins (then Hudson) before 1.430.
+If you use a plugin that relies on the functionality provided by the Ant plugin or the Javadoc plugin and manage plugins outside the Jenkins plugin manager, you will now need to ensure yourself that a recent release of those plugins are installed.
+Jenkins will attempt to load such plugins but may fail at any time during startup or afterwards with `ClassNotFoundException` or similar.
+In these cases, the best path forward is usually to modify the plugin that has the problem so that it requires a newer version of Jenkins core.