Forge Home

kamailio

A module for managing Kamailio deployments with Puppet.

10,823 downloads

9,663 latest version

3.5 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.

Support the Puppet Community by contributing to this module

You are welcome to contribute to this module by suggesting new features, currency updates, or fixes. Every contribution is valuable to help ensure that the module remains compatible with the latest Puppet versions and continues to meet community needs. Complete the following steps:

  1. Review the module’s contribution guidelines and any licenses. Ensure that your planned contribution aligns with the author’s standards and any legal requirements.
  2. Fork the repository on GitHub, make changes on a branch of your fork, and submit a pull request. The pull request must clearly document your proposed change.

For questions about updating the module, contact the module’s author.

Version information

  • 0.0.6 (latest)
  • 0.0.5
  • 0.0.4
  • 0.0.3
  • 0.0.2
  • 0.0.1
released Oct 27th 2014

Start using this module

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

Add this module to your Puppetfile:

mod 'trulabs-kamailio', '0.0.6'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add trulabs-kamailio
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install trulabs-kamailio --version 0.0.6

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

trulabs/kamailio — version 0.0.6 Oct 27th 2014

puppet-kamailio

Description

Puppet module for Kamailio

=======

Overview

This module provides a simple interface for managing Kamailio deployments with Puppet.

Module Description

Kamailio is a very fast and configurable SIP proxy. kamailio.org

Setup

For the minimal setup, add:

include 'kamailio'

in your manifest.

You may want to configure a few options, e.g.:

class { '::kamailio':
    service_manage  => true,
    service_enable  => true,
    service_ensure  => 'running',
    manage_repo     => true,
    with_tls        => true,
    with_websockets => true,
    with_ephem_auth => true,
    manage_config   => false,
}

On an empty host:

apt-get update && apt-get install -y puppet
## This will also pull puppetlabs-apt and puppetlabs-stdlib
puppet module install trulabs-kamailio
puppet apply -v /etc/puppet/modules/kamailio/tests/init.pp --show_diff --noop

Parameters

#####service_manage

If set to true, Puppet takes care of the service according to service_enable and service_ensure. Default is 'true'.

#####service_enable

Configures whether Kamailio should be enabled. Applies if service_manage is true. Default is 'true'.

#####service_ensure

If service_manage is true and service_enable is true, this parameter tells Puppet whether Kamailio should be running. Default is 'running'.

#####manage_repo

Should Puppet manage apt sources?

#####with_tls

Whether TLS should be enabled, plus basic configuration.

#####with_websockets

Whether the WebSockets module should be installed.

#####with_ephem_auth

Whether the ephemeral authentication module should be installed.

#####manage_config

Should Puppet deploy the configuration files?

#####package_ensure

Version or status of the package, e.g. 'latest' (which is also default) or '4.1.6+wheezy'

Author

Truphone Labs
Giacomo Vacca <giacomo.vacca@gmail.com>

License

See LICENSE file.

##Tests

Run tests with: sudo puppet apply -v tests/init.pp --modulepath modules/:/etc/puppet/modules --show_diff --noop

##Limitations

This module has been built and tested with Puppet 2.7.

The module has been tested on:

  • Debian 7

##Contributors The list of contributors can be found at: https://github.com/trulabs/puppet-kamailio/graphs/contributors