Repository layout

A BundleWrap repository contains everything you need to contruct the configuration for your systems.

This page describes the various subdirectories and files than can exist inside a repo.


nodes.py This file tells BundleWrap what nodes (servers, VMs, ...) there are in your environment and lets you configure options such as hostnames.
groups.py This file allows you to organize your nodes into groups.
bundles/ This required subdirectory contains the bulk of your configuration, organized into bundles of related items. Each bundle is a subdirectory of bundles/ with an items.py or metadata.py in it (or both).
data/ This optional subdirectory contains data files that are not generic enough to be included in bundles (which are meant to be shareable).
hooks/ This optional subdirectory contains hooks you can use to act on certain events when using BundleWrap.
items/ This optional subdirectory contains the code for your custom item types.
libs/ This optional subdirectory contains reusable custom code for your bundles.