Forge Home

opendeploy

Module to manage opendeploy installations

7,312 downloads

7,312 latest version

5.0 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.0 (latest)
released Mar 8th 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 'wafture-opendeploy', '0.1.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add wafture-opendeploy
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install wafture-opendeploy --version 0.1.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

wafture/opendeploy — version 0.1.0 Mar 8th 2016

puppet-opendeploy

travis-cs status

Table of Contents

  1. Module Description - What the module does and why it is useful
  2. Setup - The basics of getting started with opendeploy
  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

Module Description

The opendeploy module installs, configures, and manages the OpenDeploy service for each respective run mode.

This module manages the installation of OpenDeploy.

Setup

Beginning with opendeploy

To install a base server with the default options:

class { '::opendeploy::base':
  source_url =>
  'http://example.com/path/to/IWOVOpenDeployBaseServer.Linux.8.1.0.tar.gz',
}

To customize options, such as the install directory or to enable event reporting, you must also pass the appropriate parameters:

class { '::opendeploy::base':
  source_url             =>
  'http://example.com/path/to/IWOVOpenDeployBaseServer.Linux.8.1.0.tar.gz',
  install_dir            => '/usr/od-home',
  enable_event_reporting => 'y',
}

Note: when working with any of the modes, the sourceurl paramter _is required. This should be the location to the tarball provided by the vendor.

Usage

Interaction for each of the server run modes is done via opendeploy::<MODE>. To install the receiver, use opendeploy::receiver. To install an admin, use opendeploy::admin.

Create a Base server

To create a base server with custom port mappings:

class { '::opendeploy::base':
  source_url     =>
  'http://example.com/path/to/IWOVOpenDeployBaseServer.Linux.8.1.0.tar.gz',
  registry_port  => 9175,
  listening_port => 20015,
}

Create a Receiver server

To create a receiver server with custom port mappings:

class { '::opendeploy::receiver':
  source_url     =>
  'http://example.com/path/to/IWOVOpenDeployRcvrServer.Linux.8.1.0.tar.gz',
  registry_port  => 9175,
  listening_port => 20015,
}

Reference

Classes

Public classes

Private classes

  • opendeploy::base::install: Installs OpenDeploy Base.
  • opendeploy::base::service: Manages service.
  • opendeploy::base::packages: Installs package dependencies for OpenDeploy.
  • opendeploy::base::skeleton: Creates appropriate directories for installation.
  • opendeploy::receiver::install: Installs OpenDeploy Receiver.
  • opendeploy::receiver::service: Manages service.
  • opendeploy::receiver::packages: Installs package dependencies for OpenDeploy.
  • opendeploy::receiver::skeleton: Creates appropriate directories for installation.

Parameters

opendeploy::base

source_url

HTTP GETable location of the vendor install tarball.

This is a required parameter.

install_dir

Location, as a fully qualified path, on the filesystem to install OpenDeploy.

Using install_dir => '/opt/od-home' will create the following structure:

/opt/od-home
    ├── OpenDeployNG/
        └── <installed files>
    └── odinstall/
        └── <files used to install>

Valid values are valid system paths. Defaults to /opt/od-home.

service_ensure

The status of the service. Valid values are stopped and running. Defaults to running.

registry_port

Defines a custom registry port for OpenDeploy to run on. Valid values are integers. Defaults to 9173.

listening_port

Defines a custom registry port for OpenDeploy to run on. Valid values are integers. Defaults to 20014.

enable_event_reporting

Enables event reporting with the OpenDeploy instance. Valid values are y or n. Default is n.

opendeploy::receiver

source_url

HTTP GETable location of the vendor install tarball.

This is a required parameter.

install_dir

Location, as a fully qualified path, on the filesystem to install OpenDeploy.

Using install_dir => '/opt/od-home' will create the following structure:

/opt/od-home
    ├── OpenDeployNG/
        └── <installed files>
    └── odinstall/
        └── <files used to install>

Valid values are valid system paths. Defaults to /opt/od-home.

service_ensure

The status of the service. Valid values are stopped and running. Defaults to running.

registry_port

Defines a custom registry port for OpenDeploy to run on. Valid values are integers. Defaults to 9173.

listening_port

Defines a custom registry port for OpenDeploy to run on. Valid values are integers. Defaults to 20014.

enable_event_reporting

Enables event reporting with the OpenDeploy instance. Valid values are y or n. Default is n.

Limitations

This module has been tested on:

  • RedHat Enterprise Linux 6, 7
  • CentOS 6, 7

Testing on other platforms is nonsensical as the vendor only supports the above systems

Development

See something you want to improve? Fork, clone, work, commit, and PR. Yay OSS!

Authors

This module was created and maintained by Nick Anderson.