Forge Home

gitblit

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

10,700 downloads

6,807 latest version

5.0 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

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 2023.5.x, 2023.4.x, 2023.3.x, 2023.2.x, 2023.1.x, 2023.0.x, 2021.7.x, 2021.6.x, 2021.5.x, 2021.4.x, 2021.3.x, 2021.2.x, 2021.1.x, 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

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'dsestero-gitblit', '1.0.3'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add dsestero-gitblit
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install dsestero-gitblit --version 1.0.3

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

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.