blob: 2648fec8fe65c66401e6cee320523dee1abf7770 [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?>
<document xmlns="http://maven.apache.org/XDOC/2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/XDOC/2.0 http://maven.apache.org/xsd/xdoc-2.0.xsd">
<properties>
<title>sop-releng</title>
</properties>
<body>
<section name="Releng">
<subsection name="Context">
<p>Goal is to be able to release this project that contains the parent pom for all Papyrus components and the archetypes to create the Components projects</p>
</subsection>
<subsection name="Prerequisites">
<p>Ensure the <a href="https://hudson.eclipse.org/papyrus/view/Components/job/papyrus-components/">https://hudson.eclipse.org/papyrus/view/Components/job/papyrus-components/</a> is green.</p>
<p>Ensure that no critical bugs are opened <a href="https://bugs.eclipse.org/bugs/buglist.cgi?bug_status=__open__&#38;component=Components&#38;product=Papyrus&#38;query_format=specific">https://bugs.eclipse.org/bugs/buglist.cgi?bug_status=__open__&#38;component=Components&#38;product=Papyrus&#38;query_format=specific</a></p>
<p>Have a look to the nightly documentation in order to fetch the needed repository: <a href="https://hudson.eclipse.org/papyrus/view/Components/job/papyrus-components-website/ws/site-staging/index.html">https://hudson.eclipse.org/papyrus/view/Components/job/papyrus-components-website/ws/site-staging/index.html</a></p>
</subsection>
<subsection name="Actions">
<ul>
<li>Create a bugzilla ticket [Components][releng] Release of version X.Y.Z</li>
<li>Fetch the repository located here <a href="../source-repository.html"></a></li>
<li>Modify the change log located in the components/org.eclipse.papyrus.components.parent/src/changes/changes.xml </li>
<li>Remove the -SNAPSHOT extension in the the following pom.xml: /org.eclipse.papyrus.components.parent/org.eclipse.papyrus.components.archetype/pom.xml, /org.eclipse.papyrus.components.parent/pom.xml. Other pom.xml do not have to be touched once they are automatically generated.</li>
<li>for instance, mvn versions:set -DnewVersion=0.0.23 -DgenerateBackupPoms=false</li>
<li>Merge these modifications</li>
<li>Run the job Components: <a href="https://hudson.eclipse.org/papyrus/view/Components/job/papyrus-components/">papyrus-components</a></li>
<li>Execute the job Components: <a href="https://hudson.eclipse.org/papyrus/view/Components/job/papyrus-components-deploy-nexus/">papyrus-components-deploy-nexus</a> by entering in the COMMITID field the commitid you would like to release. Usually it is the revision number in the last successful build in Hudson or the last commit shown in the git log command.</li>
<li>It should deploy the new version into the <a href="https://repo.eclipse.org/index.html#nexus-search;quick~org.eclipse.papyrus.components">nexus repository</a> and execute downstream the website job Components: <a href="https://hudson.eclipse.org/papyrus/view/Components/job/papyrus-components-deploy-website">papyrus-components-deploy-website</a>. The downstream jobs can be seen at the end of the build's console report.</li>
<li>Deploy the web site by copying the staging directory in the papyrus web git repository. To do this, first clone the <a href="http://git.eclipse.org/c/www.eclipse.org/papyrus.git/"> Papyrus Web git repository </a> and unzip in the components/components/ directory the unzipped built site from <a href="https://hudson.eclipse.org/papyrus/view/Components/job/papyrus-components-deploy-website/ws/site-staging/*zip*/site-staging.zip"> papyrus-components-deploy-website </a></li>
<li>Modify the index.html to reflect the new release version by adding a new item to the dropdown menu and updating the referenced page address. This file can be found in the Papyrus Web git repository at the root of the components/components/ folder</li>
<li>Increase the different pom.xml artifact version by adding a +(0.0.1)-SNAPSHOT suffix in parent and archetype. Do not forget to update both components/parent/ and components/parent/archetype pom.xml</li>
</ul>
</subsection>
<subsection name="Post-Actions">
<p>You could inform Papyrus Components project leader that you have improve the project in order they switch to the new pom version.</p>
</subsection>
</section>
</body>
</document>