chef-apply (executable)

[edit on GitHub]

chef-apply is an executable program that runs a single recipe from the command line:

• Is part of the Chef development kit
• A great way to explore resources
• Is NOT how Chef is run in production

Options

This command has the following syntax:

$ chef-apply name_of_recipe.rb

This tool has the following options:

-e RECIPE_TEXT, --execute RECIPE_TEXT

Execute a resource using a string.

-l LEVEL, --log_level LEVEL

The level of logging to be stored in a log file.

-s, --stdin

Execute a resource using standard input.

-v, --version

The version of the chef-client.

-W, --why-run

Run the executable in why-run mode, which is a type of chef-client run that does everything except modify the system. Use why-run mode to understand why the chef-client makes the decisions that it makes and to learn more about the current and proposed state of the system.

-h, --help

Show help for the command.

Examples

Run a recipe

Run a recipe named machinations.rb:

$ chef-apply machinations.rb

Install Emacs

Run:

$ sudo chef-apply -e "package 'emacs'"

Returns:

Recipe: (chef-apply cookbook)::(chef-apply recipe)
  * package[emacs] action install
    - install version 23.1-25.el6 of package emacs

Install nano

Run:

$ sudo chef-apply -e "package 'nano'"

Returns:

Recipe: (chef-apply cookbook)::(chef-apply recipe)
  * package[nano] action install
    - install version 2.0.9-7.el6 of package nano

Install vim

Run:

$ sudo chef-apply -e "package 'vim'"

Returns:

Recipe: (chef-apply cookbook)::(chef-apply recipe)
  * package[vim] action install
    - install version 7.2.411-1.8.el6 of package vim-enhanced

Rerun a recipe

Run:

$ sudo chef-apply -e "package 'vim'"

Returns:

Recipe: (chef-apply cookbook)::(chef-apply recipe)
  * package[vim] action install (up to date)