Forge Home

fhs_app

Puppet module that implements an unofficial extension to Filesystem Hierarchy Standard (FHS) to manage system applications (users and directory hierarchies)

9,223 downloads

8,423 latest version

3.5 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

  • 2.0.0 (latest)
  • 1.0.3
  • 1.0.2
  • 1.0.1
  • 1.0.0 (deleted)
released Sep 3rd 2015

Start using this module

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

Add this module to your Puppetfile:

mod 'solict-fhs_app', '2.0.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add solict-fhs_app
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install solict-fhs_app --version 2.0.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

Documentation

solict/fhs_app — version 2.0.0 Sep 3rd 2015

fhs_app

Table of Contents

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with the module
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how
  6. Limitations - OS compatibility, etc.
  7. Development - Guide for contributing to the module
  8. Release Notes - Other notable remarks

Overview

Puppet module that implements an unofficial extension to Filesystem Hierarchy Standard (FHS) to manage system applications (users and directory hierarchies). Designed for Puppet 3.x and newer in POSIX environments.

Module Description

The module will implement and manage system applications users and directory hierarchies in scenarios where system administrators wish to bundle, in the same location, software, logging, data and backups, in contrast to distributing the files in either the distro or the addon system locations.

It allows to configure and manage the top level location and the respective locations for all the applications. It also allows configuring and managing the applications users, groups and directories.

An extension for the Filesystem Hierarchy Standard (FHS) has been prepared for it. Follows a brief comparison with the standard:

|-----------------------------------------------------|
|  App            |  Addon          |  System         |
|-----------------|-----------------|-----------------|
|  root           |  root           |  root           |
|  |              |  |              |  |              |
|  +-etc          |  +-etc          |  +-etc          |
|  | |            |  | |            |  | |            |
|  | +-<app>      |  | +-opt        |  | +-<app>      |
|  |              |  |   |          |  |              |
|  +-app          |  |   +-<app>    |  +-usr          |
|    |            |  |              |  | |            |
|    +-<app>      |  +-opt          |  | +-bin        |
|      |          |  | |            |  | |            |
|      +-src      |  | +-<app>      |  | +-lib        |
|      |          |  |              |  |   |          |
|      +-log      |  +-var          |  |   +-<app>    |
|      |          |    |            |  |              |
|      +-data     |    +-opt        |  +-var          |
|      |          |      |          |  | |            |
|      +-backup   |      +-<app>    |  | +-backup     |
|                 |                 |  | | |          |
|                 |                 |  | | +-<app>    |
|                 |                 |  | |            |
|                 |                 |  | +-lib        |
|                 |                 |  | | |          |
|                 |                 |  | | +-<app>    |
|                 |                 |  | |            |
|                 |                 |  | +-log        |
|                 |                 |  |   |          |
|                 |                 |  |   +-<app>    |
|                 |                 |  |              |
|                 |                 |  +-srv          |
|                 |                 |    |            |
|                 |                 |    +-<app>      |
|                 |                 |                 |
|-----------------------------------------------------|

Via this implementation it is thus possible to satisfy scenarios where it is more important to keep most files of an application together, which can be the case for Docker containers, custom builds of known packages, custom software, big infrastructures with many complex scenarios, etc., relying on simplicity.

Care should be given to deploy the app hierarchy in a separate mount point.

This module has been desgined for Puppet 3.x and newer in POSIX environments.

Setup

What the module affects

  • Directory hierarchies will be created for the app location and also for all applications parameterized, permissions and owners included.
  • System users and groups will be generated for applications, where applicable.

Setup Requirements

Puppet-stdlib is a requirement and should be automatically installed.

Beginning with the module

When deployed, the directory of the module should be renamed to fhs_app.

The class fhs_app must be declared in a manifest or loaded with hiera_include to be initialized. All other classes are autoloaded and do not need to be manually initialized.

Parameters can be provided with both methods, for the class fhs_app.

Usage

The following parameters are used:

  • defaults A hash that defines the default parameters. It is hard coded into params.pp and can be ignored. There are used when the other hashes are missing or incomplete.

  • mother A hash that defines the parameters for the mother class. These will be used to create the /app FHS hierarchy. User, group, permissions and locations are customizable. If no mother params are provided, the defaults will be used.

  • childs A hash that defines the parameters for the child class. These will be used to create the application user, group and directories. User, group, permissions and locations are customizable. If no child params are provided, no changes will be made. Multiple childs can be provided.

The file HOWTO.md details sample usage with manifests and hiera.

Reference

There are 4 classes provided by this module:

  • fhs_app, which initializes the module are accepts parameters
  • fhs_app::params, which is autoloaded to retrieve parameters
  • fhs_app::mother, which is autoloaded to create the /app FHS hierarchy
  • fhs_app::childs, which is autoloaded to create the applications provided

The parameterized user, group and file resources are managed as configured, as defined for params mother and childs.

No new resources are provided.

Limitations

It has been successfully tested in CentOS/RHEL and Debian. Should be compatible with most of the Linux distributions.

Development

The source for the module can be found on it's project source page. Contributions and issues are welcomed.

Release Notes

This source code comes with absolutely no warranty or liability for damages.