devpi-puppet

Table of Contents

• Overview
• TL;DR
• Using the module in detail
• Tested platforms
• Related projects
• References

Overview

This is a Puppet module to install devpi-server behind a NginX proxy. See also debianized-devpi for building the required devpi package. On non-Debian platforms, you can use fpm or similar tools to build such a package.

Screenshot of the 'default' theme

TL;DR

If you just want a working 'devpi-server' on your machine proxied by NginX on port 31415 and watched by supervisord, then call these commands, after either installing the devpi package via dpkg -i, or providing it in a source registered with APT:

git clone "https://github.com/jhermann/devpi-puppet.git"
cd devpi-puppet
sudo ./apply.sh

You can also pass --noop and other Puppet options to the script. It installs Puppet if that's missing, and then applies the node definition contained in site.pp.

Using the module in detail

Parameters

All the possible parameters are documented in init.pp and nginx.pp. For creating a simple HTML rendering, use this command:

rdoc -q -SN1 -E pp=rb >doc/index.html manifests/init.pp manifests/nginx.pp

Importing the module into your project

If for whatever reason you don't want to use tools like the puppet module command or librarian-puppet, the following shows how to use git subtree (as opposed to git submodule) to import this repository into your modules directory.

First, and once only, add devpi-puppet to your remotes and add a subtree named modules/devpi:

git remote add -f devpi-puppet "https://github.com/jhermann/devpi-puppet.git"
git remote update && git subtree add --prefix modules/devpi devpi-puppet master --squash

Then to later update the subtree, use this:

git remote update && git subtree pull --prefix modules/devpi devpi-puppet master --squash

You can also use a tag name instead of master, to get a specific release.

Tested platforms

This module is known to work on:

• Debian 7.6 (wheezy)
• Ubuntu 12.04 (precise)
• Ubuntu 14.04 (trusty)

Related projects

• devpi – The main project on Bitbucket.
• devpi Debian packaging – Build a DEB package for devpi that contains all dependencies and extensions in a virtualenv.
• puppet-module-skeleton – A great stencil for Puppet modules.
• daniellawrence/puppet-devpi – An alternative devpi Puppet module.
• dave-shawley/devpi-cookbook – Chef cookbook for devpi-server.
• ansible-devpi – Ansible role for setting up a devpi server by Doug Hellmann.
• scrapinghub/docker-devpi – Trusted build of devpi published to the public Docker registry.
• daniellawrence/devpi-docker – Running devpi the easy way.
• fschulze/devpi-buildout – A buildout to set up devpi-server on localhost.

References

• devpi Docs
• Puppet Homepage