Difference between revisions of "Kepler/Simultaneous Release Plan"
(removed "under development" clause.)
(remove link that doesn't exist yet)
|Line 1:||Line 1:|
This document is for primarily for developers of the June 2013 Kepler [[Simultaneous Release]].
This document is for primarily for developers of the June 2013 Kepler [[Simultaneous Release]]. Users and consumers should see the [http://www.eclipse.org/kepler/ general Eclipse page for Kepler] (which typically becomes available around April or May before the release).
Users and consumers should see the [http://www.eclipse.org/kepler/ general Eclipse page for Kepler] (which typically becomes available around April or May before the release).
Revision as of 18:21, 1 February 2013
This document is for primarily for developers of the June 2013 Kepler Simultaneous Release.
- 1 Requirements For Participation
- 2 Milestones and Release Candidates
- 3 Communication Channels
- 4 Builds and P2 repository
- 5 Service Releases
Requirements For Participation
Projects that are part of Kepler agree to abide by the requirements of the Eclipse yearly Simultaneous Release.
Milestones and Release Candidates
The Release is always on the fourth Wednesday of June. The milestone dates are at roughly 6 week intervals. Any end-of-cycle release-candidate (RC) dates are typically one week apart. Each project has their deliveries due at times offset from the end-date, so that the project dependencies can come together in a reasonable order. These delivery times are based on the dependencies between projects. They are labeled +0, +1, +2, and +3, with +0 coming first (the Platform) and +3 coming last (EPP). Projects themselves decide if they are +0, +1, +2, or +3. The actual time-offset represented by these intervals change over the course of the year of development, being several days at first, but then only one day near the end of the release. The following calendar is the official schedule of the overall Kepler Release. Projects are free to have their own schedules as long as they meet the Kepler deliverables.
Note that projects choose their own +n category based on major or primary dependencies. There are many cases where a project might have to deliver pieces of their code a little earlier, if some project depends on it, or a little later if they have a stray dependency. These sorts of deviations are left to the projects to work out, pair-wise, among themselves. Feel free to bring up complicated cases for discussion.
Given all these constraints, the exact dates for any particular year are pretty predictable. The following table summarizes the most significant Kepler dates, but see the subsequent calendar for the important details. That is, your stuff is due earlier than these table dates! Projects need to deliver a week or two before these "end dates", depending on their chosen, committed offset category (+0, +1, etc).
After RC4 is quiet week. There will be no further builds. That time is reserved for final, in depth testing, and preparation for release. Emergency rebuilds might be considered, by following the usual Planning Council Exception Process, but only for serious, blocking regressions.
Elapsed Weeks End Date Span from +0 for RC0 for EPP avail M1 Friday, August 24, 2012 08/10 to 08/24 6 8 (from previous release GA) M2 Friday, October 05 09/21 to 10/05 6 6 (from M1) M3 Friday, November 16 11/02 to 11/16 6 6 (from M2) M4 Friday, December 21 12/14 to 12/21 6 5 (from M3) (shift from 2 week window to 1 week window) M5 Friday, February 08, 2013 02/01 to 02/08 7 7 (from M4) (extra week for end of year holidays) M6 Friday, March 22 03/15 to 03/22 6 6 (from M5) EclipseCon! (03/25 to 03/28) M7 Friday, May 10 05/03 to 05/10 7 7 (from M6) (extra week for EclipseCon) RC1 Friday, May 24 05/17 to 05/24 2 2 (from M7) RC2 Friday, May 31 05/24 to 05/31 1 1 (from RC1) RC3 Friday, June 07 05/31 to 06/07 1 1 (from RC2) RC4 Friday, June 14 06/07 to 06/14 1 1 (from RC3) Quiet week, June 17 to June 21 (no builds during "quiet time", assumed all code is done by end of RC4 Release Wednesday, June 26, 2013
Cross-Project Milestone & RC Status Reporting
Only negative status needs to be reported. It is essential for many aspect of the simultaneous release that communication be prompt and clear, on many topics. One of the most important ones, is if someone is not meeting some date or delivery. Put another way, we assume everyone is on target and has delivered their stuff unless a note is sent to cross-project list that you are delayed. Its better to be up front about it, so everyone knows what to expect, rather than to hope things turn out ok at the very last minute, since if you "miss" without saying anything you are more likely to impact other people, and miss your chance to be part of the release.
Mailing Lists and Newsgroups
Eclipse projects have three communication channels: a mailing list for developers, a newsgroup for users, and Bugzilla. While Kepler is not a "project" per se, it will use the same structure:
Developer mailing list
- cross-projects-issues-dev - mailing list for developers and releng (see archives). This is the list to use to discuss build issues, announce changes in plans, slippage in deliverables, etc.
Users news group
If there is any doubt about where a bug belongs, it can always start in the "Cross-Project" component. (Under Eclipse Foundation > Community). If it turns out to be a single-project's responsibility, it can be moved to that project. If it is a true cross-project bug, where several projects need to act, then it can stay in the cross-project component.
The Planning Council Mailing List
Because there has been confusion in the past, we'll be explicit here that the planning council mailing list (eclipse.org-planning-council) is for Planning Council business, not the Kepler Release activities per se. While they sometimes overlap, there is no need to cross post. While anyone can request a subscription to the planning council list (for openness and transparency) the expectation is that only Planning Council members post to it.
But there are no planned calls for the release, per se, or for larger audiences, but they can be arranged if required or desired (for example, if needed for build coordination).
Builds and P2 repository
This section, about assembling the repositories, is subject to change, as improvements in the process are made.
A number of utilities have been written to automate the assembly of Callisto '06, Europa '07, Ganymede '08, Galileo '09, Helios '10, Indigo '11 and now Kepler '12 builds. These are available in their own CVS repository. You can find more information about the history and organization by looking at some of the old, previous information on the Contributing to Helios Build, Galileo Build, Ganymede Build and Europa Build pages).
With Kepler we are using the b3 Aggregator.
The Contributing to Simultaneous Build page is where you go to learn how to add your project to the Kepler build (aggregation).
To obtain the latest published bits from Kepler, use this URL:
It contains the latest milestone, release candidate, eventually the release itself, and then eventually service releases.
To obtain the latest working version, as we build up to a milestone or release, you can test the site at
Coordinated Service Releases are (always) scheduled for the fourth Friday of September, and the fourth Friday of February. Individual Projects may have their own, of course, at any time, if they need to, but all participants in the Yearly Release, are expected to participate in the Coordinated Service Releases. What bugs are fixed, if any, is up to each Project to decide, but each Project must continue to "fit in", build, install, avoid conflicts, etc.
Instead of "staging", the roll-out of service releases are kept at
until the release, at which time the service release joins the release (via composite repository) at the ".../releases/kepler" site.
GA: 9/27/2013 (fourth Friday of September)
In the SR1 rampdown, as shown in the following table, there will be 4 RCs, each one of those spanning just one week, with projects staging themselves into the build just one day apart.
Projects may elect not to participate in any particular RC (and just contribute what's already there), but projects do have an obligation to fix any build problems that are related to their code or p2 repositories during each RC, if any such problems arise.
RC1 is really a "warm-up" RC, just to make sure we can still build, etc. Subsequent RCs are expected to be true "Release Candidates", suitable for acceptance testing, etc.
The Final week before GA will not have any further builds or contributions, but instead be reserved for final adopter testing and site preparations. Only emergency fixes for very serious regressions that effect many projects or the general ability to install or update will be considered as a reason to rebuild during the final quiet week.
The 'promote period' (9/23 to 9/26) will be the time projects put final zips and repository artifacts in their final release location (but, without displaying them or making them visible to p2) so they can propagate through the mirroring system (but not generally be "visible" to end users or p2, so that there really is a "simultaneous maintenance release"). At 9 AM (Eastern) on the GA date projects can make their final maintenance releases visible. (Be sure to check cross-project list, first, to make sure there's not any last-minute blocking problems or changes to exact times).
Note: the due time is 5 PM (Eastern) and availability time is 9 AM (Eastern) unless otherwise communicated on cross-project list.
| Available |
|Kepler SR1 ("GA")||quiet: 9/20||quiet: 9/23||quiet: 9/24||quiet: 9/25||quiet: 9/26||GA: 9/27|
2/28/2014 (fourth Friday of February)
Rampdown principles similar to SR1.
| Available |
|Kepler SR2 ("GA")||quiet: 2/21||quiet: 2/24||quiet: 2/25||quiet: 2/26||quiet: 2/27||GA: 2/28|