Cross-distribution system package compiler
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.gopath/src/github.com/holocm
doc
src
test
util
vendor
.gitignore
.travis.yml
CHANGELOG.md
CONTRIBUTING.md
LICENSE
Makefile
PACKAGING.md
README.md

README.md

holo-build - cross-distribution system package compiler

Build Status

Holo relies on system packages to deploy configuration files and install applications. Distributions offer tooling to build such packages, but most of the time, these tools impose an unnecessary overhead when the goal is just to package up a few static files and list some dependencies. holo-build provides a simple, distribution-independent package description language and generates a system package from such a description. Supported package formats include dpkg, pacman and RPM.

[package]
name     = "hologram-systemd-timesyncd"
version  = "1.0"
author   = "Jane Doe <jane.doe@example.org>"
requires = ["systemd"]

[[file]]
path     = "/etc/systemd/timesyncd.conf.d/server.conf"
content  = """
    [Time]
    NTP=ntp.someserver.local
"""

[[symlink]]
# as created by `systemctl enable systemd-timesyncd`
path     = "/etc/systemd/system/sysinit.target.wants/systemd-timesyncd.service"
target   = "/usr/lib/systemd/system/systemd-timesyncd.service"

[[action]]
on     = "setup"
script = "systemctl daemon-reload && systemctl start systemd-timesyncd"

[[action]]
on     = "cleanup"
script = "systemctl stop systemd-timesyncd"

Installation

It is recommended to install holo-build as a package. The website lists distributions that have a holo-build package available.

holo-build requires Go and Perl as build-time dependencies. There are no runtime dependencies other than a libc. Once you're all set, the build is done with

make
make check
sudo make install

Documentation

User documentation is available in man page form.

For further information, visit holocm.org.