abuxton / prosvcs-node_manager

node_manager

Table of Contents

1. Overview
2. [Requirements] (#requirements)
3. [Types] (#types)

• [Node_group] (#node_group)
• [Puppet_environment] (#puppet_environment)

1. [Functions] (#functions)

• [node_groups()] (#node_groups)

Overview

Create and manage Node Manager API endpoints as resources.

Module State

NOTE: This module is a Professional Service side project and is currently unmaintained. It is not supported and may not function as expected.

Requirements:

• *nix operating system
• Puppet >= 3.7.1
• puppetclassify gem

Types

Node_group

Node_groups will autorequire parent node_groups.

Enumerate all node groups:

• puppet resource node_group
  

Example output for puppet resource node_group 'PE MCollective'

node_group { 'PE MCollective':
  ensure               => 'present',
  classes              => {'puppet_enterprise::profile::mcollective::agent' => {}},
  environment          => 'production',
  id                   => '4cdec347-20c6-46d7-9658-7189c1537ae9',
  override_environment => 'false',
  parent               => 'PE Infrastructure',
  rule                 => ['and', ['~', ['fact', 'pe_version'], '.+']],
}

Node_group parameters

• classes
  Classes that are assigned to the node in hash format. Elements of the hash are class parameters. Default (empty hash): {}

• environment
  Environment selected for this node group. Default: production

• name
  (namevar) Node group's name.

• id
  Universal ID for the group. This attribute is read-only.

• override_environment
  Whether or not this group's environment ment setting overrides all other other environments. Default: false

• parent
  The UID for the data group. Can be specified by group name or UID. Default: default

• rules
  An array of classification rules. Default (empty array): []

Puppet_environment

Enumerate all puppet environments:

• puppet resource puppet_environment
  

Example output for puppet resource puppet_environment production

puppet_environment { 'production':
  ensure => 'present',
}

Puppet_environment parameters

• name
  (namevar) Name of the Puppet environment on disk, i.e. the directory name in $environmentpath.

Functions

node_groups()

Retrieve all or one node_group and its data.

node_groups() will return:

{
  "default"=>{
    "environment_trumps"=>false,
    "parent"=>"00000000-0000-4000-8000-000000000000",
    "name"=>"default",
    "rule"=>["and", ["~", "name", ".*"]],
    "variables"=>{}, "id"=>"00000000-0000-4000-8000-000000000000",
    "environment"=>"production",
    "classes"=>{}
  },
  "Production environment"=>{
    "environment_trumps"=>false,
    "parent"=>"00000000-0000-4000-8000-000000000000",
    "name"=>"Production environment",
    "rule"=>["and", ["~", "name", ".*"]],
    "variables"=>{},
    "id"=>"7233f964-951e-4a7f-88ea-72676ed3104d",
    "environment"=>"production",
    "classes"=>{}
  },
  ...
}

node_groups('default') will return:

{
  "default"=>{
    "environment_trumps"=>false,
    "parent"=>"00000000-0000-4000-8000-000000000000",
    "name"=>"default",
    "rule"=>["and", ["~", "name", ".*"]],
    "variables"=>{}, "id"=>"00000000-0000-4000-8000-000000000000",
    "environment"=>"production",
    "classes"=>{}
  }
}

Type: rvalue