Forge Home

augeasng

Next generation Puppet-Augeas integration

10,658 downloads

10,658 latest version

3.8 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Version information

  • 0.0.1 (latest)
released Dec 4th 2011

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'domcleal-augeasng', '0.0.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add domcleal-augeasng
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install domcleal-augeasng --version 0.0.1

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

domcleal/augeasng — version 0.0.1 Dec 4th 2011

puppet-augeas-ng: next generation Puppet-Augeas integration

This module is a development ground for the Augeas provider in Puppet. It will also bring changes being merged into master (i.e. the next Puppet release) to existing versions of Puppet.

Using puppet-augeas-ng

A new resource type will be provided, identical to the existing augeas type but will add new features via providers.

Change existing resource types from augeas to augeasng to take advantage of the new providers. The type parameters are all backwards-compatible, no more changes are required.

Requirements

Ensure both Augeas and ruby-augeas bindings are installed and working as normal.

See the providers section below for specific requirements. Generally use the latest version possible to get the most out of this module and enable all features.

  • On RHEL 4, 5 and derivatives, use EPEL versions of Augeas and ruby-augeas
  • On RHEL 6 and derivatives, use Augeas from main and optional channels, ruby-augeas from EPEL. This may not be the latest version, do check beta channels too (e.g. RHEL 6.2).
  • On Fedora, use Augeas and ruby-augeas from main updates repo. Consider checking updates-testing.
  • On Debian, use Augeas and libaugeas-ruby* from main repo, or backports if available. Ensure you use the correct libaugeas-ruby1.8, 1.9 or 1.9.1 package for your version of Ruby.
  • On Ubuntu, as with Debian. Also see raphink's PPA repo for fresh Augeas packages.

Merged changes

The following changes are already merged in development or new versions of Puppet and are included here too:

  • #6494: New commands, defvar, defnode, mv and setm (in 2.7.0)
  • #2728: Add diff output for changes made by Augeas provider (in 2.7.3)
  • #2744: Display file diffs through the Puppet log system (in 2.7.8)
  • #7285: Use Augeas NO_LOAD/incl to optimise loading based on context (in 2.8)
  • #5606: Print Augeas' /augeas//error info to debug on save failure (in 2.8)

Providers

The following providers are planned along with their dependencies. Some deps will be very new or unreleased versions.

  • augparse provider, legacy parsing of commands and direct use of ruby-augeas API.
    • augeas: any version
    • ruby-augeas: any version
  • augsrun provider, using aug_srun for commands
    • augeas: 0.10.0 or higher
    • ruby-augeas: development
  • augcond provider, using aug_srun for commands and parsing for onlyif support
    • augeas: 0.10.0 or higher
    • ruby-augeas: development

Issues

Please file any issues or suggestions on Github: https://github.com/domcleal/puppet-augeas-ng/issues