gitblit

This Puppet module manages Gitblit (http://gitblit.com/)

Dario Sestero

dsestero

9,531 downloads

5,843 latest version

5.0 quality score

Version information

  • 1.0.3 (latest)
  • 1.0.2
  • 1.0.1
  • 1.0.0
released Jul 12th 2016
This version is compatible with:
  • Puppet Enterprise 2021.0.x, 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x, 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 3.0.0
  • Ubuntu

Start using this module

Documentation

dsestero/gitblit — version 1.0.3 Jul 12th 2016

#gitblit

####Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with gitblit
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how
  6. Limitations - OS compatibility, etc.
  7. Development - Guide for contributing to the module

##Overview

This is the gitblit module. It installs, sets up and starts the gitblit service to allow small groups to host their Git repositories and make them accessible with a web browser.

##Module Description

The module installs the Jetty app server, then download and install the distribution of gitblit war, and sets up the file system in order to run the gitblit service.

##Setup

###What gitblit affects

The module installs the jetty package which in turn creates a jetty system user. Furthermore, the module installs the Gitblit war distribution, sets up jetty defaults in /etc/defaults/jetty and register at boot and starts the jetty service, listening on the specified port.

###Setup Requirements

This modules requires the following other modules to be installed:

  • dsestero/download_uncompress

    to provide the basic capability to download and unzip the Gitblit distribution

  • dsestero/java

    to install a suitable java development environment

###Beginning with gitblit

To install Gitblit as a service with default configuration, it is possible to use a declaration as the following:

include gitblit

##Usage

To install the Gitblit service listening on port 9090 and hosting the git repositories under /srv/git a typical declaration would be:

  class gitblit { 'install_gitblit':
    port             => '9090',
    gitblit_home     => '/srv/git',
  }

##Reference

###Public Classes

###Private Classes

###gitblit::gitblit Installs, configure and sets up a gitblit service.

####Parameters

#####distribution String. Name or full url of the Gitblit war distribution to download. Defaults to gitblit-1.6.2.war which will be downloaded from the distributions_base_url key defined in hiera (see the README of the download_uncompress module).

#####port String. Port the jetty service will use. Defaults to 8080.

#####gitblit_home String. Path of the directory where Gitblib repositories will be hosted. Defaults to /var/lib/gitblit.

##Limitations

At the moment the module targets only OpenJDK on Ubuntu platforms. Specifically, it is tested only on Ubuntu 12.04 distributions, although probably it will work also on more recent versions.

##Development

If you need some feature please send me a (pull) request or send me an email at: dsestero 'at' gmail 'dot' com.