This plugin integrates GitBlit 1.7.1 as a repository browser into Gerrit, with full SSO through Gerrit.
For a list of contributors, see at GitHub.
This is a privately maintained fork of the official Gerrit-Gitblit plugin. Please report any issues with this plugin at the GitHub issue tracker.
For the official plugin, see the repository at Google Code.
There are two different configurations: one for Gerrit so it knows how to generate links that will be processed by the plugin, and an optional GitBlit configuration for the plugin itself.
In Gerrit’s gerrit.config, define the [gitweb] section as follows:
[gitweb]
type = custom
url = plugins/gitblit/
linkname = browse
project = summary/?r=${project}
revision = commit/?r=${project}&h=${commit}
branch = log/?r=${project}&h=${branch}
filehistory = history/?f=${file}&r=${project}&h=${branch}
file = blob/?r=${project}&h=${commit}&f=${file}
roottree = tree/?r=${project}&h=${commit}
This is normally done automatically if you add the plugin and run through java -jar gerrit.war init -d site_path, but you can also add this manually to Gerrit’s config file. The linkname can be adapted to your taste.
This plugin adds a “GitBlit” top menu to Gerrit, and also a new sub-menu item to the “Projects” top menu. Since v2.11.162.2 of this plugin, the link texts for all sub-menu items can be configured to your taste in a [plugin "gitblit"] section in your gerrit.config. If the section is not present, or some values in that section are not defined, the plugin uses built-in default texts. The default configuration would correspond to
[plugin "gitblit"]
repositories = Repositories
activity = Activity
documentation = Documentation
search =
browse = Browse
The first four are sub-menu items of the “GitBlit” top menu, the last one is a new “browse” sub-menu item in Gerrit’s “Projects” menu that is shown for Gerrit’s “current” project (since v2.11.162.2).
The “search” sub-menu item is by default not set and will thus not be shown. Setting it makes only sense if you enable GitBlit indexing on some of your projects. See the GitBlit documentation for more information on that.
The plugin includes a minimal default configuration to make GitBlit act only as a repository viewer. You can augment that with further customizations in a normal gitblit.properties file located in Gerrit’s $GERRIT_SITE/etc directory. The built-in configuration, which ensures that GitBlit is configured as a viewer only, always takes precedence. Also, the git.repositoriesFolder property is always set to Gerrit’s git directory at $GERRIT_SITE/git.
To see the built-in configuration, access it at gitblit.properties.
By default, the built-in configuration does allow anonymous browsing, subject to the repository and ref-level access restrictions defined in Gerrit. If you want to lock the GitBlit plugin to allow only logged-in users to browse, set in $GERRIT_SITE/etc/gitblit.properties the key web.authenticateViewPages = true. This is the only key of the built-in configuration that you can override.
GitBlit’s ticket service, fan-out service, and its plugin mechanism are disabled in this plugin, as is ssh access through GitBlit since Gerrit already provides that. Also disabled is Gitblit’s LFS implementation.
The GitBlit ${baseFolder} is the plugin’s data directory provided by Gerrit at $GERRIT_SITE/data/gitblit/.
Up to and including v2.11.162.1 of this plugin, GitBlit’s
${baseFolder}was at$GERRIT_SITE/etc/gitblit/. If you upgraded from that or an earlier version and do have data in$GERRIT_SITE/etc/gitblit/, move it over to the new place. The directory$GERRIT_SITE/etc/gitblit/can then be removed.
web.maxCommitDiffContext = [1 .. 10]
Since 2.12.162.2. In a GitBlit commit diff, diffs of all changed files in a commit are shown on one page. This setting
defines how many context lines shall be shown shown at most in such diffs. The default is 10, but can be reduced further through this property
in your gitblit.properties file.
If the Gerrit preference setting for the number of context lines in diffs is lower than this GitBlit setting, the Gerrit setting is taken.
For single-file diffs, the plugin respects the Gerrit preference setting of the currently logged-in user for the number of context lines in a diff. For non-logged-in users, the GitBlit default of 3 context lines applies. (The Gerrit default is 10.)
Report bugs or make feature requests at the GitHub issue tracker.
For logged-in users, their preference page (“my profile”) is accessible but non-functional. Per-user GitBlit preferences cannot be saved. There are no plans to fix this; GitBlit uses a plain file-based mechanism to store such user preferences anyway, which won’t scale well for large user bases.
I have never tried Lucene indexing of repositories through GitBlit. It’s functionality I have never needed, and I don’t plan to ever do something about it in case it doesn’t work.