Clobberer

Types

REST type ClobberRequest

Represents a clobber request for a branch and build directory.

Keys:
  • branch (unicode) -- The branch for this clobber request (defaults to all branches).

  • builddir (unicode) -- The clobbered directory.

  • slave (unicode) -- A particular slave (null means all slaves).

REST type ClobberRequestByBuilder

Represents a clobber request for a branch and buildername.

Keys:
  • branch (unicode) -- The branch for this clobber request (defaults to all branches).

  • buildername (unicode) -- A buildername whose associated builddirs will be clobbered.

  • slave (unicode) -- A particular slave (null means all slaves).

REST type ClobberTime

Represents the most recent data pertaining to a particular clobber.

Keys:
  • branch (unicode) -- The branch for this clobber request (defaults to all branches).

  • builddir (unicode) -- The clobbered directory.

  • slave (unicode) -- A particular slave (null means all slaves).

  • lastclobber (int) -- Timestamp associated with the last clobber request.

  • who (unicode) -- User who initiated the last clobber.

REST type TCWorkerType

Represents worker type of taskcluster

Keys:
  • name (unicode) --

  • caches ([str]) --

REST type TCBranch

Represents branches of taskcluster

Keys:
  • name (unicode) --

  • provisionerId (unicode) --

  • workerTypes ({str: TCWorkerType}) --

REST type TCPurgeCacheRequest

A clobber request for purging cache on taskcluster. http://docs.taskcluster.net/services/purge-cache

Keys:
  • provisionerId (unicode) --

  • workerType (unicode) --

  • cacheName (unicode) --

Endpoints

endpoint GET /clobberer/branches
Response Body:

[unicode]

Return a list of all the branches clobberer knows about.

endpoint POST /clobberer/clobber
Request Body:

[ClobberRequest]

Request clobbers for particular branches and builddirs.

endpoint POST /clobberer/clobber/by-builder
Request Body:

[ClobberRequestByBuilder]

Request clobbers for app builddirs associated with a particular buildername.

endpoint GET /clobberer/lastclobber/all
Response Body:

[ClobberTime]

Return a sorted list of all clobbers

endpoint GET /clobberer/lastclobber/branch/by-builder/<string:branch>
Parameters:
  • branch -- unicode

Response Body:

{"...": [ClobberTime]}

Return a dictionary of most recent ClobberTimes grouped by buildername.

endpoint GET /clobberer/tc/branches
Response Body:

[TCBranch]

List of all the gecko branches with their worker types

endpoint POST /clobberer/tc/purgecache
Request Body:

[TCPurgeCacheRequest]

Purge cache on taskcluster