Customizing Chef

Jon Cowie is a senior operations engineer at Etsy where he mixes his love of both coding and operations to try and solve interesting problems. He has created and open sourced a number of projects, including the Chef tools knife-spork and knife-preflight, and has spoken at several of O'Reilly's Velocity conferences.

Chef and Ruby 101
Chapter 1Introduction
What Is Configuration Management?
So Why Chef?
Think Critically
Meet AwesomeInc
Criteria for Customization
State of the Customization Nation
Chef Installation Types and Limitations
Prerequisites
Assumptions
Chapter 2Just Enough Ruby to Customize Chef
Ruby Is Object-Oriented
Ruby Is Dynamically Typed
Classes
Variable Scoping
Inheritance
Modules
Using Other Classes and Modules
When Things Go Wrong
Tying It All Together
Summary
Chapter 3Chef Internals
Chef Architecture
Anatomy of a Chef Run
Dry-Run and Why-Run
Using the Source
Tracing a chef-client Run
Summary
Customizing Chef Runs
Chapter 4Extending Ohai
Introduction
Ohai Example 1: Plugin Skeleton
Testing and Running Ohai Plugins
Ohai Example 2: Adding More to the Plugin
Ohai Example 3: Multilevel Plugins
Summary
Chapter 5Creating Handlers
Preparing a Test Environment
Introduction to Handlers
The Run Status Object
Handler Example 1: Start Handler
Handler Example 2: Report Handler
Handler Example 3: Exception Handler
Handlers: Summary and Further Reading
Chapter 6Extending Chef Run Events
Introduction to the Event Dispatcher
Event Dispatcher Initialization
Publish Overview
Subscribe Overview
Creating Formatters
Creating Custom Subscribers
Revisiting AwesomeInc—Which Customization?
Summary
Customizing Recipes
Chapter 7Definitions and Libraries
Cookbook Structure Revisited
Creating a Test Environment
Definitions
Libraries
Chapter 8Lightweight Resources and Providers
Introduction to Resources and Providers
Introduction to LWRPs
LWRP Example 1: Getting Started with LWRPs
The LWRP Domain-Specific Language
LWRP Example 2: Extending the Provider
Provider Internals
LWRP Example 3: Native Provider
Summary and Further Reading
Chapter 9Heavyweight Resources and Providers
Introduction to HWRPs
HWRP Example 1: Getting Started with HWRPs
Advanced HWRP Tricks
HWRP Example 2: Extending the package Resource
Summary and Further Reading
Other Customizations
Chapter 10Customizing Knife
The Knife Source Code
Introduction to Knife Plugins
Anatomy of a Knife Command
Creating a Test Environment
Knife Example 1: Wrapping an Existing Plugin
Presenting Presenters!
The UI Class
Knife Example 2: Search Plugin
Working with Chef Objects
Knife Example 3: Tying It All Together
Revisiting AwesomeInc—Plugin Best Practices
Summary and Further Reading
Chapter 11The Chef API
Introduction to the Chef API
Creating a Test Environment
API Example 1: Authenticating and Making a GET Request
The Chef::Rest Class
API Example 2: Combining Multiple API Requests
Error Handling
Secrets of the Chef API
Summary and Further Reading
Chapter 12Contributing Your Customizations
Documentation
Supporting Your Code
Managing Contributions
Testing Your Software
Versioning Your Software
Licensing and Copyright
Distributing Your Customizations
Summary
Appendix Chef API Endpoints and Verbs