Steps for a Release

Preparations

  • Heads up on the mailing-lists

e.g.:

first steps for the next release

hi @ all,

if there are no objections, i'll start with the first steps for the next release (review, documentation,...).
it would be great to start with the release procedure next week.

regards,
[name]
  • Check the jenkins builds

  • Create release notes and commit them to deltaspike/readme/ (format [ReleaseNotes][version].txt)

test at least:

mvn clean install -POWB
mvn clean install -PWeld
mvn clean install -Prat
mvn clean install -Ptomee-build-managed
mvn clean install -Pjbossas-build-managed-7
mvn clean install -Pwildfly-build-managed
mvn clean install -Pglassfish-build-managed-3

deploy a demo app especially with jsf-impl-ee6 to an ee6 server and check the logs (if there are no optional ee7+ classes) (https://github.com/os890/ee6-ds-demo can be used for it e.g.)

First steps

//install a version of git which is compatible with the release-plugin (e.g. v1.8.3.2)
git checkout -b ds-[release version]

mvn release:prepare -Pdistribution -DreleaseProfiles=distribution

//copy prepared workspace (to continue faster if an upload fails in the next step)

//hint: dois not use -DdryRun=true -- since it can break the next step
mvn release:perform -Pdistribution -DreleaseProfiles=distribution

//!!!check the created commits including user-name and email

//login to https://repository.apache.org/ and go to "Staging Repositories"
//check esp. .../org/apache/deltaspike/deltaspike-project/[version]/deltaspike-project-[version]-source-release.zip
//close the repository

//push the release-branch and tag to a third-party git repo
git remote add vote https://github.com/[user]/deltaspike-vote
git push -u vote master
git push vote ds-[release version]
git push vote --tags

Vote

Start the Vote

e.g.:

[VOTE] Release of Apache DeltaSpike [version]


Hi,

I was running the needed tasks to get the ... release of Apache DeltaSpike out.
The artifacts are deployed to Nexus [1] (and [2]).

The tag is available at [3] and will get pushed to the ASF repository once the vote passed.

Please take a look at the ... artifacts and vote!

Please note:
This vote is "majority approval" with a minimum of three +1 votes (see [4]).

------------------------------------------------
[ ] +1 for community members who have reviewed the bits
[ ] +0
[ ] -1 for fatal flaws that should cause these bits not to be released, and why..............
------------------------------------------------

Thanks,
[name]

[1] https://repository.apache.org/content/repositories/...
[2] https://repository.apache.org/content/repositories/.../org/apache/deltaspike/deltaspike-project/[version]/deltaspike-project-[version]-source-release.zip
[3] https://github.com/[user]/deltaspike-vote/tree/deltaspike-project-[version]
[4] http://www.apache.org/foundation/voting.html#ReleaseVotes

Announce the Vote

  • Create a link to the release notes at http://s.apache.org (format DeltaSpike_[version])

  • Tweet about the vote via @DeltaSpikeTeam.

Perform the final release

Close the Vote

After 72 hours close the vote.

e.g.:

Result (was: Re: [VOTE] Release of Apache DeltaSpike [version])

thank you for voting!

X binding +1 votes (pmc):
[list]

Y non-binding +1 votes:
[list]

Z -1 votes
[list]

If the binding majority approved the vote continue.

  • Login to https://repository.apache.org/ and release the repository

  • Merge release branch into master and push the branch and tag to the ASF repository

Always do a merge in this case (not a rebase):

git checkout master
git merge ds-[version]
git push origin ds-[version]
git push origin deltaspike-[version]
git push origin master

Upload Artifacts

svn co https://dist.apache.org/repos/dist/release/deltaspike
mkdir [version]
//add and commit the artifacts (at least *source-release.zip + asc, md5, sha1)
//use the artifacts from:
//  http://repo1.maven.org/maven2/org/apache/deltaspike/deltaspike/[version]/
//  http://repo1.maven.org/maven2/org/apache/deltaspike/distribution/distribution-full/[version]/

Update site content

via source: - Update the build (version.deltaspike.latest.stable and version.deltaspike.latest.snapshot) - Update news: http://deltaspike.apache.org/news.html

via CMS: - Update version: http://deltaspike.apache.org/index.html

deploy the site * mvn site deploy * mvn clean site-deploy -Pstaging * mvn clean site-deploy * mvn clean javadoc:aggregate scm-publish:publish-scm or javadoc.sh * update cms workspace * publish content via https://cms.apache.org/deltaspike/publish

Announce the Release

E-mails

[ANNOUNCE] Release of Apache DeltaSpike [version]

The Apache DeltaSpike team is pleased to announce the 6th release of DeltaSpike.

Apache DeltaSpike is not a CDI-container, but a portable CDI extension.

Documentation:
http://deltaspike.apache.org/documentation.html

Download:
http://deltaspike.apache.org/download.html

Release Notes:
http://s.apache.org/DeltaSpike_06

Enjoy!

[name]

Write the e-mails to:

Twitter

e.g.:

[ANNOUNCE] The Apache #DeltaSpike team is pleased to announce http://s.apache.org/DeltaSpike_[version]. Feel free to test it! Feedback is very welcome!