~ubuntu-branches/ubuntu/trusty/buildbot/trusty-proposed

    behavior with non-integer revisions (e.g., Git), or with integer

``pauseSlave``

    temporarily stop running new builds on a slave

 

GitHub hook

    The incoming HTTP requests for this hook are not authenticated by default.

    Anyone who can access the web status can "fake" a request from

    GitHub, potentially causing the buildmaster to run arbitrary code.

 

To protect URL against unauthorized access you should use ``change_hook_auth`` option ::

 

    c['status'].append(html.WebStatus(..

                                      change_hook_auth=["file:changehook.passwd"]))

 

And create a file ``changehook.passwd`` ::

 

    user:password

 

Then, create a GitHub service hook (see https://help.github.com/articles/post-receive-hooks) with a WebHook URL like ``http://user:password@builds.mycompany.com/bbot/change_hook/github``.

 

See the `documentation <https://twistedmatrix.com/documents/current/core/howto/cred.html>`_ for twisted cred for more option to pass to ``change_hook_auth``.

 

Note that not using ``change_hook_auth`` can expose you to security risks.

``previousBuildGetter``

    An optional function to calculate the previous build to the one at hand. A

    :func:`previousBuildGetter` takes a :class:`BuildStatus` and returns a

    :class:`BuildStatus`. This function is useful when builders don't process

    their requests in order of arrival (chronologically) and therefore the order

    of completion of builds does not reflect the order in which changes (and

    their respective requests) arrived into the system. In such scenarios,

    status transitions in the chronological sequence of builds within a builder

    might not reflect the actual status transition in the topological sequence

    of changes in the tree. What's more, the latest build (the build at hand)

    might not always be for the most recent request so it might not make sense

    to send a "change" or "problem" email about it. Returning None from this

    function will prevent such emails from going out.

 

Title of the buildmaster

    :meth:`master_status.getTitle()`

 

:samp:`shutdown {ARG}`

    Control the shutdown process of the buildbot master.

    Available arguments are:

 

    ``check``

        Check if the buildbot master is running or shutting down

 

    ``start``

        Start clean shutdown

 

    ``stop``

        Stop clean shutdown

 

    ``now``

        Shutdown immediately without waiting for the builders to finish

    def gerritStartCB(builderName, build, arg):

        message = "Buildbot started compiling your patchset\n"

        message += "on configuration: %s\n" % builderName

 

        if arg:

            message += "\nFor more details visit:\n"

            message += status.getURLForThing(build) + "\n"

 

        return message

 

                                        reviewArg=c['buildbotURL'],

                                        startCB=gerritStartCB,

                                        startArg=c['buildbotURL']))

GerritStatusPush sends review of the :class:`Change` back to the Gerrit server,

optionally also sending a message when a build is started.

``startCB`` should return a message.