push-jobs cookbook

Installs the Chef Push Jobs client package and sets it up to run as
a service.

The official documentation is on
docs.getchef.com

Requirements

Requires Enterprise Chef with the Push
Jobs feature.

• Chef: 11.4.0 or higher
• runit cookbook

Platform

• Debian
• Ubuntu
• Windows

Tested on Ubuntu 10.04, 12.04, CentOS 6.4, and Windows 2008
R2. It may work on other debian, rhel, or windows platform families with or
without modification.

Testing for Ubuntu/CentOS can be done with Test Kitchen, see TESTING.md in this repository.

Usage

Set the appropriate attributes and include the default recipe in a
node's run list.

In order for the push jobs to be used, a whitelist of job names and
their commands must be set in the configuration file. This is
automatically generated from the attribute
node['push_jobs']['whitelist']. For example:

node.set['push_jobs']['whitelist'] = {
  "chef-client" => "chef-client",
  "apt-get-update" => "apt-get update"
}

As this is an attribute, interesting uses arise from orchestrating a
Chef Client run. Assuming the above is present on the node prior to
running the recipe, run Chef Client with this command from the local
workstation:

knife job start chef-client A_NODE_NAME

New jobs can be added to the whitelist simply by creating attributes.
This can be done with knife exec:

knife exec -E 'nodes.transform("name:A_NODE_NAME") do |n|
  n.set["push_jobs"]["whitelist"]["ntpdate"] = "ntpdate -u time"
end'

Then, run the chef-client job, and then the ntpdate job:

knife job start chef-client A_NODE_NAME
knife job start ntpdate A_NODE_NAME

In a future release, an LWRP may be added to automatically add push
jobs.

Attributes

Attributes are documented in metadata.rb. See attributes/default.rb
for default values.

Recipes

default

The default recipe includes the appropriate recipe based on the node's
platform_family.

linux

The node['push_jobs']['package_url'] attribute must be set for this
recipe to download the Chef Push Jobs Client package from the URL.

The recipe will write out the whitelist of
jobs as a separate configuration file.

It will also set up the Chef Push Jobs Client daemon as a service
using runit. The default logger is used, so the log will be
/var/log/push-jobs-client/current.

knife

If the node['push_jobs']['gem_url'] attribute is set, this
recipe will download the knife-pushy gem to the system.

Use this recipe on workstation systems that should manage running jobs
with the knife plugin.

windows

The node['push_jobs']['package_url'] attribute must be set
to use this recipe, as Windows does not have the concept of a package
manager with remote repositories. The URL will be used (with the
checksum attribute) to install the package using the windows_package
resource from the windows cookbook.

The recipe will write out the whitelist of
jobs as a separate configuration file.

The client service will be enabled and started.

Author & License

• Author: Joshua Timberman (joshua@getchef.com)
• Author: Charles Johnson (charles@getchef.com)
• Author: Christopher Maier (cm@getchef.com)
• Copyright: 2013-2014 Chef, Inc. (legal@getchef.com)

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

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.