puppet-module-genders

Table of Contents

1. Description
2. Setup - The basics of getting started with genders
   • What genders affects
   • Setup requirements
3. Usage - Configuration options and additional functionality
4. Reference - Module reference

Description

This module will manage genders

Setup

What genders affects

This module will install the genders packages and manage the genders config.

Setup Requirements

For systems with yum package manager using Puppet >= 6.0 there is a dependency on puppetlabs/yumrepo_core.

Usage

Install genders:

include ::genders

Define nodes either via genders class parameter or via defined type:

class { '::genders':
  nodes => {
    'compute01' => { 'attrs' => ['compute','rack01'] },
  },
}
::genders::node { 'compute02':
  attrs => ['compute','rack01'],
}

A node's attributes can be defined as a Hash

::genders::node { 'compute02':
  attrs => {'role' => 'compute','rack' => 'rack01'},
}

A node can be defined as an Array

::genders::node { 'compute':
  node => ['compute01','compute02']
  attrs => ['compute','rack01'],
}

Reference

http://treydock.github.io/puppet-module-genders/

Reference

Table of Contents

Classes

• genders: Manage genders

Defined types

• genders::node: Manage genders node

Classes

genders

Manage genders

Examples

include genders

Parameters

The following parameters are available in the genders class:

• manage_repo
• package_name
• package_ensure
• config_path
• nodes

manage_repo

Data type: Boolean

Boolean that sets of repo for genders should be managed Currently only impacts Red Hat based systems

Default value: true

package_name

Data type: String

Genders package name

Default value: 'genders'

package_ensure

Data type: String

Genders package ensure property

Default value: 'installed'

config_path

Data type: Stdlib::Absolutepath

Path to genders file

Default value: '/etc/genders'

nodes

Data type: Hash

Hash used to define genders::node resources.

Default value: {}

Defined types

genders::node

Manage genders node

Examples

Define nodes

genders::node { 'compute01':
  attrs => ['compute','rack01'],
}

Define node with Hash attrs

genders::node { 'compute01':
  attrs => { 'class' => 'compute', 'rack' => 'rack01' },
}

Parameters

The following parameters are available in the genders::node defined type:

• node
• attrs
• content
• source
• order

node

Data type: Variant[Array[String], String]

The node or nodes to define in genders file

Default value: $name

attrs

Data type: Variant[Array[String],Hash[String,String]]

Array or Hash of attributes to define for a node

Default value: []

content

Data type: Optional[String]

Optional content to override module template

Default value: undef

source

Data type: Optional[String]

Optional Source to override module template

Default value: undef

order

Data type: String

Order in genders file for this node

Default value: '50'

Change log

All notable changes to this project will be documented in this file. The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

v1.0.0 (2021-05-20)

Full Changelog

Changed

• Major updates to supported Puppet and OSes (read description) #1 (treydock)

v0.1.0 (2019-08-20)

Full Changelog

* This Changelog was automatically generated by github_changelog_generator