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 or come chat with us on the Chef Community Slack in #sous-chefs.
Requirements
Platforms
The following platforms have been tested with Test Kitchen:
|---------------+-------|
| amazonlinux-2 | X |
|---------------+-------|
| centos-7 | X |
|---------------+-------|
| centos-8 | X |
|---------------+-------|
| fedora | X |
|---------------+-------|
| debian-9 | X |
|---------------+-------|
| debian-10 | X |
|---------------+-------|
| ubuntu-16.04 | X |
|---------------+-------|
| ubuntu-18.04 | X |
|---------------+-------|
| ubuntu-20.04 | X |
|---------------+-------|
| openSUSE Leap | X |
|---------------+-------|
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_service: Sets up a Git service via xinetd. WARNING: This is insecure and will probably be removed in the future
git_config: Sets up Git configuration on a node.
git_client
The git_client resource manages the installation of a Git client on a machine.
Note: on macOS systems homebrew must first be installed on the system before running this resource. Prior to version 9.0 of this cookbook homebrew was automatically installed.
Currently, there are distinct sets of resource properties, used by the providers for source, package, macos, and windows.
used by Linux provider
package_name - Package name to install on Linux machines. Defaults to a calculated value based on platform.
package_version - Defaults to nil.
package_action - Defaults to :install
used by Linux source install
source_prefix - Defaults to '/usr/local'
source_url - Defaults to a calculated URL based on source_version
source_version - Defaults to 2.8.1
source_use_pcre - configure option for build. Defaults to false
source_checksum - Defaults to a known value for the 2.8.1 source tarball
used by the Windows provider
windows_display_name - Windows display name
windows_package_url - Defaults to the Internet
windows_package_checksum - Defaults to the value for 2.8.1
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.
Backers
Thank you to all our backers!
Sponsors
Support this project by becoming a sponsor. Your logo will show up here with a link to your website.
请发表评论