puppet-fooacl

Overview

Manage POSIX filesystem ACLs with Puppet.

Most (all?) other ACL modules implement a type which can be declared only once per file, which isn't flexible. This module takes the unusual approach of creating a single large concatenated script to manage all ACLs recursively in a single run. Ugly, yet very efficient and flexible since ACLs aren't tied to the file type in any way.

Features :

• Set ACLs for the same path from different parts of your puppet manifests (flexible).
• Set global ACL permissions to be applied for all paths managed by the module (flexible).
• Automatic purging of ACLs on paths as long as at least one ACL is still being applied by the module (remove users easily and reliably).
• Automatic setting of both normal and default ACLs to the same values (shortens declarations, increases code readability).

Limitations :

• No purging once paths are no longer being managed by the module.
• Any ACL changes trigger re-applying all ACLs (fine for a few thousands files, but typically an issue for millions of files).

Module content :

• fooacl : Class to start managing ACLs with the module (fooacl::conf automatically includes it).
• fooacl::conf: Definition to manage ACLs configuration.

Examples

A typical declaration from anywhere in your puppet manifests :

fooacl::conf { '/var/www/www.example.com':
  permissions => [
    'user:userA:rwX',
    'user:userB:rwX',
    'user:userX:r-X',
  ],
}

From anywhere else, you may set more ACLs for the same /var/www/www.example.com directory as long as you don't use the same $title (that would cause a duplicate declatation), so you would do :

fooacl::conf { 'www.example.com-other-team':
  target      => '/var/www/www.example.com',
  permissions => [
    'user:userC:rwX',
    'user:userY:r-X',
  ],
}

Parameter requirements :

• If $target is not specificed, $title must be the target.
• If $target is specified, as a directory or an array of directories, $title is ignored (this allows to work around duplicate declarations)
• The special $title of 'default' will apply permissions to all directories managed by this module on the node. Useful for global access on certain nodes.

If you need to order some of your resources with the execution of the script contained in the module (e.g. refresh when you modify uid or gid values), use :

foo { 'bar':
  ...
  notify => Class['::fooacl'],
}

More advanced example :

# Global webmasters
fooacl::conf { 'default':
  permissions => [
    'user:userA:rwX',
    'user:userB:rwX',
  ],
}
# Frontend website webmasters
fooacl::conf { 'frontend':
  target => [
    '/var/www/frontend.example.com',
    '/var/www/frontend.example.org',
  ],
  permissions => [
    'user:userX:rwX',
    'user:userY:rwX',
  ],
}
# Backend website webmasters
fooacl::conf { 'backend':
  target => [
    '/var/www/backend.example.com',
    '/var/www/backend.example.org',
  ],
  permissions => [
    'user:userZ:rwX',
  ],
}

Debugging

You can set the module fooacl_noop globally using hiera :

---
fooacl::fooacl_noop: true

After which the /usr/local/sbin/fooacl script will get updated but won't be automatically run.

• Add 'set -e' for exit status to be non-zero for any error (#9, @ngiger).
• No longer include concat::setup as it is deprecated.

2014-09-09 - 1.0.0

• Install required packages for acl functionality (#6, @Slashbunny).
• Fix 20.erb template parse error (#8).

2014-04-29 - 0.1.3

• Enable permissions to be nested arrays.
• Rename 'noop' to 'fooacl_noop' because of reserved metaparameter name.

2014-03-14 - 0.1.2

• Fix puppetlabs/concat requirement syntax causing librarian-puppet to fail.

2014-02-11 - 0.1.1

• Sort so that sub-directory ACLs get applied after parent directory ACLs.

2013-12-16 - 0.1.0

• Initial module release.