Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Upstream has MOVED to hercules-team/augeasproviders
Ruby CSS Puppet Shell

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib/puppet/provider
manifests
.gitignore
Modulefile
README.markdown
metadata.json

README.markdown

augeasproviders: alternative Augeas-based providers for Puppet

This module provides alternative providers for core Puppet types such as host and mailalias using the Augeas configuration library.

The advantage of using Augeas over the default Puppet parsedfile implementations is that Augeas will go to great lengths to preserve file formatting and comments, while also failing safely when needed.

These providers will hide all of the Augeas commands etc., you don't need to know anything about Augeas to make use of it.

If you want to make changes to config files in your own way, you should use the augeas type directly. For more information about Augeas, see the web site or the Puppet/Augeas wiki page.

Using augeasproviders

Change the provider on individual resources to augeas:

host { "example.com":
  ensure   => present,
  ip       => "10.1.2.3",
  provider => "augeas",
}

Or change the resource defaults globally or in a single scope:

Host {
  provider => "augeas",
}

Requirements

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

See Puppet/Augeas pre-requisites.

Providers

The following types have an Augeas-based provider implemented:

  • host
  • mailalias

The following are planned:

  • mount or mounttab, once #7188 mount/tab split is done
  • port, once #5660 is done
  • ssh_authorized_key, once lens is written
  • yumrepo, once #8758 is done

Issues

Please file any issues or suggestions on Github: https://github.com/domcleal/augeasproviders/issues

Something went wrong with that request. Please try again.