1. blueprintignore(5)
  2. Blueprint
  3. blueprintignore(5)

NAME

blueprintignore - ignore specific resources when creating blueprints

SYNOPSIS

/etc/foo
!foo/bar
baz*
:file:/etc/foobar
:package:apt/build-essential
!:source:/opt

DESCRIPTION

Lines in /etc/blueprintignore and ~/.blueprintignore are interpreted as in blueprint-rules(5) but in a negative context - rules enumerate resources to be ignored and !-prefixed rules unignore resources.

As part of blueprint-create(1), the /etc/blueprintignore and ~/.blueprintignore files that were used to create the blueprint are stored in the local blueprint repository.

There are many resources that are ignored by default. These defaults are not meant to be an exhuastive list of exceptions and edge cases. Rather, they're meant to cover typical base installations without hassle.

Files

The following files and directories are part of the default ignore list. They can be negated using ! just like any other pattern.

The following files are ignored if their content matches an expected hash. They can be negated using ! just like any other pattern. These comparisions are made to augment searching files from packages to handle files that are part of packages but are not explicitly listed.

Packages

All APT- or Yum-managed packages considered essential to the system are part of the default ignore list.

Debian packages that are listed as essential, important, required, or standard and those that are depended upon by ubuntu-minimal, ubuntu-standard, or ubuntu-desktop are ignored.

Yum packages that are part of the base, core, or gnome-desktop groups are ignored.

Sources

By default, all directories except /usr/local are ignored as source resources. If it is necessary to build and install software from source in another directory, use a negated source resource such as !:source:/opt.

FILES

~/.blueprints.git
The local repsitory where blueprints are stored, each on its own branch.
/etc/blueprintignore, ~/.blueprintignore
Lists of filename patterns to be ignored when creating blueprints.
/tmp/blueprint-apt-exclusions, /tmp/blueprint-yum-exclusions
The lists of APT- and Yum-managed packages considered essential.
/tmp/blueprintignore
A cached copy of the complete list of ignore rules.

THEME SONG

The Flaming Lips - "The W.A.N.D. (The Will Always Negates Defeat)"

AUTHOR

Richard Crowley richard@devstructure.com

SEE ALSO

Part of blueprint(1).

  1. DevStructure
  2. December 2011
  3. blueprintignore(5)