Hackage :: [Package]

apotiki: a faster debian repository

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain] [Publish]

apotiki generates debian repositories fast. its goal is to be a great companion to fpm and jenkins.

apotiki operates with the following features and constraints:

[Skip to Readme]

Properties

Versions 0.5.1, 0.5.2, 0.5.2
Change log None available
Dependencies aeson (>=0.6.2.1), attoparsec (>=0.10.4.0), base (>=4.6 && <4.7), binary (>=0.7.1.0), bytestring (>=0.10.0.2), containers (>=0.5.0.0), crypto-api (==0.12.2.2), cryptohash (>=0.9.1), directory (>=1.2.0.1), http-types (>=0.8.3), old-time (>=1.1.0.1), openpgp (>=0.6.1), openpgp-asciiarmor (>=0.1), openpgp-crypto-api (>=0.6.3), scotty (>=0.6.2), strict (>=0.3.2), tar (>=0.4.0.1), text (>=1.0.0.1), transformers (>=0.3.0.0), wai-extra (>=2.0.3.1), wai-middleware-static (>=0.4.0.2), zlib (>=0.5.4.1) [details]
License MIT
Author Pierre-Yves Ritschard
Maintainer pyr@spootnik.org
Category System
Home page https://github.com/pyr/apotiki
Uploaded by pyr at 2014-01-24T22:51:26Z

Modules

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Readme for apotiki-0.5.2

[back to package description]

apotiki: a faster debian repository

apotiki

(image source)

apotiki generates debian repositories fast. its goal is to be a great companion to fpm and jenkins.

apotiki operates with the following features and constraints:

The Story

You operate a production environment and rely on software that is more recent than is available on a standard Debian or Ubuntu distribution ? Apotiki helps you distribute software by creating a separate debian repository which you can add to your apt sources.

Turns out there's already software available for this, such as freight, apotiki's angle is to work very fast for the most common use case.

Companion software

fpm is a great tool to build Debian packages with. It can produce packages from directories, gems, npm or pip libraries.

jenkins or travis-ci can produce artifacts by running scripts.

Using

apotiki has two modes of operation, try not to mix the two too much:

Running apotiki with no arguments or help will tell you a bit about usage.

If you wish to submit packages to the repository with curl here is the relevant command line assuming your package file is package-foo.deb

curl -X POST -F "package=@/path/to/package-foo.deb" http://repo-host:8000/repo

Building

Apotiki is a haskell program and relies on both the ghc compiler and cabal. They are probably already available in your platform of choice.

Once cabal is installed, just run:

cabal install

Alternatively, you can build apotiki with docker. Just run:

sudo docker build .

The resulting container will have the built cabal executable.

Installing

You can either run cabal install locally or distribute the built executable available in dist/build/apotiki/apotiki.

Configuring

For now the configuration is a serialized haskell structure:

ApotikiConfig {
  keyPath = "/etc/apotiki.key",      -- path to a PGP private key
  architectures = ["amd64", "i386"], -- list of supported architectures
  component = "main",                -- debian release component
  release = "precise",               -- debian release name
  label = "Apotiki",                 -- release label
  origin = "Apotiki",                -- release origin
  repoDir = "/srv/repo"              -- repository location, expose via http
}

The PGP private key you wish to use can be exported with:

gpg --export-secret-keys repository-key@your.domain > /etc/apotiki.key

The config file path can be controlled with the APOTIKI_CONFIG environment variable.

Caveats

Error handling is suboptimal to say the least. we'll get there.