This article was written originally in Early 2021 during the bootstrap of Rocky Linux. Content on this page is kept for historical reasons, but has been edited lightly to fix links, provide context, or remove instructions that are no longer relevant to prevent confusion. This document will be archived.
- Download Rocky Devtools
- Install Rocky Devtools
- Download Source RPMs (rockyget)
- Building packages (rockybuild)
- Trobleshooting package builds
Work in progress
Rocky Devtools refers to a set of home grown scripts and utlities created by members of the Rocky Linux community to help with sourcing, creating, branding, patching and building software packages distributed with the Rocky Linux Operating system.
Rocky devtools consists of
At a low level Rocky Devtools is a wrapper for running some custom and tradtional programs that are used for various package management tasks. Rocky Devtools relies heavily on
You'll need an existing modern RPM based Linux system to install and use Rocky devtools.
Let's walk through a typical installation and usage scenario of the devtools.
1. Download Rocky Devtools¶
Download the devtools zipped source from the following URL:
Here we use the
curl -OJL https://github.com/rocky-linux/devtools/archive/refs/heads/main.zip
You should now have a zipped archive named
2. Install Rocky Devtools¶
Locate and uncompress the devtools archive that you just downloaded.
Here we'll use the
unzip command line utility:
Change your working directory to the new devtool source directory that was just created:
make to configure and compile devtools:
sudo make install
3. Use Rocky Devtools (rockyget) to search for and download Source RPMs (SRPMs)¶
Once installed, the main utility for finding and downloading SRPMs is the
rockyget to download the SRPM for the popular
~/rocky/rpmsfolder will be automaically created.
For our current sed example, its sources will be stored under the following sample folder hierchy:
~rocky/rpms/sed/ └── r8 ├── SOURCES │ ├── sed-4.2.2-binary_copy_args.patch │ ├── sed-4.5.tar.xz │ ├── sedfaq.txt │ ├── sed-fuse.patch │ └── sed-selinux.patch └── SPECS └── sed.spec
Once you have the original sources, this might be a good time to look through the SPECs file (
~rocky/rpms/sed/SPECS/specs.spec) to look for potential debranding opportinites in the given package. Debranding might include replacing upstream artwork/logos and so on.
If you are looking for other Rocky packages to build and experiment with, you can browse the list of packages that are currently failing in the Rocky automated build environment here - https://kojidev.rockylinux.org/koji/builds?state=3&order=-build_id
4. Use Rocky Devtools (rockybuild) to build a new package for the Rocky OS¶
Under the hood,
mock utilities to build the source package in a chroot environment for the application specified on the command-line. It relies on the application sources and RPM SPEC file that was automatically downloaded via the
rockybuild to build the sed utility:
The time needed to complete the build process/step depends on the size and complexity of the application you are trying to build.
At the end of the
rockybuild run, an output similar to the one here indicates that the build completed successfully.
.......... + exit 0 Finish: rpmbuild sed-4.5-2.el8.src.rpm Finish: build phase for sed-4.5-2.el8.src.rpm INFO: Done(~/rocky/rpms/sed/r8/SRPMS/sed-4.5-2.el8.src.rpm) Config(baseos) 4 minutes 34 seconds INFO: Results and/or logs in: /home/centos/rocky/builds/sed/r8 ........
If all goes well you should end up with a Rocky ready SRPM file under the
5. Debugging a failed package build¶
The previous rockybuild process will generate some log files that can be used in debugging failed application builds. The results and/or logs of the build process are stored under the
~/rocky/builds/<PACKAGE NAME>/r8. For example
~/rocky/builds/sed/r8 ├── build.log ├── hw_info.log ├── installed_pkgs.log ├── root.log ├── sed-4.5-2.el8_3.src.rpm ├── sed-4.5-2.el8_3.x86_64.rpm ├── sed-debuginfo-4.5-2.el8_3.x86_64.rpm ├── sed-debugsource-4.5-2.el8_3.x86_64.rpm └── state.log
The main files to search for clues for the causes any error(s) are the build.log and root.log. The build.log file should detail all build errors and the root.log file will contain information about the chroot environment setup and tear down processes. With everything else being equal, most of the build debugging/troubleshooting process can be performed with the contents of the build.log file.