Poudriere
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
Contents |
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 ports -l % poudriere testport -j <JAILNAME> -o <category>/<portname>
Added functionality
Portmaster and Portshaker can be used with Poudriere to add functionality.
