1TITO(8) Tito User Manual TITO(8)
2
6 tito - manage RPM based projects using git
7
9 tito init
10 tito tag [OPTIONS]
12 tito build --test --rpm
14 tito build [OPTIONS]
16 tito release [OPTIONS] TARGET
18 tito report
20
22 After setting up a directory as a Git repo, use tito to manage the tags
23 and builds. A simple workflow may look like:
24 1. Save user preferences as described in titorc(5)
26 2. Initialize a .tito directory
28 3. Test
30 1. Make changes to source
32 2. Use git to commit changes
34 3. Build: tito build --rpm --test
36 4. Finalize a release
38 1. Tag: tito tag
40 2. Push: git push && git push $ORIGIN $TAG
42 3. Build: tito build [OPTIONS]
44
46 tito init
47 This will create a top-level metadata directory called ".tito/" and
48 commit it to git. This directory will store tito’s configuration and
49 package metadata on a per branch basis. It will be filtered out when
50 creating .tar.gz’s.
51 Note
53 Your spec file should list the source as %{name}-%{version}.tar.gz
54 tito tag [options]
56 By default, tito will tag by bumping the rpm version (i.e. we bump the
57 Z in X.Y.Z). If you’d prefer to bump the package release instead
58 (normally should just be used for changes to the spec file or patches
59 applied within it), you can change the tagger class in .tito/tito.props
60 to ReleaseTagger. This will affect all packages in this git branch; if
61 you’d prefer to do this on a per-package basis you can do so in a
62 package specific tito.props.
63 If you work in a OBS style git with a separate .changes file for the
65 changelog, change the tagger class to tito.susetagger.SUSETagger. The
66 SUSETagger is based on the VersionTagger.
67 -h, --help
69 show this help message and exit
70 --debug
72 print debug messages (can be also set using DEBUG environment
73 variable)
74 --offline
76 do not attempt any remote communication (avoid using this please)
77 -o OUTPUTDIR, --output=OUTPUTDIR
79 Write temp files, tarballs, and RPMs to OUTPUTDIR. Create
80 sub-directories as needed by rpmbuild(8). (default /tmp/tito)
81 --tag-release
83 Deprecated, no longer required.
84 --keep-version
86 Use spec file version/release exactly as specified in spec file to
87 tag package.
88 --use-version=USE_VERSION
90 Update the spec file with the specified version.
91 --use-release=USE_RELEASE
93 Update the spec file with the specified release.
94 --no-auto-changelog
96 Don’t automatically create a changelog entry for this tag if none
97 is found
98 --accept-auto-changelog
100 Automatically accept the generated changelog.
101 --auto-changelog-message=MESSAGE
103 Use MESSAGE as the default changelog message for new packages
104 --changelog=MESSAGE
106 Use MESSAGE as the changelog when tagging, this can be specified
107 every time a package is tagged. Useful when needing to generate
108 custom changelogs. This will override the auto generated changelog.
109 -u, --undo
111 Undo the most recent (un-pushed) tag.
112 Note
114 Tito will create automatic changelog from git commits. Unless you
115 specify one of auto options, tito will open text editor and allow
116 you to edit the text. Editor is by default. This can be changes by
117 environment variable EDITOR.
118 tito build [options]
120 -h, --help
121 show this help message and exit
122 --debug
124 print debug messages (can be also set using DEBUG environment
125 variable)
126 --offline
128 do not attempt any remote communication. Avoid using this please.
129 See OFFLINE section below.
130 -o OUTPUTDIR, --output=OUTPUTDIR
132 Write temp files, tarballs and RPMs to OUTPUTDIR. (default
133 /tmp/tito)
134 --tgz
136 Build .tar.gz
137 --srpm
139 Build srpm
140 --rpm
142 Build srpm and rpm
143 -i, --install
145 Install any binary RPMs being built.
146 Warning
148 uses sudo rpm -Uvh --force
149 --no-sudo
151 Don’t escalate privileges when installing. Use when running this
152 command with required privileges.
153 --dist=DISTTAG
155 Apply DISTTAG to srpm and/or rpm. (e.g., ".el5")
156 --test
158 use current branch HEAD instead of latest package tag.
159 --no-cleanup
161 do not clean up temporary build directories/files
162 --rpmbuild-options=OPTIONS
164 Pass OPTIONS to rpmbuild.
165 --builder=BUILDER
167 Override the normal builder by specifying a full class path or one
168 of the pre-configured shortcuts. Only useful if you need to
169 override the default builder for some purpose, such as testing a
170 build via mock.
171 --arg=BUILDER_ARGS
173 Custom arguments specific to a particular builder. (key=value)
174 --scl=COLLECTION
176 Build package for software collection. This is mostly useful for
177 building src.rpm, because for rpm you want to define this option
178 for specific tag in tito.props
179 --quiet
181 Suppress output from the build process.
182 --verbose
184 Expose more output from the build process.
185 tito release [options] TARGETS
187 Runs the release targets defined in .tito/releasers.conf.
188 -h, --help
190 show this help message and exit
191 --debug
193 print debug messages (can be also set using DEBUG environment
194 variable)
195 --offline
197 do not attempt any remote communication. Avoid using this please.
198 See OFFLINE section below.
199 -o OUTPUTDIR, --output=OUTPUTDIR
201 Write temp files, tarballs and RPMs to OUTPUTDIR. (default
202 /tmp/tito)
203 --tag=PKGTAG
205 build a specific tag instead of the latest version (e.g.,
206 spacewalk-java-0.4.0-1)
207 --dry-run
209 Do not actually commit/push anything during release.
210 --no-build
212 Do not perform a brew/koji build, only DistGit commit. (only for
213 Koji/DistGit releasers)
214 --all
216 Run all release targets defined in .tito/releasers.conf.
217 --list
219 List all release targets defined in .tito/releasers.conf.
220 --all-starting-with=ALL_STARTING_WITH
222 Run all release targets starting with the given string. (i.e. if
223 you have defined release targets yum-f15 and yum-f14 in
224 releasers.conf, --all-starting-with=yum will run only these
225 targets, and ignore any others.)
226 --scratch
228 Perform a scratch build in Koji. Can be specified using environment
229 variable SCRATCH set to 1 as well.
230 --yes
232 Do not ask to confirm release commits or edit their messages.
233 tito report [options]
235 Display a report of all packages with differences between HEAD and
236 their most recent tag, as well as a patch for that diff. Used to
237 determine which packages are in need of a rebuild.
238 -h, --help
240 show this help message and exit
241 --debug
243 print debug messages (can be also set using DEBUG environment
244 variable)
245 --offline
247 do not attempt any remote communication. Avoid using this please.
248 See OFFLINE section below.
249 -o OUTPUTDIR, --output=OUTPUTDIR
251 Write temp files, tarballs and RPMs to OUTPUTDIR. (default
252 /tmp/tito)
253 --untagged-diffs
255 Print out diffs for all packages with changes between their most
256 recent tag and HEAD. Useful for determining which packages are in
257 need of a re-tag.
258 --untagged-commits
260 Print out the list for all packages with changes between their most
261 recent tag and HEAD. Useful for determining which packages are in
262 need of a re-tag.
263
265 Offline lets you potentially do builds you can’t reproduce, normally we
266 check that the tag you’re building exists in the remote repo. If it
267 hasn’t been pushed, it’s quite easy to do a build that will result in a
268 checksum that is no longer the same. This is something you should try
269 to avoid.
270
272 Build and install a test package from the latest code in current git
273 HEAD
274 tito build --rpm --test -i
275 Overriding the default builder to build via mock instead
277 tito build --builder mock --arg mock=fedora-15-x86_64 --rpm
278
280 titorc(5) releasers.conf(5) tito.props(5)
281 /usr/share/doc/tito-*/README.mkd
283
285 Devan Goodwin <dgoodwin@rm-rf.ca>
286 James Bowes <jbowes@repl.ca>
288 Jan Pazdziora
290 Jesus M Rodriguez <jesusr@redhat.com>
292 Pall Sigurdsson <palli@opensource.is>
294 Miroslav Suchý <msuchy@redhat.com>
296 and: Adam Miller, Alex Wood, Aron Parsons, Brenton Leanhardt, Ivan
298 Nečas, John Eckersberg, Kenny MacDermid, Lukáš Zapletal, Luke Meyer,
299 Marian Csontos, Martin Bačovský, Michael Stead, Mike McCune, mscherer,
300 Paul Morgan, Sean P. Kane, Steve Ashcrow Milner
301tito 07/08/2023 TITO(8)