Forge Home

augeas

Camptocamp Augeas module

3,311,589 downloads

152,158 latest version

4.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

  • 1.9.0 (latest)
  • 1.8.0
  • 1.7.0
  • 1.6.1
  • 1.6.0
  • 1.5.1
  • 1.4.2
  • 1.4.1
  • 1.4.0
  • 1.3.1
  • 1.3.0
  • 1.2.13
  • 1.2.12
  • 1.2.11
  • 1.2.10
  • 1.2.9
  • 1.2.8
  • 1.2.7
  • 1.2.5
  • 1.2.4
  • 1.2.3
  • 1.2.2
  • 1.2.1
  • 1.2.0
  • 1.1.7
  • 1.1.6
  • 1.1.4
  • 1.1.3
  • 1.1.2
  • 1.1.0
  • 1.0.3
  • 1.0.2
  • 1.0.1
  • 1.0.0
  • 0.3.2
  • 0.3.1
  • 0.3.0
  • 0.2.1
  • 0.2.0
  • 0.0.1
released Jan 8th 2020
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, 2017.2.x, 2016.4.x
  • Puppet >= 4.10.0 < 7.0.0
  • , , , , Archlinux

Start using this module

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

Add this module to your Puppetfile:

mod 'camptocamp-augeas', '1.9.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add camptocamp-augeas
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install camptocamp-augeas --version 1.9.0

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
Tags: augeas

Documentation

camptocamp/augeas — version 1.9.0 Jan 8th 2020

Augeas Puppet module

Puppet Forge Version Puppet Forge Downloads Build Status Gemnasium By Camptocamp

Install and configure Augeas.

This module is provided by Camptocamp

Usage

Simple usage:

include augeas

Classes

The module provides an augeas class which installs and configures Augeas.

  • lets you force the augeas version by defining $augeas_version, otherwise puppet will only ensure the packages are present;
  • lets you force the ruby library version by defining $augeas_ruby_version, otherwise puppet will only ensure the libaugeas-ruby version will be installed according to internal critera;
  • provides an augeas() master-side function to manipulate strings using Augeas;

Note: the augeas class realizes all augeas resources in order to ensure they are managed after the required Augeas packages.

Definitions

augeas::lens

The augeas::lens definition allows you to deploy an Augeas lens and any associated test files, running unit tests and not installing if they fail:

Parameters:

  • ensure: present/absent
  • lens_content: the content of the lens
  • lens_source: deprecated, the source for the lens
  • test_content: optionally, the content of the test file
  • test_source: deprecated, the source for the test file.
  • stock_since: optionally, indicate in which version of Augeas the lens became stock, so it will not be deployed above that version.

Example usage:

augeas::lens { 'networkmanager':
  lens_content => file('networkmanager/lenses/networkmanager.aug'),
  test_content => file('networkmanager/lenses/test_networkmanager.aug'),
  stock_since  => '1.0.0',
}

Functions

augeas()

Modifies a string using Augeas.

Example:

augeas("proc        /proc   proc    nodev,noexec,nosuid     0       0\n", 'Fstab.lns', ['rm ./1/opt[3]'])

Would result in:

"proc        /proc   proc    nodev,noexec     0       0\n"
  • Type: rvalue

Contributing

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.