Note: This cookbook is still a work in progress!

Installs the Gerrit review system. Optional support for MySQL database and Apache2 as proxy server is included.

• Debian 6.0 and 7.0
• other platforms untested

• build-essential
• mysql
• database
• java
• git
• maven
• apache2
• ssl_certificates
• Optional: git-daemon

These attributes are set by the cookbook by default.

• node['gerrit']['flavor'] - Installation type, either war or source. war downloads the .war file from download_url. source checks out the git repository repository and builds it using Maven. Please note that the source flavor is absolutely not recommended for production use. Building Gerrit will cause severe load on your server!
• node['gerrit']['version'] - Gerrit version to deploy.
• node['gerrit']['download_url'] - URL to download the .war file from. Defaults to http://gerrit.googlecode.com/files/gerrit-#{node['gerrit']['version']}.war
• node['gerrit']['repository'] - Git repository containing the Gerrit source code. Defaults to https://gerrit.googlesource.com/gerrit.
• node['gerrit']['reference'] - Git revision or branch name to checkout.

• node['gerrit']['user'] - User, under which Gerrit runs (container.user). Defaults to gerrit.
• node['gerrit']['group'] - Group name of the gerrit user. Defaults to gerrit.
• node['gerrit']['home'] - Home directory of the gerrit user. Defaults to /var/gerrit.
• node['gerrit']['install_dir'] - Directory, where Gerrit is installed into. Defaults to node['gerrit']['home']/review.

• node['gerrit']['hostname'] - The default hostname for Gerrit to be accessed through. Defaults to fqdn.
• node['gerrit']['canonicalWebUrl'] - The default URL for Gerrit to be accessed through. Typically this would be set to "http://review.example.com/" or "http://example.com/gerrit/" so Gerrit can output links that point back to itself. (gerrit.canonicalWebUrl). Defaults to http://#{node['fqdn']}/. connections on (sshd.listenAddress).
• node['gerrit']['canonicalGitUrl'] - The URL under which the repositories are available through the Git protocol (gerrit.canonicalGitUrl). Has to include the protocol (git://). As Gerrit does not support the Git protocol, such a server has to be managed through another cookbook, e.g. git-daemon.
• node['gerrit']['proxy'] - Enable Apache2 reverse proxy in front of Gerrit. Defaults to true, which makes Gerrit available on port 80.
• node['gerrit']['ssl'] - Enable SSL for the reverse proxy. Defaults to false.
• node['gerrit']['ssl_certificate']- Makes use of the ssl_certificates, to use a certain SSL certificate. An entry in the ssl_certificates data bag matching the given name must exist. Defaults to nil, which results in snakeoil certificates being used.

• node['gerrit']['port'] - Specifies the local addresses the internal SSHD should listen for

• node['gerrit']['database']['type'] - Type of database server to connect to (database.type). Defaults to MYSQL.

• node['gerrit']['database']['hostname'] - Hostname of the database server (database.hostname). Defaults to localhost.

• node['gerrit']['database']['name'] - For POSTGRESQL or MYSQL, the name of the database on the server. For H2, this is the path to the database, and if not absolute is relative to $site_path (database.database). Defaults to gerrit.

• node['gerrit']['database']['username'] - Username to connect to the database server as (database.username). Defaults to gerrit.

• node['gerrit']['database']['password'] - Password to authenticate to the database server with (database.password). Defaults to gerrit.

• node['gerrit']['auth']['type'] - Set auth type (auth.type). Defaults to OPENID.

Set the options for the sendemail section. All attributes below node['gerrit']['sendemail'] are rendered into the gerrit.config's [sendemail] section.

E.g. to change the sendemail.enable setting, set node['gerrit']['sendemail']['smtpServer'].

• node['gerrit']['theme']['compile_files] - Hash of files deployed to etc/. Possible file names are GerritSite(Header|Footer).html and GerritSite.css. See Gerrit docs. Gerrit will automatically reload these files, as long as not deactivated explicitly.
• node['gerrit']['static_files'] - Hash of files deployed to static/. Files, which can be used in a custom theme and are available through #{node['gerrit']['canonicalWebUrl']}/static/. See Gerrit docs.

• node['gerrit']['replication']['remotes'] - Hash of remotes to populate to replication.config. Keys should be the remote name, while values should be a hash of options to apply to that remote, such as url, threads, etc.`. See Gerrit docs.
• node['gerrit']['replication']['plugin_download_url'] - URL to download the replication.jar plugin file from. The build must be compatible with the Gerrit version specified in node['gerrit']['version']. See Gerrit docs.

Sets up Gerrit. Includes other recipes, if needed (no need to add them to your run list on your own).

Configures the MySQL server, if node['gerrit']['database']['type'] == "MYSQL".

Installs Apache2 as reverse proxy in front of Gerrit, if enabled through node['gerrit']['proxy']. This also binds Gerrit's HTTPD to localhost on port 8080. HTTPS support is available, if node['gerrit']['proxy'] is set.

Deploys an SSH key-pair for the magic Gerrit Code Review user. See suexec and File etc/peer_keys. Intended to be used in scripts.

Checks out the Git repository configured in node['gerrit']['repository'] and runs the tools/release.sh script, which builds Gerrit. Note: This is not intended for production use, but might be useful while developing Gerrit!

Create a role for the Gerrit server. See above for attributes that can be entered here.

% cat roles/gerrit.rb
name 'gerrit'
description 'A Gerrit server'
run_list(
  'recipe[gerrit]',
  'recipe[git-daemon]'
)
override_attributes(
  'gerrit' => {
    'version' => 'full-2.5.0',
  }
)

Using the git-daemon cookbook is suggested, if you want to make your repositories available also through the Git protocol. Gerrit itself only supports SSH and HTTP(S).

When flavor war is specified, the .war file is downloaded into node['gerrit']['install_dir']/war.. This triggers to run java -jar gerrit.war init -d /path/to/gerrit, which initializes the Gerrit installation.

When the Git repository changes, a new build through Gerrit's tools/release.sh is triggered and created through Maven. Afterwards, the resulting .war file is processed as described above for war deplyoment.

A new Gerrit version is installed, as soon as a new .war file is available through one of the methods described above. The init command is called automatically and if schema migrations have to be made, they are executed automatically.

Author:: Steffen Gebert ([email protected])

Copyright:: 2012, Steffen Gebert / TYPO3 Association

Licensed under the Apache License, Version 2.0 (the 'License'); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.