Poudriere

Revision as of 02:24, 10 March 2015

Poudriere is a program to create packages from port builds inside a jail. This system allows packages to be made without logging into the jail.

To install:

% pkg install poudriere

% /usr/ports/ports-mgmt/poudriere/make install clean

For quick help type:

% poudriere <option> help

Setup

The following configurations are done within the directory /usr/local/etc/.

Edit poudriere.conf based on poudriere.conf.sample To speed up later compiles, by allowing poudriere to track changes and use code from previous compiles, uncomment the following line in poudriere.conf , then make sure this directory exists:

CCACHE_DIR=/var/cache/ccache

Then create make.conf in the /usr/local/etc/poudriere.d/ directory with the following to allow use with pkgng:

WITH_PKG=yes

For specific makefiles, create <JAILNAME>-make.conf here.

% vi amd64-make.conf

To configure source options, including source retrieval, edit src.conf, and for custom files create <JAILNAME>-src.conf. See the manpage for src.conf for options.

Poudriere requires a portstree; to create it type:

% poudriere ports -c

Then it requires a base for each architecture and FreeBSD version you wish to compile for:

% poudriere jail -c -j <JAILNAME> -v 10.1-RELEASE -a ARCHITECTURE -m svn

If the architecture isn't specified, it defaults to your system's architecture.

Building

Create a file with a list of category/port in it to be referenced by the build. Example contents of <list1>:

multimedia/gstreamer1

These can be set now, or during the build:

% poudriere options -j <JAILNAME> -f <directory>/<list1>

or

% poudriere options -j <JAILNAME> cat/port1 cat/port2

Update ports, set options, then compile:

% poudriere ports -u
% poudriere bulk -f <directory>/<list1> -j <JAILNAME>

Testing

After compiling use the option testport. This is also a developer's tool.

% poudriere testport -j <JAILNAME>

Added functionality

Portmaster and Portshaker can be used with Poudriere to add functionality.

References

• Poudriere manpage
• What is poudriere?