Boxen

The Boxen puppet module for... Boxen.

Required Modules for Boxen

Fundamental modules and types used by all of Boxen.

Usage

# We owe you examples. Sorry.

Facts

Boxen loads facts from following locations:

• ~/.boxen/config.json (weight -1)
• $BOXEN_HOME/config/facts/*.json (weight -1)
• $BOXEN_REPO_DIR/facts.d/ (weight EXTERNAL_FACT_WEIGHT + 1 = 10001) - various filetypes, see documentation
• _MODULEPATH_/_MODULE-NAME_/lib/facter/*.rb (weight set by vendor or default = number of confines, no confines = 0)

Facter itself also loads facts from environment variables with mask FACTER_* (weight 1_000_000).

Default values:

• _MODULEPATH_=$BOXEN_REPO_DIR/shared
• $BOXEN_REPO_DIR=Dir.pwd - de facto root of this repository, typically cloned into /opt/boxen/repo

Configuration

• ENV['BOXEN_HOME']/config/boxen/defaults.json
  • Default $BOXEN_HOME = /opt/boxen

Development

Write code. Run script/cibuild to test it. Check the script directory for other useful tools.