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

The habitat cookbook has been deprecated

Author provided reason for deprecation:

The habitat cookbook has been deprecated and is no longer being maintained by its authors. Use of the habitat cookbook is no longer recommended.


habitat (74) Versions 0.1.1

Habitat related resources for chef-client

cookbook 'habitat', '= 0.1.1', :supermarket
cookbook 'habitat', '= 0.1.1'
knife supermarket install habitat
knife supermarket download habitat
Quality 50%

Habitat Cookbook

Build Status Cookbook Version

This cookbook provides resources for working with Habitat. It is intended that these resources will be included in core Chef at some point in the future, so it is important to note:

  • APIs are subject to change
  • Code style adheres to chef-core (chefstyle)
  • Habitat is a rapidly changing product, and this cookbook may change rapidly as well

(this is a pre-1.0 version, after all)



  • RHEL 6+
  • Ubuntu 12.04+


Chef 12.11, for the systemd_unit resource.

Resources are written in the style of Chef 12.5 custom resources where applicable or available.


This cookbook has no external cookbook dependencies. It does not attempt to maintain backwards compatibility with previous Chef versions.



Installs Habitat on the system using the install script.

This resource is written as a Chef 12.5 custom resource.


  • install: Installs Habitat. Does nothing if the hab binary is found in the default location for the system (/bin/hab on Linux, /usr/local/bin/hab on macOS)
  • upgrade: Installs the latest version of Habitat, does not check if the binary exists


  • install_url: URL to the install script, default is from the habitat repo


hab_install 'install habitat'


Install the specified Habitat package. Requires that Habitat is installed

This resource is written as a library resource because it subclasses Chef's package resource/provider to get features such as the multi-package API).


  • install: Installs the specified package
  • upgrade: aliased to install


  • package_name: A Habitat package name, must include the origin and package name separated by /, for example, core/redis
  • version: A Habitat version which contains the version and optionally a release separated by /, for example, 3.2.3 or 3.2.3/20160920131015

While it is valid to pass the version and release with a Habitat package as a "fully qualified package identifier" when using the hab CLI, they must be specified using the version property when using this resource. See the examples below.


hab_package "core/redis"

hab_package "core/redis" do
  version "3.2.3"

hab_package "core/redis" do
  version "3.2.3/20160920131015"


Manages a Habitat application service using systemd. It will drop off a unit file using the systemd_unit provider in Chef.

This resource is written as a library resource because it subclasses Chef's service resource/provider to get built in properties and actions.

This resource requires Chef 12.11 or higher.

A future version of this resource may support other service providers.


  • start: (default action) writes a systemd_unit for the application and starts the service
  • enable: writes the systemd_unit for the application
  • stop: stops the application service


  • unit_content: Content passed into the systemd_unit resource as its content property. By default this is a hash that starts the service with /bin/hab start.
  • environment: An environment string to pass into the unit file. By default this contains the location of the SSL certificate from the Habitat core/cacerts package.


hab_package 'core/redis'

hab_service 'core/redis' do
  action :enable

# unit_content as a hash
hab_service 'myorigin/myapp' do
    Unit: {
      Description: 'myapp',
      After: ' audit.service'
    Service: {
      Environment: 'HAB_MYAPP=workers=3'
      ExecStart: '/bin/hab start myorigin/myapp'

# unit_content as a string
hab_service 'myorigin/myapp' do
  unit_content <<-EOF
Description = myapp
After = audit.service

Environment = "HAB_MAPP=workers=3"
ExecStart = "/bin/hab start myorigin/myapp"
Restart = "on-failure"

License and Authors

Copyright 2016, Chef Software, Inc

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.


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

v0.1.1 (2016-11-10)

  • Removed Chef 11 compatibility in the metadata
  • Resolved Chefstyle warnings
  • Resolved foodcritic warnings
  • Added a chefignore file
  • Updated the gitignore file
  • Improve the readme format and add badges
  • Update all test deps to current
  • Remove the apt testing dependency
  • Add integration testing in Travis using kitchen-dokken

v0.1.0 (2016-11-08)

  • add hab_service resource
  • make the hab_package resource convergent
  • add chefspec and inspec tests
  • better documentation through README updates

v0.0.3 (2016-07-14)

  • Initial release, includes hab_package and hab_install resources

Collaborator Number Metric

0.1.1 passed this metric

Collaborator Number Metric

0.1.1 passed this metric

Foodcritic Metric

0.1.1 failed this metric

FC016: LWRP does not declare a default action: /tmp/42c0c6faf308fcfa07a5fa74/habitat/resources/install.rb:1
Run with Foodcritic Version 8.1.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any

Foodcritic Metric

0.1.1 failed this metric

FC016: LWRP does not declare a default action: /tmp/36bcf41baee04ef06c253761/habitat/resources/install.rb:1
Run with Foodcritic Version 8.1.0 with tags metadata,correctness ~FC031 ~FC045 and failure tags any