1RBM(1) RBM(1)
2
6 rbm - Packaging tool
7
9 rbm [command] [options]
10
12 Reproducible Build Manager (rbm) is a tool that helps you create and
13 build packages for multiple linux distributions, and automate the parts
14 that can be automated. It includes options to run the build in a
15 defined environement to allow reproducing the build.
16 It can be used to create rpm, debian and other types of packages.
18
20 tarball creation
21 Create tarballs for your software using a simple command and a git
22 or mercurial revision.
23 automatic verification of gpg signatures
25 If your git commits or git tags are gpg signed, the signature can
26 be automatically checked using a specified keyring.
27 package creation
29 Create binary or source packages from any git or mercurial revision
30 using a simple command.
31 packages upload
33 Upload the packages that you have built to a repository and update
34 metadata.
35 multi-os support
37 RPM and debian packages are currently supported. Support for more
38 packaging systems could easily be added. Using package templates
39 and the Template Toolkit, you can make different packages for
40 different distributions using the same files. The syntax of this
41 templating system is much more clear and powerful than the RPM
42 macros syntax.
43 remote builds
45 Build your software on a remote server with ssh, or in a local
46 chroot using a different OS. For instance if you are using rbm on
47 an rpm based distribution, this allows you to build debian packages
48 from the same workspace, using a Debian chroot.
49 customizable
51 Almost everything rbm do can be changed using some optional
52 settings, globally, or for some selected projects or OSs.
53 simple configuration
55 The configuration is done using simple YAML files.
56 a flexible configuration system
58 All settings can be set globally, per workspace, project, or target
59 operating system.
60 a dynamic configuration system
62 All configuration settings are templates. You can reuse other
63 configuration settings, or the output of some commands in those
64 settings. For instance, the version number of your software can be
65 set using a command to grep the README file in your sources tree.
66 extensible in perl
68 While the configuration is usually done in simple YAML, you can
69 also in the same configuration file use perl to define any of the
70 options. Those options can be defined by a perl function that will
71 be executed when the option is queried, and whose return value will
72 be used as the option value.
73
75 The following man pages are available :
76 • rbm_tutorial(7) : A tutorial introduction to rbm
78 • rbm_layout(7) : The rbm layout
80 • rbm_config(7) : The rbm configuration
82 • rbm_cli(7) : The rbm command line interface
84 • rbm_templates(7) : The rbm templates
86 • rbm_remote(7) : The rbm remote builds
88 • rbm_input_files(7) : The input files configuration
90 • rbm_targets(7) : The targets configuration
92 • rbm_steps(7) : The steps configuration
94 rbm commands :
96 • rbm(1)
98 • rbm-usage(1)
100 • rbm-tar(1)
102 • rbm-showconf(1)
104 • rbm-build(1)
106 • rbm-srpm(1)
108 • rbm-rpm(1)
110 • rbm-rpmspec(1)
112 • rbm-fetch(1)
114 • rbm-deb-src(1)
116 • rbm-deb(1)
118 • rbm-pkg(1)
120 • rbm-publish(1)
122
124 You can look at the Tor Browser build repository for an example of how
125 it can be used.
126 https://gitweb.torproject.org/builders/tor-browser-build.git/
127 07/23/2021 RBM(1)