
Chef Infrastructure Automation Cookbook Second Edition
By :

If running your own Chef server seems like an overkill and you're not comfortable with using the hosted Chef, you can use local mode to execute cookbooks.
my_cookbook
by running the following command:mma@laptop:~/chef-repo $ chef generate cookbook cookbooks/my_cookbook
Compiling Cookbooks... Recipe: code_generator::cookbook ...TRUNCATED OUTPUT...
my_cookbook
so that it creates a temporary file:mma@laptop:~/chef-repo $ subl cookbooks/my_cookbook/recipes/default.rb
file "/tmp/local_mode.txt" do content "created by chef client local mode" end
Let's run my_cookbook
on your local workstation using Chef client's local mode:
my_cookbook
in the run list:mma@laptop:~/chef-repo $ chef-client -z -o my_cookbook
[2014-12-11T22:54:44+01:00] INFO: Starting chef-zero on host localhost, port 8889 with repository at repository at /Users/mma/work/chef-repo [2014-12-11T22:54:44+01:00] INFO: Forking chef instance to converge... Starting Chef Client, version 11.18.0.rc.1 [2014-12-11T22:54:44+01:00] INFO: *** Chef 11.18.0.rc.1 *** [2014-12-11T22:54:44+01:00] INFO: Chef-client pid: 20179 [2014-12-11T22:54:47+01:00] WARN: Run List override has been provided. [2014-12-11T22:54:47+01:00] WARN: Original Run List: [] [2014-12-11T22:54:47+01:00] WARN: Overridden Run List: [recipe[my_cookbook]] [2014-12-11T22:54:47+01:00] INFO: Run List is [recipe[my_cookbook]] [2014-12-11T22:54:47+01:00] INFO: Run List expands to [my_cookbook] [2014-12-11T22:54:47+01:00] INFO: Starting Chef Run for webops
mma@laptop:~/chef-repo $ cat /tmp/local_mode.txt
created by chef client local mode%
The -z
parameter switches the Chef client into local mode. Local mode uses chef-zero—a simple, in-memory version of the Chef server provided by Chef DK—when converging the local workstation.
By providing the -o
parameter, you override the run list of your local node so that the Chef client executes the default recipe from my_cookbook
.
Chef-zero saves all modifications made by your recipes to the local file system. It creates a JSON
file containing all node attributes for your local workstation in the nodes
directory. This way, the next time you run the Chef client in local mode, it will be aware of any changes your recipes made to the node.
You can use knife in local mode, too. To set the run list of your node named laptop
(instead of having to override it with -o
), you can run the following command:
mma@laptop:~/chef-repo $ knife node run_list add -z laptop 'recipe[my_cookbook]'
When you're done editing and testing your cookbooks on your local workstation with chef-zero, you can seamlessly upload them to hosted Chef or your own Chef server:
mma@laptop:~/chef-repo $ knife upload /
laptop: run_list: recipe[my_cookbook]
Change the font size
Change margin width
Change background colour