Adoptable Cookbooks List

Looking for a cookbook to adopt? You can now see a list of cookbooks available for adoption!
List of Adoptable Cookbooks

Supermarket Belongs to the Community

Supermarket belongs to the community. While Chef has the responsibility to keep it running and be stewards of its functionality, what it does and how it works is driven by the community. The chef/supermarket repository will continue to be where development of the Supermarket application takes place. Come be part of shaping the direction of Supermarket by opening issues and pull requests or by joining us on the Chef Mailing List.

Select Badges

Select Supported Platforms

Select Status


git_better (5) Versions 1.0.0

Provide a selection of better Git Provider(s) for Chef `deploy` resources

cookbook 'git_better', '= 1.0.0', :supermarket
cookbook 'git_better', '= 1.0.0'
knife supermarket install git_better
knife supermarket download git_better
Quality 100%

git_better GitHub Latest Release Build Status Chef Cookbook

A Chef cookbook to provide a selection of better Git Provider(s) for Chef deploy resources.

Supported Platforms


  • RHEL: Amazon Linux


  • RHEL: RedHat, CentOS, Scientific, Oracle, Fedora, etc.
  • Debian: Debian, Ubuntu, LinuxMint, etc.
  • MacOS X: MacOS X, MacOS X Server, etc.
  • Windows: Windows, MinGW32, MSWin, etc.
  • Solaris: Solaris, Solaris2, OpenSolaris, OmniOS, SmartOS, etc.


Assumes that git >= 1.7.10 is installed on the system (Chef assumes the same).


Add the git_better cookbook to your Berksfile or other cookbook-fetching mechanism.

Then, in some recipe file where you are using a deploy resource:

deploy '/srv/www/my_app' do

  # Set `scm_provider` to `Chef::Provider::GitSingleBranch` (instead of `:git`, or default)
  scm_provider Chef::Provider::GitSingleBranch

  repository   ''
  revision     'my_branch'
  user         'deploy'
  group        'www-data'

  # ...
  # etc., other attributes, etc.
  # ...

Deploy a Git-based application from the repository but ONLY clone the my_branch branch.


If the shallow_clone attribute of a deploy resource is not included or is set to false, this provider will default to setting depth equal to 1. However, if shallow_clone is set to true, Chef unfortunately forcibly binds this provider to using a depth of 5 instead.


  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Added some feature')
  4. Run the unit tests (bundle exec rake spec)
  5. Run test kitchen (bundle exec kitchen test)
  6. Push to the branch (git push origin my-new-feature)
  7. Create new Pull Request


Copyright (c) 2015, James M. Greene (MIT License)

Dependent cookbooks

This cookbook has no specified dependencies.

Contingent cookbooks

There are no cookbooks that are contingent upon this one.

git_better CHANGELOG

This file is used to list changes made in each version of the git_better cookbook.


  • Initial release of the git_better cookbook!

Check the Markdown Syntax Guide for help with Markdown.

The Github Flavored Markdown page describes the differences between markdown on github and standard markdown.

Foodcritic Metric

1.0.0 passed this metric