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 "EASE/Build"

(Created page with "EASE is based on a maven/tycho build. = Manual Build = = Integration Server = The main hudson integration server is available under: https://hudson.eclipse.org/ease/ == Jo...")
 
m
 
(41 intermediate revisions by the same user not shown)
Line 2: Line 2:
  
 
= Manual Build =
 
= Manual Build =
 +
The build requires to have git and maven installed.
 +
 +
== EASE Core ==
 +
 +
git clone https://git.eclipse.org/r/ease/org.eclipse.ease.core
 +
cd org.eclipse.ease.core
 +
mvn clean install
 +
 +
After the build is finished, there is a local update site available from releng/org.eclipse.ease.releng.p2/target/repository
 +
 +
== EASE Modules ==
 +
 +
git clone https://git.eclipse.org/r/ease/org.eclipse.ease.modules
 +
cd org.eclipse.ease.modules
 +
mvn clean install
 +
 +
After the build is finished, there is a local update site available from releng/org.eclipse.ease.modules.releng.p2/target/repository
  
 
= Integration Server =
 
= Integration Server =
  
−
The main hudson integration server is available under: https://hudson.eclipse.org/ease/
+
The main hudson integration server is available at: https://ci.eclipse.org/ease/
 +
 
 +
 
 +
== Release Process ==
 +
 
 +
Integrate pending patchsets:
 +
 
 +
# search for open gerrit topics https://git.eclipse.org/r/#/q/projects:+ease+status:pending
 +
# integrate patchsets for release
 +
 
 +
 
 +
Build binaries:
 +
 
 +
# run the release build job https://ci.eclipse.org/ease/job/ease.build.release/
 +
 
 +
 
 +
Create release tags:
 +
 
 +
# make sure your git repos are up to date
 +
# Switch to 'Git Repositories' view
 +
# select <Repository>/Tags
 +
# select context menu 'Create Tag...'
 +
# set Tag name to 'ease-0.x.0', set Tag message to 'release 0.x.0' (adapt major/minor version)
 +
# click 'Create Tag and Start Push...', finish the wizard
 +
# repeat procedure for all repositories:
 +
#* http://git.eclipse.org/c/ease/org.eclipse.ease.core.git/
 +
#* http://git.eclipse.org/c/ease/org.eclipse.ease.modules.git/
 +
#* http://git.eclipse.org/c/ease/org.eclipse.ease.scripts.git/
 +
 
 +
 
 +
Maintain Bugzilla:
 +
 
 +
# verify that bugs are in '''CLOSED''' state and not ony '''RESOLVED''' ([https://bugs.eclipse.org/bugs/buglist.cgi?bug_status=RESOLVED&list_id=11658072&product=Ease&query_format=advanced find resolved bugs])
 +
# verify that '''Target Milestone''' is set to the upcoming release name ([https://bugs.eclipse.org/bugs/buglist.cgi?bug_status=CLOSED&list_id=17307754&product=Ease&query_format=advanced&resolution=FIXED&resolution=WORKSFORME&target_milestone=--- find bugs not related to a milestone])
 +
 
 +
 
 +
Maintain Release Description:
 +
 
 +
# switch to https://projects.eclipse.org/projects/technology.ease
 +
# open the upcoming release and maintain release information
 +
 
 +
 
 +
Follow the [https://wiki.eclipse.org/Development_Resources/HOWTO/Release_Reviews Eclipse release process]:
  
−
== Job Description ==
+
# create an [https://www.eclipse.org/projects/ip_log.php?projectid=technology.ease automated IP Log] for EASE
 +
# verify that the log is correct and send it by pushing the '''Submit For Review''' button. You will receive a link to a CQ on the following page. That link will be needed in the next steps.
 +
# once the IP log is submitted, development on the master branch may continue
 +
# send an email to technology-pmc@eclipse.org [https://accounts.eclipse.org/mailing-list/technology-pmc mailing list], requesting release approval.
 +
'''Subject:''' PMC approval request for EASE v0.7.0 release
 +
Dear PMCs,
 +
 +
I would like to request your approval for the upcoming EASE v0.7.0 release [1]
 +
 +
The project's IP Log has been submitted [2].
 +
 +
thanks
 +
Christian
 +
 +
[1] https://projects.eclipse.org/projects/technology.ease/releases/0.7.0
 +
[2] https://dev.eclipse.org/ipzilla/show_bug.cgi?id=20399
  
−
;ease-milestone
+
# wait for the IP log and PMC approval
−
: creates a milestone build
+
  
−
;ease-nightly
+
=== Schedule the review ===
−
: nightly build. Builds from master branch and updates p2 night update site
+
  
−
;ease-build-branch
+
See [https://wiki.eclipse.org/Development_Resources/HOWTO/Review_Process Review Process]
−
: Checks out a dedicated branch (set as parameter) and hands over to ease-base-build
+
  
−
;ease-base-build
+
# switch to the release page https://projects.eclipse.org/projects/technology.ease, select the release and select 'Schedule a review for this release.'
−
: Generic maven build.needs a configured workspace to run upon.
+
  
−
;ease-sonar
+
Create & update release binaries:
−
: Builds master branch and analyses code for sonar integration
+
  
−
;ease-verify-*
+
# run [https://hudson.eclipse.org/ease/job/ease-release/build?delay=0sec ease-release] on the [https://hudson.eclipse.org/ease/ Hudson server]. Building is save and does not alter official download locations. Build will run from master branch by default. If you want to build from a release branch, the job needs to be adapted.
−
: Jobs for gerrit verification builds. Used to provide +1/-1 to gerrit commits
+
# on a failure: fix the problem, back to step 1
 +
# promote the build and set the version parameter correctly (eg 0.5.3). After promotion the update sites and download locations are updated and live.
 +
# on a failure: fix the problem, back to step 1
 +
# create a tag named ease_${version} (eg ease_0.5.3) for each of the following repositories:
 +
#* http://git.eclipse.org/c/ease/org.eclipse.ease.core.git/
 +
#* http://git.eclipse.org/c/ease/org.eclipse.ease.modules.git/
 +
#* http://git.eclipse.org/c/ease/org.eclipse.ease.scripts.git/
 +
# push created tags
 +
# update the [https://wiki.eclipse.org/EASE/Releases Release Notes wiki page]
 +
# update the [http://git.eclipse.org/c/www.eclipse.org/ease.git/tree/download/index.php download/index.php] page location
 +
# add a news entry to the [http://git.eclipse.org/c/www.eclipse.org/ease.git/tree/news news folder]
 +
# post an update to the [https://dev.eclipse.org/mailman/listinfo/ease-dev mailing list]
  
 +
Prepare next release:
 +
# [https://bugs.eclipse.org/bugs/enter_bug.cgi?product=EASE&rep_platform=All&op_sys=All create a bugzilla entry] titled: Release preparations for v0.7.0
 +
# update plugin/feature versions to next revision (0.8.0 -> 0.9.0); best use search/replace on the whole workspace
 +
#* search/replace '<version>0.8.0-SNAPSHOT</version>' for pom.xml files
 +
#* search/replace 'Bundle-Version: 0.8.0.qualifier' for MANIFEST.MF files
 +
#* search/replace 'version="0.8.0.qualifier"' for feature.xml files
 +
#* also update /plugins/pom.xml, /features/pom.xml, tests/pom.xml files
 +
# create a new release on the [https://projects.eclipse.org/projects/technology.ease EASE project page] (sidebar: Committer Tools)
 +
# update [https://wiki.eclipse.org/EASE/Roadmap product roadmap]
 +
# maintain bugzilla
 +
#* switch to the [https://dev.eclipse.org/site_login/myaccount.php my account] page
 +
#* select 'Bugzilla Manager' from the Committer Tools
 +
#* select 'Edit' from Bugzilla Management
 +
#* add a new Bugzilla version using the release name (eg. 0.5.3)
 +
#* add a new Bugzilla milestone for the upcoming version (eg. 0.6.0). Make sure the Sort key is smaller than the one from the previous release. This will list the upcomping release on the topmost position of the drop down dialog.
  
 
[[Category:EASE]]
 
[[Category:EASE]]

Latest revision as of 04:16, 22 June 2021

EASE is based on a maven/tycho build.

Manual Build

The build requires to have git and maven installed.

EASE Core

git clone https://git.eclipse.org/r/ease/org.eclipse.ease.core
cd org.eclipse.ease.core
mvn clean install

After the build is finished, there is a local update site available from releng/org.eclipse.ease.releng.p2/target/repository

EASE Modules

git clone https://git.eclipse.org/r/ease/org.eclipse.ease.modules
cd org.eclipse.ease.modules
mvn clean install

After the build is finished, there is a local update site available from releng/org.eclipse.ease.modules.releng.p2/target/repository

Integration Server

The main hudson integration server is available at: https://ci.eclipse.org/ease/


Release Process

Integrate pending patchsets:

  1. search for open gerrit topics https://git.eclipse.org/r/#/q/projects:+ease+status:pending
  2. integrate patchsets for release


Build binaries:

  1. run the release build job https://ci.eclipse.org/ease/job/ease.build.release/


Create release tags:

  1. make sure your git repos are up to date
  2. Switch to 'Git Repositories' view
  3. select <Repository>/Tags
  4. select context menu 'Create Tag...'
  5. set Tag name to 'ease-0.x.0', set Tag message to 'release 0.x.0' (adapt major/minor version)
  6. click 'Create Tag and Start Push...', finish the wizard
  7. repeat procedure for all repositories:


Maintain Bugzilla:

  1. verify that bugs are in CLOSED state and not ony RESOLVED (find resolved bugs)
  2. verify that Target Milestone is set to the upcoming release name (find bugs not related to a milestone)


Maintain Release Description:

  1. switch to https://projects.eclipse.org/projects/technology.ease
  2. open the upcoming release and maintain release information


Follow the Eclipse release process:

  1. create an automated IP Log for EASE
  2. verify that the log is correct and send it by pushing the Submit For Review button. You will receive a link to a CQ on the following page. That link will be needed in the next steps.
  3. once the IP log is submitted, development on the master branch may continue
  4. send an email to technology-pmc@eclipse.org mailing list, requesting release approval.
Subject: PMC approval request for EASE v0.7.0 release
Dear PMCs,

I would like to request your approval for the upcoming EASE v0.7.0 release [1]

The project's IP Log has been submitted [2].

thanks
Christian

[1] https://projects.eclipse.org/projects/technology.ease/releases/0.7.0
[2] https://dev.eclipse.org/ipzilla/show_bug.cgi?id=20399
  1. wait for the IP log and PMC approval

Schedule the review

See Review Process

  1. switch to the release page https://projects.eclipse.org/projects/technology.ease, select the release and select 'Schedule a review for this release.'

Create & update release binaries:

  1. run ease-release on the Hudson server. Building is save and does not alter official download locations. Build will run from master branch by default. If you want to build from a release branch, the job needs to be adapted.
  2. on a failure: fix the problem, back to step 1
  3. promote the build and set the version parameter correctly (eg 0.5.3). After promotion the update sites and download locations are updated and live.
  4. on a failure: fix the problem, back to step 1
  5. create a tag named ease_${version} (eg ease_0.5.3) for each of the following repositories:
  6. push created tags
  7. update the Release Notes wiki page
  8. update the download/index.php page location
  9. add a news entry to the news folder
  10. post an update to the mailing list

Prepare next release:

  1. create a bugzilla entry titled: Release preparations for v0.7.0
  2. update plugin/feature versions to next revision (0.8.0 -> 0.9.0); best use search/replace on the whole workspace
    • search/replace '<version>0.8.0-SNAPSHOT</version>' for pom.xml files
    • search/replace 'Bundle-Version: 0.8.0.qualifier' for MANIFEST.MF files
    • search/replace 'version="0.8.0.qualifier"' for feature.xml files
    • also update /plugins/pom.xml, /features/pom.xml, tests/pom.xml files
  3. create a new release on the EASE project page (sidebar: Committer Tools)
  4. update product roadmap
  5. maintain bugzilla
    • switch to the my account page
    • select 'Bugzilla Manager' from the Committer Tools
    • select 'Edit' from Bugzilla Management
    • add a new Bugzilla version using the release name (eg. 0.5.3)
    • add a new Bugzilla milestone for the upcoming version (eg. 0.6.0). Make sure the Sort key is smaller than the one from the previous release. This will list the upcomping release on the topmost position of the drop down dialog.
Retrieved from "https://wiki.eclipse.org/index.php?title=EASE/Build&oldid=443523"

This page was last modified 04:16, 22 June 2021 by Christian Pontesegger.

Back to the top