Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sous-chefs/git
Development repository for the git cookbook
https://github.com/sous-chefs/git
chef chef-cookbook chef-resource git hacktoberfest managed-by-terraform
Last synced: 6 days ago
JSON representation
Development repository for the git cookbook
- Host: GitHub
- URL: https://github.com/sous-chefs/git
- Owner: sous-chefs
- License: apache-2.0
- Created: 2012-03-14T18:31:23.000Z (almost 13 years ago)
- Default Branch: main
- Last Pushed: 2024-07-15T17:10:32.000Z (5 months ago)
- Last Synced: 2024-10-29T21:24:43.285Z (about 1 month ago)
- Topics: chef, chef-cookbook, chef-resource, git, hacktoberfest, managed-by-terraform
- Language: Ruby
- Homepage: https://supermarket.chef.io/cookbooks/git
- Size: 452 KB
- Stars: 124
- Watchers: 39
- Forks: 175
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
- awesome-chef - git
README
# Git Cookbook
[](https://supermarket.chef.io/cookbooks/git)
[](https://github.com/sous-chefs/git/actions?query=workflow%3Aci)
[](#backers)
[](#sponsors)
[](https://opensource.org/licenses/Apache-2.0)
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](https://sous-chefs.org/) or come chat with us on the Chef Community Slack in [#sous-chefs](https://chefcommunity.slack.com/messages/C2V7B88SF).
## 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`](./documentation/git_client.md): Manages a Git client installation on a machine. Source install action is available on Linux.
- [`git_config`](./documentation/git_config.md): 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.](https://opencollective.com/sous-chefs/contributors.svg?width=890&button=false)
### 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.
