Working With Tasks

Tasks are generated by the system whenever a build is submitted for a package. A task is created for each build target associated with a package’s releases. Tasks are created by the system, and can not be created, updated, or deleted by users.

Note: The below examples assume that you have set your ‘current-project’ to ‘my-project’, so as to not have to pass the ‘–project’ option with every command. This can be done as:

$ mf workon my-project

Listing Tasks

# list all open tasks for a project
$ mf task listall

# but filter results
$ mf task listall -f php

# including closed tasks
$ mf task listall --all

Note: it is more common to list builds via the quickview, which shows the associated tasks under each build.

Showing Data For a Task

$ mf task show php-5.2.14-1

          Label | php-5.2.14-1.el5.i386
          Owner | john.doe
          Build | php-5.2.14-1
        Package | php
         Target | el5.i386
        Project | my-project
     Created On | 2010-12-01 09:57:55
    Last Update | 2010-12-01 10:17:03
     Start Time | 2010-12-01 10:13:57
       End Time | 2010-12-01 10:17:03
         Status | BuildSuccess
       Data Dir | projects/rpmdev/builds/php-5.2.14-1/php-5.2.14-1.el5.i386
    Building On | None
    End of Life | True

        configs | mf-target.cfg
                  site-defaults.cfg
                  logging.ini

           Logs | stdout
                  build.log
                  state.log
                  stderr
                  root.log

        Sources | php-5.2.14-1.src.rpm


          Files | php-5.2.14-1.el5.i386.rpm
                  php-common-5.2.14-1.el5
                  php-devel-5.2.14-1.el5
                  php-mysql-5.2.14-1.el5
                  ...

Viewing Task Logs and Config Files

$ mf task taillogs php-5.2.14-1.el5.i386 build.log

$ mf task showlog php-5.2.14-1.el5.i386 build.log

$ mf task showconfig php-5.2.14-1.el5.i386 mf-target.cfg

Note: The log and config file names are based on the build_handler for the build and will differ with every project. The ‘taillogs’ option tails the last 25 lines of every log file by default. This can be altered with the ‘–num-lines=XX’ option where XX is an integer. The ‘showlog’ option outputs the entire contents of a single log. Finally, ‘showconfig’ is similar in that it outputs the entire contents of a single config file.

Downloading Files From a Task

$ mf task getfiles php-5.2.14-1.el5.i386

$ mf task getsource php-5.2.14-1.el5.i386

Resetting a Task

It is possible to reset a task, which essentially halts and deletes any progress and sets the task to ‘New’. This is useful in situations where the task failed as a flook and not because the build is bad.

$ mf task reset php-5.2.14-1.el5.i386