Skip to content
Permalink
Browse files
Apache Archiva Main site deployment
  • Loading branch information
olamy committed Apr 17, 2022
1 parent 9729292 commit d73f0664d8c84acfbe9c10d6a9ae71f02b41546c
Showing 25 changed files with 337 additions and 426 deletions.
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<!--
| Generated by Apache Maven Doxia Site Renderer 1.8.1
| Generated by Apache Maven Doxia Site Renderer 1.11.1
| Rendered using Apache Maven Fluido Skin 1.6
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -137,20 +137,18 @@
<li class=""><a href="https://www.apache.org" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li>
<li class=""><a href="./" title="Archiva">Archiva</a><span class="divider">/</span></li>
<li class="active ">CI Management</li>
<li id="publishDate" class="pull-right">Last Published: 15 Apr 2022</li>
<li id="publishDate" class="pull-right">Last Published: 17 Apr 2022</li>
</ul>
</div>
<div id="bodyColumn" >
<div class="section">
<section>
<h2><a name="Overview"></a>Overview</h2><a name="Overview"></a>
<p>This project uses <a class="externalLink" href="http://jenkins-ci.org/">Jenkins</a>.</p></div>
<div class="section">
<p>This project uses <a class="externalLink" href="http://jenkins-ci.org/">Jenkins</a>.</p></section><section>
<h2><a name="Access"></a>Access</h2><a name="Access"></a>
<p>The following is a link to the continuous integration system used by the project:</p>
<div class="source"><pre class="prettyprint"><a class="externalLink" href="https://builds.apache.org/view/A-F/view/Archiva/">https://builds.apache.org/view/A-F/view/Archiva/</a></pre></div></div>
<div class="section">
<div class="source"><pre class="prettyprint"><a class="externalLink" href="https://builds.apache.org/view/A-F/view/Archiva/">https://builds.apache.org/view/A-F/view/Archiva/</a></pre></div></section><section>
<h2><a name="Notifiers"></a>Notifiers</h2><a name="Notifiers"></a>
<p>No notifiers are defined. Please check back at a later date.</p></div>
<p>No notifiers are defined. Please check back at a later date.</p></section>
</div>
</div>
<hr/>
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<!--
| Generated by Apache Maven Doxia Site Renderer 1.8.1
| Generated by Apache Maven Doxia Site Renderer 1.11.1
| Rendered using Apache Maven Fluido Skin 1.6
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -138,48 +138,42 @@
<li class=""><a href="https://www.apache.org" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li>
<li class=""><a href="../" title="Archiva">Archiva</a><span class="divider">/</span></li>
<li class="active ">Building Archiva</li>
<li id="publishDate" class="pull-right">Last Published: 15 Apr 2022</li>
<li id="publishDate" class="pull-right">Last Published: 17 Apr 2022</li>
</ul>
</div>
<div id="bodyColumn" >
<div class="section">
<section>
<h2><a name="Building_Archiva"></a>Building Archiva</h2>
<p>To build the very latest code available... </p>
<ol style="list-style-type: decimal">
<li>Check out the source code as described on the <a href="../source-repository.html">Source Repository</a> page.</li>
<li>You may setup a suitable ~/.m2/settings.xml to add the needed repositories.</li>
<li>In the 'parent' directory, execute <tt>mvn clean install</tt> to build the parent pom. (only needed if we depend on a new parent)</li>
<li>In the 'archiva' directory, execute <tt>mvn clean install</tt> to build the Archiva modules and distribution.</li></ol>
<p>After the build completes, you can find the Archiva distribution in <tt>archiva-jetty/target</tt> and the Archiva webapp in <tt>archiva-modules/archiva-web/archiva-webapp/target</tt></p>
<p>Usually, it's that simple. :) Occasionally, Archiva may depend on a snapshot of another project such as <a class="externalLink" href="http://archiva.apache.org/redback">Redback</a>, and you may need to build that first, or configure a snapshot repository. If you're having trouble building Archiva, ask on the <a href="../mailing-lists.html">Development mailing list</a> and we'll point you in the right direction.</p></div>
<div class="section">
<li>In the 'parent' directory, execute <code>mvn clean install</code> to build the parent pom. (only needed if we depend on a new parent)</li>
<li>In the 'archiva' directory, execute <code>mvn clean install</code> to build the Archiva modules and distribution.</li></ol>
<p>After the build completes, you can find the Archiva distribution in <code>archiva-jetty/target</code> and the Archiva webapp in <code>archiva-modules/archiva-web/archiva-webapp/target</code></p>
<p>Usually, it's that simple. :) Occasionally, Archiva may depend on a snapshot of another project such as <a class="externalLink" href="http://archiva.apache.org/redback">Redback</a>, and you may need to build that first, or configure a snapshot repository. If you're having trouble building Archiva, ask on the <a href="../mailing-lists.html">Development mailing list</a> and we'll point you in the right direction.</p></section><section>
<h2><a name="Merging_Github_Pull_requests"></a>Merging Github Pull requests</h2>
<p>When somebody creates a pull request for archiva on github an email is sent to the developer list.</p>
<p>First review the changes and check for style and impact of the changes. And check the build on the jenkins server for this pull request (archiva-master-build-pr-builder).</p>
<p>We have moved to gitbox, so merging the PR should be done on the github web site by using the PR merge features.</p></div>
<div class="section">
<p>We have moved to gitbox, so merging the PR should be done on the github web site by using the PR merge features.</p></section><section>
<h2><a name="Documentation"></a>Documentation</h2>
<p>The version-specific documentation for the latest version of Archiva can be found in <tt>archiva/archiva-docs</tt>, and the top-level Archiva website --including the page you're reading now -- is in the <tt>site</tt> directory.</p>
<p>To work on the documentation, execute <tt>mvn site:run</tt> in one of these directories, and then visit <a class="externalLink" href="http://localhost:8080">http://localhost:8080</a> to view pages as you edit them. When you're done, submit a patch in the <a href="../issue-management.html">issue tracker</a>.</p></div>
<div class="section">
<p>The version-specific documentation for the latest version of Archiva can be found in <code>archiva/archiva-docs</code>, and the top-level Archiva website --including the page you're reading now -- is in the <code>site</code> directory.</p>
<p>To work on the documentation, execute <code>mvn site:run</code> in one of these directories, and then visit <a class="externalLink" href="http://localhost:8080">http://localhost:8080</a> to view pages as you edit them. When you're done, submit a patch in the <a href="../issue-management.html">issue tracker</a>.</p></section><section>
<h2><a name="git_clone"></a>git clone</h2>
<div class="source"><pre class="prettyprint">git clone git://github.com/apache/archiva.git
or trough https
git clone https://github.com/apache/archiva.git</pre></div></div>
<div class="section">
git clone https://github.com/apache/archiva.git</pre></div></section><section>
<h2><a name="Running_Javascript_webapp_with_jetty-maven-plugin"></a>Running Javascript webapp with jetty-maven-plugin</h2>
<p>You can use <a class="externalLink" href="https://www.eclipse.org/jetty/documentation/current/maven-and-jetty.html">jetty-maven-plugin</a> to run the webapp without installing the war in a container. With maven3 in the top directory :</p>
<div class="source"><pre class="prettyprint">mvn jetty:run -pl :archiva-webapp -am # use mvnDebug if you want to attach a debugger
or
sh ./jetty.sh # use sh ./jetty-debug.sh if you want to attach a debugger</pre></div>
<p>Hit your browser: <a class="externalLink" href="http://localhost:9091/archiva/index.html">http://localhost:9091/archiva/index.html</a></p></div>
<div class="section">
<h2><a name="Running_the_selenium_tests_Web_UI_tests_locally"></a>Running the selenium tests (Web UI tests) locally</h2>
<p>Hit your browser: <a class="externalLink" href="http://localhost:9091/archiva/index.html">http://localhost:9091/archiva/index.html</a></p></section><section>
<h2><a name="Running_the_selenium_tests_.28Web_UI_tests.29_locally"></a>Running the selenium tests (Web UI tests) locally</h2>
<p>The selenium tests use docker containers for the selenium and browser installation. To run the tests locally you should have docker installed on your developer machine. The docker container can be built locally or pulled from the apachearchiva Dockerhub repository. To start the docker container, run the following script:</p>
<div class="source"><pre class="prettyprint"> ./src/ci/scripts/container_webtest.sh start</pre></div>
<p>The UI tests can be run with:</p>
<div class="source"><pre class="prettyprint">mvn clean install -DmaxWaitTimeInMs=2000 -DseleniumRemote=true -Pci-server -Pit-js -Pchrome -pl :archiva-webapp-test</pre></div></div>
<div class="section">
<div class="source"><pre class="prettyprint">mvn clean install -DmaxWaitTimeInMs=2000 -DseleniumRemote=true -Pci-server -Pit-js -Pchrome -pl :archiva-webapp-test</pre></div></section><section>
<h2><a name="Maven_settings.xml"></a>Maven settings.xml</h2>
<p>You should setup the following repositories in your settings.xml to be able to resolve the dependencies. Sometimes we need to have certain snapshot versions for plugins, so the apache snapshot repository is added.</p>
<div class="source"><pre class="prettyprint"> &lt;profiles&gt;
@@ -223,7 +217,7 @@ <h2><a name="Maven_settings.xml"></a>Maven settings.xml</h2>

&lt;/pluginRepositories&gt;
&lt;/profile&gt;
&lt;/profiles&gt;</pre></div></div>
&lt;/profiles&gt;</pre></div></section>
</div>
</div>
<hr/>
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<!--
| Generated by Apache Maven Doxia Site Renderer 1.8.1
| Generated by Apache Maven Doxia Site Renderer 1.11.1
| Rendered using Apache Maven Fluido Skin 1.6
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -138,22 +138,20 @@
<li class=""><a href="https://www.apache.org" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li>
<li class=""><a href="../" title="Archiva">Archiva</a><span class="divider">/</span></li>
<li class="active ">How We Do Things</li>
<li id="publishDate" class="pull-right">Last Published: 15 Apr 2022</li>
<li id="publishDate" class="pull-right">Last Published: 17 Apr 2022</li>
</ul>
</div>
<div id="bodyColumn" >
<div class="section">
<section>
<h2><a name="How_We_Do_Things"></a>How We Do Things</h2>
<p>Below are the conventions we follow in Archiva.</p>
<div class="section">
<p>Below are the conventions we follow in Archiva.</p><section>
<h3><a name="Continuous_Integration"></a>Continuous Integration</h3>
<p>We use the Jenkins Apache instance for building Archiva (and redback dependencies) on scm changes.</p>
<p>See the tab with various builds: <a class="externalLink" href="https://builds.apache.org/view/A-D/view/Archiva/">Archiva tab</a></p>
<p>You can test fresh builds with downloading from this Jenkins job <a class="externalLink" href="https://builds.apache.org/job/archiva-master-build/">archiva-master-build/</a>:</p>
<ul>
<li><a class="externalLink" href="https://builds.apache.org/job/archiva-master-build/lastSuccessfulBuild/artifact/archiva-jetty/target/apache-archiva-3.0.0-SNAPSHOT-bin.zip">standalone with embeded jetty</a> (unzip then cd bin;./archiva start running on 8080)</li>
<li><a class="externalLink" href="https://builds.apache.org/job/archiva-master-build/lastSuccessfulBuild/artifact/archiva-modules/archiva-web/archiva-webapp/target/archiva-webapp-3.0.0-SNAPSHOT-SNAPSHOT.war">war webapp js</a></li></ul></div>
<div class="section">
<li><a class="externalLink" href="https://builds.apache.org/job/archiva-master-build/lastSuccessfulBuild/artifact/archiva-modules/archiva-web/archiva-webapp/target/archiva-webapp-3.0.0-SNAPSHOT-SNAPSHOT.war">war webapp js</a></li></ul></section><section>
<h3><a name="Code_Style"></a>Code Style</h3>
<p>There isn't any code style that needs to be followed as long as it is consistent, can be checked in checkstyle, can be formatted in Eclipse, IDEA and NetBeans. And the following rules must be followed:</p>
<ol style="list-style-type: decimal">
@@ -166,17 +164,15 @@ <h3><a name="Code_Style"></a>Code Style</h3>
<p>You can use the existing codestyle files:</p>
<ul>
<li><a href="./archiva-idea-codestyle.xml">idea</a></li>
<li><a href="./archiva-eclipse-codestyle.xml">eclipse</a></li></ul></li></ol></div>
<div class="section">
<li><a href="./archiva-eclipse-codestyle.xml">eclipse</a></li></ul></li></ol></section><section>
<h3><a name="Versioning"></a>Versioning</h3>
<p>It has been established in the community that the following style would be followed for the versioning of releases:</p>
<div>
<pre>Milestones -&gt; Final -&gt; Patch releases (e.g. 1.1-M1, 1.1-M2, 1.1, 1.1.1, 1.1.2 )</pre></div>
<p>As much as possible, the team is aiming for frequent releases. If the roadmap for the current development version is big, milestone releases can be applied until the final release. But if the roadmap is composed of just a small number of issues, we could proceed immediately to preparing a release candidate and push it out as the final release once it passes the vote.</p></div>
<div class="section">
<p>As much as possible, the team is aiming for frequent releases. If the roadmap for the current development version is big, milestone releases can be applied until the final release. But if the roadmap is composed of just a small number of issues, we could proceed immediately to preparing a release candidate and push it out as the final release once it passes the vote.</p></section><section>
<h3><a name="References"></a>References</h3>
<ul>
<li><a class="externalLink" href="http://old.nabble.com/Fwd%3A-What-do-we-need-to-establish--td17098487.html"> Mailing list discussion regarding conventions</a></li></ul></div></div>
<li><a class="externalLink" href="http://old.nabble.com/Fwd%3A-What-do-we-need-to-establish--td17098487.html"> Mailing list discussion regarding conventions</a></li></ul></section></section>
</div>
</div>
<hr/>
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<!--
| Generated by Apache Maven Doxia Site Renderer 1.8.1
| Generated by Apache Maven Doxia Site Renderer 1.11.1
| Rendered using Apache Maven Fluido Skin 1.6
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -137,7 +137,7 @@
<li class=""><a href="https://www.apache.org" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li>
<li class=""><a href="../" title="Archiva">Archiva</a><span class="divider">/</span></li>
<li class="active "></li>
<li id="publishDate" class="pull-right">Last Published: 15 Apr 2022</li>
<li id="publishDate" class="pull-right">Last Published: 17 Apr 2022</li>
</ul>
</div>
<div id="bodyColumn" >
@@ -1,6 +1,6 @@
<!DOCTYPE html>
<!--
| Generated by Apache Maven Doxia Site Renderer 1.8.1
| Generated by Apache Maven Doxia Site Renderer 1.11.1
| Rendered using Apache Maven Fluido Skin 1.6
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
@@ -138,11 +138,11 @@
<li class=""><a href="https://www.apache.org" class="externalLink" title="Apache">Apache</a><span class="divider">/</span></li>
<li class=""><a href="../" title="Archiva">Archiva</a><span class="divider">/</span></li>
<li class="active ">Archiva release process</li>
<li id="publishDate" class="pull-right">Last Published: 15 Apr 2022</li>
<li id="publishDate" class="pull-right">Last Published: 17 Apr 2022</li>
</ul>
</div>
<div id="bodyColumn" >
<div class="section">
<section>
<h2><a name="Archiva_release_process"></a>Archiva release process</h2>
<ol style="list-style-type: decimal">
<li>Post to the dev list a few days before you plan to do an Archiva release</li>
@@ -221,7 +221,7 @@ <h2><a name="Archiva_release_process"></a>Archiva release process</h2>
./deploySite.sh
# You can check the files locally, if you press y after the message is presented, it will be pushed to the asf-staging branch</pre></div>
<p>The site can be checked at: https://archiva.staged.apache.org/ The downloads do not work on the staged site.</p>
<p>Commit the sources and binaries from <tt>org/apache/archiva/archiva-jetty</tt> and <tt>org/apache/archiva/archiva</tt> to the svn distribution tree. First in dev tree: <tt>https://dist.apache.org/repos/dist/dev/archiva/</tt></p>
<p>Commit the sources and binaries from <code>org/apache/archiva/archiva-jetty</code> and <code>org/apache/archiva/archiva</code> to the svn distribution tree. First in dev tree: <code>https://dist.apache.org/repos/dist/dev/archiva/</code></p>
<div class="source"><pre class="prettyprint">svn co https://dist.apache.org/repos/dist/dev/archiva/ archiva-dev-release
cd archiva-dev-release
sh ./release-script-svn.sh $ARCHV ${RELEASE_URL}/
@@ -236,7 +236,7 @@ <h2><a name="Archiva_release_process"></a>Archiva release process</h2>
sh ./release-script-parent-pom.sh $POMV ${RELEASE_URL}/
REDBV=2.6 # New redback version
sh ./release-script-redback-svn.sh $REDBV ${RELEASE_URL}/</pre></div>
<p>If the vote passes the binaries must be copied to release tree: <tt>https://dist.apache.org/repos/dist/release/archiva</tt></p>
<p>If the vote passes the binaries must be copied to release tree: <code>https://dist.apache.org/repos/dist/release/archiva</code></p>
<p>Call for a vote in the dev list and wait for 72 hrs. for the vote results. 3 binding votes are necessary for the release to be finalized. If the vote fails or needs to be canceled, the version number should not be re-used if the version was made available for public download. After the vote has passed, move the files from dist dev to dist release:</p>
<div class="source"><pre class="prettyprint">svn mv https://dist.apache.org/repos/dist/dev/archiva/${ARCHV} https://dist.apache.org/repos/dist/release/archiva/

@@ -260,7 +260,7 @@ <h2><a name="Archiva_release_process"></a>Archiva release process</h2>
<p>If there are security incidents that should be published after release, please check the Apache information <a class="externalLink" href="http://www.apache.org/security/committers.html">http://www.apache.org/security/committers.html</a> for further actions.</p>
<p>And finally remove old versions from the distribution directory. All versions that are not mentioned in the download page should be removed:</p>
<div class="source"><pre class="prettyprint">svn del -m&quot;Archiving release 2.2.x&quot; https://dist.apache.org/repos/dist/release/archiva/2.2.x</pre></div>
<p>See also: https://infra.apache.org/release-download-pages.html</p></li></ol></div>
<p>See also: https://infra.apache.org/release-download-pages.html</p></li></ol></section>
</div>
</div>
<hr/>

0 comments on commit d73f066

Please sign in to comment.