3.4.4. Adding Bundles to Inventory

A bundle archive needs to be added to bundle inventory before it can be deployed. Bundle inventory is simply a directory or set of directories containing extracted bundle archives.

The add command is used to add a bundle archive to inventory. The source of this bundle archive can be a local file or a remote URL.

When a bundle added to inventory, a couple of things occur:

  1. The directories and files in the extracted archive are all set to 'read only'. This provides protection against accidental changes or deletions inside a bundle. Note that when a bundle is deployed, a writable 'work' directory is created for runtime data.
  2. A bundle hook named 'setup' is executed. This is a script that you can include to perform additional actions on the extracted archive (overriding the default permissions, for example).