git

Table of Contents

1. Description
2. Setup - The basics of getting started with git
   • Beginning with git
3. Usage - Configuration options and additional functionality
4. Reference - An under-the-hood peek at what the module is doing and how
5. Limitations - OS compatibility, etc.
6. Development - Guide for contributing to the module

Description

This is an all-inclusive Git management module. Manage the Git package as well as repos and config files.

If you're looking to get all the Git functionality you'll ever need, look no further.

Setup

Beginning with git

Start with a basic class declaration to install and manage the Git package:

class { 'git': }

Usage

After intial declaration, add a configuration file:

git::config_file { '/home/user/.gitconfig':
  user_email => 'user@example.com',
  user_name  => 'User Smith',
  aliases    => [{'a' => 'add'}, {'co' => 'checkout'}]
}

Reference

git

• manage_package Boolean Defaults to true, manage the git package.

• package_ensure ensure Defaults to present, used only if manage_package is true

• package_name String Defaults to 'git', used only if manage_package is true

git::user

• username String Git user name

• email String Specify user's email

• full_name String Specify the user's name

git::config_file

• config_file String Defaults to $name, path to configuration file

• user Git::User Pass in a user resource

• aliases Array An array of hashes for git aliases

Limitations

Currently this module has only been verified on Ubuntu 14.04

Development

Please feel free to submit issues and PRs at www.github.com/eputnam/eputnam-git