Gitblit devel
view | history | commit | commitdiff
Moxie
2015-11-23 67834872ddd5630b9c30c53c2972f5dcbf3dd5aa
commit | author | age
48fe87 1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
M 2 <html>
3 <head>
4 <!-- Begin Header -->
5 <title>Gitblit</title>
6 <meta charset="utf-8">
7 <meta name="ROBOTS" content="INDEX">
8 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
9 <meta name="viewport" content="width=device-width, initial-scale=1.0">
10         
11 <link rel="stylesheet" href="./bootstrap/css/bootstrap.css">
12 <link rel='shortcut icon' type='image/png' href='./gitblt-favicon.png' />
13 <link rel="stylesheet" href="./prettify/prettify.css" />
14 <!-- Google Plus Profile Page -->
15 <link rel="publisher" href="https://plus.google.com/114464678392593421684" />
16 <style type="text/css"> a.gpluspage { margin-top:3px;text-decoration: none; } </style>
17
18 <!-- Google Plus One -->
19 <link rel="canonical" href="http://gitblit.com" />
20 <script type="text/javascript" src="https://apis.google.com/js/plusone.js"></script>
21 <style type="text/css"> div.gplusone { margin-top:12px; } </style>
22
23 <script src="./prettify/prettify.js"></script>
24 <script src="./bootstrap/js/jquery.js"></script>
25 <script src="./bootstrap/js/bootstrap.min.js"></script>
26 </head>
27 <body onload='prettyPrint()'>        <!-- Navigation Bar -->
28         <div class="navbar navbar-fixed-top">
29             <div class="navbar-inner">
30                 <div class="container">
31                       <a class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse">
32                         <span class="icon-bar"></span>
33                         <span class="icon-bar"></span>
34                         <span class="icon-bar"></span>
35                       </a>
36                       <a class="brand" href="./"><img src="./gitblt_25_white.png" alt="Gitblit"></img></a>
37                     <div class="nav-collapse">
38                         <ul class="nav">
39                             <li class='dropdown'> <!-- Menu -->
40 <a class='dropdown-toggle' href='#' data-toggle='dropdown'>about<b class='caret'></b></a>
41 <ul class='dropdown-menu'>
42 <li><a href='index.html'>overview</a></li>
43 <li><a href='features.html'>features</a></li>
44 <li><a href='screenshots.html'>screenshots</a></li>
45 </ul></li> <!-- End Menu -->
46 <li class='dropdown'> <!-- Menu -->
47 <a class='dropdown-toggle' href='#' data-toggle='dropdown'>documentation<b class='caret'></b></a>
48 <ul class='dropdown-menu'>
49 <li class='dropdown-submenu'> <!-- Submenu -->
50 <a tabindex='-1' href='#'>Gitblit GO</a>
51 <ul class='dropdown-menu'>
52 <li><a href='setup_go.html'>setup GO</a></li>
53 <li><a href='upgrade_go.html'>upgrade GO</a></li>
54 </ul></li> <!-- End Submenu -->
55 <li class='divider'></li>
56 <li class='dropdown-submenu'> <!-- Submenu -->
57 <a tabindex='-1' href='#'>Gitblit WAR</a>
58 <ul class='dropdown-menu'>
59 <li><a href='setup_war.html'>setup WAR</a></li>
60 <li><a href='upgrade_war.html'>upgrade WAR</a></li>
61 </ul></li> <!-- End Submenu -->
62 <li class='divider'></li>
63 <li class='dropdown-submenu'> <!-- Submenu -->
64 <a tabindex='-1' href='#'>Server Configuration</a>
65 <ul class='dropdown-menu'>
66 <li><a href='administration.html'>administration</a></li>
67 <li><a href='setup_authentication.html'>authentication</a></li>
68 <li><a href='setup_hooks.html'>push hooks</a></li>
69 <li><a href='setup_lucene.html'>lucene indexing</a></li>
70 <li><a href='setup_proxy.html'>reverse proxies</a></li>
71 <li><a href='setup_clientmenus.html'>client app menus</a></li>
72 <li><a href='setup_bugtraq.html'>bugtraq</a></li>
73 <li><a href='setup_mirrors.html'>mirrors</a></li>
74 <li><a href='setup_scaling.html'>scaling</a></li>
5287d2 75 <li><a href='setup_fail2ban.html'>fail2ban</a></li>
48fe87 76 <li class='divider'></li>
M 77 <li><a href='setup_viewer.html'>Gitblit as a viewer</a></li>
78 </ul></li> <!-- End Submenu -->
79 <li class='divider'></li>
80 <li class='dropdown-submenu'> <!-- Submenu -->
81 <a tabindex='-1' href='#'>Client Usage</a>
82 <ul class='dropdown-menu'>
83 <li><a href='setup_transport_http.html'>using HTTP/HTTPS</a></li>
84 <li><a href='setup_transport_ssh.html'>using SSH</a></li>
85 <li><a href='eclipse_plugin.html'>using the Eclipse plugin</a></li>
86 </ul></li> <!-- End Submenu -->
87 <li class='divider'></li>
88 <li class='dropdown-submenu'> <!-- Submenu -->
89 <a tabindex='-1' href='#'>Tickets</a>
90 <ul class='dropdown-menu'>
91 <li><a href='tickets_overview.html'>overview</a></li>
92 <li><a href='tickets_using.html'>using</a></li>
93 <li><a href='tickets_barnum.html'>barnum</a></li>
94 <li><a href='tickets_setup.html'>setup</a></li>
95 <li><a href='tickets_replication.html'>replication & advanced administration</a></li>
96 </ul></li> <!-- End Submenu -->
97 <li class='divider'></li>
98 <li class='dropdown-submenu'> <!-- Submenu -->
99 <a tabindex='-1' href='#'>Plugins</a>
100 <ul class='dropdown-menu'>
101 <li><a href='plugins_overview.html'>overview</a></li>
102 <li><a href='plugins_extensions.html'>extension points</a></li>
103 </ul></li> <!-- End Submenu -->
104 <li class='divider'></li>
105 <li><a href='federation.html'>federation</a></li>
106 <li class='divider'></li>
107 <li><a href='properties.html'>settings</a></li>
108 <li><a href='faq.html'>faq</a></li>
109 <li class='divider'></li>
110 <li><a href='design.html'>design</a></li>
111 <li><a href='rpc.html'>rpc</a></li>
112 </ul></li> <!-- End Menu -->
113 <li class='dropdown'> <!-- Menu -->
114 <a class='dropdown-toggle' href='#' data-toggle='dropdown'>releases<b class='caret'></b></a>
115 <ul class='dropdown-menu'>
116 <li><a href='releasenotes.html'>release notes</a></li>
117 <li><a href='releases.html'>release history</a></li>
118 </ul></li> <!-- End Menu -->
119 <li class='dropdown'> <!-- Menu -->
120 <a class='dropdown-toggle' href='#' data-toggle='dropdown'>downloads<b class='caret'></b></a>
121 <ul class='dropdown-menu'>
678348 122 <li><a href='http://dl.bintray.com/gitblit/releases/gitblit-1.7.1.zip'>Gitblit GO (Windows)</a></li>
M 123 <li><a href='http://dl.bintray.com/gitblit/releases/gitblit-1.7.1.tar.gz'>Gitblit GO (Linux/OSX)</a></li>
124 <li><a href='http://dl.bintray.com/gitblit/releases/gitblit-1.7.1.war'>Gitblit WAR</a></li>
48fe87 125 <li class='divider'></li>
M 126 <li><a href='https://registry.hub.docker.com/u/jmoger/gitblit/'>Gitblit GO (Docker)</a></li>
127 <li class='divider'></li>
128 <li><a href='http://plugins.gitblit.com'>Plugins Registry</a></li>
129 <li class='divider'></li>
678348 130 <li><a href='http://dl.bintray.com/gitblit/releases/manager-1.7.1.zip'>Gitblit Manager</a></li>
M 131 <li><a href='http://dl.bintray.com/gitblit/releases/fedclient-1.7.1.zip'>Federation Client</a></li>
48fe87 132 <li class='divider'></li>
678348 133 <li><a href='http://dl.bintray.com/gitblit/releases/gbapi-1.7.1.zip'>API Library</a></li>
48fe87 134 <li class='divider'></li>
M 135 <li><a href='https://bintray.com/gitblit/releases/gitblit'>Bintray (1.4.0+)</a></li>
136 <li><a href='https://code.google.com/p/gitblit/downloads/list?can=1'>GoogleCode (pre-1.4.0)</a></li>
137 <li class='divider'></li>
138 <li><a href='http://gitblit.github.io/gitblit-maven'>Maven Repository</a></li>
139 </ul></li> <!-- End Menu -->
140 <li class='dropdown'> <!-- Menu -->
141 <a class='dropdown-toggle' href='#' data-toggle='dropdown'>links<b class='caret'></b></a>
142 <ul class='dropdown-menu'>
143 <li><a href='https://dev.gitblit.com'>dev.gitblit.com (self-hosted)</a></li>
144 <li class='divider'></li>
145 <li><a href='http://plugins.gitblit.com'>Plugins Registry</a></li>
146 <li class='divider'></li>
147 <li><a href='https://github.com/gitblit/gitblit'>Github</a></li>
5287d2 148 <li><a href='https://github.com/gitblit/gitblit'>Issues</a></li>
48fe87 149 <li><a href='http://groups.google.com/group/gitblit'>Discussion</a></li>
M 150 <li><a href='https://twitter.com/gitblit'>Twitter</a></li>
151 <li><a href='http://www.ohloh.net/p/gitblit'>Ohloh</a></li>
584328 152 <li class='divider'></li>
M 153 <li><a href='https://vimeo.com/86164723'>Gitblit Tickets screencast</a></li>
154 <li><a href='https://asciinema.org/a/9342'>Gitblit SSH and Plugin Management asciicast</a></li>
155 <li><a href='http://episodes.gitminutes.com/2014/05/gitminutes-29-james-moger-on-gitblit.html'>GitMinutes #29: James Moger on Gitblit</a></li>
48fe87 156 <li class='divider'></li>
M 157 <li><a href='https://twitter.com/JamesMoger'>@JamesMoger</a></li>
158 </ul></li> <!-- End Menu -->
159 <li class='divider-vertical'></li>
160 <li><a href='https://plus.google.com/114464678392593421684?prsrc=3' class='gpluspage'><img src='https://ssl.gstatic.com/images/icons/gplus-16.png' width='16' height='16 style='order: 0;'/></a></li><li><div class='gplusone'><g:plusone size='small' href='http://gitblit.com'></g:plusone></div></li>
161                         </ul>
162                     </div><!--/.nav-collapse -->
163                 </div>
164             </div>
165         </div><!-- end Navigation Bar -->
166 <div class='container'>
167 <!-- Begin Markdown -->
168 <h2 class="section" id='H1'><a href="#H1" class="sectionlink"><i class="icon-share-alt"> </i></a>Design Principles</h2>
169 <ol>
170   <li><a href="http://en.wikipedia.org/wiki/KISS_principle">Keep It Simple, Stupid</a></li>
171   <li>Offer useful features for serving Git repositories. If feature is complex, refer to #1.</li>
172   <li>All dependencies must be retrievable from a publicly accessible <a href="http://maven.apache.org">Maven</a> repository.<br/>This is to ensure authenticity of dependencies and to automate the setup of developer environments.</li>
173 </ol>
174 <h2 class="section" id='H2'><a href="#H2" class="sectionlink"><i class="icon-share-alt"> </i></a>Architecture</h2><p><img src="architecture.png"  alt="block diagram"/></p>
175 <h3 class="section" id='H3'><a href="#H3" class="sectionlink"><i class="icon-share-alt"> </i></a>Bundled Dependencies</h3><p>The following dependencies are bundled with Gitblit.</p>
176 <ul>
177   <li><a href="http://twitter.github.com/bootstrap">Bootstrap</a> (Apache 2.0)</li>
178   <li><a href="http://glyphicons.com">GLYPHICONS</a> (Creative Commons CC-BY)</li>
179   <li><a href="http://somerandomdude.com/work/iconic">Iconic</a> (Creative Commons Share Alike 3.0)</li>
180   <li><a href="http://angularjs.org">AngularJS</a> (MIT)</li>
181   <li><a href="https://github.com/mojombo/clippy">Clippy</a> (MIT)</li>
182   <li><a href="http://code.google.com/p/google-code-prettify">google-code-prettify</a> (Apache 2.0)</li>
183   <li><a href="http://commons.apache.org/daemon">Commons Daemon</a> (Apache 2.0)</li>
184   <li><a href="https://jquery.org">jQuery</a> (MIT)</li>
185   <li><a href="http://humblesoftware.com/flotr2">flotr2</a> (BSD)</li>
186   <li>magnifying glass search icon courtesy of <a href="http://gnome.org">Gnome</a> (Creative Commons CC-BY)</li>
187   <li>Git logo originally designed by <a href="http://git-scm.com/downloads/logos">Jason Long</a></li>
188   <li>modified Git logo originally designed by <a href="http://henrik.nyh.se/2007/06/alternative-git-logo-and-favicon">Henrik Nyh</a></li>
189   <li>fork icon courtesy of <a href="http://emberjs.com">Ember.js</a></li>
190   <li>other icons courtesy of <a href="http://www.fatcow.com/free-icons">FatCow Hosting</a> (Creative Commons CC-BY)</li>
191 </ul>
192 <h3 class="section" id='H4'><a href="#H4" class="sectionlink"><i class="icon-share-alt"> </i></a>Downloaded Dependencies</h3><p>The following dependencies are automatically downloaded by Gitblit GO (or already bundled with the WAR) from the Apache Maven repository and from the Eclipse Maven repository when Gitblit is launched for the first time.</p>
193 <ul>
194   <li><a href="http://eclipse.org/jgit" title="Eclipse JGit Site">JGit</a> (EDL 1.0)</li>
195   <li><a href="http://wicket.apache.org">Wicket</a> (Apache 2.0)</li>
196   <li><a href="http://eclipse.org/jetty">Jetty</a> (Apache 2.0, EPL 1.0)</li>
197   <li><a href="http://www.slf4j.org">SLF4J</a> (MIT/X11)</li>
198   <li><a href="http://logging.apache.org/log4j">Log4j</a> (Apache 2.0)</li>
199   <li><a href="http://args4j.kohsuke.org">args4j</a> (Apache 2.0)</li>
200   <li><a href="http://www.bouncycastle.org">BouncyCastle</a> (MIT/X11)</li>
201   <li><a href="http://www.jcraft.com/jsch">JSch - Java Secure Channel</a> (BSD)</li>
202   <li><a href="http://rome.dev.java.net">Rome</a> (Apache 1.1)</li>
203   <li><a href="http://www.jdom.org">jdom</a> (Apache-style JDOM license)</li>
204   <li><a href="http://code.google.com/google-gson">google-gson</a> (Apache 2.0)</li>
205   <li><a href="http://kenai.com/projects/javamail">javamail</a> (CDDL-1.0, BSD, GPL-2.0, GNU-Classpath)</li>
206   <li><a href="http://groovy.codehaus.org">Groovy</a> (Apache 2.0)</li>
207   <li><a href="http://lucene.apache.org">Lucene</a> (Apache 2.0)</li>
208   <li><a href="http://www.unboundid.com">UnboundID</a> (LGPL 2.1)</li>
209   <li><a href="http://ant.apache.org/ivy">Ivy</a> (Apache 2.0)</li>
210   <li><a href="http://www.toedter.com/en/jcalendar">JCalendar</a> (LGPL 2.1)</li>
211   <li><a href="http://commons.apache.org/compress">Commons-Compress</a> (Apache 2.0)</li>
212   <li><a href="http://tukaani.org/xz/java.html">XZ for Java</a> (Public Domain)</li>
213   <li><a href="http://www.freemarker.org">FreeMarker</a> (modified BSD)</li>
214   <li><a href="http://dblock.github.io/waffle">Waffle</a> (EPL 1.0)</li>
215   <li><a href="https://github.com/twall/jna">JNA</a> (LGPL 2.1)</li>
216   <li><a href="https://code.google.com/p/guava-libraries">Guava</a> (Apache 2.0)</li>
217   <li><a href="https://github.com/kohsuke/libpam4j">libpam4j</a> (MIT)</li>
218   <li><a href="http://commons.apache.org/proper/commons-codec">commons-codec</a> (Apache 2.0)</li>
219   <li><a href="https://github.com/sirthias/pegdown">pegdown</a> (Apache 2.0)</li>
220   <li><a href="https://github.com/xetorthio/jedis">jedis</a> (MIT)</li>
221   <li><a href="https://mina.apache.org">Mina SSHD</a> (Apache 2.0)</li>
222   <li><a href="https://github.com/decebals/pf4j">pf4j</a> (Apache 2.0)</li>
5287d2 223   <li><a href="https://code.google.com/p/google-guice">google-guice</a> (Apache 2.0)</li>
48fe87 224 </ul>
M 225 <h3 class="section" id='H5'><a href="#H5" class="sectionlink"><i class="icon-share-alt"> </i></a>Other Build Dependencies</h3>
226 <ul>
227   <li><a href="http://fancybox.net">Fancybox image viewer</a> (MIT and GPL dual-licensed)</li>
228   <li><a href="http://junit.org">JUnit</a> (Common Public License)</li>
229   <li><a href="http://moxie.gitblit.com">Moxie</a> (Apache 2.0)</li>
230 </ul>
231 <h2 class="section" id='H6'><a href="#H6" class="sectionlink"><i class="icon-share-alt"> </i></a>Building from Source</h2><p><a href="http://eclipse.org">Eclipse</a> is recommended for development as the project settings are preconfigured.</p><p>Additionally, <a href="http://code.google.com/javadevtools">Google CodePro AnalytiX</a>, <a href="http://eclipse-cs.sourceforge.net">eclipse-cs</a>, <a href="http://findbugs.sourceforge.net">FindBugs</a>, and <a href="http://www.eclemma.org">EclEmma</a> are recommended development tools.</p>
232 <ol>
233   <li>Clone the git repository from <a href="http://github.com/gitblit" title="gitblit git repository">Github</a>.</li>
234   <li>Import the gitblit project into your Eclipse workspace.<br/><em>There will be lots of build errors.</em></li>
235   <li>Using Ant, execute the <code>build.xml</code> script in the project root.<br/><em>This will download all necessary build dependencies and will also generate the Keys class for accessing settings.</em></li>
236   <li>Select your gitblit project root and <strong>Refresh</strong> the project, this should correct all build problems.</li>
237   <li>Using JUnit, execute the <code>com.gitblit.tests.GitBlitSuite</code> test suite.<br/><em>This will clone some repositories from the web and run through the unit tests.</em></li>
238   <li>Execute the <em>com.gitblit.GitBlitServer</em> class to start Gitblit.</li>
239 </ol>
240 <h2 class="section" id='H7'><a href="#H7" class="sectionlink"><i class="icon-share-alt"> </i></a>Contributing</h2><p>Pull requests are preferred. Patches are welcome.</p><p>Contributions must be your own original work and must licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0" title="Apache License, Version 2.0">Apache License, Version 2.0</a>, the same license used by Gitblit.
241 <!-- End Markdown -->
678348 242 <div ><ul class="pager"> <li class="next"><a href="rpc.html">rpc &rarr;</a></li></ul></div><footer class="footer"><p class="pull-right">generated 2015-11-23</p>
48fe87 243 <p>The content of this page is licensed under the <a href="http://creativecommons.org/licenses/by/3.0">Creative Commons Attribution 3.0 License</a>.</p>
M 244 </footer>
245 </div>
246 <!-- Google Analytics -->
247 <script type="text/javascript">
248     var _gaq = _gaq || [];
249     _gaq.push(['_setAccount', 'UA-24377072-1']);
250     _gaq.push(['_trackPageview']);
251
252     (function() {
253         var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
254         ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
255         var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
256     })();
257 </script>
258
259 </body>
260 </html>