jail

Table of Contents

1. Overview
2. Module Description - What the module does and why it is useful
3. Beginning with jail
4. Usage - Configuration options and additional functionality
5. Limitations - OS compatibility, etc.

Overview

This module creates and manages FreeBSD jails.

Module Description

Setup

Beginning with jail

This module creates and manages FreeBSD jails. It is possible to create simple jails and use them as seperate systems. The module also allows to generate ezjail style basejails. Basejails are like templates for other jails, that allow to not duplicate the system data.

Usage

Setting up the host

include jail

Create a jail

Create basic jail

A basic jail will download FreeBSD from the FreeBSD FTP servers.

jail::jail {'myjail':

}

Create a base jail and 2 jails

jail::jail {'mybase':
}
jail::jail {'jail1:
  hostname => "jail1.example.com"
  basejail => "mybase"
}
jail::jail {'jail2:
  hostname => "jail2.example.com"
  basejail => "mybase"
}

Limitations

At this point only FreeBSD 10 is supported. Older versions of FreeBSD might work, however the installation of puppet within the jail uses the pkg(8) utility.