Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "Releasing Tycho"

m
m
Line 9: Line 9:
 
*Add your credentials for server <tt>&lt;OSS_ID&gt;</tt> in <tt>~/.m2/settings.xml</tt>  
 
*Add your credentials for server <tt>&lt;OSS_ID&gt;</tt> in <tt>~/.m2/settings.xml</tt>  
 
*Sync to release commit and deploy to nexus staging repository: <br/><tt>mvn clean deploy -Prelease -DforgeReleaseId=&lt;OSS_ID&gt; -DforgeReleaseUrl=https://oss.sonatype.org/service/local/staging/deploy/maven2/ -Dgpg.passphrase=&lt;YOUR_GPG_PASSPAHRASE&gt;</tt>  
 
*Sync to release commit and deploy to nexus staging repository: <br/><tt>mvn clean deploy -Prelease -DforgeReleaseId=&lt;OSS_ID&gt; -DforgeReleaseUrl=https://oss.sonatype.org/service/local/staging/deploy/maven2/ -Dgpg.passphrase=&lt;YOUR_GPG_PASSPAHRASE&gt;</tt>  
*Close the staging repository and announce the temporary stage URL on tycho-user@eclipse.org:<tt><br/>Subject:&nbsp;please test staged tycho &lt;VERSION&gt; <br/><br/>Tycho milestone release &lt;VERSION&gt; has been staged. For details of new features and bugfixes, see release notes [1]. <br/> Please help by testing the staged milestone build. To use it, change your tycho version to &lt;VERSION&gt; and add snippet [2] to your pom. <br/><br/> We plan to promote this release in one week unless major regressions are found.<br/><br/>Regards,<br/>  Tycho team<br/> <br/>  [1] http://wiki.eclipse.org/Tycho/Release_Notes/&lt;VERSION&gt; <br/>[2]<br/>&lt;pluginRepositories&gt;<br/>  &nbsp;&lt;pluginRepository&gt;<br/>    &nbsp;&nbsp;&lt;id&gt;tycho-staged&lt;/id&gt;<br/> &nbsp;&nbsp;&lt;url&gt;&lt;NEXUS_OSS_STAGING_URL&gt;&lt;/url&gt;<br/>  &nbsp;&lt;/pluginRepository&gt;<br/>&lt;/pluginRepositories&gt;<br/></tt>
+
*Close the staging repository and announce the temporary stage URL on tycho-user@eclipse.org:<tt><br/>Subject:&nbsp;please test staged tycho &lt;VERSION&gt; <br/><br/>Tycho release &lt;VERSION&gt; has been staged. For details of new features and bugfixes, see release notes [1]. <br/> Please help by testing the staged build. To use it, change your tycho version to &lt;VERSION&gt; and add snippet [2] to your pom. <br/><br/> We plan to promote this release in one week unless major regressions are found.<br/><br/>Regards,<br/>  Tycho team<br/> <br/>  [1] http://wiki.eclipse.org/Tycho/Release_Notes/&lt;VERSION&gt; <br/>[2]<br/>&lt;pluginRepositories&gt;<br/>  &nbsp;&lt;pluginRepository&gt;<br/>    &nbsp;&nbsp;&lt;id&gt;tycho-staged&lt;/id&gt;<br/> &nbsp;&nbsp;&lt;url&gt;&lt;NEXUS_OSS_STAGING_URL&gt;&lt;/url&gt;<br/>  &nbsp;&lt;/pluginRepository&gt;<br/>&lt;/pluginRepositories&gt;<br/></tt>
 
*Generate site docs for both tycho and tycho-extras using <tt>mvn clean install site site:stage</tt> and check the result in to [http://www.eclipse.org/tycho/sitedocs tycho homepage site docs]  
 
*Generate site docs for both tycho and tycho-extras using <tt>mvn clean install site site:stage</tt> and check the result in to [http://www.eclipse.org/tycho/sitedocs tycho homepage site docs]  
 
*After ~1 week of testing, promote the stage repository on https://oss.sonatype.org/
 
*After ~1 week of testing, promote the stage repository on https://oss.sonatype.org/
Line 24: Line 24:
 
* Announce the release on tycho-user@eclipse.org, tycho-dev@eclipse.org, thanking the contributors:
 
* Announce the release on tycho-user@eclipse.org, tycho-dev@eclipse.org, thanking the contributors:
  
Subject: Tycho milestone <n> released
+
Subject: Tycho <n> released
  
Tycho milestone <n> has been released and is available from maven central.
+
Tycho <n> has been released and is available from maven central.
  
 
See the release notes [1] for details of enhancements and bug fixes in this release.
 
See the release notes [1] for details of enhancements and bug fixes in this release.

Revision as of 10:17, 26 January 2018

This page describes the steps necessary to create releases of the Tycho project.

  • Prepare the Tycho/Release Notes which should provide a quick overview of new features and bug fixes
  • Steps below apply to both tycho and tycho-extras git repositories as these should normally be released together and with the same version
  • Update versions using
    mvn org.eclipse.tycho:tycho-versions-plugin:set-version -DnewVersion=...
  • Commit version change, and create a git tag tycho-<VERSION> (and tycho-extras-<VERSION> respectively) on this commit
  • Update versions (same as above) to next -SNAPSHOT development version and push commit to master branch
  • Make sure you have everything setup (GPG installed!) for deploying to the Nexus OSS repository, see guide
  • Add your credentials for server <OSS_ID> in ~/.m2/settings.xml
  • Sync to release commit and deploy to nexus staging repository:
    mvn clean deploy -Prelease -DforgeReleaseId=<OSS_ID> -DforgeReleaseUrl=https://oss.sonatype.org/service/local/staging/deploy/maven2/ -Dgpg.passphrase=<YOUR_GPG_PASSPAHRASE>
  • Close the staging repository and announce the temporary stage URL on tycho-user@eclipse.org:
    Subject: please test staged tycho <VERSION>

    Tycho release <VERSION> has been staged. For details of new features and bugfixes, see release notes [1].
    Please help by testing the staged build. To use it, change your tycho version to <VERSION> and add snippet [2] to your pom.

    We plan to promote this release in one week unless major regressions are found.

    Regards,
    Tycho team

    [1] http://wiki.eclipse.org/Tycho/Release_Notes/<VERSION>
    [2]
    <pluginRepositories>
     <pluginRepository>
      <id>tycho-staged</id>
      <url><NEXUS_OSS_STAGING_URL></url>
     </pluginRepository>
    </pluginRepositories>
  • Generate site docs for both tycho and tycho-extras using mvn clean install site site:stage and check the result in to tycho homepage site docs
  • After ~1 week of testing, promote the stage repository on https://oss.sonatype.org/
    • Only drop the staging repository once the artifacts have reached Maven central.
  • Push the release tags to git: git push origin --tags
  • Browse the Tycho wiki pages to update any hardcoded tycho versions to the latest version
  • Update tycho-demo projects to the latest release
  • Find out who contributed to the release:
git log --pretty=format:%an tycho-0.<n>..tycho-0.<n+1> | sort | uniq
git log --grep="Also-[bB]y:" tycho-0.<n>..tycho-0.<n+1> | grep -i also-by | sed -e 's/.*Also-[bB]y:\s*\(.*\)/\1/' | sort | uniq
  • Announce the release on tycho-user@eclipse.org, tycho-dev@eclipse.org, thanking the contributors:

Subject: Tycho <n> released

Tycho <n> has been released and is available from maven central.

See the release notes [1] for details of enhancements and bug fixes in this release.

Thanks to

<contributors>

who contributed patches for this release.

And thanks and to everyone who helped us with testing the staged version.

Regards, Tycho team

[1] http://wiki.eclipse.org/Tycho/Release_Notes/<n>


Back to the top