Forge Home


Puppet module for Runscope Gateway Agent


7,239 latest version

4.6 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

  • 0.1.1 (latest)
released Feb 29th 2016
This version is compatible with:
  • ,

Start using this module

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

Add this module to your Puppetfile:

mod 'cloudmine-runscope_gateway', '0.1.1'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add cloudmine-runscope_gateway
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install cloudmine-runscope_gateway --version 0.1.1

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.



cloudmine/runscope_gateway — version 0.1.1 Feb 29th 2016


Table of Contents

  1. Overview
  2. Requirements - OSes and Puppet modules
  3. Usage - Quickly getting started
  4. Configuration - Required and optional configuration options
  5. Development - Guide for contributing to the module
  6. Maintainers - Who helps keep this module up to date
  7. Release Notes / Changelog


Puppet module for Runscope Gateway Agent.


Operation Systems

These are the operating systems for which the module has been tested.

  • Ubuntu 14.04

Puppet Modules


If you do not already have an application token for the Runscope Gateway Agent, generate one by manually downloading, unzipping, and running the command without arguments the first time or generate one in the Runscope web interface.

Using Hiera

Add required configuration hiera in the appropriate location for your environment, e.g.

runscope_gateway::token: my-runscope-app-token

Then add include runscope_gateway in your site.pp or add runscope_gateway to your classes hiera.

Directly without Hiera

class { 'runscope_gateway':
  token => 'my-runscope-app-token',


Required Configuration

Parameter Description Type Default
token Runscope application token String undef

Optional Configuration

Parameter Description Type Default
certfile Agent HTTPS certificate file String undef
config_dir Configuration directory String (auto-detected, see params.pp)
group Group for running agent String runscope
group_manage Whether to manage agent group creation Boolean true
hostname Agent hostname String $::fqdn
http Enable agent HTTP support Boolean true
http_port Agent HTTP port Fixnum 8000
https Enable agent HTTPS support Boolean false
https_port Agent HTTPS port Fixnum 8443
install_binary Installation binary filename String (auto-detected, see params.pp)
install_dir Installation directory String (auto-detected, see params.pp)
interface Agent interface to bind String undef
keyfile Agent HTTPS key file String undef
service_enable Enable agent service on boot Boolean true
service_ensure Ensure agent service running Boolean true
service_manage Whether to manage agent service Boolean true
service_style OS service style String (auto-detected, see params.pp)
url Full URL to agent zip file String (auto-detected, see params.pp)
user User for running agent String runscope
user_manage Whether to manage agent user creation Boolean true


  • Full development and testing workflow with rspec-puppet, puppet-lint, and friends:

To use aws instead of virtualbox vagrant hosts

  • vagrant plugin install vagrant-aws
  • vagrant plugin install puppet
  • vagrant plugin install nugrant (
  • sudo gem install puppet
  • Debug comands by setting VAGRANT_LOG to the appropriate level
VAGRANT_LOG=debug vagrant $command (to debug)
  • create ~/.vagrantuser
  access_key: "YOUR_KEY"
  secret_key: "YOUR_SECRET"
  keypair_name: "$USERNAME"
  ssh_username: "$USERNAME"
  ssh_pubkey: "FULL_PATH_TO_PEM"
  • vagrant up --provider aws dummy
  • vagrant ssh
  • vagrant halt | suspend | destroy


  • CloudMine Engineering