particle-os/debian-koji
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

runroot: basic docs

Browse source 
Fixes: https://pagure.io/koji/issue/2111
This commit is contained in:
Tomas Kopecek 2020-06-26 14:57:14 +02:00
parent cfe70c21bd
commit ae7f686e05
2 changed files with 33 additions and 1 deletions
Download patch file Download diff file Expand all files Collapse all files

8
builder/kojid.conf
View file

@ -126,3 +126,11 @@ from_addr=Koji Build System <buildsys@example.com>
;to hub. It could be useful for debugging purposes, but creates twice as many
;log files
;log_timestamps = False
;enabled plugins, base koji installation has access to runroot and save_failed_tree
;none of these is enabled by default
;plugin =
;path where builder plugins are located, there could be multiple paths delimited
by :
;pluginpath = /usr/lib/koji-builder-plugins

26
docs/source/plugins.rst
View file

@ -7,7 +7,31 @@ Following plugins are available in default koji installation.
Runroot
=======
Plugin for running any command in buildroot.
Plugin for running any command in buildroot. It has three parts as most of the
others (hub, builder and CLI).
Builder
-------
You enable plugin by editing ``/etc/kojid.conf`` by adding ``plugin = runroot``
there. Plugin itself has separate configuration file on each builder located at
``/etc/kojid/plugins/runroot.conf`` There is a sample configuration file
with option descriptions installed.
Hub
---
On the hub side ``Plugins = runroot_hub`` needs to be added to
``/etc/koji-hub/hub.conf``. Note, that by default policy runroot tasks are
assigned to ``runroot`` channel. As this is a plugin, we don't create it
automatically. There are three options - create channel when adding first builder
there via ``koji add-host-to-channel --new hostname runroot`` or by changing the
default channel policy according to :doc:`defining_hub_policies`. Last option is
to use ``--channel-override`` option in CLI to drive task to channel of choice.
CLI
---
CLI is looking for available plugins every run, so it if it is installed, you'll
see new command ``runroot`` with options described in its help. No config
options are needed to enable it.
Save Failed Tree
================