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 "Reviews/R4E/Release Howto"

< Reviews‎ | R4E
(References)
(References)
Line 154: Line 154:
 
#[http://wiki.eclipse.org/Equinox/p2/p2.mirrorsURL p2.mirrorsURL]
 
#[http://wiki.eclipse.org/Equinox/p2/p2.mirrorsURL p2.mirrorsURL]
 
#[https://hudson.eclipse.org/hudson/job/mylyn-reviews-r4e-release/ Hudson R4E Release Job]
 
#[https://hudson.eclipse.org/hudson/job/mylyn-reviews-r4e-release/ Hudson R4E Release Job]
#[http://eclipse.org/projects/ip_log.php?projectid=mylyn.reviews.r4e R4e approved CQs / IP log]
+
#[http://eclipse.org/projects/ip_log.php?projectid=mylyn.reviews.r4e R4E approved CQs / IP log]
 
#[http://www.eclipse.org/projects/project-plan.php?projectid=mylyn.reviews.r4e R4E Project plan]
 
#[http://www.eclipse.org/projects/project-plan.php?projectid=mylyn.reviews.r4e R4E Project plan]
 
#[http://www.eclipse.org/r4e/ R4E New &amp; Noteworthy]
 
#[http://www.eclipse.org/r4e/ R4E New &amp; Noteworthy]

Revision as of 16:33, 10 January 2013

Warning2.png
Draft Content
This page is currently under construction. Community members are encouraged to maintain the page, and make sure the information is accurate.


This document is based on Mylyn Release Howto

This document is targeting minor releases and needs to be completed to cover Major releases as R4E moves out of incubation.

Before the Release

Prepare Build Environment

TBD for Major releases

Create a Branch

TBD for major releases

Prepare Source Code

Internationalize Messages

  • Run Source > Find Broken Externalized Strings over all bundles
  • Run Source > Externalize Strings over all bundles

Update User Guide

  • Adjust org.eclipse.mylyn.reviews.r4e.help/build-r4e-help.xml to set proxies as well as the plugin directory of the eclipse installation to use to find the Mylyn wikitext plug-ins
  • Run org.eclipse.mylyn.reviews.r4e.help/build-r4e-help.xml as an Ant Build
  • Review the user guide changes and then commit

Update Copyright Notices

  • Update the year in the about.ini to the current year
  • Update the year in all feature.xml files to the current year for changed features
  • Update the year in copyright notices of changed source files: Install platform releng tools, Project context menu > Fix Copyrights
  • Use the following script (under the r4e source repository) to find files without copyrights
tools/findNotCopyRight

Backport changes to the Platform Specific Branches

TBD

Update Integration Repository

TBD (No subprojects under R4E)

Run Tests

TBD - This is covered in a later step I.e. when using a Hudson release build job.

The Release

Update Targets

  • Update target files in org.eclipse.mylyn.reviews.r4e-target to point to release sites of dependencies e.g. Mylyn, Egit/Jgit to ensure builds are reproducible in the future

Build

Verify Update Site Contents

From the artifact(s) produced by the build

  • Check that only approved features are on the update site
  • Check that all Orbit bundles are tracked in r4e approved CQs

Prepare Download Area

The build job will publish the update site to "build.eclipse.org" at /shared/download-staging.priv/r4e/staging/

  • Log into buld.eclipse.org i.e. using and SFTP or SCP client (such as WinSCP, CoreFTP) in SSH mode
    • Copy the Release to /home/data/httpd/download.eclipse.org/r4e/staging
    • Test install from http://download.eclipse.org/r4e/staging/
    • Move /home/data/httpd/download.eclipse.org/r4e/updates to /home/data/httpd/download.eclipse.org/r4e/updates_prev
    • Copy the Release to /home/data/httpd/download.eclipse.org/r4e/updates
    • Copy the Release to /home/data/httpd/download.eclipse.org/r4e/drops
      Remove any preliminary integration builds if any e.g. /home/data/httpd/download.eclipse.org/r4e/drops/0.13.0.I*
    • Copy Release to archive.eclipse.org
      E.g. /home/data/httpd/archive.eclipse.org/r4e/drops/....v.../
  • Add mirror URLs
    • Update the downloads update site to include the p2.mirrorsURL
      I.e. at /home/data/httpd/download.eclipse.org/r4e/drops/
    • Check that the aritifacts.jar contains the following property:
 <property name="p2.mirrorsURL"  value="http://www.eclipse.org/downloads/download.php?file=/r4e/drops/....v..../&format=xml"/>

Test Install

Tag Sources

  • Tag with the version as vx.y.z (e.g. v0.13.0):
org.eclipse.mylyn.reviews.r4e
  • Push tags
git push --tags

Update Release Repository Content

TBD - Not using composite repositories at the moment

Create API Baseline

  • major releases Create an API baseline zip

An API baseline is in essence a zip file of the release update site "plugins" folder excluding *source*.jar and documentation jar files.

See an example script at

git repo url = http://git.eclipse.org/gitroot/mylyn/org.eclipse.mylyn.git
path: org.eclipse.mylyn.releng/bin/create-api-profile.sh

Place the new API baselines at

/home/data/httpd/download.eclipse.org/r4e/drops/api_baseline/

Update Website

  • Update the version number on download page
  • Create a new section on download archive page [TBD]
  • Create a new section in the New & Noteworthy
  • Archive project plan in the r4e web repository under "plans"
  • major releases Add a link to the new API baseline on the download archive page and update the developer page

Update Babel

  • Make release available in Eclipse Babel for translation (major releases only)

Announce Release

Update Eclipse Info Center (major release)

After the Release

Update Versions

  • Bump up versions to next release using the following script available from the r4e source repository
"tools/update-versions.sh"

Create New Download Area

TBD - The following steps are not being used at the moment although might be needed as we maintain release branches see base document for details

  • Create download directory (TBD)
  • major release Create snapshot site

Add Bugzilla Versions and Milestones

From the Eclipse portal

  • Add Bugzilla Milestones for the next release
  • major release Add Bugzilla Version for the current release

Update Project Plan

Project Plan Guide

  • major release Update versions and queries in all plan.xml documents (from web repository)
  • major release Update release plans in portal

References

  1. Mylyn Release Howto
  2. Development Resources
  3. Eclipse portal
  4. p2.mirrorsURL
  5. Hudson R4E Release Job
  6. R4E approved CQs / IP log
  7. R4E Project plan
  8. R4E New & Noteworthy
  9. mylyn-reviews-dev mailing list
  10. mylyn-announce mailing list
  11. Mylyn news group forum
  12. R4E Blog

Back to the top