src/main/webapp/contribute/manual-release-guide.html [397:581]: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
git checkout tags/unomi-root-${next.stable.version}
cd docker
mvn clean install
mvn docker:push
git push --delete origin unomi-root-${next.stable.version}
git tag --delete unomi-root-${next.stable.version}
git reset --hard c65f9897ec5f31d9d22ad639738c7db9d109aa77
git push origin -f
Tweet, post on Facebook, LinkedIn, and other platforms. Ask other contributors to do the same.
In order to lighten the load on mirrors, remove old releases from the dist server once the new release has properly been deployed to all the mirrors. Old releases are automatically archived so they are not needed on the mirrors anymore. Just make sure that all the links in the download page do point to the archive server.
It is important that we improve the release processes over time. Once you’ve finished the release, please take a step back and look what areas of this process and be improved. Perhaps some part of the process can be simplified. Perhaps parts of this guide can be clarified.
If we have specific ideas, please start a discussion on the dev@ mailing list and/or propose a pull request to update this guide. Thanks!
Subject: [VOTE] Apache Unomi ${next.stable.version} release [TAKE2]
Body:
Hi all,
I submit Apache Unomi ${next.stable.version} release [TAKE2] to your vote.
The following corrections were done since TAKE 1:
NOTICE year (2016) has been updated to 2018
unexpected binaries inside zip file [1] : zip file has been completely removed
All artefacts are now signed in an apache email address
Staging Repository:
*https://repository.apache.org/content/repositories/orgapacheunomi-1021/
<https://repository.apache.org/content/repositories/orgapacheunomi-1021/>*
You can find the sources here :
*https://repository.apache.org/content/repositories/orgapacheunomi-1021/org/apache/
unomi/unomi-root/${next.stable.version}/unomi-root-${next.stable.version}-source-release.zip
<https://repository.apache.org/content/repositories/orgapacheunomi-1021/org/apache/
unomi/unomi-root/${next.stable.version}/unomi-root-${next.stable.version}-source-release.zip>*
Convenience binaries are also available here:
*https://repository.apache.org/content/repositories/orgapacheunomi-1021/org/apache/
unomi/unomi/${next.stable.version}/
<https://repository.apache.org/content/repositories/orgapacheunomi-1021/org/apache/
unomi/unomi/${next.stable.version}/>*
Git tag:
unomi-root-${next.stable.version}
Release Notes:
https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12319220&
version=12341610
Please vote to approve this release:
[ ] +1 Approve the release
[ ] -1 Don't approve the release (please provide specific comments)
This vote will be open for at least 72 hours, or until the necessary number
of binding votes (3 +1) is reached.
Please let me know if you have any questions.
Thanks,
Regards
Subject: [RESULT][VOTE] Apache Unomi ${next.stable.version} release [TAKE2]
Body:
Hi,
Thank you for your votes.
Here's the summary :
3 binding votes +1:
John Doe 1
John Doe 2
John Doe 3
2 non-binding vote +1:
John Doe 4
John Doe 5
No 0 or -1.
The proposal to release Unomi ${next.stable.version} is approved by the team.
Thanks,
John Doe 1
Subject : [ANNOUNCE] Apache Unomi ${next.stable.version} Release
Body:
The Apache Unomi team would like to announce the release of Apache
Unomi ${next.stable.version}.
Release notes are here:
https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12319220&
version=12338361
Apache Unomi is a Java Open Source customer data platform, a Java server
designed to manage customers, leads and visitors' data and help personalize customers'
experiences.
More details regarding Apache Unomi can be found here:
http://unomi.apache.org/
The release artifacts can be downloaded here:
https://dist.apache.org/repos/dist/release/incubator/unomi/${next.stable.version}/
All JIRAs completed for this release are tagged with 'FixVersion =
${next.stable.version}'; the JIRA release notes can be found here:
https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12319220&
version=12338361
Thanks!
The Apache Unomi Team
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
src/main/webapp/contribute/release-guide.html [290:474]:
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Go back to the site project and make sure you update the documentation page to link to the proper
versions of the documents.
Docker image
-
Checkout the tagged version:
git checkout tags/unomi-root-${next.stable.version}
-
Change to the Docker directory. Make sure you have docker running locally (start Docker Desktop for
example):
cd docker
-
Launch the docker build and push
mvn clean install
mvn docker:push
Rollback
- Delete the tag:
git push --delete origin unomi-root-${next.stable.version}
git tag --delete unomi-root-${next.stable.version}
- Reset to the previous commit before the release preparation:
git reset --hard c65f9897ec5f31d9d22ad639738c7db9d109aa77
git push origin -f
Announce
- Send an announce to the project mailing list and the Apache announce mailing list to announce the new release using mail template [3]
- If you were releasing from a branch, make sure you merge all the branch changes for the release back to the master.
Social media
Tweet, post on Facebook, LinkedIn, and other platforms. Ask other contributors to do the same.
Remove old releases
In order to lighten the load on mirrors, remove old releases from the dist server once the new release
has properly been deployed to all the mirrors. Old releases are automatically archived so they are
not needed on the mirrors anymore. Just make sure that all the links in the download page do point
to the archive server.
Checklist to declare the process completed
- Release announced on the user@ mailing list.
- Release recorded in reporter.apache.org.
- Release announced on social media.
- Completion declared on the dev@ mailing list.
- Check that old release where removed from the dist server
Improve the process
It is important that we improve the release processes over time. Once you’ve finished the release, please take a step back and look what areas of this process and be improved. Perhaps some part of the process can be simplified. Perhaps parts of this guide can be clarified.
If we have specific ideas, please start a discussion on the dev@ mailing list and/or propose a pull request to update this guide. Thanks!
Mail templates
[1] Mail template for the Unomi PMC vote:
Subject: [VOTE] Apache Unomi ${next.stable.version} release [TAKE2]
Body:
Hi all,
I submit Apache Unomi ${next.stable.version} release [TAKE2] to your vote.
The following corrections were done since TAKE 1:
NOTICE year (2016) has been updated to 2018
unexpected binaries inside zip file [1] : zip file has been completely removed
All artefacts are now signed in an apache email address
Staging Repository:
*https://repository.apache.org/content/repositories/orgapacheunomi-1021/
<https://repository.apache.org/content/repositories/orgapacheunomi-1021/>*
You can find the sources here :
*https://repository.apache.org/content/repositories/orgapacheunomi-1021/org/apache/
unomi/unomi-root/${next.stable.version}/unomi-root-${next.stable.version}-source-release.zip
<https://repository.apache.org/content/repositories/orgapacheunomi-1021/org/apache/
unomi/unomi-root/${next.stable.version}/unomi-root-${next.stable.version}-source-release.zip>*
Convenience binaries are also available here:
*https://repository.apache.org/content/repositories/orgapacheunomi-1021/org/apache/
unomi/unomi/${next.stable.version}/
<https://repository.apache.org/content/repositories/orgapacheunomi-1021/org/apache/
unomi/unomi/${next.stable.version}/>*
Git tag:
unomi-root-${next.stable.version}
Release Notes:
https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12319220&
version=12341610
Please vote to approve this release:
[ ] +1 Approve the release
[ ] -1 Don't approve the release (please provide specific comments)
This vote will be open for at least 72 hours, or until the necessary number
of binding votes (3 +1) is reached.
Please let me know if you have any questions.
Thanks,
Regards
[2] Mail template for the results of the Unomi PMC vote:
Subject: [RESULT][VOTE] Apache Unomi ${next.stable.version} release [TAKE2]
Body:
Hi,
Thank you for your votes.
Here's the summary :
3 binding votes +1:
John Doe 1
John Doe 2
John Doe 3
2 non-binding vote +1:
John Doe 4
John Doe 5
No 0 or -1.
The proposal to release Unomi ${next.stable.version} is approved by the team.
Thanks,
John Doe 1
[3] Announce mailing list template:
Subject : [ANNOUNCE] Apache Unomi ${next.stable.version} Release
Body:
The Apache Unomi team would like to announce the release of Apache
Unomi ${next.stable.version}.
Release notes are here:
https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12319220&
version=12338361
Apache Unomi is a Java Open Source customer data platform, a Java server
designed to manage customers, leads and visitors' data and help personalize customers'
experiences.
More details regarding Apache Unomi can be found here:
http://unomi.apache.org/
The release artifacts can be downloaded here:
https://dist.apache.org/repos/dist/release/incubator/unomi/${next.stable.version}/
All JIRAs completed for this release are tagged with 'FixVersion =
${next.stable.version}'; the JIRA release notes can be found here:
https://issues.apache.org/jira/secure/ReleaseNote.jspa?projectId=12319220&
version=12338361
Thanks!
The Apache Unomi Team
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -