otto-de-legacy / puppet-forge_server

A Puppet module for managing Puppet Forge Server

forge_server

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 forge_server
   • What forge_server affects
   • Setup requirements
   • Beginning with forge_server
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

Overview

Manages Puppet Forge Server, a service for hosting a private puppet forge. It aims to support both the forge v1 and v3 api, cache directories and exposing modules from multiple paths. It installs as a ruby gem and requires ruby >=1.9.3

Module Description

This module installs the puppet-forge-server gem and runs the service as a daemon. All configurable parameters can be tweaked from this module.

Setup

What forge_server affects

• Unprivileged forge user to run the daemon
• Gem installation either in system ruby or specific SCL
• Manages the puppet-forge-server service

Setup Requirements

If installing in system ruby it must be at least version 1.9.3

Beginning with forge_server

Install the module:

puppet module install unibet-forge_server

Usage

To install puppet-forge-server:

class { '::forge_server': }

Reference

The only "public" class is forge_server. See rdoc for usage.

Limitations

SCL won't work on non-EL distributions.

Development

Fork it and create a pull request