blob: bbe871109e7d00e2ec48b7c0880cf8f5a7674031 [file] [log] [blame]
Gerrit2 - Gitweb Integration
============================
Gerrit2 can generate hyperlinks to gitweb, allowing users to jump
from Gerrit content to the same information, but shown by gitweb.
To enable the gitweb integration, update `system_config.gitweb_url`
with the URL of your gitweb CGI.
The CGI's `$projectroot` should be `'$git_base_path'`, or a fairly
current replica. If a replica is being used, ensure it uses a full
mirror, so the `refs/changes/*` namespace is available.
====
UPDATE system_config SET gitweb_url='http://example.com/gitweb.cgi'
====
After updating `system_config`, the Gerrit server must be restarted
and clients must reload the host page to see the change.
Configurable Parameters
-----------------------
Some columns in the `system_config` table may be set to control
how Gerrit interacts with gitweb.
gitweb_url
~~~~~~~~~~
Defines the web location where a `gitweb.cgi` is installed to browse
`'$git_base_path'` and the repositories it contains.
Gerrit appends any necessary query arguments onto the end of this URL.
For example, "?p=$project.git;h=$commit".
Access Control
--------------
Gitweb access controls can be implemented using standard web server
access controls. This isn't typically integrated with Gerrit's own
access controls. Caution must be taken to ensure the controls are
consistent if access needs to be restricted.
Caching Gitweb
--------------
If your repository set is large and you are expecting a lot
of users, you may want to look at the caching forks used by
high-traffic sites like kernel.org or repo.or.cz.