rtsisyk/MINC_logo1.jpg

PackPack

PackPack is a comprehensive ready-to-use solution to build and publish RPM and Debian packages in the cloud.

[][PackPack]

Push your code to [GitHub]
Build packages using [Travis CI]
Host repositories on [PackageCloud] or Amazon S3¹

PackPack is the missing glue between [GitHub], [Travis CI] and [PackageCloud].

Cloud-hosted and absolutely free of charge. Just a minute from the push to the end user.

Supported Distros

Debian Wheezy / Jessie / Stretch / Sid
Ubuntu Precise / Trusty / Xenial / Yakkety
Fedora 23 / 24 / Rawhide
CentOS 6 / 7

Please feel free to file an [issue][Issues] if you want more distros.

Quick Start

Put RPM spec to rpm/<myreponame>.spec and Debian rules to debian/ folder.
Tag the git repository with he major.minor annotated git tag. PackPack will automatically set patch level based on the commit number from this tag in order to provide major.minor.patch sematic versioning.

$ git tag -a 1.0
$ git describe --always --long
1.0-0-g5c26e8b # major.minor-patch

Register an account on [PackageCloud] and create a repo.
Add your [GitHub] project to [Travis CI].
Add PACKAGECLOUD_TOKEN=<token> (secret) and PACKAGECLOUD_REPO=<username>/<reponame> environment variables [to your project settings on Travis CI][Travis CI Environment].
Enable PackPack magic. Here is our .travis.yml file:

sudo: required
services:
  - docker

cache: ccache

env:
    matrix:
      - OS=centos DIST=6 PACK=rpm
      - OS=centos DIST=7 PACK=rpm
      - OS=fedora DIST=23 PACK=rpm
      - OS=fedora DIST=24 PACK=rpm
      - OS=ubuntu DIST=trusty PACK=deb
      - OS=ubuntu DIST=precise PACK=deb
      - OS=ubuntu DIST=xenial PACK=deb
      - OS=ubuntu DIST=yakkety PACK=deb
      - OS=debian DIST=jessie PACK=deb
      - OS=debian DIST=wheezy PACK=deb
      - OS=debian DIST=stretch PACK=deb

script:
  - git clone https://github.com/packpack/packpack.git
  - ./packpack/packpack

Push the update to GitHub repo to trigger Travis CI.
Check Travis logs and fix the build problems if any.
Get packages on your [PackageCloud] repo.
(Optional) Star us on GitHub.

That's it.

Local Usage

PackPack can be used locally without Travis CI to troubleshoot problems with builds.

Install the following dependencies:

bash
tar
Docker
Python 2.6+ or Python 3+

Clone this repository:

myproject$ git clone https://github.com/packpack/packpack.git packpack

Try to build some packages, say RPM packages for Fedora 24:

myproject$ OS=fedora DIST=24 ./packpack/packpack

For the first time PackPack will download Docker images, please wait for a while.

Generated RPM packages will be stored to packpack/root/${PRODUCT}/${VERSION}-${RELEASE}/$OS/$DIST/results/ folder:

myproject$ ls -1s build/root/myproject/1.0.2-0/fedora/24/results/
total 112
76 myproject-1.0.2-0.fc24.src.rpm
36 myproject-devel-1.0.2-0.fc24.x86_64.rpm

Environment variables

PackPack can be tuned using environment variables.

OS - target operating system (like fedora or ubuntu)
DIST - os distribution name or tag (like 21 or precise)
PACK - packager type [deb/rpm/none].
PRODUCT - project name used for source tarball and source package.
VERSION - a package version to use, e.g. 1.0.0 (defaults to git tag name)
RELEASE - a package release number, e.g. -155 (defaults to the commit number from the last tag, see git describe --long)
PACKAGECLOUD_TOKEN - a token for http://packagecloud.io/
PACKAGECLOUD_REPO - package cloud repository name (default is ${username}/${branch})

Please see [config.yml][config.yml] for detailed guide.

Customizing Rules

To override some Packpack rules create a file named .packpack.yml at the root directory of your git repository. PackPack will try to load this and override system-wide rules in [config.yml][config.yml].

For example, to override version generator, create a .packpack.yml file with the following content.

env:
  VERSION:
    - git describe --long --always | sed -n 's/^\([0-9\.]*\)-\([0-9]*\)-\([a-z0-9]*\)/\1.\2/p')
  RELEASE=1

Please see [config.yml][config.yml] for examples.

Tests

If PACK is equal none - Travis run test.sh from project root (if file exists)

Exclusion

It's possible to exclude some builds from packaging: https://docs.travis-ci.com/user/customizing-the-build/#Build-Matrix

Example: https://github.com/tarantool/tarantool/blob/1.6/.travis.yml

1 Amazon S3 support is coming soon. ^ [PackPack]: https://github.com/packpack/packpack [GitHub]: https://github.com/ [PackageCloud]: https://packagecloud.io/ [Travis CI]: https://travis-ci.org/ [Travis CI Environment]: https://docs.travis-ci.com/user/environment-variables/#Defining-Variables-in-Repository-Settings [Issues]: https://github.com/packpack/packpack/issues [RPM]: https://github.com/tarantool/modulekit/tree/master/rpm [Debian]: https://github.com/tarantool/modulekit/tree/master/debian [Travis Integration]: https://docs.travis-ci.com/user/getting-started/ [PackageCloud Integration]: https://packagecloud.io/docs#travis [luafun]: https://github.com/rtsisyk/luafun [luafun-logo]: https://gist.githubusercontent.com/rtsisyk/28436ebd7bec8cb1a441faf0cc588fb3/raw/7870cfc5d8174041f2abfe12778bb0466e39711e/luafun.png [tarantool-logo]: https://gist.githubusercontent.com/rtsisyk/28436ebd7bec8cb1a441faf0cc588fb3/raw/bac8cf73fb98ce892a5b3837627736ceaba37652/tarantool.png [config.yml]: https://github.com/packpack/packpack/blob/master/config.yml