public class JobDefinition extends Object
Definition of a single job that can be added to Treeherder Project is determined by the routing key, so we don’t need to specify it here.
See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#
Modifier and Type | Class and Description |
---|---|
class |
JobDefinition.Display |
class |
JobDefinition.JobInfo |
class |
JobDefinition.Log |
Modifier and Type | Field and Description |
---|---|
Machine |
buildMachine
|
String |
buildSystem
The name of the build system that initiated this content.
|
String[] |
coalesced
The job guids that were coalesced to this job.
|
JobDefinition.Display |
display
|
Object |
extra
Extra information that Treeherder reads on a best-effort basisSee https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/extra
|
boolean |
isRetried
True indicates this job has been retried.
|
JobDefinition.JobInfo |
jobInfo
Definition of the Job Info for a job.
|
String |
jobKind
Possible values: * “build” * “test” * “other” Default: “other”See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/jobKind
|
String[] |
labels
Labels are a dimension of a platform.
|
JobDefinition.Log[] |
logs
|
Object |
origin
|
String |
owner
Description of who submitted the job: gaia | scheduler name | username | emailMin length: 1 Max length: 50See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/owner
|
String |
productName
Examples include: - ‘b2g’ - ‘firefox’ - ‘taskcluster’ - ‘xulrunner’Min length: 1 Max length: 125See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/productName
|
String |
reason
Examples include: - scheduled - scheduler - Self-serve: Rebuilt by foo@example.com - Self-serve: Requested by foo@example.com - The Nightly scheduler named ‘b2g_mozilla-inbound periodic’ triggered this build - unknownMin length: 1 Max length: 125See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/reason
|
String |
result
fail: A failure exception: An infrastructure error/exception success: Build/Test executed without error or failure canceled: The job was cancelled by a user unknown: When the job is not yet completed superseded: When a job has been superseded by another jobPossible values: * “success” * “fail” * “exception” * “canceled” * “superseded” * “unknown”See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/result
|
int |
retryId
The infrastructure retry iteration on this job.
|
Machine |
runMachine
|
String |
state
unscheduled: not yet scheduled pending: not yet started running: currently in progress completed: Job ran through to completionPossible values: * “unscheduled” * “pending” * “running” * “completed”See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/state
|
String |
taskId
This could just be what was formerly submitted as a job_guid in the REST API.
|
int |
tier
Mininum: 1 Maximum: 3See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/tier
|
Date |
timeCompleted
|
Date |
timeScheduled
|
Date |
timeStarted
|
int |
version
Message versionPossible values: * 1See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/version
|
Constructor and Description |
---|
JobDefinition() |
public Machine buildMachine
public String buildSystem
The name of the build system that initiated this content. Some examples are “buildbot” and “taskcluster”. But this could be any name. This value will be used in the routing key for retriggering jobs in the publish-job-action task.
Syntax: ^[\w-]+$ Min length: 1 Max length: 25
See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/buildSystem
public String[] coalesced
The job guids that were coalesced to this job.
See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/coalesced
public JobDefinition.Display display
public Object extra
Extra information that Treeherder reads on a best-effort basis
See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/extra
public boolean isRetried
True indicates this job has been retried.
See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/isRetried
public JobDefinition.JobInfo jobInfo
Definition of the Job Info for a job. These are extra data fields that go along with a job that will be displayed in the details panel within Treeherder.
See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/jobInfo
public String jobKind
Possible values: * “build” * “test” * “other” Default: “other”
See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/jobKind
public String[] labels
Labels are a dimension of a platform. The values here can vary wildly, so most strings are valid for this. The list of labels that are used is maleable going forward.
These were formerly known as “Options” within “Option Collections” but calling labels now so they can be understood to be just strings that denotes a characteristic of the job.
Some examples of labels that have been used: opt Optimize Compiler GCC optimize flags debug Debug flags passed in pgo Profile Guided Optimization - Like opt, but runs with profiling, then builds again using that profiling asan Address Sanitizer tsan Thread Sanitizer Build
See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/labels
public JobDefinition.Log[] logs
public Object origin
public String owner
Description of who submitted the job: gaia | scheduler name | username | email
Min length: 1 Max length: 50
See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/owner
public String productName
Examples include: - ‘b2g’ - ‘firefox’ - ‘taskcluster’ - ‘xulrunner’
Min length: 1 Max length: 125
See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/productName
public String reason
Examples include: - scheduled - scheduler - Self-serve: Rebuilt by foo@example.com - Self-serve: Requested by foo@example.com - The Nightly scheduler named ‘b2g_mozilla-inbound periodic’ triggered this build - unknown
Min length: 1 Max length: 125
See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/reason
public String result
fail: A failure exception: An infrastructure error/exception success: Build/Test executed without error or failure canceled: The job was cancelled by a user unknown: When the job is not yet completed superseded: When a job has been superseded by another job
Possible values: * “success” * “fail” * “exception” * “canceled” * “superseded” * “unknown”
See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/result
public int retryId
The infrastructure retry iteration on this job. The number of times this job has been retried by the infrastructure. If it’s the 1st time running, then it should be 0. If this is the first retry, it will be 1, etc.
Default: 0 Mininum: 0
See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/retryId
public Machine runMachine
public String state
unscheduled: not yet scheduled pending: not yet started running: currently in progress completed: Job ran through to completion
Possible values: * “unscheduled” * “pending” * “running” * “completed”
See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/state
public String taskId
This could just be what was formerly submitted as a job_guid in the REST API.
Syntax: ^[A-Za-z0-9/+-]+$ Min length: 1 Max length: 50
See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/taskId
public int tier
Mininum: 1 Maximum: 3
See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/tier
public Date timeCompleted
public Date timeScheduled
public Date timeStarted
public int version
Message version
Possible values: * 1
See https://schemas.taskcluster.net/treeherder/v1/pulse-job.json#/properties/version
Copyright © 2014–2018 Mozilla. All rights reserved.