Forge Home

trac

Puppet module for managing Trac instances

9,671 downloads

9,671 latest version

1.9 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 Feb 24th 2014

Start using this module

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

Add this module to your Puppetfile:

mod 'jjulien-trac', '0.1.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add jjulien-trac
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install jjulien-trac --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

jjulien/trac — version 0.1.0 Feb 24th 2014

trac

##Overview Puppet module for managing trac instances

##Usage

Creating a trac instance

To accept all defaults use this code. Note: This will setup trac with no authentication and no admins. You will need to setup your own apache auth at a more global level if you use these defaults. You will also probably want to specify at least one admin using trac::admin {'admin': } in your manifest as well.

  trac::project {'sampleproject': }

Setup using basic auth where this module manages the passwd file

  trac::project {'sampleproject': 
   admins       => ['testadmin'],
   userhash     => {'testadmin'     => '4a7h9E5zdLJ/c',
                   {'testuser'      => '4a7h9E5zdLJ/c'}

Setup using basic auth where your module manages the passwd file

  trac::project {'sampleproject': 
   admins       => ['testadmin'],
   auth_file    => '/etc/tracsecurity/passwd',
  }

Setup using your own template to manage the apache authentication

Manifest:

  trac::project {'sampleproject':
    httpd_auth_content => template('mytracmodule/httpd/auth.erb'),
    admins     => ['testadmin'],
  }

mytracmodule/httpd/auth.erb:

  AuthType Kerberos
  AuthName "EXAMPLE"
  Krb5KeyTab /etc/httpd/keytabs/http.keytab
  KrbMethodNegotiate On
  KrbMethodK5Passwd On
  KrbVerifyKDC On
  KrbServiceName HTTP/trac.example.com
  require valid-user

Parameters

#####db_user Default: testing

The database user who will manage the trac instance. This is used to buid the connection string for the trac.ini file.

#####db_host Default: localhost

The host the database is running on. This is used to buid the connection string for the trac.ini file.

#####db_port Default: 5432

The host the database is running on. This is used to buid the connection string for the trac.ini file.

#####httpd_auth_content Default: Configures for basic auth

#####auth_name Default: trac

The name displayed in the BasicAuth authentication popup

#####userhash Default: undef

Hash of {user => password} where password is a hashed version that will be placed into the htpasswd file

#####admins Deafult: []

A list of usernames to give the TRAC_ADMIN permission to

#####trac_title Default: undef

The title of your project which will be displayed at the top of your trac page

#####logo_image Default: undef

A Puppet file URL that points to the image you want displayed on your trac page. Ex. puppet:///module/mytracmodule/images/logo.png

#####logo_height Default: undef

The height of your logo

#####logo_width Default: undef

The width of your logo

#####logo_alttext Default: undef

Alt tag that will be associated with your logo

##TODOs

  • Add support for other database backends (currently only supports postgresql)
  • Abstract ini parameter management for the defined type trac::project and allow users to pass in a hash of override or additional parameters