Notice: This Wiki is now read only and edits are no longer possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.
Difference between revisions of "WTP Release Tasks"
(→Tasks for All Releases (including Service Releases)) |
(→Elsewhere) |
||
(56 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
For each [[WTP/Releng/Processes|WTP release]], there are a few bookkeeping tasks unrelated to planning, development, and building, that also need tending to. | For each [[WTP/Releng/Processes|WTP release]], there are a few bookkeeping tasks unrelated to planning, development, and building, that also need tending to. | ||
− | They should be recorded here so they're not forgotten. This | + | They should be recorded here so they're not forgotten. This is intended as a living document. |
===Tasks for Major and Minor Releases=== | ===Tasks for Major and Minor Releases=== | ||
− | * | + | * The release should be tagged in all non-releng repositories. |
− | * | + | * Maintenance branch ''may'' created for future adopter patch builds, but this is not typical with quarterly releases and 3 week milestones. Main development will continue in master for the next [https://wiki.eclipse.org/SimRel/Simultaneous_Release_Cycle_FAQ#What_is_the_schedule_of_the_next_releases_.3F quarterly] simultaneous release. |
+ | * A [[:Category:New_Help_for_Old_Friends|New Help for Old Friends]] page created, if required | ||
+ | * June releases typically line up for our mandatory Release Review, and necessitate prepared documentation | ||
===Tasks for All Releases (including Service Releases)=== | ===Tasks for All Releases (including Service Releases)=== | ||
+ | ==== Deliverables==== | ||
+ | * March/September releases coincide with a new Java version: facets need updating | ||
+ | * Copy last RCx to R using [https://hudson.eclipse.org/webtools/view/webtools_CI/job/WTP-Publish/ WTP Publish] job | ||
* R-build GA'd on http://download.eclipse.org/webtools/downloads/, and email sent out declaring it | * R-build GA'd on http://download.eclipse.org/webtools/downloads/, and email sent out declaring it | ||
− | * Marketplace | + | * EPP packages tested, signed-off on, and +1 sent to epp-dev mailing list |
+ | :* Eclipse IDE for Java EE Developers: Chuck and Nitin ([https://wiki.eclipse.org/J2EE_Smoke_Test_(WTP_3.9) Java EE Smoke] and also manual checks to general layout, preferences etc for changes from integrated features like m2e, oomph etc..) | ||
+ | * [http://download.eclipse.org/webtools/repository/latest/ Composite site] updated via [https://hudson.eclipse.org/webtools/view/webtools_CI/job/WTP-Publish-Repo/ WTP Publish Repo job]. Repeat for latest [http://download.eclipse.org/webtools/repository/2020-09 20xx-yy site] | ||
+ | * Marketplace listings created/updated for [https://marketplace.eclipse.org/user/nitind/listings these 3 listings] (contact Nitin D. if you want edit privileges, but try to keep the mandatory features to a minimum) | ||
* [[WTP_FAQ]] installation instructions updated (add versions/numbers/update sites) | * [[WTP_FAQ]] installation instructions updated (add versions/numbers/update sites) | ||
+ | * [[IRC_FAQ]] updated | ||
− | + | ||
− | :* [http://git.eclipse.org/c/www.eclipse.org/webtools.git/tree/common.php <code>/common.php</code>] (linking to Java EE package page and release train update site) | + | ==== [http://git.eclipse.org/c/www.eclipse.org/webtools.git/ Web site updates]==== |
− | + | * Make sure packages/org.eclipse.epp.package.jee.feature/epp.website.xml in ssh://{USER}@git.eclipse.org:29418/epp/org.eclipse.epp.packages points to the correct New and Noteworthy | |
− | + | * [http://git.eclipse.org/c/www.eclipse.org/webtools.git/tree/common.php <code>/common.php</code>] (linking to Java EE package page and release train update site) | |
− | + | * [http://git.eclipse.org/c/www.eclipse.org/webtools.git/tree/releases/index.html <code>/releases/index.html</code>] updated to point to newest release | |
− | + | * New release-specific landing page under [http://git.eclipse.org/c/www.eclipse.org/webtools.git/tree/releases <code>/releases</code>] | |
− | + | :* [http://git.eclipse.org/c/www.eclipse.org/webtools.git/tree/releases/3.9.3/index.xml <code>index.xml</code>] content -> appears on [https://www.eclipse.org/webtools/releases/3.9.3/index.php 3.9.3] page | |
− | + | :* Provide link to a report showing [https://bugs.eclipse.org/bugs/report.cgi?x_axis_field=bug_severity&y_axis_field=product&z_axis_field=&query_format=report-table&short_desc_type=allwordssubstr&short_desc=&classification=WebTools&target_milestone=0.3.3&target_milestone=3.7.3&target_milestone=3.7.3+M1&target_milestone=3.7.3+M2&target_milestone=3.7.3+M3&target_milestone=3.7.3+M4&target_milestone=3.7.3+M5&target_milestone=3.7.3+M6&target_milestone=3.7.3+M7&target_milestone=3.7.3+RC0&target_milestone=3.7.3+RC1&target_milestone=3.7.3+RC2&target_milestone=3.7.3+RC3&target_milestone=3.7.3+RC4&target_milestone=3.9.3&target_milestone=3.9.3+RC0&target_milestone=3.9.3+RC1&target_milestone=3.9.3+RC2&target_milestone=3.9.3+RC3&target_milestone=3.9.3+RC4&target_milestone=3.9.3+RC5&resolution=FIXED&format=table&action=wrap&chfieldfrom=2017-09-01&chfieldto=2018-04-30&chfield=resolution&chfieldvalue=FIXED <code>Bugs fixed</code>] in the release | |
− | + | * New & Noteworthy appears on [https://www.eclipse.org/webtools/development/news/main.php development/news] and its URL listed in PMI | |
+ | * News feed entry published in [http://git.eclipse.org/c/www.eclipse.org/webtools.git/tree/news.xml <code>news.xml</code>] | ||
+ | |||
+ | ==== download.eclipse.org, archive.eclipse.org, build.eclipse.org Site Updates==== | ||
+ | * Add new versions / remove old versions from: [http://build.eclipse.org/webtools/committers/buildbranches.php /shared/webtools/committers/buildbranches.php] | ||
+ | * Add new versions / remove old versions from: [http://download.eclipse.org/webtools/downloads/buildbranches.php /home/data/httpd/download.eclipse.org/webtools/downloads/buildbranches.php] | ||
+ | * Move old releases from download.eclipse.org to archive.eclipse.org. If you don't have permission, [https://bugs.eclipse.org/bugs/show_bug.cgi?id=533631 open a bug]. | ||
+ | :* See [[WTP/Retention_Policy|WTP Retention Policy]], then use [https://hudson.eclipse.org/webtools/job/WTP-Archive/ WTP-Archive] job | ||
+ | * Clean out old Jenkins workspaces / saved builds, old builds from http://build.eclipse.org/webtools/committers/, and old builds from http://download.eclipse.org/webtools/downloads/drops/ | ||
+ | :* Use [https://hudson.eclipse.org/webtools/job/WTP-Disk-Cleanup/ WTP-Disk-Cleanup] job | ||
* Update releng files w/ new versions/dependencies: | * Update releng files w/ new versions/dependencies: | ||
− | :* [http://git.eclipse.org/c/webtools/webtools.releng.aggregator.git/tree/ | + | :* [http://git.eclipse.org/c/webtools/webtools.releng.aggregator.git/tree/wtp-parent/pom.xml parent pom] -> newer Eclipse Platform I build, etc. |
− | :* [http://git.eclipse.org/c/webtools/webtools.releng.aggregator.git/tree/ | + | :* [http://git.eclipse.org/c/webtools/webtools.releng.aggregator.git/tree/webtools.repositories/pom.xml repositories pom] -> controls default build stream value (e.g. 3.25), etc. |
− | :* [http://git.eclipse.org/c/webtools/webtools.releng.aggregator.git/tree/wtp-parent/data/dependencies.properties | + | :* [http://git.eclipse.org/c/webtools/webtools.releng.aggregator.git/tree/wtp-parent/data/dependencies.properties dependencies.properties] |
==== Project Lead Tasks ==== | ==== Project Lead Tasks ==== | ||
− | + | Each [[WTP_Who%27s_Who|project lead]] or a designated Committer should perform these tasks for every release. | |
− | Each [[WTP_Who%27s_Who|project lead]] should perform these tasks for every release. | + | |
* Repositories tagged for the release | * Repositories tagged for the release | ||
Line 35: | Line 52: | ||
* Babel repo/branch set/updated for release | * Babel repo/branch set/updated for release | ||
* Version value created in Bugzilla | * Version value created in Bugzilla | ||
+ | * Project metadata at https://projects.eclipse.org/projects/webtools updated for the release version | ||
+ | * Project metadata at https://projects.eclipse.org/projects/webtools created for the next release, with the New and Noteworthy URL populated | ||
+ | |||
+ | |||
+ | ===== SCM Tagging script ===== | ||
+ | |||
+ | 1. Check out the webtools.releng.aggregator project & make sure you're up to date in all the submodules. Commit any updates. | ||
+ | |||
+ | * https://gist.github.com/nickboldt/4f5bf0ace88dcfd2b7f4779be23146f7 | ||
+ | |||
+ | 2. Check out all the projects listed below, then: | ||
+ | |||
+ | TAG=R3_23 | ||
+ | for d in */; do echo $d; cd $d; git pull origin master; git tag ${TAG}; git push origin ${TAG}; cd ..; echo; done | ||
+ | |||
+ | Projects to tag include: | ||
+ | |||
+ | webtools.releng.aggregator/ | ||
+ | webtools.releng/ | ||
+ | webtools.common/ | ||
+ | webtools.dali/ | ||
+ | webtools.javaee/ | ||
+ | webtools.jsdt/ | ||
+ | webtools.jsf/ | ||
+ | webtools.servertools/ | ||
+ | webtools.sourceediting/ | ||
+ | webtools.webservices/ | ||
+ | |||
+ | ==== Overall project + update site versions ==== | ||
+ | |||
+ | * Once tags are created in the aggregator and releng projects, the following files should be bumped to the new 3.y+1 version: | ||
+ | |||
+ | pom.xml | ||
+ | publish/pom.xml | ||
+ | webtools.repositories/pom.xml | ||
+ | webtools.repositories/repository/pom.xml | ||
+ | webtools.repositories/repositoryunittests/pom.xml | ||
+ | |||
+ | * For example: | ||
+ | |||
+ | for d in pom.xml publish/pom.xml webtools.repositories/pom.xml webtools.repositories/repository*/pom.xml; do \ | ||
+ | sed -i $d -r -e "s#3.23.0-SNAPSHOT#3.24.0-SNAPSHOT#g"; \ | ||
+ | done | ||
+ | |||
+ | ==== Elsewhere ==== | ||
+ | * Make sure [[Eclipse/Installation]] reflects the current/new Eclipse Project release | ||
+ | * Make sure [[Simultaneous_Release]] points to the current or next release | ||
[[Category:Eclipse Web Tools Platform Project]] | [[Category:Eclipse Web Tools Platform Project]] | ||
− | [[Category:WTP | + | [[Category:WTP Releng]] |
Latest revision as of 13:25, 10 March 2022
For each WTP release, there are a few bookkeeping tasks unrelated to planning, development, and building, that also need tending to.
They should be recorded here so they're not forgotten. This is intended as a living document.
Tasks for Major and Minor Releases
- The release should be tagged in all non-releng repositories.
- Maintenance branch may created for future adopter patch builds, but this is not typical with quarterly releases and 3 week milestones. Main development will continue in master for the next quarterly simultaneous release.
- A New Help for Old Friends page created, if required
- June releases typically line up for our mandatory Release Review, and necessitate prepared documentation
Tasks for All Releases (including Service Releases)
Deliverables
- March/September releases coincide with a new Java version: facets need updating
- Copy last RCx to R using WTP Publish job
- R-build GA'd on http://download.eclipse.org/webtools/downloads/, and email sent out declaring it
- EPP packages tested, signed-off on, and +1 sent to epp-dev mailing list
- Eclipse IDE for Java EE Developers: Chuck and Nitin (Java EE Smoke and also manual checks to general layout, preferences etc for changes from integrated features like m2e, oomph etc..)
- Composite site updated via WTP Publish Repo job. Repeat for latest 20xx-yy site
- Marketplace listings created/updated for these 3 listings (contact Nitin D. if you want edit privileges, but try to keep the mandatory features to a minimum)
- WTP_FAQ installation instructions updated (add versions/numbers/update sites)
- IRC_FAQ updated
Web site updates
- Make sure packages/org.eclipse.epp.package.jee.feature/epp.website.xml in ssh://{USER}@git.eclipse.org:29418/epp/org.eclipse.epp.packages points to the correct New and Noteworthy
-
/common.php
(linking to Java EE package page and release train update site) -
/releases/index.html
updated to point to newest release - New release-specific landing page under
/releases
-
index.xml
content -> appears on 3.9.3 page - Provide link to a report showing
Bugs fixed
in the release
-
- New & Noteworthy appears on development/news and its URL listed in PMI
- News feed entry published in
news.xml
download.eclipse.org, archive.eclipse.org, build.eclipse.org Site Updates
- Add new versions / remove old versions from: /shared/webtools/committers/buildbranches.php
- Add new versions / remove old versions from: /home/data/httpd/download.eclipse.org/webtools/downloads/buildbranches.php
- Move old releases from download.eclipse.org to archive.eclipse.org. If you don't have permission, open a bug.
- See WTP Retention Policy, then use WTP-Archive job
- Clean out old Jenkins workspaces / saved builds, old builds from http://build.eclipse.org/webtools/committers/, and old builds from http://download.eclipse.org/webtools/downloads/drops/
- Use WTP-Disk-Cleanup job
- Update releng files w/ new versions/dependencies:
- parent pom -> newer Eclipse Platform I build, etc.
- repositories pom -> controls default build stream value (e.g. 3.25), etc.
- dependencies.properties
Project Lead Tasks
Each project lead or a designated Committer should perform these tasks for every release.
- Repositories tagged for the release
- Bugs triaged/retargeted out of the release
- Babel repo/branch set/updated for release
- Version value created in Bugzilla
- Project metadata at https://projects.eclipse.org/projects/webtools updated for the release version
- Project metadata at https://projects.eclipse.org/projects/webtools created for the next release, with the New and Noteworthy URL populated
SCM Tagging script
1. Check out the webtools.releng.aggregator project & make sure you're up to date in all the submodules. Commit any updates.
2. Check out all the projects listed below, then:
TAG=R3_23 for d in */; do echo $d; cd $d; git pull origin master; git tag ${TAG}; git push origin ${TAG}; cd ..; echo; done
Projects to tag include:
webtools.releng.aggregator/ webtools.releng/ webtools.common/ webtools.dali/ webtools.javaee/ webtools.jsdt/ webtools.jsf/ webtools.servertools/ webtools.sourceediting/ webtools.webservices/
Overall project + update site versions
- Once tags are created in the aggregator and releng projects, the following files should be bumped to the new 3.y+1 version:
pom.xml publish/pom.xml webtools.repositories/pom.xml webtools.repositories/repository/pom.xml webtools.repositories/repositoryunittests/pom.xml
- For example:
for d in pom.xml publish/pom.xml webtools.repositories/pom.xml webtools.repositories/repository*/pom.xml; do \ sed -i $d -r -e "s#3.23.0-SNAPSHOT#3.24.0-SNAPSHOT#g"; \ done
Elsewhere
- Make sure Eclipse/Installation reflects the current/new Eclipse Project release
- Make sure Simultaneous_Release points to the current or next release