This module provides new types/providers for Puppet to read and modify syslog config files 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.
Ensure both Augeas and ruby-augeas 0.3.0+ bindings are installed and working as normal.
See Puppet/Augeas pre-requisites.
On Puppet 2.7.14+, the module can be installed easily (documentation):
puppet module install herculesteam/augeasproviders_syslog
You may see an error similar to this on Puppet 2.x (#13858):
Error 400 on SERVER: Puppet::Parser::AST::Resource failed with error ArgumentError: Invalid resource type `syslog` at ...
Ensure the module is present in your puppetmaster's own environment (it doesn't
have to use it) and that the master has pluginsync enabled. Run the agent on
the puppetmaster to cause the custom types to be synced to its local libdir
(puppet master --configprint libdir) and then restart the puppetmaster so it
loads them.
Minimum of Puppet 2.7.
| Augeas Versions | 0.10.0 | 1.0.0 | 1.1.0 | 1.2.0 |
|---|---|---|---|---|
| PROVIDERS | ||||
| syslog (augeas) | yes | yes | yes | yes |
| syslog (rsyslog) | no | yes | yes | yes |
| rsyslog_filter (augeas) | no | yes | yes | yes |
Type documentation can be generated with puppet doc -r type or viewed on the
Puppet Forge page.
A syslog provider handles basic syslog configs, while an rsyslog provider
handles the extended rsyslog config (this requires Augeas 1.0.0).
syslog { "my test":
ensure => present,
facility => "local2",
level => "*",
action_type => "file",
action => "/var/log/test.log",
}
syslog { "cron.*":
ensure => present,
facility => "cron",
level => "*",
action_type => "file",
action => "/var/log/cron",
no_sync => true,
}
syslog { "my test":
ensure => present,
facility => "local2",
level => "*",
action_type => "hostname",
action => "centralserver",
}
syslog { "my test":
ensure => present,
facility => "local2",
level => "*",
action_type => "hostname",
action_port => "514",
action_protocol => "tcp",
action => "centralserver",
}
syslog { "my test":
ensure => present,
facility => "local2",
level => "*",
action_type => "user",
action => "root",
}
syslog { "my test":
ensure => present,
facility => "local2",
level => "*",
action_type => "program",
action => "/usr/bin/foo",
}
syslog { "mail.*":
ensure => absent,
facility => "mail",
level => "*",
action_type => "file",
action => "/var/log/maillog",
}
syslog { "my test":
ensure => present,
facility => "local2",
level => "*",
action_type => "file",
action => "/var/log/test.log",
provider => "rsyslog",
}
syslog { "my test":
ensure => present,
facility => "local2",
level => "*",
action_type => "file",
action => "/var/log/test.log",
target => "/etc/mysyslog.conf",
}
Please file any issues or suggestions on GitHub.
See metadata.json for supported OS versions.
See metadata.json for dependencies.
The supported Puppet versions are listed in the metadata.json
Please see REFERENCE.md for more details.
Please report bugs and feature request using GitHub issue tracker.
For pull requests, it is very much appreciated to check your Puppet manifest with puppet-lint to follow the recommended Puppet style guidelines from the Puppet Labs style guide.
This plugin was originally authored by Hercules Team. The maintainer preferred that Puppet Community 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 Hercules Team.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent