blp-grub cookbook

Cookbook which configures the Grub Bootloader.

Platforms

The following platforms are tested automatically
using Test Kitchen, in Docker, with
the default suite of integration tests:

• Ubuntu 12.04/14.04/16.04
• CentOS (RHEL) 6/7

Basic Usage

The [default recipe](recipes/default.rb) gives you the ability to pass
attributes to tune your grub settings. There are currently no
defaults in this cookbook so your regular distrobution provided grub
file will remain intact. You can tweak the settings in the
Policefile.rb or directly using attributes. All GRUB specific settings
should use underscores like the examples below.

Hash merging

Values provided as hashes (under ['grub']['config']['settings'][key])
will be merged/flattened to form strings.
This is intended to allow overrides to, for example, kernel boot options without ugly string manipulation.

This approach is probably best demonstrated using an example:

default['grub']['config']['settings']['cmdline_linux']['biosdevname'] = '0'
default['grub']['config']['settings']['cmdline_linux']['nomodeset'] = nil
default['grub']['config']['settings']['cmdline_linux']['console'] = [ 'tty0', 'ttyS1,115200n8']

is the precise equivalent of
ruby
default['grub']['config']['settings']['cmdline_linux'] = 'biosdevname=0 nomodeset console=tty0 console=ttyS1,115200n8'


Using hashes permits simple overrides like the following
ruby
node.override[grub']['config']['settings']['cmdline_linux']['biosdevname'] = '1'


How hash values are merged

for each key = value pair in the hash:

• if value is nil, it is omitted and the key is inserted without a value
  ...[cmdline_linux']['nomodeset'] = nil results in nomodeset

• if value is an array, the result is key=v1 key=v2... for each value in the array
  ...['cmdline_linux']['console'] = [ 'x', 'y''] results in console=x console=y

• otherwise we simply insert key=value
  ...['cmdline_linux']['biosdevname'] = '0' results in biosdevname=0

To permit overrides to (for example) commandline options it is possible to specify

Recipe

node.default['grub']['config']['settings']['timeout'] = 30
node.default['grub']['config']['settings']['distributor'] = "$(sed 's, release .*$,,g' /etc/system-release)"
node.default['grub']['config']['settings']['terminal_output'] = "console"

Policyfile

name 'grub'
default_source :community
run_list 'blp-grub::default'

override['grub']['config']['settings']['timeout'] = 30
override['grub']['config']['settings']['distributor'] = "$(sed 's, release .*$,,g' /etc/system-release)"
override['grub']['config']['settings']['terminal_output'] = "console"