LinuxCommandLibrary

koji-resubmit

Resubmit Koji builds

TLDR

Resubmit a task

$ koji resubmit [task_id]
copy

Resubmit a task without waiting for it to finish
$ koji resubmit [task_id] --nowait
copy

Resubmit a task without printing task information
$ koji resubmit [task_id] --quiet
copy

Display help
$ koji resubmit [[-h|--help]]
copy

SYNOPSIS

koji resubmit TASK_ID [HOST] [options…]

PARAMETERS

TASK_ID
    Required ID of the task to resubmit (from koji taskinfo)

[HOST]
    Optional target builder host

--arch ARCHS
    Restrict to specific architectures

--background
    Run the resubmitted task in background

--force
    Allow resubmitting successful or active tasks

--priority PRIO
    PRIO as low/normal/high to set task priority

--quiet
    Suppress non-essential output

--scratch
    Resubmit as non-permanent scratch build

--help
    Display usage help

DESCRIPTION

The koji resubmit command is part of the Koji CLI tools, used in distributed build systems like Fedora's for RPM package building, testing, and management. It resubmits a previously failed, canceled, or aborted task back into the queue for re-execution, helping developers retry builds after fixing source issues, dependency problems, or transient host failures.

Specify the unique task ID (from koji taskinfo or logs) as the primary argument. Optionally target a specific builder host, adjust priority, or mark as a scratch build (ephemeral, not saved to repo). By default, it only resubmits non-successful tasks; use --force for others.

Requires Koji client setup with hub/server URLs in ~/.koji/client.cfg and authentication (e.g., Kerberos). Output includes the new task ID. Ideal for CI/CD pipelines or manual intervention in large-scale builds.

Limits automation errors without re-uploading sources, leveraging Koji's tag/host scheduling.

CAVEATS

Requires Koji client authentication and hub permissions; defaults to failed/canceled tasks only; scratch builds don't update package repos; use cautiously to avoid queue spam.

EXAMPLES

koji resubmit 12345
koji resubmit 12345 builder.example.com --priority high --scratch
koji resubmit 12345 --force

CONFIGURATION

Edit ~/.koji/client.cfg for server, weburl, topurl. Authenticate via kinit or koji call session.

HISTORY

Koji project started in 2007 by Fedora Infrastructure for mock-based RPM builds. The resubmit subcommand added early (~2008) in koji-cli evolution, with options like --scratch and --priority refined in 2010s updates for better scalability in EPEL/RHEL/CentOS ecosystems.

SEE ALSO

koji(1), koji-taskinfo(1), koji-build(1), koji-wait-repo(1)

Copied to clipboard