diff options
| author | Paul Martin <paul@paulsputer.com> | 2015-10-10 12:46:51 +0100 |
|---|---|---|
| committer | Paul Martin <paul@paulsputer.com> | 2015-10-10 12:50:00 +0100 |
| commit | bd0e83e350fc703bcae72a28c41b09d9a9cec594 (patch) | |
| tree | f9c3d5112600f89f64ded2d56472664db185750a /src/main/java/com/gitblit/wicket/pages/FilestoreUsage.html | |
| parent | f2a9b239d2605b36401dd723ac22c195b938f8e0 (diff) | |
| download | gitblit-bd0e83e350fc703bcae72a28c41b09d9a9cec594.tar.gz gitblit-bd0e83e350fc703bcae72a28c41b09d9a9cec594.zip | |
Git-LFS support
+ Metadata maintained in append-only JSON file providing complete audit
history.
+ Filestore menu item
+ Lists filestore items
+ Current size and availability
+ Link to GitBlit Filestore help page (top right)
+ Hooks into existing repository permissions
+ Uses default repository path for out-of-box operation with Git-LFS
client
+ accessRestrictionFilter now has access to http method and auth header
+ Testing for servlet and manager
Diffstat (limited to 'src/main/java/com/gitblit/wicket/pages/FilestoreUsage.html')
| -rw-r--r-- | src/main/java/com/gitblit/wicket/pages/FilestoreUsage.html | 69 |
1 files changed, 69 insertions, 0 deletions
diff --git a/src/main/java/com/gitblit/wicket/pages/FilestoreUsage.html b/src/main/java/com/gitblit/wicket/pages/FilestoreUsage.html new file mode 100644 index 00000000..e9bff47c --- /dev/null +++ b/src/main/java/com/gitblit/wicket/pages/FilestoreUsage.html @@ -0,0 +1,69 @@ +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" + xmlns:wicket="http://wicket.apache.org/dtds.data/wicket-xhtml1.3-strict.dtd" + xml:lang="en" + lang="en"> + +<body> +<wicket:extend> +<div class="container"> +<div class="markdown"> +<div class="row"> +<div class="span10 offset1"> + + <div class="alert alert-danger"> + <h3><center>Using the Filestore</center></h3> + <p> + <strong>All clients intending to use the filestore must first install the <a href="https://git-lfs.github.com/">Git-LFS Client</a> and then run <code>git lfs init</code> to register the hooks globally.</strong><br/> + <i>This version of GitBlit has been verified with Git-LFS client version 0.6.0 which requires Git v1.8.2 or higher.</i> + </p> + </div> + + <h3>Clone</h3> + <p> + Just <code>git clone</code> as usual, no further action is required as GitBlit is configured to use the default Git-LFS end point <code>{repository}/info/lfs/objects/</code>.<br/> + <i>If the repository uses a 3rd party Git-LFS server you will need to <a href="https://github.com/github/git-lfs/blob/master/docs/spec.md#the-server">manually configure the correct endpoints</a></i>. + </p> + + <h3>Add</h3> + <p>After configuring the file types or paths to be tracked using <code>git lfs track "*.bin"</code> just add files as usual with <code>git add</code> command.<br/> + <i>Tracked files can also be configured manually using the <code>.gitattributes</code> file</i>.</p> + + <h3>Remove</h3> + <p>When you remove a Git-LFS tracked file only the pointer file will be removed from your repository.<br/> + <i>All files remain on the server to allow previous versions to be checked out.</i> + </p> + + <h3>Learn more...</h3> + <p><a href="https://github.com/github/git-lfs/blob/master/docs/spec.md">See the current Git-LFS specification for further details</a>.</p> + <br /> + + <div class="alert alert-warn"> + <h3><center>Limitations & Warnings</center></h3> + <p>GitBlit currently provides a server-only implementation of the opensource Git-LFS API, <a href="https://github.com/github/git-lfs/wiki/Implementations">other implementations</a> are available.<br/> + However, until <a href="https://bugs.eclipse.org/bugs/show_bug.cgi?id=470333">JGit provides Git-LFS client capabilities</a> some GitBlit features may not be fully supported when using the filestore. + Notably: + <ul> + <li>Mirroring a repository that uses Git-LFS - Only the pointer files, not the large files, are mirrored.</li> + <li>Federation - Only the pointer files, not the large files, are transfered.</li> + </ul> + </p> + </div> + + <div class="alert alert-info"> + <h3><center>GitBlit Configuration</center></h3> + <p>GitBlit provides the following configuration items when using the filestore: + <h4>filestore.storageFolder</h4> + <p>Defines the path on the server where filestore objects are to be saved. This defaults to <code>${baseFolder}/lfs</code></p> + <h4>filestore.maxUploadSize</h4> + <p>Defines 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. This defaults to <code>-1</code> indicating no limits.</p> + </p> + </div> + +</div> +</div> +</div> +</div> +</wicket:extend> +</body> +</html> |