Configuring Assemblies

An "assembly" is a group of files and/or directories assembled into an archive and distributed. File system entries are included (or excluded) by setting up the appropriate entries in your configuration. For example, consider the following additions to a standard, top level rebar.config, which will put the entire [rebar generated release](https://github.com/basho/rebar/wiki/Release-handling) into an archive, but exclude the erts subdirectories.

{sub_dirs, ["rel"]}.
{dist, [
    {incl_dirs, ["rel/*"]},
    {excl_dirs, ["**/erts-*"]}
]}.

The plugin will work out the difference between overlapping includes and excludes so as to remove the directory matching the +erts-* + glob pattern from the output prior to archiving.

Configuration Options

These options are given in the rebar.config configuration file, or in a corollary config file named dist.config if you prefer to keep the options separate.

Command	Option	Description
dist	format	The output format, one of zip,tar,targz. Defaults to targz.
dist	outdir	The output directory into which all assemblies should be placed. Defaults to ./dist.
dist	workdir	The directory in which all temporary file system entries should be dealt with. Defaults to ./dist/.work.
dist	incl_dirs	List of glob patterns or literal folder names to include. No Default.
dist	excl_dirs	List of glob patterns or literal folder names to Exclude. No Default.
6	Three items	ok