DTP Build Transition
This page describes the changes that will occur when the DTP build transitions from the current system to a PDE based build infrastructure. While the output of both build systems is functionally equivalent, there are some details that will impact both DTP committers and consumers of DTP.
Note: There is a tool, described on this page that helps with tagging and updating map files.
The new DTP build process will use map files. These files specify the features and plug-ins to be included in the build. Further, map files specify a CVS tag for each plug-in and feature. The use of map files is fairly common among Eclipse Foundation projects and brings a number of advantages:
- Committers can use tags to manage which code appears in which build.
- Committers can update the map files to add or remove plug-ins.
- Consumers of DTP interested in duplicating the build process have a specification of exactly what code was used for a given build.
The map files for DTP will be kept in the org.eclipse.datatools.releng CVS module, to which all DTP committers have write access.
There are 5 map projects to hold DTP map files. Each sub-project now has its own "releng" project. (Incubator will also be changed as soon as we finish up a committer election.) So now you have:
HEAD/org.eclipse.datatools.connectivity/releng/org.eclipse.datatools.connectivity.releng HEAD/org.eclipse.datatools.enablement/releng/org.eclipse.datatools.enablement.releng HEAD/org.eclipse.datatools.modelbase/releng/org.eclipse.datatools.modelbase.releng HEAD/org.eclipse.datatools.sqltools/releng/org.eclipse.datatools.sqltools.releng HEAD/org.eclipse.datatools.releng
We will keep entires for top-level features and doc plugins in the top-level map project. And other 4 are used to hold plugin entries for each sub-projects.
Naturally, with power comes responsibility. Aside from the obvious requirement to keep the map files and CVS tags current, committers should be very care when adding or removing plug-ins, since doing so can introduce dependencies and build breakage. Therefore, aside from update the existing tags used in the map files, we encourage committers to file bugs with proposed changes (additions/removals/etc.) for review by the release engineering team and PMC before making such changes.
Use of ".qualifier"
As described in the DTP Plug-in Versioning Policy, "A DTP plug-in version number has four fields, separated by a ".": Major.Minor.Service.Qualifier"
Previously DTP committers where required to update the qualifier field with each plug-in change. Starting with the new build system, the time stamps in all DTP 1.6 plug-ins will be changed to ".qualifier" and the DTP build process will control update of these values.
For DTP builds, the source code will be taken from the tags specified in the map files, and the ".qualifier" field in each plug-in will be stamped with the value of the tag. The DTP Plug-in Versioning Policy details the format of the tags.
Format of Distribution Version Stamp
Currently DTP distributions (end user and extender zips) have the following format:
with the exact time stamp varying according to the build date. In the new build system, the format will be like:
again, with the exact time stamp varying according to the build date. Consumers relying on a specific format (say for automatic consumption in a build process) might need to update their matching patterns for this change.
- Nightly builds take place from Monday to Thursday. Integration builds takes place on Friday.
- DTP builds will take place at 5am (Shanghai time).
- DTP committers should refrain from updating map files for +/- 30 minutes around the start of the build, to avoid version inconsistencies in the map file set.
Contacting the Build Team
There are a number of ways to contact the build team:
- Create a Bugzilla entry for DTP, using the "releng" component
- Send mail to the DTP development mailing list