Update your chef client with omnibus! This cookbook can install the omnibus chef package into your system if you are currently running via gem install, and it can keep your omnibus install up to date.

This cookbook is inspired by the omnibus_updater cookbook and essentially performs the same function but improves it in various areas:

• It uses idiomatic Ruby and is way less entangled with callbacks and notifications.
• It only performs web requests if absolutely necessary. The omnibus_updater cookbook will perform a web request on each execution and will fail if the Chef web servive is not reachable for any reason.
• It provides an LWRP for its core functionality, allowing easier and more flexible usage in other cookbooks.

The default recipe checks some preconditions and then just includes the install cookbook.

The install cookbook installs the Omnibus Chef client package. By default, it will install the latest available version of Chef which might not be what you actually want (you can set the exact version in an attribute, see below).

Also, by default, it will kill the current chef run directly after having updated the chef version. This is heavily recommended to ensure a clean state for the following cookbooks. During an update, internal chef libraries may change, move, or no longer exist. The currently running instance can encounter unexpected states because of this. To prevent this, the updater will attempt to kill the Chef instance so that it can be restarted in a normal state.

Please see the Attributes section below options to configure this behavior.

This optional recipe removes the chef gem if it is installed to the system ruby. This might be useful if Chef was installed as a system gem once and you are now migrating to an Omnibus based install.

All attributes are namespaced under node['omnibus_chef']. The full attribute name is thus e.g. node['omnibus_chef']['version'].

You can override any of these attributes

  By default, this is unset and we determine the correct URL from the
  specified version and download the package directly from
  https://www.getchef.com if required.

  If this is set explicitly, we try to determine the version of the
  package from the URL. It is expected, that it contains the string
  <code>chef_&lt;VERSION&gt;</code>.
</td>

  When defining <code>"latest"</code>, a web request to the
  https://getchef.com site always be performed during each chef run.
  Generally, you will want to override this and set your desired version.
</td>

  See http://docs.opscode.com/api_omnitruck.html for details.
</td>

  See http://docs.opscode.com/api_omnitruck.html for details.
</td>

  See http://docs.opscode.com/api_omnitruck.html for details.
</td>

  You should generally keep this enabled unless there is a need to
  intercept the communication (e.g. with a transparent proxy).
</td>

  If this is set to <code>"immediately"</code>, the upgrade is performed
  where the <code>omnibus_chef::install_client</code> recipe heppens to
  be in the runlist.

  If set to <code>"delayed"</code>, the update is performed at the end of
  the chef run. The current run thus is performed with the version of
  chef that is on the system during the start of the run.
</td>

  During an update, internal chef libraries may change, move, or no
  longer exist. The currently running instance can encounter unexpected
  states because of this. To prevent this, the updater will attempt to
  kill the Chef instance so that it can be restarted in a normal state.

  If <code>when</code> is set to <code>"delayed"</code>, this attribute
  has no effect. The chef run is then not killed as it ends anyway after
  the final delayed notifications have finished to run.
</td>

Copyright 2014 Holger Just

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.