shellinabox

Puppet Module for managing Shellinabox

Matt Dainty

bodgit

4,405 downloads

4,405 latest version

5.0 quality score

Version information

  • 1.0.0 (latest)
released Sep 29th 2018
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, 2017.1.x, 2016.4.x
  • Puppet >=4.9.0 <7.0.0
  • RedHat
    ,
    CentOS
    ,
    OracleLinux
    ,
    Scientific

Start using this module

Documentation

bodgit/shellinabox — version 1.0.0 Sep 29th 2018

shellinabox

Tested with Travis CI

Build Status Coverage Status Puppet Forge

Table of Contents

  1. Description
  2. Setup - The basics of getting started with shellinabox
  3. Usage - Configuration options and additional functionality
  4. Reference - An under-the-hood peek at what the module is doing and how
  5. Limitations - OS compatibility, etc.
  6. Development - Guide for contributing to the module

Description

This module installs and manages ShellInABox.

RHEL/CentOS is supported using Puppet 4.9.0 or later.

Setup

Setup Requirements

On RHEL/CentOS platforms you will need to have access to the EPEL repository by using stahnma/epel or by other means.

Beginning with shellinabox

In the very simplest case, you can just include the following:

include ::shellinabox

Usage

To run an SSH instance listening on localhost-only suitable for using with a reverse proxy:

class { '::shellinabox':
  disable_ssl      => true,
  disable_ssl_menu => true,
  localhost_only   => true,
  services         => {
    '/' => 'SSH',
  },
}

Reference

The reference documentation is generated with puppet-strings and the latest version of the documentation is hosted at https://bodgit.github.io/puppet-shellinabox/.

Limitations

This module has been built on and tested against Puppet 4.9.0 and higher.

The module has been tested on:

  • CentOS/Red Hat Enterprise Linux 6/7

Development

The module has both rspec-puppet and beaker-rspec tests. Run them with:

$ bundle exec rake test
$ PUPPET_INSTALL_TYPE=agent PUPPET_INSTALL_VERSION=x.y.z bundle exec rake beaker:<nodeset>

Please log issues or pull requests at github.