Skip to content
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.

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

YAML based LTS changelog #661

Closed
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
105 changes: 105 additions & 0 deletions content/_data/changelogs/lts.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,105 @@
- version: "2.32.1"
date: 2016-12-24
lts_predecessor: "2.19.4"
lts_baseline: "2.32" # TODO figure out how to get rid of this
lts_changes:
- type: major rfe
message: >
Upgrade Remoting to version 3.1 with <a href="https://github.com/jenkinsci/remoting/blob/master/docs/protocols.md#jnlp4-connect">JNLP4-connect protocol</a>.
<a href="https://github.com/jenkinsci/remoting/blob/master/docs/remoting-3-compatibility.md">Compatibility notes are available here</a>.
Notably, it is no longer possible to use JDK 6 for the Maven project type, as communication with the Maven process uses Remoting, and it now requires Java 7.
references:
- issue: 37564
- issue: 36871
- issue: 37565
- type: major rfe
message: Show notification with popup on most pages when administrative monitors are active
issue: 38391
- type: rfe
message: Allow disabling/enabling administrative monitors on Configure Jenkins form
issue: 38301
- type: rfe
message: Ask for confirmation before canceling/aborting runs
issue: 30565
- type: rfe
message: Prompt user whether to add the job to the current view.
issue: 19142
- type: rfe
message: >
Allow <code>CommandInterpreter</code> build steps to set a build result as <code>Unstable</code> via the return code.
Shell and Batch build steps now support this feature.
issue: 23786
- type: rfe
message: >
Internal: Upgrade Stapler library from <code>1.243</code> to <code>1.246</code> with fixes required for the Blue Ocean project.
Changes are listed <a href="https://github.com/stapler/stapler/compare/stapler-parent-1.243...stapler-parent-1.246">here</a>.
pull: 2593
changes:
- type: major bug
message: >
Prevent early deallocation of process references by Garbage Collector when starting a remote process.
It was sometimes causing build failures with messages like <code>FATAL: Invalid object ID 184 iuota=187</code> and <code>java.lang.Exception: Object was recently deallocated</code>.
issue: 23271
- type: bug
message: Redirect to login page in the case of authorisation error when checking connectivity to the Update Center
issue: 39741
- type: bug
message: >
WinP 1.24: Native class now tries loading DLLs from the temporary location.
issue: 20913
- version: "2.32.2"
date: 2017-02-01
changes:
- type: security
message: Important security fixes
references:
- url: https://jenkins.io/security/advisory/2017-02-01/
title: security advisory
- type: major rfe
message: Support displaying of warnings from the update site in the plugin manager and in administrative monitors
references:
- issue: 40494
- url: https://jenkins.io/blog/2017/01/10/security-warnings/
title: announcement blog post
- type: bug
message: Correctly state that Jenkins will refuse to load plugins whose dependencies are not satisfied in plugin manager.
issue: 40666
- type: bug
message: The <tt>install-plugin</tt> CLI command now correctly installs plugins when multiple file arguments are specified.
issue: 32358
- type: bug
message: >
Prevent the <code>ClassNotFoundException: javax.servlet.ServletException</code> error when invoking shell tasks on remote agents.
issue: 40863
- type: bug
message: Properties were not passed to Maven command by Maven build step when the <code>Inject Build Variables</code> flag was not set.
issue: 39268
- type: bug
message: Job configuration submission now does not fail when there is no parameters property.
issue: 39700, regression in 1.637
- type: bug
message: Update remoting to 3.4 in order to properly terminate the channel in the case <code>Errors</code> and <code>Exception</code>s.
issue: 39835
- type: bug
message: <code>Check for Updates</code> button in the Plugin Manager was hidden in the <code>Updates</code> tab when there was no plugins updates available.
issue: 39971
- type: bug
message: >
SSHD Module: Handshake was failing (wrong shared secret) 1 out of 256 times due to <a href="https://issues.apache.org/jira/browse/SSHD-330">SSHD-330</a>.
issue: 40362
- type: bug
message: >
Performance: Use bulk change when submitting Job configurations to minimize the number of sequential <code>config.xml</code> write operations.
issue: 40435
- type: bug
message: Jobs were hanging during process termination on the Solaris 11 Intel platform, regression in 2.20
issue: 40470
- type: bug
message: Restore option value for setting build result to unstable when loading shell and batch build steps from disk.
issue: 40894
- type: rfe
message: >
Update to Winstone 3.2 to support ad-hoc certificate generation on Java 8 (using unsupported APIs).
<strong>This option is deprecated and will be removed in a future release.</strong>
We strongly recommend you create self-signed certificates yourself and use <tt>--httpsKeyStore</tt> and related options instead.
issue: 25333
33 changes: 33 additions & 0 deletions content/_partials/changelog-header.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
<link rel="stylesheet" TYPE="text/css" href="/changelog.css">
<div id="head"></div>
<script type="text/javascript" src="https://rating.jenkins.io/rate/rate.js"></script>

<div align="right">Legend:
<span class="iconlegend">
<img src="/images/rfe2.gif" alt="major RFE">major enhancement <img src="/images/rfe.gif" alt="RFE">enhancement
<img src="/images/bug2.gif" alt="major bug">major bug fix <img src="/images/bug.gif" alt="bug">bug fix
</span><span style="visibility:hidden">xxxxx</span>
</div>

<div id="ratings" style="display:none; font-size:120%;
border:1px solid black; background-color:#eee; padding:0.5em; margin-bottom:1em">
Help other Jenkins users by letting the community know which releases you've used,
and whether they had any significant issues. <br>
Legend: <br>
<img src="//ci.jenkins.io/images/16x16/health-80plus.gif" width="16" height="16"
alt="Sunny"> = I use it on my production site without major issues. <br>
<img src="//ci.jenkins.io/images/16x16/health-40to59.gif" width="16" height="16"
alt="Cloudy"> = I don't recommend it. <br>
<img src="//ci.jenkins.io/images/16x16/health-00to19.gif" width="16" height="16"
alt="Lightning"> = I tried it but rolled back to a previous version. <br>
View ratings below, and click one of the icons next to your version to provide your input.
</div>

<a href="#" style="padding-left:3em" onClick="return loaddata(this)">Community ratings</a>

<div style="margin: 10px; padding: 10px; background-color: #FFFFCE;">
See our new <a href="/doc/upgrade-guide/">LTS upgrade guide</a> for advice on upgrading Jenkins.
</div>

<div id="rc" style="display:none;">
</div>
Original file line number Diff line number Diff line change
Expand Up @@ -3,165 +3,7 @@
title: LTS Changelog
---

<link rel="stylesheet" TYPE="text/css" href="/changelog.css">
<!--[if IE]>
<style type="text/css">div.rate-offset { bottom: 0.2em !important; left: 5em !important; }</style>
<![endif]-->
<div id="head"></div>
<script type="text/javascript" src="https://rating.jenkins.io/rate/rate.js"></script>
<!--

We record noteworthy changes in this file, which then becomes http://jenkins-ci.org/changelog

Some tips:

- Record your changes between "TRUNK-BEGIN" and "TRUNK-END".
(except in rare cases when you are making changes in the RC branch,
in which case it goes to the rc section)

- There are four CSS classes to denote the kind of changes.
"rfe" for enhancement and "bug" for bug fixes,
plus "major" to indicate major RFE/bugfix.

- Link to bugs in the issue tracker, e-mail thread in the archive, and so on if you can.

-->
<div align="right">Legend:
<span class="iconlegend">
<img src="/images/rfe2.gif" alt="major RFE">major enhancement <img src="/images/rfe.gif" alt="RFE">enhancement
<img src="/images/bug2.gif" alt="major bug">major bug fix <img src="/images/bug.gif" alt="bug">bug fix
</span><span style="visibility:hidden">xxxxx</span>
</div>

<div id="ratings" style="display:none; font-size:120%;
border:1px solid black; background-color:#eee; padding:0.5em; margin-bottom:1em">
Help other Jenkins users by letting the community know which releases you've used,
and whether they had any significant issues. <br>
Legend: <br>
<img src="//ci.jenkins.io/images/16x16/health-80plus.gif" width="16" height="16"
alt="Sunny"> = I use it on my production site without major issues. <br>
<img src="//ci.jenkins.io/images/16x16/health-40to59.gif" width="16" height="16"
alt="Cloudy"> = I don't recommend it. <br>
<img src="//ci.jenkins.io/images/16x16/health-00to19.gif" width="16" height="16"
alt="Lightning"> = I tried it but rolled back to a previous version. <br>
View ratings below, and click one of the icons next to your version to provide your input.
</div>

<a href="" style="padding-left:3em" onClick="return loaddata(this)">Community ratings</a>

<div style="margin: 10px; padding: 10px; background-color: #FFFFCE;">
See our new <a href="/doc/upgrade-guide/">LTS upgrade guide</a> for advice on upgrading Jenkins.
</div>


<div id="rc" style="display:none;">
</div>

<h3><a name=v2.32.2>What's new in 2.32.2</a> (2017-02-01)</h3>

<a href="/doc/upgrade-guide/2.32/#upgrading-to-jenkins-lts-2-32-2">Upgrade Guide</a>

<ul class=image>
<li class="major bug">
<strong>Important security fixes</strong>
(<a href="https://jenkins.io/security/advisory/2017-02-01/">security advisory</a>)
<li class="major rfe">
Support displaying of warnings from the update site in the plugin manager and in administrative monitors.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-40494">issue 40494</a>,
<a href="/blog/2017/01/10/security-warnings/">announcement blog post</a>)
<li class=bug>
Correctly state that Jenkins will refuse to load plugins whose dependencies are not satisfied in plugin manager.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-40666">issue 40666</a>)
<li class=bug>
The <tt>install-plugin</tt> CLI command now correctly installs plugins when multiple file arguments are specified.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-32358">issue 32358</a>)
<li class=bug>
Prevent the <code>ClassNotFoundException: javax.servlet.ServletException</code> error
when invoking shell tasks on remote agents.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-40863">issue 40863</a>)
<li class=bug>
Properties were not passed to Maven command by Maven build step when the <code>Inject Build Variables</code> flag was not set.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-39268">issue 39268</a>)
<li class="bug">
Job configuration submission now does not fail when there is no parameters property.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-39700">issue 39700</a>, regression in 1.637)
<li class=bug>
Update remoting to 3.4 in order to properly terminate the channel in the case <code>Errors</code> and <code>Exception</code>s.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-39835">issue 39835</a>)
<li class="bug">
<code>Check for Updates</code> button in the Plugin Manager was hidden in the <code>Updates</code> tab
when there was no plugins updates available.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-39971">issue 39971</a>)
<li class="bug">
SSHD Module: Handshake was failing (wrong shared secret) 1 out of 256 times due to
<a href="https://issues.apache.org/jira/browse/SSHD-330">SSHD-330</a>.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-40362">issue 40362</a>)
<li class="bug">
Performance: Use bulk change when submitting Job configurations
to minimize the number of sequential <code>config.xml</code> write operations.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-40435">issue 40435</a>)
<li class=bug>
Jobs were hanging during process termination on the Solaris 11 Intel platform.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-40470">issue 40470</a>, regression in 2.20)
<li class=bug>
Restore option value for setting build result to unstable when loading shell and batch build steps from disk.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-40894">issue 40894</a>)
<li class=rfe>
Update to Winstone 3.2 to support ad-hoc certificate generation on Java 8 (using unsupported APIs).
<strong>This option is deprecated and will be removed in a future release.</strong>
We strongly recommend you create self-signed certificates yourself and use <tt>--httpsKeyStore</tt> and related options instead.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-25333">issue 25333</a>)
</ul>


<h3><a name=v2.32.1>What's new in 2.32.1</a> (2016-12-24)</h3>

<div><strong>Changes since 2.32:</strong></div>

<ul class=image>
<li class="major bug">
Prevent early deallocation of process references by Garbage Collector when starting a remote process.
It was sometimes causing build failures with messages like <code>FATAL: Invalid object ID 184 iuota=187</code> and <code>java.lang.Exception: Object was recently deallocated</code>.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-23271">issue 23271</a>)
<li class="bug">
Redirect to login page in the case of authorisation error when checking connectivity to the Update Center.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-39741">issue 39741</a>)
<li class="bug">
WinP 1.24: Native class now tries loading DLLs from the temporary location.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-20913">issue 20913</a>)
</ul>

<div><strong>Notable changes since 2.19.4:</strong></div>

<ul class=image>
<li class="major rfe">
Upgrade Remoting to version 3.1 with <a href="https://github.com/jenkinsci/remoting/blob/master/docs/protocols.md#jnlp4-connect">JNLP4-connect protocol</a>.
<a href="https://github.com/jenkinsci/remoting/blob/master/docs/remoting-3-compatibility.md">Compatibility notes are available here</a>.
Notably, it is no longer possible to use JDK 6 for the Maven project type, as communication with the Maven process uses Remoting, and it now requires Java 7.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-37564">issue 37564</a>,
<a href="https://issues.jenkins-ci.org/browse/JENKINS-36871">issue 36871</a>,
<a href="https://issues.jenkins-ci.org/browse/JENKINS-37565">issue 37565</a>)
<li class="major rfe">
Show notification with popup on most pages when administrative monitors are active.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-38391">issue 38391</a>)
<li class="rfe">
Allow disabling/enabling administrative monitors on Configure Jenkins form.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-38301">issue 38301</a>)
<li class="rfe">
Ask for confirmation before canceling/aborting runs.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-30565">issue 30565</a>)
<li class="rfe">
Prompt user whether to add the job to the current view.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-19142">issue 19142</a>)
<li class="rfe">
Allow <code>CommandInterpreter</code> build steps to set a build result as <code>Unstable</code> via the return code.
Shell and Batch build steps now support this feature.
(<a href="https://issues.jenkins-ci.org/browse/JENKINS-23786">issue 23786</a>)
<li class="rfe">
Internal: Upgrade Stapler library from <code>1.243</code> to <code>1.246</code> with fixes required for the Blue Ocean project.
Changes are listed <a href="https://github.com/stapler/stapler/compare/stapler-parent-1.243...stapler-parent-1.246">here</a>.
(<a href="https://github.com/jenkinsci/jenkins/pull/2593">pull 2593</a>)
</ul>
<!-- this document archives change logs of LTS releases 2.19.4 and earlier in HTML. It has since been replaced by YAML based changelogs. -->

<h3><a name=v2.19.4>What's new in 2.19.4</a> (2016-11-23)</h3>
<ul class=image>
Expand Down Expand Up @@ -611,7 +453,7 @@ <h3><a name=v1.651.3>What's new in 1.651.3</a> (2016/06/08)</h3>
Installation Wizard: SEVERE errors in logs, enabling of the enabled plugin.
(<a href='https://issues.jenkins-ci.org/browse/JENKINS-34710'>issue 34710</a>)
<li class='bug'>
Check Updates PeriodicWork dies horribly in the case of invalid signature.
Check Updates PeriodicWork dies horribly in the case of invalid signature.
(<a href='https://issues.jenkins-ci.org/browse/JENKINS-34745'>issue 34745</a>)
<li class='bug'>
RSS ID duplication for items with same name in different folders.
Expand Down
33 changes: 33 additions & 0 deletions content/_partials/changes.html.haml
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
- page.changes.each do | change |
%li{:class => change.type }
= change.message
- if change.issue
(
%a{:href => "https://issues.jenkins-ci.org/browse/JENKINS-#{change.issue}" }<>
= "issue #{change.issue}"
)
- elsif change.pull
(
%a{:href => "https://github.com/jenkinsci/jenkins/pull/#{change.pull}" }<>
= "pull #{change.pull}"
)
- if change.references
- change.references.each_with_index do | reference, index |
- if index == 0
(
- else
,&nbsp;
- if reference.issue
%a{:href => "https://issues.jenkins-ci.org/browse/JENKINS-#{reference.issue}" }<>
Copy link
Contributor

Choose a reason for hiding this comment

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

The logic here should ideally check a custom prefix (e.g. "SECURITY"), but not required right now

Copy link
Contributor Author

Choose a reason for hiding this comment

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

We don't have separate changelog entries for security vulnerabilities (instead we link to the advisory), and the rare references elsewhere can be done with full URL and label.

= "issue #{reference.issue}"
- if reference.pull
%a{:href => "https://github.com/jenkinsci/jenkins/pull/#{reference.pull}" }<>
= "pull #{reference.pull}"
- else
%a{:href => reference.url }<>
- if reference.title
= reference.title
- else
= reference.url
- if index == change.references.count - 1
)
27 changes: 27 additions & 0 deletions content/changelog-stable/index.html.haml
Original file line number Diff line number Diff line change
@@ -0,0 +1,27 @@
---
layout: simplepage
title: LTS Changelog
---

= partial('changelog-header.html')

.ratings
- site.changelogs[:lts].reverse_each do | release |
%h3
%a{:name => "v#{release.version}" }
What's new in
= release.version
= "(#{release.date})"
-if release.changes and release.lts_changes and release.lts_baseline
%div
%strong
= "Changes since #{release.lts_baseline}:"
%ul.image
= partial('changes.html.haml', :changes => release.changes)
-if release.changes and release.lts_changes
%div
%strong
= "Notable changes since #{release.lts_predecessor}:"
%ul.image
= partial('changes.html.haml', :changes => release.lts_changes)
= partial('changelog-stable.html')
4 changes: 4 additions & 0 deletions content/changelog.css
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,10 @@ UL.image LI.bug {
UL.image LI.bug.major {
background-image: url(images/bug2.gif);
}
UL.image LI.security {
background-image: url(images/bug2.gif);
font-weight: bold;
}

UL.iconlegend {
display: inline;
Expand Down