This project is largely unmaintained. Use it at your own risk.
Repoman is a RESTful client/server interface for managing Debian repositories and building packages.
$ repoman show
anotherrepo
myrepo
myotherrepo
$ repoman show myrepo
libavahi-compat-libdnssd-dev
hadoop-doc
libavahi-common3
libavahi-core5
hadoop
php5-pecl-http
...
$ repoman show myrepo/php5
$ ls -l
-rw-r--r-- root/root 1143 2009-08-19 00:20 digg-example_0.1-1.dsc
-rw-r--r-- root/root 651952 2009-08-19 00:20 digg-example_0.1-1.tar.gz
-rw-r--r-- root/root 53888 2009-08-19 00:20 digg-example_0.1-1_all.deb
-rw-r--r-- root/root 1717 2009-08-19 00:20 digg-example_0.1-1_amd64.changes
$ repoman upload myrepo digg-example_0.1-1_amd64.changes
or:
$ tar czf digg-example.tar.gz digg-example_*
$ repoman upload myrepo digg-example.tar.gz
$ repoman promote myotherrepo/digg-example anotherrepo
$ repoman rm anotherrepo/digg-example
$ repoman refs github/ieure/repoman
1716b2a66fe03ae44f3ccce1b2c47f807be78d1f refs/heads/master
d01c66d053bea4098947bc93e46cdb5bde47fd74 refs/tags/release-1.3-2ubuntu1
5e2d2c4210c19a1d764e3f42fbca016c8b916b33 refs/tags/release-1.4-1
fae29549cc765dd71d74eec4348479c15724d42c refs/tags/release-1.4.3-1
053c6266ab01e9f403a7c7d524d04b1978178233 refs/tags/release-1.4.5-1
0c53809eda39a2d1d6d6a3d065f6f1ff22669d72 refs/tags/release-1.4.6-1
86a2c0136dc0922d036a93c322cd8e8ed2693f7d refs/tags/repoman-1.0
a9b4de203561476b5b761fe6f434b102762100f2 refs/tags/repoman-1.1
da855eddba3ba9aef87175bef99293d030ab8f04 refs/tags/repoman-1.2
$ repoman build github/ieure/repoman
Building github/ieure/repoman:origin/master, ID c27c8602197242539532980593cbfa26
. . . . . . . . Build complete.
$
$ repoman build_async github/ieure/repoman
Building github/ieure/repoman:origin/master, ID c27c8602197242539532980593cbfa26
$ repoman status c27c8602197242539532980593cbfa26
Build complete.
$ repoman wait c27c8602197242539532980593cbfa26
$ repoman get c27c8602197242539532980593cbfa26
$ curl -X GET http://repoman.example.com/repository/
[
"anotherrepo",
"myrepo",
"myotherrepo"
]
$ curl -X GET http://repoman.example.com/repository/myrepo
[
"libavahi-compat-libdnssd-dev",
"hadoop-doc",
"libavahi-common3",
"libavahi-core5",
"hadoop",
"php5-pecl-http",
...
]
$ curl -X GET http://repoman.example.com/repository/myrepo/php5
[
{
"SHA1": "cae8b9a4a821237a24b5757566efdc95391090d4",
"Maintainer": "Jeremy Grosser <synack@digg.com>",
"Description": "server-side, HTML-embedded scripting language (meta-package) This package is a meta-package that, when installed, guarantees that you have at least one of the four server-side versions of the PHP5 interpreter installed. Removing this package won't remove PHP5 from your system, however it may remove other packages that depend on this one. . PHP5 is an HTML-embedded scripting language. Much of its syntax is borrowed from C, Java and Perl with a couple of unique PHP-specific features thrown in. The goal of the language is to allow web developers to write dynamically generated pages quickly. . Homepage: http://www.php.net/",
"Package": "php5",
"Section": "web",
"MD5sum": "0efa615337f0ba59d8369e4469884730",
"Installed-Size": "20",
"Filename": "pool/main/p/php5/php5_5.2.9-digg8_all.deb",
"Priority": "normal",
"Depends": "libapache2-mod-php5 (>= 5.2.9-digg8) | php5-cgi (>= 5.2.9-digg8), php5-common (>= 5.2.9-digg8)",
"Version": "5.2.9-digg8",
"Architecture": "all",
"SHA256": "26844b968f6b51c1a02fd59c21455bf6ba47e46e47e53c6676af0ee4c2dd799b",
"Size": "1024"
}
]
$ tar -tzvf package.tar.gz
-rw-r--r-- root/root 1143 2009-08-19 00:20 digg-example_0.1-1.dsc
-rw-r--r-- root/root 651952 2009-08-19 00:20 digg-example_0.1-1.tar.gz
-rw-r--r-- root/root 53888 2009-08-19 00:20 digg-example_0.1-1_all.deb
-rw-r--r-- root/root 1717 2009-08-19 00:20 digg-example_0.1-1_amd64.changes
$ curl -F"package=@package.tar.gz;type=application/x-tar-gz" http://repoman.example.com/repository/myotherrepo
[
[
{
"SHA1": "18327ff3b2ac4e364baf700484fa487a78847a7a",
"Maintainer": "Jeremy Grosser <synack@digg.com>",
"Description": "Example package",
"Package": "digg-example",
"Section": "python",
"MD5sum": "4bbbee22e1ccbba6a2287f46e12c1b4b",
"Installed-Size": "836",
"Filename": "pool/main/d/digg-example/digg-example_0.1-1_all.deb",
"Priority": "normal",
"Depends": "python, python-support (>= 0.90.0)",
"Version": "0.1-1",
"Architecture": "all",
"SHA256": "23c31968821ac71a5b788ba193b92b48c78c9d677b2ba32823b9c8111387a2ea",
"Python-Version": "2.4, 2.5, 2.6",
"Size": "53888"
}
]
]
$ curl -X POST http://repoman.example.com/repository/myotherrepo/digg-example/copy?dstdist=anotherrepo
$ curl -X DELETE http://repoman.example.com/repository/anotherrepo/digg-example
$ curl -X POST -d "cburl=http://repoman.example.com/repository/myotherrepo&ref=origin/master" http://repoman.example.com/buildbot/github/synack/ncore
There are a few POST arguments passed here...
- '''ref''' - Git ref to be built. This can be a tag, commit id, branch, etc. Branches must be prefixed with origin/ (required)
- '''cburl''' - URL to post the resulting build tarball to. (optional)
- '''submodules''' - If this option is specified, the buildbot will attempt to update submodules before building. (optional)
The response to a properly formed POST will be a build ID hash.
$ curl -X GET http://repoman.example.com/buildbot/status/f82334b6664a4739a8c341544feec898
Build complete.
The last component of the URL is the build ID returned by the initial build POST. Completed builds may only show in status for up to 24 hours. After which, the build directories are cleaned and removed.
curl -X GET http://repoman.example.com/buildbot/tarball/f82334b6664a4739a8c341544feec898
Returns the tarball binary if the build is done or an informative message otherwise. Completed builds may only be available for up to 24 hours. After which, the build directories are cleaned and removed.
If you're going to run repomand under something like supervisor, be sure to set daemonize to false in web.conf.
Be sure the user repomand runs as has permissions to write to the specified logging directory.
Be sure to set the REPOMAN_API_URL environment variable. This will typically be set to http://localhost:9998. If you build a Debian package using the included things in the debian/ directory, this will be done for you.
An example config file for supervisor might look like this:
[program:repoman]
command=/usr/bin/repomand
autostart=true
autorestart=true
redirect_stderr=true
stdout_logfile=/var/log/repoman/repoman-stdout.log
user=jenkins
exitcodes=0