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.
Difference between revisions of "EMF Compare/Build"
(→Creating the release build) |
|||
| (42 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
= Build job locations = | = Build job locations = | ||
| − | '''The latest version can always be built with the '' | + | '''The latest version can always be built with the ''master-nightly'' job.''' |
| − | * Master : https://hudson.eclipse.org/ | + | * Master : https://hudson.eclipse.org/emfcompare/job/master-nightly/ |
| − | * 1.3.* : https://hudson.eclipse.org/ | + | * 3.2.* : https://hudson.eclipse.org/emfcompare/job/maintenance-3.2/ |
| − | * 1.2.* : https://hudson.eclipse.org/ | + | * 3.1.* : https://hudson.eclipse.org/emfcompare/job/maintenance-3.1/ |
| − | * 1.1.* : https://hudson.eclipse.org/ | + | * 2.1.* : https://hudson.eclipse.org/emfcompare/job/maintenance-2.1/ |
| + | * 1.3.* : https://hudson.eclipse.org/emfcompare/job/archived-1.3/ | ||
| + | * 1.2.* : https://hudson.eclipse.org/emfcompare/job/archived-1.2/ | ||
| + | * 1.1.* : https://hudson.eclipse.org/emfcompare/job/archived-1.1/ | ||
| + | |||
| + | = p2 repositories (a.k.a. update sites) locations = | ||
| + | |||
| + | [[EMF Compare]] builds are stored in [[Equinox/p2|p2]] repositories that are produced as part of the build process. This section provides an overview of the different repositories maintained by the EMF Compare project, and their corresponding location and [[Eclipse/Repository retention policy| retention policy]]. | ||
| + | |||
| + | EMF Compare update sites are located on the server <code>build.eclipse.org</code> within the folder <code>/home/data/httpd/download.eclipse.org/modeling/emf/compare/updates</code>. | ||
= Launching a Build = | = Launching a Build = | ||
| Line 12: | Line 21: | ||
Members of the EMF Compare team are the only persons that can launch builds. You will need to be connected to hudson and on the page of the job you want to run (see above). | Members of the EMF Compare team are the only persons that can launch builds. You will need to be connected to hudson and on the page of the job you want to run (see above). | ||
| − | + | The build takes a single parameter, the reference target platform, which determines the target eclipse version. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
= Promotion Instructions = | = Promotion Instructions = | ||
| − | + | * Launch build on the required hudson job. Let's assume here that you build the latest version through job ''master-nightly''. | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | * Launch build on the required hudson job. Let's assume here that you build the latest version through job '' | + | |
* Once the build has passed | * Once the build has passed | ||
| − | ** | + | ** Look at the log and search for the string "org.eclipse.emf.compare-feature/target" |
| − | + | ** Just a few lines under that is "The project's OSGi version is x.x.x.yyyyMMddhhmm" | |
| − | ** | + | ** Copy that version |
| − | + | * Go to the manual publishing job at https://hudson.eclipse.org/emfcompare/job/publish-milestone-manual | |
| − | * | + | |
| − | * | + | |
| − | + | ||
| − | + | ||
| − | + | This build takes two parameters, none of which can be empty: | |
| − | + | * '''QUALIFIER''' is the version you've copied just above. Paste it in there. | |
| + | * '''ALIAS''' is the human readable name for this milestone. By convention, this is "x.x.x<optional milestone name>", for example 3.3.1M7 or 3.3.1RC2. | ||
| − | + | Once the build completes, we need to tag the repository | |
| + | * Open a terminal at the location of the emf compare clone | ||
| + | * checkout the commit that was built as this milestone if it's not the HEAD | ||
| + | * Tag the commit | ||
| + | ** git tag -a '2.1.0M7' -m 'EMF Compare 2.1.0M7 - Luna M7 - 201305060839' | ||
| + | *: (git tag -a '<alias>' -m '<message>') | ||
| + | * Make sure you've tagged the right commit for this milestone | ||
| + | ** git show 2.1.0M7 | ||
| + | * Push the tag | ||
| + | ** git push origin 2.1.0M7 | ||
| − | + | = Changing the aggregator (simultaneous release) = | |
| − | + | ||
| − | ''' | + | * Clone the simrel repository |
| + | ** ''git clone ssh://<user>@git.eclipse.org:29418/simrel/org.eclipse.simrel.build.git/'' | ||
| + | * Install the aggregation editor in the eclipse where you'll change the aggregation (for an Eclipse 4.6 (Neon), it can be installed from http://download.eclipse.org/cbi/updates/aggregator/ide/4.6) | ||
| + | * Checkout the simrel project in your eclipse, on the accurate branch (e.g. Juno_maintenance for Juno, master for the current release train) | ||
| + | * Open the main simrel file (simrel.aggr) with the aggregation editor | ||
| + | * Locate the EMF Compare entry, and change the update site it references so that it points toward the latest milestone (it should be available at "http://download.eclipse.org/modeling/emf/compare/updates/milestones/x.x/SyyyyMMddhhmm", "x.x" and "yyyyMMddhhmm" being the parts of the qualifier you used above to start the publishing job). | ||
| + | * Make sure that the file validates (right-click within the editor, then select "Validate Aggregation") | ||
| + | * Commit and push the modification for review | ||
| + | ** There should only be changes in the ''emf-compare.aggrcon'' file. | ||
| + | * If the review is succesfully verified by hudson, +2 and push it to the repository. | ||
| − | * Go to the | + | = Producing the Release build |
| − | + | * Go to the manual publishing job at https://hudson.eclipse.org/emfcompare/job/publish-release-manual | |
| − | * | + | * This build takes a single parameter, '''QUALIFIER''', which should be of the form x.x.x.yyyyMMddhhmm. Reconstruct it by looking at the update site url for the build you're trying to promote (from https://www.eclipse.org/emf/compare/downloads/) |
| − | + | * Start the build and check that the target's "R" update site exists and contains this version of EMF Compare | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | * | + | |
| − | + | ||
| − | + | ||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
| − | |||
[[Category:EMF Compare]] | [[Category:EMF Compare]] | ||
Latest revision as of 10:31, 12 May 2017
Contents
Build job locations
The latest version can always be built with the master-nightly job.
- Master : https://hudson.eclipse.org/emfcompare/job/master-nightly/
- 3.2.* : https://hudson.eclipse.org/emfcompare/job/maintenance-3.2/
- 3.1.* : https://hudson.eclipse.org/emfcompare/job/maintenance-3.1/
- 2.1.* : https://hudson.eclipse.org/emfcompare/job/maintenance-2.1/
- 1.3.* : https://hudson.eclipse.org/emfcompare/job/archived-1.3/
- 1.2.* : https://hudson.eclipse.org/emfcompare/job/archived-1.2/
- 1.1.* : https://hudson.eclipse.org/emfcompare/job/archived-1.1/
p2 repositories (a.k.a. update sites) locations
EMF Compare builds are stored in p2 repositories that are produced as part of the build process. This section provides an overview of the different repositories maintained by the EMF Compare project, and their corresponding location and retention policy.
EMF Compare update sites are located on the server build.eclipse.org within the folder /home/data/httpd/download.eclipse.org/modeling/emf/compare/updates.
Launching a Build
Members of the EMF Compare team are the only persons that can launch builds. You will need to be connected to hudson and on the page of the job you want to run (see above).
The build takes a single parameter, the reference target platform, which determines the target eclipse version.
Promotion Instructions
- Launch build on the required hudson job. Let's assume here that you build the latest version through job master-nightly.
- Once the build has passed
- Look at the log and search for the string "org.eclipse.emf.compare-feature/target"
- Just a few lines under that is "The project's OSGi version is x.x.x.yyyyMMddhhmm"
- Copy that version
- Go to the manual publishing job at https://hudson.eclipse.org/emfcompare/job/publish-milestone-manual
This build takes two parameters, none of which can be empty:
- QUALIFIER is the version you've copied just above. Paste it in there.
- ALIAS is the human readable name for this milestone. By convention, this is "x.x.x<optional milestone name>", for example 3.3.1M7 or 3.3.1RC2.
Once the build completes, we need to tag the repository
- Open a terminal at the location of the emf compare clone
- checkout the commit that was built as this milestone if it's not the HEAD
- Tag the commit
- git tag -a '2.1.0M7' -m 'EMF Compare 2.1.0M7 - Luna M7 - 201305060839'
- (git tag -a '<alias>' -m '<message>')
- Make sure you've tagged the right commit for this milestone
- git show 2.1.0M7
- Push the tag
- git push origin 2.1.0M7
Changing the aggregator (simultaneous release)
- Clone the simrel repository
- git clone ssh://<user>@git.eclipse.org:29418/simrel/org.eclipse.simrel.build.git/
- Install the aggregation editor in the eclipse where you'll change the aggregation (for an Eclipse 4.6 (Neon), it can be installed from http://download.eclipse.org/cbi/updates/aggregator/ide/4.6)
- Checkout the simrel project in your eclipse, on the accurate branch (e.g. Juno_maintenance for Juno, master for the current release train)
- Open the main simrel file (simrel.aggr) with the aggregation editor
- Locate the EMF Compare entry, and change the update site it references so that it points toward the latest milestone (it should be available at "http://download.eclipse.org/modeling/emf/compare/updates/milestones/x.x/SyyyyMMddhhmm", "x.x" and "yyyyMMddhhmm" being the parts of the qualifier you used above to start the publishing job).
- Make sure that the file validates (right-click within the editor, then select "Validate Aggregation")
- Commit and push the modification for review
- There should only be changes in the emf-compare.aggrcon file.
- If the review is succesfully verified by hudson, +2 and push it to the repository.
= Producing the Release build
- Go to the manual publishing job at https://hudson.eclipse.org/emfcompare/job/publish-release-manual
- This build takes a single parameter, QUALIFIER, which should be of the form x.x.x.yyyyMMddhhmm. Reconstruct it by looking at the update site url for the build you're trying to promote (from https://www.eclipse.org/emf/compare/downloads/)
- Start the build and check that the target's "R" update site exists and contains this version of EMF Compare