puppet-module-installer

Installs puppet modules recursively from a Puppetfile.

Installation

Until proper packages (Deb, Rpm) exist you can install the puppet-module-installer by downloading it from Maven Central: http://repo1.maven.org/maven2/org/backuity/puppet-module-installer_2.11/2.2.1/puppet-module-installer_2.11-2.2.1-one-jar.jar

If you have binfmt-support installed you can simply give the executable permission to your jar:

wget http://repo1.maven.org/maven2/org/backuity/puppet-module-installer_2.11/2.2.1/puppet-module-installer_2.11-2.2.1-one-jar.jar -O ~/bin/puppet-module-installer
chmod u+x ~/bin/puppet-module-installer

If you don't have binfmt-support, you can create a bash script:

#!/bin/bash

java -jar ~/bin/puppet-module-installer.jar "$@"

And download the jar next to it:

wget http://repo1.maven.org/maven2/org/backuity/puppet-module-installer_2.11/2.2.1/puppet-module-installer_2.11-2.2.1-one-jar.jar -O ~/bin/puppet-module-installer.jar

Usage

The tool provides the following options:

• --help : print a detailed help message
• --version : print the version

Go to a folder containing a Puppetfile and run puppet-module-installer, it will download recursively all the module described by the Puppetfile. You can inspect the graph of modules with the puppet-module-installer graph command, ex:

Puppetfile
  ├ my-app(HEAD)
  │ ├ java(1.16.0)
  │ ├ jmxtrans(1.74.0)
  │ │ └ logrotate(1.0.0)
  │ │
  │ └ tomcat(2.23.0)
  │   ├ dynatrace(1.4.0)
  │   ├ introscope(3.4.0)
  │   ├ java(1.16.0)
  │   ├ jmxtrans(1.28.0)
  │   ├ nexus(1.10.0)
  │   ├ puppi(2.0.8)
  │   ├ ssl(1.76.0)
  │   └ stdlib(1.2.0)
  │
  ├ motd(HEAD)
  └ sudo(HEAD)

Fetch mode

There are 5 different ways to retrieve the modules:

• Normal : (no option) Stick to the versions found in the Puppetfile, when no version is found, HEAD is used.
• Head : (--head) Use HEAD for all modules.
• Latest : (--latest) Ask git for a list of tags choose the highest minor for the current major
• Latest Forced : (--latest-force) Ask git for a list of tags and choose the highest
• Latest Head : (--latest-head) Same as Latest unless HEAD is wanted

Example

Given 2 puppet modules :

• java whose repository git is ssh://repos/java.git with the following tags : v1.3, v2.5, v2.6, v3.2
• nexus whose repository git is ssh://repos/nexus.git with the following tags : v1.10, v2.5

Give the following puppet file :

mod 'java',
  :git => 'ssh://repos/java.git',
  :ref => 'v2.5'
  
mod 'nexus',
  :git => 'ssh://repos/nexus.git'

Here are results of the different modes:

Mode	Java	Nexus
Normal	v2.5	HEAD
Head	HEAD	HEAD
Latest	v2.6	v2.5
Latest forced	v3.2	v2.5
Latest Head	v2.6	HEAD

Puppetfile syntax

The syntax comes from Librarian Puppet.