Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/voxpupuli/puppet-augeasproviders_base
Augeas-based additional providers for Puppet base types
https://github.com/voxpupuli/puppet-augeasproviders_base
augeas augeasproviders configuration configuration-files configuration-management debian-puppet-module hacktoberfest linux-puppet-module puppet puppet-module puppet-resources redhat-puppet-module ubuntu-puppet-module
Last synced: 4 months ago
JSON representation
Augeas-based additional providers for Puppet base types
- Host: GitHub
- URL: https://github.com/voxpupuli/puppet-augeasproviders_base
- Owner: voxpupuli
- License: apache-2.0
- Created: 2014-08-07T13:08:11.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-04-12T11:14:22.000Z (10 months ago)
- Last Synced: 2024-04-13T23:10:38.233Z (10 months ago)
- Topics: augeas, augeasproviders, configuration, configuration-files, configuration-management, debian-puppet-module, hacktoberfest, linux-puppet-module, puppet, puppet-module, puppet-resources, redhat-puppet-module, ubuntu-puppet-module
- Language: Ruby
- Size: 109 KB
- Stars: 2
- Watchers: 42
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://github.com/voxpupuli/puppet-augeasproviders_base/actions?query=workflow%3ACI)
[](https://github.com/voxpupuli/puppet-augeasproviders_base/actions/workflows/release.yml)
[](https://coveralls.io/github/voxpupuli/puppet-augeasproviders_base)
[](https://forge.puppetlabs.com/puppet/augeasproviders_base)
[](https://forge.puppetlabs.com/puppet/augeasproviders_base)
[](https://forge.puppetlabs.com/puppet/augeasproviders_base)
[](https://forge.puppetlabs.com/puppet/augeasproviders_base)
[](http://www.puppetmodule.info/m/puppet-augeasproviders_base)
[](LICENSE)
[](#transfer-notice)
# base: additional providers for Puppet base types
This module provides additional providers for Puppet base types
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.
This provider will hide *all* of the Augeas commands etc., you don't need to
know anything about Augeas to make use of it.
## Requirements
Ensure both Augeas and ruby-augeas 0.3.0+ bindings are installed and working as
normal.
See [Puppet/Augeas pre-requisites](http://docs.puppetlabs.com/guides/augeas.html#pre-requisites).
## Installing
The module can be installed easily ([documentation](http://docs.puppetlabs.com/puppet/latest/reference/modules_installing.html)):
```
puppet module install puppet/augeasproviders_base
```
## Compatibility
### Puppet versions
See `metadata.json`.
### Augeas versions
Augeas Versions | 0.10.0 | 1.0.0 | 1.1.0 | 1.2.0 |
:-------------------------|:-------:|:-------:|:-------:|:-------:|
**PROVIDERS** |
host | **yes** | **yes** | **yes** | **yes** |
mailalias | **yes** | **yes** | **yes** | **yes** |
## Documentation and examples
Type documentation can be generated with `puppet doc -r type` or viewed on the
[Puppet Forge page](http://forge.puppetlabs.com/herculesteam/augeasproviders_base).
### host provider
This is a provider for a type distributed in Puppet core: [host type
reference](http://docs.puppetlabs.com/references/stable/type.html#host).
The provider needs to be explicitly given as `augeas` to use `augeasproviders`.
#### manage simple entry
host { "example":
ensure => present,
ip => "192.168.1.1",
provider => augeas,
}
#### manage entry with aliases and comment
host { "example":
ensure => present,
ip => "192.168.1.1",
host_aliases => [ "foo-a", "foo-b" ],
comment => "test",
provider => augeas,
}
#### manage entry in another location
host { "example":
ensure => present,
ip => "192.168.1.1",
target => "/etc/anotherhosts",
provider => augeas,
}
#### delete entry
host { "iridium":
ensure => absent,
provider => augeas,
}
#### remove aliases
host { "iridium":
ensure => present,
host_aliases => [],
provider => augeas,
}
#### remove comment
host { "argon":
ensure => present,
comment => "",
provider => augeas,
}
### mailalias provider
This is a provider for a type distributed in Puppet core: [mailalias type
reference](http://docs.puppetlabs.com/references/stable/type.html#mailalias).
The provider needs to be explicitly given as `augeas` to use `augeasproviders`.
#### manage simple entry
mailalias { "example":
ensure => present,
recipient => "bar",
provider => augeas,
}
#### manage entry with multiple recipients
mailalias { "example":
ensure => present,
recipient => [ "fred", "bob" ],
provider => augeas,
}
#### manage entry in another location
mailalias { "example":
ensure => present,
recipient => "bar",
target => "/etc/anotheraliases",
provider => augeas,
}
#### delete entry
mailalias { "mailer-daemon":
ensure => absent,
provider => augeas,
}
## Issues
Please file any issues or suggestions [on GitHub](https://github.com/voxpupuli/puppet-augeasproviders_core/issues).
## Transfer Notice
This plugin was originally authored by [hercules-team](http://augeasproviders.com).
The maintainer preferred that Vox Pupuli take ownership of the module for future improvement and maintenance.
Existing pull requests and issues were transferred over, please fork and continue to contribute here instead of Camptocamp.
Previously: https://github.com/hercules-team/augeasproviders_core