<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<body link="#355491" alink="#4262a1" vlink="#355491" style="background: #e2e2e2; margin: 0; padding: 20px;">
<div>
<table cellpadding="0" bgcolor="#FFFFFF" border="0" cellspacing="0" style="border: 1px solid #dadada; margin-bottom: 30px; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td>
<table border="0" cellpadding="0" cellspacing="0" bgcolor="#FFFFFF" style="border: solid 2px #ccc; background: #dadada; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td bgcolor="#000000" valign="middle" height="58px" style="border-bottom: 1px solid #ccc; padding: 20px; -moz-border-radius-topleft: 3px; -moz-border-radius-topright: 3px; -webkit-border-top-right-radius: 5px; -webkit-border-top-left-radius: 5px;">
<h1 style="color: #333333; font: bold 22px Arial, Helvetica, sans-serif; margin: 0; display: block !important;">
<!-- To have a header image/logo replace the name below with your img tag -->
<!-- Email clients will render the images when the message is read so any image -->
<!-- must be made available on a public server, so that all recipients can load the image. -->
<a href="https://community.jboss.org/index.jspa" style="text-decoration: none; color: #E1E1E1">JBoss Community</a></h1>
</td>
</tr>
<tr>
<td bgcolor="#FFFFFF" style="font: normal 12px Arial, Helvetica, sans-serif; color:#333333; padding: 20px; -moz-border-radius-bottomleft: 4px; -moz-border-radius-bottomright: 4px; -webkit-border-bottom-right-radius: 5px; -webkit-border-bottom-left-radius: 5px;"><h3 style="margin: 10px 0 5px; font-size: 17px; font-weight: normal;">
Promoting JBoss Tools nightly project builds to milestone or stable release
</h3>
<span style="margin-bottom: 10px;">
modified by <a href="https://community.jboss.org/people/nickboldt">Nick Boldt</a> in <i>JBoss Tools Development</i> - <a href="https://community.jboss.org/docs/DOC-47427">View the full document</a>
</span>
<hr style="margin: 20px 0; border: none; background-color: #dadada; height: 1px;">
<div class="jive-rendered-content"><p><em><strong>This doc is in progress and subject to change. ~nickboldt</strong></em></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Publishing SOA/BRMS Tooling components</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong style="font-size: 12pt;">== STEP ONE :: Nightly Snapshot Build (Continuous Integration) ==</strong></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Run your job as you would run a local build, that is, by invoking Maven 3 w/ Tycho 0.15 (or later) against your sources.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Then publish the output of the build to the server using publish.sh - simply run a shell script at the end of the job which does this:</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Currently, the publish.sh script that everyone uses assumes a few things:</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>a) git or svn sources are fetched into ${WORKSPACE}/sources/, not the root ${WORKSPACE} folder</p><p><span>b) all builds will go into </span><a class="jive-link-external-small" href="http://download.jboss.org/jbosstools/builds/staging/builds/staging/$" target="_blank">http://download.jboss.org/jbosstools/builds/staging/builds/staging/$</a><span>{JOB_NAME}</span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Invocation of the script is done via Jenkins like this:</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>    cd ${WORKSPACE}/sources/</p><p><span>    wget </span><a class="jive-link-external-small" href="http://anonsvn.jboss.org/repos/jbosstools/trunk/build/publish/publish.sh" target="_blank">http://anonsvn.jboss.org/repos/jbosstools/trunk/build/publish/publish.sh</a><span> -q --no-check-certificate -N</span></p><p>    . publish.sh </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><strong style="font-size: 12pt;">== STEP TWO :: Promoting a Snapshot to Milestone / Release ==</strong></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>You will need a second job with a "-publish" suffix which will copy your latest nightly to a new location.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Invocation of the script is done via Jenkins like this:</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><span>    wget </span><a class="jive-link-external-small" href="http://anonsvn.jboss.org/repos/jbosstools/trunk/build/publish/promote.sh" target="_blank">http://anonsvn.jboss.org/repos/jbosstools/trunk/build/publish/promote.sh</a><span> -q --no-check-certificate -N</span></p><p>    . promote.sh ${BUILD_TYPE} ${TARGET_PLATFORM} ${TARGET_FOLDER} ${PROJECT_NAME}</p><p>        or</p><p>    . promote.sh ${BUILD_TYPE} ${TARGET_PLATFORM} ${TARGET_FOLDER} ${PROJECT_NAME} SwitchYard-Tools/eclipse</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Example jobs (which show how to set up the above job parameters, such as ${TARGET_PLATFORM} or ${BUILD_TYPE}):</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><span>    </span><a class="jive-link-external-small" href="https://jenkins.mw.lab.eng.bos.redhat.com/hudson/view/SOA-Team/view/SOAStudio_6.0.juno/job/SwitchYard-Tools-publish/" target="_blank">https://jenkins.mw.lab.eng.bos.redhat.com/hudson/view/SOA-Team/view/SOAStudio_6.0.juno/job/SwitchYard-Tools-publish/</a></p><p><span>    </span><a class="jive-link-external-small" href="https://jenkins.mw.lab.eng.bos.redhat.com/hudson/view/SOA-Team/view/SOAStudio_6.0.juno/job/modeshape-tools-continuous-publish/" target="_blank">https://jenkins.mw.lab.eng.bos.redhat.com/hudson/view/SOA-Team/view/SOAStudio_6.0.juno/job/modeshape-tools-continuous-publish/</a><span> </span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><span style="font-size: 12pt;"><strong>== Naming conventions ==</strong></span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Development milestones (x.y.z.Beta2) go here:  updates/development/{eclipse-version}/{stream}/</p><p>Stable releases (x.y.z.Final) will go in here: updates/{stable|release}/{eclipse-version}/{stream}/</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Examples:</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><a class="jive-link-external-small" href="http://download.jboss.org/jbosstools/updates/development/indigo/soa-tooling/switchyard/0.6.0/" target="_blank">http://download.jboss.org/jbosstools/updates/development/indigo/soa-tooling/switchyard/0.6.0/</a></p><p><a class="jive-link-external-small" href="http://download.jboss.org/jbosstools/updates/development/indigo/soa-tooling/modeshape/3.0.0.Beta1/" target="_blank">http://download.jboss.org/jbosstools/updates/development/indigo/soa-tooling/modeshape/3.0.0.Beta1/</a></p><p><a class="jive-link-external-small" href="http://download.jboss.org/jbosstools/updates/development/juno/soa-tooling/modeshape/3.0.0.Beta5/" target="_blank">http://download.jboss.org/jbosstools/updates/development/juno/soa-tooling/modeshape/3.0.0.Beta5/</a></p><p><a class="jive-link-external-small" href="http://download.jboss.org/jbosstools/updates/stable/indigo/soa-tooling/switchyard/0.5.0.Final/" target="_blank">http://download.jboss.org/jbosstools/updates/stable/indigo/soa-tooling/switchyard/0.5.0.Final/</a></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><span style="font-size: 12pt;"><strong>== Integration Builds? ==</strong></span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>In future, we may also have "integration" builds, which are nightlies deemed good enough for </p><p>use by downstream developers, but not stable enough (ie., not tested enough) to be released to community as a milestone.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>The above process will also work for building then promoting an integration build.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><span style="font-size: 12pt;"><strong>== Composite Sites? ==</strong></span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Well, it's great that we can publish to </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><a class="jive-link-external-small active_link" href="http://download.jboss.org/jbosstools/updates/development/juno/soa-tooling/modeshape/3.0.0.Beta5/" target="_blank">http://download.jboss.org/jbosstools/updates/development/juno/soa-tooling/modeshape/3.0.0.Beta5/</a></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>but what about a URL that won't change every time we release? How about</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><a class="jive-link-external-small" href="http://download.jboss.org/jbosstools/updates/development/juno/soa-tooling/modeshape/3.0.0.Beta5/" target="_blank">http://download.jboss.org/jbosstools/updates/development/juno/soa-tooling/modeshape/</a></p><p>or</p><p><a class="jive-link-external-small active_link" href="http://download.jboss.org/jbosstools/updates/development/juno/soa-tooling/modeshape/3.0.0.Beta5/" target="_blank">http://download.jboss.org/jbosstools/updates/development/juno/soa-tooling/</a></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><span>Good idea. See </span><a class="jive-link-external-small" href="https://issues.jboss.org/browse/JBIDE-12662" target="_blank">https://issues.jboss.org/browse/JBIDE-12662</a></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><span style="font-size: 12pt;"><strong>== Index Pages? ==</strong></span></p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Should the generated sites have a similar look and feel instead of a raw directory listing? </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p><span>Yes. See </span><a class="jive-link-external-small" href="https://issues.jboss.org/browse/JBIDE-12660" target="_blank">https://issues.jboss.org/browse/JBIDE-12660</a></p></div>
<div style="background-color: #f4f4f4; padding: 10px; margin-top: 20px;">
<p style="margin: 0;">Comment by <a href="https://community.jboss.org/docs/DOC-47427">going to Community</a></p>
<p style="margin: 0;">Create a new document in JBoss Tools Development at <a href="https://community.jboss.org/choose-container!input.jspa?contentType=102&containerType=14&container=2129">Community</a></p>
</div></td>
</tr>
</tbody>
</table>
</td>
</tr>
</tbody>
</table>
</div>
</body>
</html>