32 Binary Package Tracking #
Products and updates to them are often officially supported by a company. To allow giving such support, there is binary package tracking. This feature allows checking which exact version of a package was shipped at what time. This feature is often important for release managers, maintenance engineers, QA engineers and supporters.
OBS can track these binary packages and offer a database to search them.
32.1 Which Binaries Are Tracked? #
All binaries which are released into projects providing
kind=maintenance_release are tracked. In addition to
that, the OBS administrator can configure additional projects via the
packtrack setting in BSConfig.pm.
32.2 What Data Is Tracked? #
In short the information to identify a binary, its building place and timestamps are tracked. In addition to that also information about possible successor versions or if the binary got removed in the meantime. If products do reference the repositories the search interface offers also a listing of products which are supposed to use it. Either as part of the product media itself or in one of its update repositories.
32.2.1 Binary Identifier #
A binary is identified by the following information which is extracted from components of the file path of the binary:
Repository: Where is the binary hosted?
Name: Name of the binary file
Epoch: The epoch version (optional, usually not used)
Version: The version
Release: The release number
Architecture: The hardware architecture
Medium: Name of the medium (exists only for product builds)
32.2.2 Binary Information #
Additional information about a binary is information which gets updated when a binary gets added or replaced.
operation, got the binary added, removed or modified
publish time, aka the time when the repository gets published by OBS. This is not the same time as when the release action got invoked.
build time
obsolete time, exists only when a binary gets removed or replaced
supportstatus, meta information about the level of support which is granted for the binary at the time of releasing it.
updateinfo id from rpm-md repository
maintainer of the binary who has prepared this update
disturl, the exact identifier to the source and build repository
32.2.3 Product information #
Additional information about products referencing to this binary.
updatefor: the listed products do reference the repository as update channel.
product: exists when the binary was part of a product medium
32.3 API Search Interface #
The search of released binaries is provided via the following API endpoints:
/search/released/binary/id : short form, just listing the matched binary identifiers. See the reference documentation.
/search/released/binary : long form, provides all other tracked information as described above. See the reference documentation.
Please visit the before mentioned links to get details and several examples of how to use these API endpoints.