Git Cookbook

(opens in a new tab) (opens in a new tab) (opens in a new tab)

Installs git_client from package or source. Optionally sets up a git service under xinetd.

Scope

This cookbook is concerned with the Git SCM utility. It does not address ecosystem tooling or related projects.

Maintainers

This cookbook is maintained by the Sous Chefs. The Sous Chefs are a community of Chef cookbook maintainers working together to maintain important cookbooks. If you’d like to know more please visit sous-chefs.org (opens in a new tab) or come chat with us on the Chef Community Slack in #sous-chefs (opens in a new tab).

Requirements

Chef

Chef 15.3+

Cookbooks

ark (for git_client source install)

Usage

Include git::default, git::windows, or git::source in your cookbook OR use the git_client resource directly.

Resources Overview

git_client: Manages a Git client installation on a machine. Source install action is available on Linux.
git_config: Sets up Git configuration on a node.

Recipes

This cookbook ships with ready to use, attribute driven recipes that utilize the git_client and git_service resources. As of cookbook 4.x, they utilize the same attributes layout scheme from the 3.x. Due to some overlap, it is currently impossible to simultaneously install the Git client as a package and from source by using the "manipulate the node attributes and run a recipe" technique. If you need both, you'll need to utilize the git_client resource in a recipe.

Attributes

Windows

node['git']['version'] - git version to install
node['git']['url'] - URL to git package
node['git']['checksum'] - package SHA256 checksum
node['git']['display_name'] - windows_package resource Display Name (makes the package install idempotent)

Linux

node['git']['prefix'] - git install directory
node['git']['version'] - git version to install
node['git']['url'] - URL to git tarball
node['git']['checksum'] - tarball SHA256 checksum
node['git']['use_pcre'] - if true, builds git with PCRE enabled

Contributors

This project exists thanks to all the people who contribute. (opens in a new tab)

Backers

Thank you to all our backers!