diff options
| author | Moxie <moxie@localhost> | 2016-06-22 15:05:54 -0400 |
|---|---|---|
| committer | Moxie <moxie@localhost> | 2016-06-22 15:05:54 -0400 |
| commit | ae3b6b6533462a33dc0c5ac085c08ad8fce368d0 (patch) | |
| tree | 0f36a05d2ebed54100234e4eedb463e8c3bd780a /setup_filestore.html | |
| parent | 67834872ddd5630b9c30c53c2972f5dcbf3dd5aa (diff) | |
| download | gitblit-ae3b6b6533462a33dc0c5ac085c08ad8fce368d0.tar.gz gitblit-ae3b6b6533462a33dc0c5ac085c08ad8fce368d0.zip | |
updated pages
Diffstat (limited to 'setup_filestore.html')
| -rw-r--r-- | setup_filestore.html | 226 |
1 files changed, 226 insertions, 0 deletions
diff --git a/setup_filestore.html b/setup_filestore.html new file mode 100644 index 00000000..cb860acc --- /dev/null +++ b/setup_filestore.html @@ -0,0 +1,226 @@ +<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> +<html> +<head> +<!-- Begin Header -->
+<title>Gitblit</title>
+<meta charset="utf-8">
+<meta name="ROBOTS" content="INDEX">
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+
+<link rel="stylesheet" href="./bootstrap/css/bootstrap.css"> +<link rel='shortcut icon' type='image/png' href='./gitblt-favicon.png' /> +<link rel="stylesheet" href="./prettify/prettify.css" /> +<!-- Google Plus Profile Page -->
+<link rel="publisher" href="https://plus.google.com/114464678392593421684" />
+<style type="text/css"> a.gpluspage { margin-top:3px;text-decoration: none; } </style> + +<!-- Google Plus One -->
+<link rel="canonical" href="http://gitblit.com" />
+<script type="text/javascript" src="https://apis.google.com/js/plusone.js"></script>
+<style type="text/css"> div.gplusone { margin-top:12px; } </style> + +<script src="./prettify/prettify.js"></script> +<script src="./bootstrap/js/jquery.js"></script> +<script src="./bootstrap/js/bootstrap.min.js"></script> +</head> +<body onload='prettyPrint()'> <!-- Navigation Bar -->
+ <div class="navbar navbar-fixed-top">
+ <div class="navbar-inner">
+ <div class="container">
+ <a class="btn btn-navbar" data-toggle="collapse" data-target=".nav-collapse">
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ <span class="icon-bar"></span>
+ </a>
+ <a class="brand" href="./"><img src="./gitblt_25_white.png" alt="Gitblit"></img></a>
+ <div class="nav-collapse">
+ <ul class="nav">
+ <li class='dropdown'> <!-- Menu --> +<a class='dropdown-toggle' href='#' data-toggle='dropdown'>about<b class='caret'></b></a> +<ul class='dropdown-menu'> +<li><a href='index.html'>overview</a></li> +<li><a href='features.html'>features</a></li> +<li><a href='screenshots.html'>screenshots</a></li> +</ul></li> <!-- End Menu --> +<li class='dropdown'> <!-- Menu --> +<a class='dropdown-toggle' href='#' data-toggle='dropdown'>documentation<b class='caret'></b></a> +<ul class='dropdown-menu'> +<li class='dropdown-submenu'> <!-- Submenu --> +<a tabindex='-1' href='#'>Gitblit GO</a> +<ul class='dropdown-menu'> +<li><a href='setup_go.html'>setup GO</a></li> +<li><a href='upgrade_go.html'>upgrade GO</a></li> +</ul></li> <!-- End Submenu --> +<li class='divider'></li> +<li class='dropdown-submenu'> <!-- Submenu --> +<a tabindex='-1' href='#'>Gitblit WAR</a> +<ul class='dropdown-menu'> +<li><a href='setup_war.html'>setup WAR</a></li> +<li><a href='upgrade_war.html'>upgrade WAR</a></li> +</ul></li> <!-- End Submenu --> +<li class='divider'></li> +<li class='dropdown-submenu'> <!-- Submenu --> +<a tabindex='-1' href='#'>Server Configuration</a> +<ul class='dropdown-menu'> +<li><a href='administration.html'>administration</a></li> +<li><a href='setup_authentication.html'>authentication</a></li> +<li><a href='setup_hooks.html'>push hooks</a></li> +<li><a href='setup_lucene.html'>lucene indexing</a></li> +<li><a href='setup_proxy.html'>reverse proxies</a></li> +<li><a href='setup_clientmenus.html'>client app menus</a></li> +<li><a href='setup_bugtraq.html'>bugtraq</a></li> +<li><a href='setup_mirrors.html'>mirrors</a></li> +<li><a href='setup_scaling.html'>scaling</a></li> +<li><a href='setup_fail2ban.html'>fail2ban</a></li> +<li><a href='setup_filestore.html'>filestore (Git LFS)</a></li> +<li class='divider'></li> +<li><a href='setup_viewer.html'>Gitblit as a viewer</a></li> +</ul></li> <!-- End Submenu --> +<li class='divider'></li> +<li class='dropdown-submenu'> <!-- Submenu --> +<a tabindex='-1' href='#'>Client Usage</a> +<ul class='dropdown-menu'> +<li><a href='setup_transport_http.html'>using HTTP/HTTPS</a></li> +<li><a href='setup_transport_ssh.html'>using SSH</a></li> +<li><a href='eclipse_plugin.html'>using the Eclipse plugin</a></li> +</ul></li> <!-- End Submenu --> +<li class='divider'></li> +<li class='dropdown-submenu'> <!-- Submenu --> +<a tabindex='-1' href='#'>Tickets</a> +<ul class='dropdown-menu'> +<li><a href='tickets_overview.html'>overview</a></li> +<li><a href='tickets_using.html'>using</a></li> +<li><a href='tickets_barnum.html'>barnum</a></li> +<li><a href='tickets_setup.html'>setup</a></li> +<li><a href='tickets_replication.html'>replication & advanced administration</a></li> +</ul></li> <!-- End Submenu --> +<li class='divider'></li> +<li class='dropdown-submenu'> <!-- Submenu --> +<a tabindex='-1' href='#'>Plugins</a> +<ul class='dropdown-menu'> +<li><a href='plugins_overview.html'>overview</a></li> +<li><a href='plugins_extensions.html'>extension points</a></li> +</ul></li> <!-- End Submenu --> +<li class='divider'></li> +<li><a href='federation.html'>federation</a></li> +<li class='divider'></li> +<li><a href='properties.html'>settings</a></li> +<li><a href='faq.html'>faq</a></li> +<li class='divider'></li> +<li><a href='design.html'>design</a></li> +<li><a href='rpc.html'>rpc</a></li> +</ul></li> <!-- End Menu --> +<li class='dropdown'> <!-- Menu --> +<a class='dropdown-toggle' href='#' data-toggle='dropdown'>releases<b class='caret'></b></a> +<ul class='dropdown-menu'> +<li><a href='releasenotes.html'>release notes</a></li> +<li><a href='releases.html'>release history</a></li> +</ul></li> <!-- End Menu --> +<li class='dropdown'> <!-- Menu --> +<a class='dropdown-toggle' href='#' data-toggle='dropdown'>downloads<b class='caret'></b></a> +<ul class='dropdown-menu'> +<li><a href='http://dl.bintray.com/gitblit/releases/gitblit-1.8.0.zip'>Gitblit GO (Windows)</a></li> +<li><a href='http://dl.bintray.com/gitblit/releases/gitblit-1.8.0.tar.gz'>Gitblit GO (Linux/OSX)</a></li> +<li><a href='http://dl.bintray.com/gitblit/releases/gitblit-1.8.0.war'>Gitblit WAR</a></li> +<li class='divider'></li> +<li><a href='https://registry.hub.docker.com/u/jmoger/gitblit/'>Gitblit GO (Docker)</a></li> +<li class='divider'></li> +<li><a href='http://plugins.gitblit.com'>Plugins Registry</a></li> +<li class='divider'></li> +<li><a href='http://dl.bintray.com/gitblit/releases/manager-1.8.0.zip'>Gitblit Manager</a></li> +<li><a href='http://dl.bintray.com/gitblit/releases/fedclient-1.8.0.zip'>Federation Client</a></li> +<li class='divider'></li> +<li><a href='http://dl.bintray.com/gitblit/releases/gbapi-1.8.0.zip'>API Library</a></li> +<li class='divider'></li> +<li><a href='https://bintray.com/gitblit/releases/gitblit'>Bintray (1.4.0+)</a></li> +<li><a href='https://code.google.com/p/gitblit/downloads/list?can=1'>GoogleCode (pre-1.4.0)</a></li> +<li class='divider'></li> +<li><a href='http://gitblit.github.io/gitblit-maven'>Maven Repository</a></li> +</ul></li> <!-- End Menu --> +<li class='dropdown'> <!-- Menu --> +<a class='dropdown-toggle' href='#' data-toggle='dropdown'>links<b class='caret'></b></a> +<ul class='dropdown-menu'> +<li><a href='https://dev.gitblit.com'>dev.gitblit.com (self-hosted)</a></li> +<li class='divider'></li> +<li><a href='http://plugins.gitblit.com'>Plugins Registry</a></li> +<li class='divider'></li> +<li><a href='https://github.com/gitblit/gitblit'>Github</a></li> +<li><a href='https://github.com/gitblit/gitblit'>Issues</a></li> +<li><a href='http://groups.google.com/group/gitblit'>Discussion</a></li> +<li><a href='https://twitter.com/gitblit'>Twitter</a></li> +<li><a href='http://www.ohloh.net/p/gitblit'>Ohloh</a></li> +<li class='divider'></li> +<li><a href='https://vimeo.com/86164723'>Gitblit Tickets screencast</a></li> +<li><a href='https://asciinema.org/a/9342'>Gitblit SSH and Plugin Management asciicast</a></li> +<li><a href='http://episodes.gitminutes.com/2014/05/gitminutes-29-james-moger-on-gitblit.html'>GitMinutes #29: James Moger on Gitblit</a></li> +<li class='divider'></li> +<li><a href='https://twitter.com/JamesMoger'>@JamesMoger</a></li> +</ul></li> <!-- End Menu --> +<li class='divider-vertical'></li> +<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>
+ </ul>
+ </div><!--/.nav-collapse -->
+ </div>
+ </div>
+ </div><!-- end Navigation Bar --> +<div class='container'> +<!-- Begin Markdown --> +<h2 class="section" id='H1'><a href="#H1" class="sectionlink"><i class="icon-share-alt"> </i></a>Configure Git Large File Storage</h2><p>Gitblit provides a filestore that supports the <a href="https://git-lfs.github.com/">Git Large File Storage (LFS) API</a>.</p> +<h3 class="section" id='H2'><a href="#H2" class="sectionlink"><i class="icon-share-alt"> </i></a>Server Configuration</h3><p>Gitblit is configured to work straight away. However you may want to update the following in <code>gitblit.properties</code>:</p> +<table class="table"> +<thead> +<tr><th>parameter</th><th>value</th><th>description</th></tr> +</thead> +<tbody> +<tr> + <th>filestore.storageFolder</th><td>${baseFolder}/lfs</td> + <td>The path on the server where filestore objects are to be saved.</td> +</tr> +<tr> + <th>filestore.maxUploadSize</th><td>-1</td> + <td>The maximum allowable size that can be uploaded to the filestore. Once a file is uploaded it will be unaffected by later changes in this property. The default of -1 indicates no limits.</td> +</tr> +</tbody> +</table> +<h3 class="section" id='H3'><a href="#H3" class="sectionlink"><i class="icon-share-alt"> </i></a>Limitations</h3><p>Gitblit currently provides a server-only implementation of the opensource Git LFS API.</p> +<ol> + <li>Files in the filestore are not currently searchable by Lucene.</li> + <li>Mirroring a repository that uses Git LFS will only mirror the pointer files, not the large files.</li> + <li>Federation - Only the pointer files, not the large files, are transfered.</li> +</ol><p>Items 2 & 3 are pending <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=470333">JGit Git LFS client capabilities</a>.</p> +<h3 class="section" id='H4'><a href="#H4" class="sectionlink"><i class="icon-share-alt"> </i></a>How does it work?</h3> +<ol> + <li>Files that should be handled by Git LFS are defined in the <code>.gitattributes</code> file.</li> + <li>Git LFS installs a pre-commit hook when installed <code>git lfs install</code>.</li> + <li>When a commit is made the pre-commit hook replaces the defined Git LFS files with a pointer file containing metadata about the file so that it can be found later.</li> + <li>When a commit is pushed, the changeset is sent to the git repository and the large files are sent to the filestore.</li> +</ol><p>For further details check out the <a href="https://github.com/github/git-lfs/blob/master/docs/spec.md">Git LFS specification</a>.</p> +<h3 class="section" id='H5'><a href="#H5" class="sectionlink"><i class="icon-share-alt"> </i></a>Convert/Migrate existing repository</h3><p>It is possible to migrate an existing repository containing large files to one that leverages the filestore. However, commit hash history will be altered.</p><p>The following command may be run on a local repository:</p> +<pre><code>git filter-branch --prune-empty --tree-filter ' +git lfs track "*.docx" "*.pdf" > /dev/null +git add .gitattributes +git ls-files | xargs -d "\n" git check-attr filter | grep "filter: lfs" | sed -r "s/(.*): filter: lfs/\1/" | xargs -d "\n" -r bash -c "git rm -f --cached \"\$@\"; git add \"\$@\"" bash \ +' --tag-name-filter cat -- --all +</code></pre> +<h3 class="section" id='H6'><a href="#H6" class="sectionlink"><i class="icon-share-alt"> </i></a>Further Considerations</h3><p>While <a href="https://github.com/github/git-lfs/wiki/Implementations">other Git LFS implementations are available</a> as there is no current <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=470333">JGit LFS client capability</a>, Gitblit will be unable to access them. +<!-- End Markdown --> +<div ><ul class="pager"><li class="previous"><a href="setup_fail2ban.html">← fail2ban</a></li> </ul></div><footer class="footer"><p class="pull-right">generated 2016-06-22</p>
+<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> +</footer> +</div> +<!-- Google Analytics -->
+<script type="text/javascript">
+ var _gaq = _gaq || [];
+ _gaq.push(['_setAccount', 'UA-24377072-1']);
+ _gaq.push(['_trackPageview']);
+
+ (function() {
+ var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;
+ ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
+ var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);
+ })();
+</script> + +</body> +</html>
\ No newline at end of file |