Forge Home

gitolite

A module to configure gitolite

8,223 downloads

131 latest version

4.7 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.4.0 (latest)
  • 1.3.4
  • 1.3.3
  • 1.3.2
  • 1.3.1
  • 1.3.0
  • 1.2.2
  • 1.2.1
  • 1.2.0
released Dec 16th 2022
This version is compatible with:
  • Puppet Enterprise 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 >=4.0.0 < 7.0.0
  • , Ubuntu

Start using this module

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

Add this module to your Puppetfile:

mod 'cirrax-gitolite', '1.4.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add cirrax-gitolite
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install cirrax-gitolite --version 1.4.0

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
Tags: git, gitolite

Documentation

cirrax/gitolite — version 1.4.0 Dec 16th 2022

gitolite puppet module

Build Status Puppet Forge Puppet Forge Puppet Forge Puppet Forge

Table of Contents

  1. Overview
  2. Usage
  3. Reference
  4. Contribuiting

Overview

This module is used to configure gitolite and to configure git repositories and permissions.

Usage

To start using gitolite you need to include the gitolite main class.

A minimal example might be:

class{'gitolite':
  user     => 'gitolite',
  userhome => '/srv/gitolite',
}

The gitolite::admin class is only used if you like to do all admin work through puppet (like create new repos, users and permissions). If gitolite::admin is not included, you can use the admin git repo to do these tasks (feature of gitolite).

Reference

Find documentation about possible parameters on top of each manifest. Also see REFERENCE.md

classes

gitolite

The main class to install and configure gitolite.

gitolite::admin

This class manages the gitolite.conf file and prepares to manage the ssh keys with puppet.

Use this class if you want to do all admin work through puppet (add users, repositories and permissions)

do not use this class if you want to use the gitolite-admin.git repositoy for these tasks. (you have been warned ! if you use it once, there is no puppet way back, only manual work will get you back)

gitolite::client

Install the git package.

gitolite::ssh_key

Generate an SSH authentication key for authentication to a remote system (eg. for git hooks).

gitolite::params

System specific parameters.

defined types

gitolite::repo

Define git repositories

gitolite::repos

Define several git repositories with merged default values.

gitolite::user

This resources defines a git user

gitolite::users

Define several git users with merged default values.

Contributing

Please report bugs and feature request using GitHub issue tracker.

For pull requests, it is very much appreciated to check your Puppet manifest with puppet-lint and the available spec tests in order to follow the recommended Puppet style guidelines from the Puppet Labs style guide.

Authors

This module is mainly written by Cirrax GmbH.

See the list of contributors for a list of all contributors.