Version information
This version is compatible with:
- Puppet Enterprise >=3.0.0
- Puppet >=3.0.0 <5.0.0
- ,
Start using this module
Add this module to your Puppetfile:
mod 'binford2k-abalone', '0.0.9'
Learn more about managing modules with a PuppetfileDocumentation
abalone
A Puppet module for managing Abalone, a simple Sinatra & hterm based web terminal.
Table of Contents
Overview
Abalone imply exposes a login shell to a web browser. This can be the Unix standard
/bin/login
using a system user account, a custom command, or an SSH frontend.
See the Abalone project page for more information.
Usage
The simplest use case is to just include the class and accept all the defaults:
include abalone
Parameters
You can customize the configuration by passing in several parameters.
See documentation on the Abalone project page to see what these options do and what values they can take.
$port
$bind
$method
$bannerfile
$logfile
$ssh_host
$ssh_cert
$ssh_port
$ssh_user
$command
$params
(see below)
Custom Parameters
Options for a custom command can be configured by either whitelisting options in an array, or providing a full list of options and values in a hash.
Simple Options
List allowed options in an Array:
class { 'abalone':
command => '/usr/local/bin/run-container',
params => [ 'username', 'image' ],
}
Customized options
With a Hash you can fully customize the options which may be passed in, including remapping them to command line arguments and filtering accepted values:
class { 'abalone':
command => '/usr/local/bin/run-container',
params => {
'username' => undef,
'type' => ['demo', 'testing'],
'image' => {
'map' => '--create-image',
'values' => [ 'ubuntu', 'rhel', '/centos[5,6,7]/' ],
},
},
}
Limitations
This is still early in development.
Disclaimer
I take no liability for the use of this tool.
Contact
v0.0.9
- Systemd doesn't enforce system-wide max file/proc handles. Set it in the .service file
- See https://fredrikaverpil.github.io/2016/04/27/systemd-and-resource-limits/
v0.0.8
- Corrected logic for config template, allowing false values to be managed.
- Better management of settings in the params hash.
v0.0.7
- Adding params for all supported features
- autoconnect
- timeout
- ttl
- welcome
v0.0.6
- Adding watchdog support
v0.0.5
- Hotpatching is never a good idea
v0.0.4
- Corrects handling of bannerfile option.
v0.0.3
- Adds bannerfile management
v0.0.2
- Corrects an issue the the config file template.
v0.0.1
- Initial release.