Version information
This version is compatible with:
- Puppet Enterprise 2019.8.x, 2019.7.x, 2019.5.x, 2019.4.x, 2019.3.x, 2019.2.x, 2019.1.x, 2019.0.x, 2018.1.x, 2017.3.x
- Puppet >= 5.0.0 < 7.0.0
- , , , , ,
Start using this module
Add this module to your Puppetfile:
mod 'treydock-oxidized', '0.6.1'
Learn more about managing modules with a PuppetfileDocumentation
puppet-module-oxidized
Table of Contents
- Description
- Setup - The basics of getting started with oxidized
- Usage - Configuration options and additional functionality
- Reference - Module reference
Description
This module will manage oxidized
Setup
What oxidized affects
This module will install the oxidize gems and manage the oxidize configs. The gems are installed into SCL Ruby for RedHat based systems.
Setup Requirements
This module has a soft dependency on waveclaw/subscription_manager for Red Hat systems in order to enable the SCL repository.
Usage
To install oxidized and get a default config:
include ::oxidized
To define a config:
class { '::oxidized':
config => {
'rest' => false,
}
}
Reference
Reference
Table of Contents
Classes
Public Classes
oxidized
: Manage Oxidized
Private Classes
oxidized::config
: Manage oxidized configsoxidized::install
: Manage oxidized packagesoxidized::repo
: Manage repos needed for oxidizedoxidized::service
: Manage oxidized serviceoxidized::user
: Manage Oxidzed user
Classes
oxidized
Manage Oxidized
Examples
include oxidized
Parameters
The following parameters are available in the oxidized
class.
manage_repo
Data type: Boolean
Sets if repos needed for oxidize are managed.
Default value: true
ruby_dependencies
Data type: Array
Ruby dependencies
Default value: []
install_dependencies
Data type: Array
Additional install dependencies
Default value: []
with_web
Data type: Boolean
Sets if the oxidized web should be installed and configured
Default value: false
user
Data type: String
Oxidize user
Default value: 'oxidized'
user_group
Data type: String
Oxidize user's group
Default value: 'oxidized'
user_uid
Data type: Optional[Integer]
Oxidize user's UID
Default value: undef
user_group_gid
Data type: Optional[Integer]
Oxidize user's group GID
Default value: undef
user_home
Data type: Stdlib::Absolutepath
Oxidize user's home directory path
Default value: '/home/oxidized'
user_home_mode
Data type: Stdlib::FileMode
The permissions of oxidized user's home directory
Default value: '0700'
config
Data type: Hash
Oxidize config hash
Default value: {}
config_mode
Data type: Stdlib::FileMode
Oxidized config file permission mode
Default value: '0600'
source_type
Data type: Enum['csv']
Sets type of source to be used
Default value: 'csv'
devices
Data type: Array[Hash]
Information about devices.
Only used when source_type
is csv
Default value: []
devices_map
Data type: Hash[String, Integer]
Map of CSV fields for devices
Only used when source_type
is csv
Default value: {'name' => 0, 'model' => 1}
devices_vars_map
Data type: Optional[Hash[String, Integer]]
Set vars_map
for device CSV configuration
Only used when source_type
is csv
Default value: undef
with_service
Data type: Boolean
Sets if the oxidized service should be installed and running
Default value: false
service_start
Data type: String
The command to use to start oxidized service
Default value: '/usr/local/bin/oxidized'
show_diff
Data type: Boolean
Boolean that sets show_diff property for files
Default value: true
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.
v0.6.1 (2019-09-12)
Fixed
v0.6.0 (2019-09-10)
Added
- Fix config modes and support changing home and config modes #8 (treydock)
- Support defining CSV device map and vars_map #7 (treydock)
v0.5.1 (2019-09-09)
Fixed
v0.5.0 (2019-09-09)
Added
v0.4.0 (2019-08-07)
Added
v0.3.0 (2019-08-05)
Added
v0.2.0 (2019-08-05)
Added
v0.1.0 (2019-08-05)
* This Changelog was automatically generated by github_changelog_generator
Dependencies
- puppetlabs/stdlib (>= 4.15.0 <6.0.0)
- camptocamp/systemd (>= 0.4.0 <3.0.0)