backup Omnibus project

This project creates full-stack platform-specific packages for
backup!

At the moment, only the debian build are tested, and supported. Help to support other systems is welcomed !

Installation

You must have a sane Ruby 2.0.0+ environment with Bundler installed. Ensure all
the required gems are installed:

$ bundle install --binstubs

Usage

Build in Docker

We provide a script to run the debian build in Docker to get a clean build env
everytime. This script caches stuff in the cache/ folder and outputs pkgs in
the pkg/ folder. The omnibus build is a bit brittle, so you might have to run
it a few time

$ ./build.sh BACKUP_GIT_REF BUILD_NUMBER

For example, you might want to build version 5.0.0.beta.3 and it’s your third build:

$ ./build.sh 5.0.0.beta.3 3

Build

You create a platform-specific package using the build project command:

$ bin/omnibus build backup

The platform/architecture type of the package created will match the platform
where the build project command is invoked. For example, running this command
on a MacBook Pro will generate a Mac OS X package. After the build completes
packages will be available in the pkg/ folder.

Clean

You can clean up all temporary files generated during the build process with
the clean command:

$ bin/omnibus clean backup

Adding the --purge purge option removes ALL files generated during the
build including the project install directory (/opt/backup) and
the package cache directory (/var/cache/omnibus/pkg):

$ bin/omnibus clean backup --purge

If you’re using the build in docker feature, you can just remove the cache/ folder

Help

Full help for the Omnibus command line interface can be accessed with the
help command:

$ bin/omnibus help

Version Manifest

Git-based software definitions may specify branches as their
default_version. In this case, the exact git revision to use will be
determined at build-time unless a project override (see below) or
external version manifest is used. To generate a version manifest use
the omnibus manifest command:

omnibus manifest PROJECT -l warn

This will output a JSON-formatted manifest containing the resolved
version of every software definition.