Puppet Class: managedmac::mobileconfigs

Defined in:
manifests/mobileconfigs.pp

Overview

Class: managedmac::mobileconfigs

Dynamically create Puppet Mobileconfig resources using the Puppet built-in ‘create_resources’ function.

We do some validation of data, but the usual caveats apply: garbage in, garbage out.

Parameters

payloads

This is a Hash of Hashes. The hash should be in the form { title => { parameters } }. See tinyurl.com/7783b9l, and the examples below for details. Type: Hash

defaults

A Hash that defines the default values for the resources created. See tinyurl.com/7783b9l, and the examples below for details. Type: Hash

Variables

Not applicable

Examples

This class was designed to be used with Hiera. As such, the best way to pass options is to specify them in your Hiera datadir:

# Example: defaults.yaml

managedmac::mobileconfigs::defaults:

description:  'Installed by Puppet.'
organization: 'Puppet Labs'

managedmac::mobileconfigs::payloads:

'managedmac.dock.alacarte':
  content:
    largesize: 128
    orientation: left
    tilesize: 128
    autohide: true
    PayloadType: 'com.apple.dock'
  displayname: 'Managed Mac: Dock Settings'

Then simply, create a manifest and include the class…

# Example: my_manifest.pp
include managedmac::mobileconfigs

If you just wish to test the functionality of this class, you could also do something along these lines:

# Create some Hashes $defaults = { ‘organization’ => ‘Puppet Labs’} $payloads = {

'managedmac.dock.alacarte' => {
  'content' => { 'orientation' => 'left',
     'PayloadType' => 'com.apple.dock'
   },
  'displayname' => 'My Custom Dock',
},

}

class { ‘managedmac::mobileconfigs’:

payloads => $payloads,
defaults => $defaults,

}

Authors

Brian Warsing <bcw@sfu.ca>

Copyright 2015 Simon Fraser University, unless otherwise noted.

Parameters:

  • payloads (Any) (defaults to: {})
  • defaults (Any) (defaults to: {}) 


77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
 
# File 'manifests/mobileconfigs.pp', line 77

class managedmac::mobileconfigs (

  $payloads = {},
  $defaults = {}

) {

  unless empty ($payloads) {

    validate_hash ($payloads)
    validate_hash ($defaults)

    # Cheating: validate that the value for each key is itself a Hash
    $check_hash = inline_template("<%= @payloads.reject! {
      |x| x.respond_to? :key } %>")

    unless empty($check_hash) {
      fail("Payload Error: Failed to parse one or more payload data \
objects: ${check_hash}")
    }

    create_resources(mobileconfig, $payloads, $defaults)

  }

}