This page (revision-26) was last changed on 18-Jan-2025 15:36 by Juan Pablo 

This page was created on 14-Apr-2017 13:43 by Juan Pablo

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Version Date Modified Size Author Changes ... Change note
26 18-Jan-2025 15:36 12 KB Juan Pablo to previous JSPWIKI-1202: add notes to check for build reproducibility
25 18-Jan-2025 15:35 12 KB Juan Pablo to previous | to last JSPWIKI-1202: add notes to check for build reproducibility
24 02-Aug-2022 21:33 11 KB Juan Pablo to previous | to last
23 30-Jul-2022 12:59 11 KB Juan Pablo to previous | to last no need to modify jspwiki-bom file
22 13-Jan-2022 14:07 12 KB Juan Pablo to previous | to last added pre-release checks section
21 18-Dec-2021 17:09 11 KB Juan Pablo to previous | to last announce e-mail should be sent using only plain text
Incoming links Outgoing links
How to release
How to release

Difference between version and

At line 7 added one line
* Check version on {{./jspwiki-api/src/main/java/org/apache/wiki/api/Release.java}}
At line 9 changed one line
mvn clean install apache-rat:rat -Papache-release # generates artifacts, checks for AL headers
mvn clean verify apache-rat:rat -Papache-release # generates artifacts, checks for AL headers
At line 21 changed one line
* Publish latest javadocs
* Publish latest javadocs and binary compatibility reports
At line 46 changed 3 lines
<id>svn.apache.org</id>
<username>APACHE-ID</username>
<password>APACHE-PASSWORD</password>
<id>github.com</id>
<username>GITHUB-ID</username>
<password>GITHUB-2FA-TOKEN</password>
At line 56 added 7 lines
!! Pre-release checks
Verify that {{./jspwiki-api/src/main/java/org/apache/wiki/api/Release.java}} contains the appropiate JSPWiki version
* on {{./jspwiki-api/src/main/java/org/apache/wiki/api/Release.java}}, {{BUILD}} and {{POSTFIX}} constants should be empty strings.
The maven release process does not change these values on these files, so this has to be done manually.
At line 60 changed one line
mvn clean install apache-rat:rat -Papache-release
mvn clean verify apache-rat:rat -Papache-release
At line 80 added 2 lines
Note that, when asked, the tag should follow the scheme {{X.Y.Z-RC#}}. If the vote succeeds, we'll re-tag later on {{X.Y.Z-RC#}} with {{X.Y.Z}}.
At line 83 changed one line
}}}
}}}
At line 95 added 2 lines
__IMPORTANT__: when asked, the tag should follow the scheme {{X.Y.Z-RC#}}. If the vote succeeds, we'll re-tag later on {{X.Y.Z-RC#}} with {{X.Y.Z}}.
At line 92 changed one line
# Select org.apache.jspwiki from the list of repositories, then click [Close|https://docs.sonatype.org/display/Repository/Closing+a+Staging+Repository] using "Apache JSPWiki X.Y.Z" as the description to allow others to see the repository.
# Select org.apache.jspwiki from the list of repositories, then click [Close|https://help.sonatype.com/repomanager2/staging-releases/managing-staging-repositories#ManagingStagingRepositories-ClosinganOpenRepository] using "Apache JSPWiki X.Y.Z" as the description to allow others to see the repository.
At line 94 changed one line
* __Svn copy binaries and source to https://dist.apache.org/repos/dist/dev/jspwiki/X.Y.Z/__, suggested structure
* __Svn copy binaries and source to {{https://dist.apache.org/repos/dist/dev/jspwiki/X.Y.Z/}}__ (remember to also copy accompanying {{sha512}} and {{asc}} files), suggested structure:
At line 112 changed one line
https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310732&version=<REPLACE>
https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12310732&version=<VERSION>
You can see a curated changelog at https://jspwiki-wiki.apache.org/Wiki.jsp?page=NewInX.Y
At line 119 changed one line
http://people.apache.org/~<REPLACE>/jspwiki-X.Y.Z-candidate-$RC
https://dist.apache.org/repos/dist/dev/jspwiki/[VERSION]-RC[RC]
At line 124 changed one line
http://svn.apache.org/repos/asf/jspwiki/tags/release-X.Y.Z/
https://github.com/apache/jspwiki/tree/[VERSION]-RC[RC]
At line 127 changed one line
http://www.apache.org/dist/jspwiki/KEYS
https://www.apache.org/dist/jspwiki/KEYS
== Reproducible Builds ==
JSPWiki should follow Reproducible Builds (https://reproducible-builds.org/). In order to verify
artifacts' build reproducibility, please use
mvn verify artifact:compare -Dreference.repo=https://repository.apache.org/content/repositories/staging/
At line 160 added 4 lines
* Add a another __tag {{X.Y.Z}}__ to the commit tagged with {{X.Y.Z-RC#}} and push it
## {{git tag -a X.Y.Z -m "X.Y.Z" X.Y.Z-RC#}}
## {{git push origin X.Y.Z}}
At line 149 changed 4 lines
* __Publish javadocs on jspwiki.apache.org__
## {{svn checkout}} [https://svn.apache.org/repos/infra/websites/production/jspwiki/content/apidocs/]
## {{svn add}} javadocs directory/ies, which have been generated as part of the release (check for {{*/target/apidocs}} folders)
## modify the three links on [https://svn.apache.org/repos/infra/websites/production/jspwiki/content/apidocs/index.html] so they point to the new javadocs
* __Update [Downloads] page links__
## add source + checksum + signature + links to current release and delete those links from older releases ([ref.|https://www.apache.org/dev/release-distribution#download-links])
At line 176 added 8 lines
* __Publish javadocs and binary compatibility reports on jspwiki.apache.org__
## modify the three links on [https://github.com/apache/jspwiki-site/blob/jbake/src/main/jbake/assets/apidocs/index.html] so they point to the new javadocs
## modify the three links on [https://github.com/apache/jspwiki-site/blob/jbake/src/main/jbake/assets/japicmp/index.html] so they point to the new binary compatibility reports
* __Update Apache JSPWiki website__
## at [https://github.com/apache/jspwiki-site], modify {{src/main/jbake/content/general/downloads.md}}, {{src/main/jbake/content/general/news.md}} and {{src/main/jbake/content/index.md}} so they reflect the new release
## add a curated changelog at {{https://jspwiki-wiki.apache.org/Wiki.jsp?page=NewIn<REPLACE>}}
At line 188 added 6 lines
!! Add the next release version to JIRA
* (Bulk) transition all X.Y.Z issues from {{Resolved}} to {{Closed}}. To avoid clogging dev@jspwiki.a.o, there's no need to send bulk e-mails for these changes
* Mark the released version as {{Released}} with a release date
* Add the [next version number to JIRA|https://issues.apache.org/jira/plugins/servlet/project-config/JSPWIKI/versions]
At line 160 changed one line
* Send the following from an apache.org address to [announce@apache.org|mailto:announce@apache.org], [user@jspwiki.apache.org|mailto:user@jspwiki.apache.org], [dev@jspwiki.apache.org|mailto:dev@jspwiki.apache.org]:
* Send the following from an apache.org address, using plain text only, to [announce@apache.org|mailto:announce@apache.org], [user@jspwiki.apache.org|mailto:user@jspwiki.apache.org], [dev@jspwiki.apache.org|mailto:dev@jspwiki.apache.org]:
At line 170 changed one line
http://www.apache.org/dyn/closer.cgi/jspwiki/
https://jspwiki-wiki.apache.org/Wiki.jsp?page=Downloads
At line 188 changed one line
!! Add the next release version to JIRA
!! First push post-release
At line 190 changed 2 lines
* Add the [next version number to JIRA|https://issues.apache.org/jira/plugins/servlet/project-config/JSPWIKI/versions]
* Mark the released version as "released" with a release date
Ensure that {{./jspwiki-api/src/main/java/org/apache/wiki/api/Release.java}} contains next development versions.
At line 195 changed 2 lines
* Cygwin mixes Windows path with cygdrive, so {{mvn release:prepare}} fails on svn commit
** Current workaround: perform release via {{cmd.exe}}
* Git doesn't allow to perform an {{mvn release:perform}} because it detects file(s) permissions change (i.e. change from old 0755 to new 0644)
** {{git config core.fileMode false}}
At line 201 changed one line
* {{mvn release:prepare}} doesn't find {{svn}} credentials
* {{mvn release:prepare}} doesn't find {{git}} credentials
At line 205 changed one line
*** {{svn.apache.org}}: to be able to create tags
*** {{github.com}}: to be able to create tags
At line 214 changed 3 lines
* [Publishing Maven Artifacts - setup your development environment|http://www.apache.org/dev/publishing-maven-artifacts.html#dev-env]
* [Maven release plugin|http://maven.apache.org/maven-release/maven-release-plugin/]
* Repository management with Nexus: [Chapter 11. Improved Releases with the Nexus Staging Suite|http://books.sonatype.com/nexus-book/reference/staging-sect-intro.html]
* [Publishing Maven Artifacts - setup your development environment|https://www.apache.org/dev/publishing-maven-artifacts.html#dev-env]
* [Maven release plugin|https://maven.apache.org/maven-release/maven-release-plugin/]
* Repository management with Nexus: [Staging Releases|https://help.sonatype.com/repomanager2/staging-releases]
This page (revision-26) was last changed on 18-Jan-2025 15:36 by Juan Pablo  Top