|
|
| (36 intermediate revisions by 6 users not shown) |
| Line 1: |
Line 1: |
| {{autolang|base=yes}}
| |
|
| |
|
| = Mock =
| |
|
| |
|
| Mock is a tool for building packages. It can build packages for different architectures and different Fedora or RHEL versions than the build host has. Mock creates chroots and builds packages in them. Its only task is to reliably populate a chroot and attempt to build a package in that chroot.
| | = This page is not maintained anymore. It has been moved to https://rpm-software-management.github.io/mock/ = |
| | |
| == Status ==
| |
| Mock is currently being used for all Fedora builds. It is called by [[Koji]] and [https://copr.fedoraproject.org Copr] to build chroots and packages.
| |
| | |
| == Download ==
| |
| | |
| If you want to contribute to code, please checkout https://fedorahosted.org/mock/ for more inforations.
| |
| | |
| Otherwise just run "yum install mock".
| |
| | |
| == Setup ==
| |
| All users that are to use mock must be added to the 'mock' group.
| |
| | |
| <code>usermod -a -G mock [User name] && newgrp mock</code>
| |
| | |
| Configuration files are in /etc/mock. Mock versions 0.8.0 and higher cache the downloaded rpm packages (via the yum_cache plugin), which speeds up subsequent builds by a considerable margin. Nevertheless, you may wish to change the default configuration to point to local repositories to speed up builds.
| |
| | |
| By default, builds are done in /var/lib/mock, so be sure you have room. Starting with mock 0.8.0 and higher, you can change this via the 'basedir' config option.
| |
| | |
| == Plugins ==
| |
| | |
| * [[Projects/Mock/Plugin/BindMount|bind_mount]]
| |
| * [[Projects/Mock/Plugin/CCache|ccache]] - compiler cache plugin
| |
| * [[Projects/Mock/Plugin/ChrootScan|chroot_scan]] - allows you to retrieve build artifacts from buildroot (e.g. additional logs, coredumps)
| |
| * [[Projects/Mock/Plugin/CompressLogs|compress_logs]] - compress logs
| |
| * [[Projects/Mock/Plugin/LvmRoot|lvm_root]] - caching buildroots using LVM
| |
| * [[Projects/Mock/Plugin/Mount|mount]] - allows you to mount directories into chroot
| |
| * [[Projects/Mock/Plugin/PackageState|package_state]] - dumps list of available and installed packages
| |
| * [[Projects/Mock/Plugin/RootCache|root_cache]] - cache buildroots (as tar file).
| |
| * [[Projects/Mock/Plugin/SELinux|selinux]] - on SELinux enabled box, this plugin will pretend, that SELinux is disabled in build environment.
| |
| * [[Projects/Mock/Plugin/Tmpfs|tmpfs]] - mount buildroot directory as tmpfs
| |
| * [[Projects/Mock/Plugin/YumCache|yum_cache]] - mount /var/cache/yum of your machine to chroot
| |
| | |
| == Using Mock outside your git sandbox ==
| |
| Create your SRPM using 'rpmbuild -bs'. Then change to the directory where your srpm was created.
| |
| | |
| Now you can start mock with
| |
| | |
| <code>mock -r <configname> rebuild package-1.2-3.src.rpm</code>
| |
| | |
| where <configname> is the name of a configuration from /etc/mock/, without the /etc/mock path prefix and without the .cfg suffix.
| |
| | |
| Note that you can track the progress of mock using the logs stored in <code>/var/lib/mock/<configfile>/result</code>
| |
| | |
| == Problems ==
| |
| If you encounter a bug running mock, please file it in [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora&component=mock Bugzilla], product "Fedora", component mock ([https://bugzilla.redhat.com/buglist.cgi?query_format=advanced&product=Fedora&component=mock&bug_status=NEW&bug_status=ASSIGNED&bug_status=MODIFIED&bug_status=ON_DEV&bug_status=ON_QA&bug_status=VERIFIED&bug_status=FAILS_QA&bug_status=RELEASE_PENDING&bug_status=POST Open Bugs]).
| |
| | |
| If your problem is specific to EPEL, then [https://bugzilla.redhat.com/enter_bug.cgi?product=Fedora%20EPEL&component=mock file it] against the "Fedora EPEL" product instead ([https://bugzilla.redhat.com/buglist.cgi?query_format=advanced&product=Fedora%20EPEL&component=mock&bug_status=NEW&bug_status=ASSIGNED&bug_status=MODIFIED&bug_status=ON_DEV&bug_status=ON_QA&bug_status=VERIFIED&bug_status=FAILS_QA&bug_status=RELEASE_PENDING&bug_status=POST Open Bugs]).
| |
| | |
| == Generate custom config file ==
| |
| Of course you may copy one and edit it manually, however if koji is already using such an config?
| |
| Then you can use '''mock-config --help''' for information how to generate one. E.g.:
| |
| koji mock-config --tag f21-build --arch=aarch64 f21
| |
| | |
| == See Also ==
| |
| | |
| * [[Using_Mock_to_test_package_builds]] has some useful tips for using mock.
| |
| * [[Docs/Drafts/MockSetupUsingLocalMirror]] Setting up a local mirror using Mock.
| |
| * [[Legacy/Mock]] has some useful tips for building packages in mock for older Fedora and Red Hat Linux releases.
| |
