buildbucketpb

package
v0.0.0-...-4a11b79 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 2, 2020 License: Apache-2.0 Imports: 24 Imported by: 0

Documentation

Overview

Package buildbucketpb is generated from Buildbucket .proto files.

It contains pRPC and mock implementations of Builds RPC service.

See also ../protoutil for utility functions for types in this package.

Index

Constants

This section is empty.

Variables

View Source 
var (
	Status_name = map[int32]string{
		0:  "STATUS_UNSPECIFIED",
		1:  "SCHEDULED",
		2:  "STARTED",
		4:  "ENDED_MASK",
		12: "SUCCESS",
		20: "FAILURE",
		36: "INFRA_FAILURE",
		68: "CANCELED",
	}
	Status_value = map[string]int32{
		"STATUS_UNSPECIFIED": 0,
		"SCHEDULED":          1,
		"STARTED":            2,
		"ENDED_MASK":         4,
		"SUCCESS":            12,
		"FAILURE":            20,
		"INFRA_FAILURE":      36,
		"CANCELED":           68,
	}
)

Enum value maps for Status.

View Source 
var (
	Trinary_name = map[int32]string{
		0: "UNSET",
		1: "YES",
		2: "NO",
	}
	Trinary_value = map[string]int32{
		"UNSET": 0,
		"YES":   1,
		"NO":    2,
	}
)

Enum value maps for Trinary.

View Source 
var (
	Toggle_name = map[int32]string{
		0: "UNSET",
		1: "YES",
		2: "NO",
	}
	Toggle_value = map[string]int32{
		"UNSET": 0,
		"YES":   1,
		"NO":    2,
	}
)

Enum value maps for Toggle.

View Source 
var (
	Acl_Role_name = map[int32]string{
		0: "READER",
		1: "SCHEDULER",
		2: "WRITER",
	}
	Acl_Role_value = map[string]int32{
		"READER":    0,
		"SCHEDULER": 1,
		"WRITER":    2,
	}
)

Enum value maps for Acl_Role.

View Source 
var File_go_chromium_org_luci_buildbucket_proto_build_proto protoreflect.FileDescriptor
View Source 
var File_go_chromium_org_luci_buildbucket_proto_builder_proto protoreflect.FileDescriptor
View Source 
var File_go_chromium_org_luci_buildbucket_proto_builder_service_proto protoreflect.FileDescriptor
View Source 
var File_go_chromium_org_luci_buildbucket_proto_builds_service_proto protoreflect.FileDescriptor
View Source 
var File_go_chromium_org_luci_buildbucket_proto_common_proto protoreflect.FileDescriptor
View Source 
var File_go_chromium_org_luci_buildbucket_proto_launcher_proto protoreflect.FileDescriptor
View Source 
var File_go_chromium_org_luci_buildbucket_proto_notification_proto protoreflect.FileDescriptor
View Source 
var File_go_chromium_org_luci_buildbucket_proto_project_config_proto protoreflect.FileDescriptor
View Source 
var File_go_chromium_org_luci_buildbucket_proto_service_config_proto protoreflect.FileDescriptor
View Source 
var File_go_chromium_org_luci_buildbucket_proto_step_proto protoreflect.FileDescriptor

Functions

func FileDescriptorSet 

func FileDescriptorSet() *descriptor.FileDescriptorSet

FileDescriptorSet returns a descriptor set for this proto package, which includes all defined services, and all transitive dependencies.

Will not return nil.

Do NOT modify the returned descriptor.

func RegisterBuildersServer 

func RegisterBuildersServer(s prpc.Registrar, srv BuildersServer)

func RegisterBuildsServer 

func RegisterBuildsServer(s prpc.Registrar, srv BuildsServer)

Types

type Acl 

type Acl struct {

	// Role denotes a list of actions that an identity can perform.
	Role Acl_Role `protobuf:"varint,1,opt,name=role,proto3,enum=buildbucket.Acl_Role" json:"role,omitempty"`
	// Name of the group defined in the auth service.
	Group string `protobuf:"bytes,2,opt,name=group,proto3" json:"group,omitempty"`
	// An email address or a full identity string "kind:name". See auth service
	// on kinds of identities. Anonymous users are "anonymous:anonymous".
	// Either identity or group must be present, not both.
	Identity string `protobuf:"bytes,3,opt,name=identity,proto3" json:"identity,omitempty"`
	// contains filtered or unexported fields
}

A single access control rule.

func (*Acl) Descriptor deprecated 

func (*Acl) Descriptor() ([]byte, []int)

Deprecated: Use Acl.ProtoReflect.Descriptor instead.

func (*Acl) GetGroup 

func (x *Acl) GetGroup() string

func (*Acl) GetIdentity 

func (x *Acl) GetIdentity() string

func (*Acl) GetRole 

func (x *Acl) GetRole() Acl_Role

func (*Acl) ProtoMessage 

func (*Acl) ProtoMessage()

func (*Acl) ProtoReflect 

func (x *Acl) ProtoReflect() protoreflect.Message

func (*Acl) Reset 

func (x *Acl) Reset()

func (*Acl) String 

func (x *Acl) String() string

type AclSet 

type AclSet struct {

	// A name of the ACL set. Required. Must match regex '^[a-z0-9_]+$'.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// List of access control rules.
	// The order does not matter.
	Acls []*Acl `protobuf:"bytes,2,rep,name=acls,proto3" json:"acls,omitempty"`
	// contains filtered or unexported fields
}

A set of Acl messages. Can be referenced in a bucket by name.

func (*AclSet) Descriptor deprecated 

func (*AclSet) Descriptor() ([]byte, []int)

Deprecated: Use AclSet.ProtoReflect.Descriptor instead.

func (*AclSet) GetAcls 

func (x *AclSet) GetAcls() []*Acl

func (*AclSet) GetName 

func (x *AclSet) GetName() string

func (*AclSet) ProtoMessage 

func (*AclSet) ProtoMessage()

func (*AclSet) ProtoReflect 

func (x *AclSet) ProtoReflect() protoreflect.Message

func (*AclSet) Reset 

func (x *AclSet) Reset()

func (*AclSet) String 

func (x *AclSet) String() string

type Acl_Role 

type Acl_Role int32

A buiildbucket user role. Defines what a user can do.

The order of enum member tags is important. A role with a higher tag number can perform any action that a role with a lower tag number can perform. 

const (
	// Can do read-only operations, such as search for builds.
	Acl_READER Acl_Role = 0
	// Same as READER + can schedule and cancel builds.
	Acl_SCHEDULER Acl_Role = 1
	// Can do all write operations.
	Acl_WRITER Acl_Role = 2
)

func (Acl_Role) Descriptor 

func (Acl_Role) Descriptor() protoreflect.EnumDescriptor

func (Acl_Role) Enum 

func (x Acl_Role) Enum() *Acl_Role

func (Acl_Role) EnumDescriptor deprecated 

func (Acl_Role) EnumDescriptor() ([]byte, []int)

Deprecated: Use Acl_Role.Descriptor instead.

func (Acl_Role) Number 

func (x Acl_Role) Number() protoreflect.EnumNumber

func (Acl_Role) String 

func (x Acl_Role) String() string

func (Acl_Role) Type 

func (Acl_Role) Type() protoreflect.EnumType

type BBAgentArgs 

type BBAgentArgs struct {

	// Path to the user executable.
	//
	// Deprecated. Superceded by payload_path and `build.exe.cmd`.
	ExecutablePath string `protobuf:"bytes,1,opt,name=executable_path,json=executablePath,proto3" json:"executable_path,omitempty"`
	// Path to the base of the user executable package.
	//
	// Required.
	PayloadPath string `protobuf:"bytes,5,opt,name=payload_path,json=payloadPath,proto3" json:"payload_path,omitempty"`
	// Path to a directory where each subdirectory is a cache dir.
	//
	// Required.
	CacheDir string `protobuf:"bytes,2,opt,name=cache_dir,json=cacheDir,proto3" json:"cache_dir,omitempty"`
	// List of Gerrit hosts to force git authentication for.
	//
	// By default public hosts are accessed anonymously, and the anonymous access
	// has very low quota. Context needs to know all such hostnames in advance to
	// be able to force authenticated access to them.
	KnownPublicGerritHosts []string `` /* 131-byte string literal not displayed */
	// Initial state of the build, including immutable state such as id and input
	// properties.
	Build *Build `protobuf:"bytes,4,opt,name=build,proto3" json:"build,omitempty"`
	// contains filtered or unexported fields
}

Arguments for bbagent command.

All paths are relateive to bbagent's working directory, and must be delimited with slashes ("/"), regardless of the host OS.

func (*BBAgentArgs) Descriptor deprecated 

func (*BBAgentArgs) Descriptor() ([]byte, []int)

Deprecated: Use BBAgentArgs.ProtoReflect.Descriptor instead.

func (*BBAgentArgs) GetBuild 

func (x *BBAgentArgs) GetBuild() *Build

func (*BBAgentArgs) GetCacheDir 

func (x *BBAgentArgs) GetCacheDir() string

func (*BBAgentArgs) GetExecutablePath 

func (x *BBAgentArgs) GetExecutablePath() string

func (*BBAgentArgs) GetKnownPublicGerritHosts 

func (x *BBAgentArgs) GetKnownPublicGerritHosts() []string

func (*BBAgentArgs) GetPayloadPath 

func (x *BBAgentArgs) GetPayloadPath() string

func (*BBAgentArgs) ProtoMessage 

func (*BBAgentArgs) ProtoMessage()

func (*BBAgentArgs) ProtoReflect 

func (x *BBAgentArgs) ProtoReflect() protoreflect.Message

func (*BBAgentArgs) Reset 

func (x *BBAgentArgs) Reset()

func (*BBAgentArgs) String 

func (x *BBAgentArgs) String() string

type BatchRequest 

type BatchRequest struct {

	// Requests to execute in a single batch.
	//
	// All requests are executed in their own individual transactions.
	// BatchRequest as a whole is not transactional.
	// Mutations are executed before read-only requests.
	Requests []*BatchRequest_Request `protobuf:"bytes,1,rep,name=requests,proto3" json:"requests,omitempty"`
	// contains filtered or unexported fields
}

A request message for Batch rpc.

func (*BatchRequest) Descriptor deprecated 

func (*BatchRequest) Descriptor() ([]byte, []int)

Deprecated: Use BatchRequest.ProtoReflect.Descriptor instead.

func (*BatchRequest) GetRequests 

func (x *BatchRequest) GetRequests() []*BatchRequest_Request

func (*BatchRequest) ProtoMessage 

func (*BatchRequest) ProtoMessage()

func (*BatchRequest) ProtoReflect 

func (x *BatchRequest) ProtoReflect() protoreflect.Message

func (*BatchRequest) Reset 

func (x *BatchRequest) Reset()

func (*BatchRequest) String 

func (x *BatchRequest) String() string

type BatchRequest_Request 

type BatchRequest_Request struct {

	// Types that are assignable to Request:
	//	*BatchRequest_Request_GetBuild
	//	*BatchRequest_Request_SearchBuilds
	//	*BatchRequest_Request_ScheduleBuild
	//	*BatchRequest_Request_CancelBuild
	Request isBatchRequest_Request_Request `protobuf_oneof:"request"`
	// contains filtered or unexported fields
}

One request in a batch.

func (*BatchRequest_Request) Descriptor deprecated 

func (*BatchRequest_Request) Descriptor() ([]byte, []int)

Deprecated: Use BatchRequest_Request.ProtoReflect.Descriptor instead.

func (*BatchRequest_Request) GetCancelBuild 

func (x *BatchRequest_Request) GetCancelBuild() *CancelBuildRequest

func (*BatchRequest_Request) GetGetBuild 

func (x *BatchRequest_Request) GetGetBuild() *GetBuildRequest

func (*BatchRequest_Request) GetRequest 

func (m *BatchRequest_Request) GetRequest() isBatchRequest_Request_Request

func (*BatchRequest_Request) GetScheduleBuild 

func (x *BatchRequest_Request) GetScheduleBuild() *ScheduleBuildRequest

func (*BatchRequest_Request) GetSearchBuilds 

func (x *BatchRequest_Request) GetSearchBuilds() *SearchBuildsRequest

func (*BatchRequest_Request) ProtoMessage 

func (*BatchRequest_Request) ProtoMessage()

func (*BatchRequest_Request) ProtoReflect 

func (x *BatchRequest_Request) ProtoReflect() protoreflect.Message

func (*BatchRequest_Request) Reset 

func (x *BatchRequest_Request) Reset()

func (*BatchRequest_Request) String 

func (x *BatchRequest_Request) String() string

type BatchRequest_Request_CancelBuild 

type BatchRequest_Request_CancelBuild struct {
	CancelBuild *CancelBuildRequest `protobuf:"bytes,4,opt,name=cancel_build,json=cancelBuild,proto3,oneof"`
}

type BatchRequest_Request_GetBuild 

type BatchRequest_Request_GetBuild struct {
	GetBuild *GetBuildRequest `protobuf:"bytes,1,opt,name=get_build,json=getBuild,proto3,oneof"`
}

type BatchRequest_Request_ScheduleBuild 

type BatchRequest_Request_ScheduleBuild struct {
	// All ScheduleBuild requests in the batch are executed before other
	// requests.
	ScheduleBuild *ScheduleBuildRequest `protobuf:"bytes,3,opt,name=schedule_build,json=scheduleBuild,proto3,oneof"`
}

type BatchRequest_Request_SearchBuilds 

type BatchRequest_Request_SearchBuilds struct {
	SearchBuilds *SearchBuildsRequest `protobuf:"bytes,2,opt,name=search_builds,json=searchBuilds,proto3,oneof"`
}

type BatchResponse 

type BatchResponse struct {

	// Responses in the same order as BatchRequest.requests.
	Responses []*BatchResponse_Response `protobuf:"bytes,1,rep,name=responses,proto3" json:"responses,omitempty"`
	// contains filtered or unexported fields
}

A response message for Batch rpc.

func (*BatchResponse) Descriptor deprecated 

func (*BatchResponse) Descriptor() ([]byte, []int)

Deprecated: Use BatchResponse.ProtoReflect.Descriptor instead.

func (*BatchResponse) GetResponses 

func (x *BatchResponse) GetResponses() []*BatchResponse_Response

func (*BatchResponse) ProtoMessage 

func (*BatchResponse) ProtoMessage()

func (*BatchResponse) ProtoReflect 

func (x *BatchResponse) ProtoReflect() protoreflect.Message

func (*BatchResponse) Reset 

func (x *BatchResponse) Reset()

func (*BatchResponse) String 

func (x *BatchResponse) String() string

type BatchResponse_Response 

type BatchResponse_Response struct {

	// Types that are assignable to Response:
	//	*BatchResponse_Response_GetBuild
	//	*BatchResponse_Response_SearchBuilds
	//	*BatchResponse_Response_ScheduleBuild
	//	*BatchResponse_Response_CancelBuild
	//	*BatchResponse_Response_Error
	Response isBatchResponse_Response_Response `protobuf_oneof:"response"`
	// contains filtered or unexported fields
}

Response a BatchRequest.Response.

func (*BatchResponse_Response) Descriptor deprecated 

func (*BatchResponse_Response) Descriptor() ([]byte, []int)

Deprecated: Use BatchResponse_Response.ProtoReflect.Descriptor instead.

func (*BatchResponse_Response) GetCancelBuild 

func (x *BatchResponse_Response) GetCancelBuild() *Build

func (*BatchResponse_Response) GetError 

func (x *BatchResponse_Response) GetError() *status.Status

func (*BatchResponse_Response) GetGetBuild 

func (x *BatchResponse_Response) GetGetBuild() *Build

func (*BatchResponse_Response) GetResponse 

func (m *BatchResponse_Response) GetResponse() isBatchResponse_Response_Response

func (*BatchResponse_Response) GetScheduleBuild 

func (x *BatchResponse_Response) GetScheduleBuild() *Build

func (*BatchResponse_Response) GetSearchBuilds 

func (x *BatchResponse_Response) GetSearchBuilds() *SearchBuildsResponse

func (*BatchResponse_Response) ProtoMessage 

func (*BatchResponse_Response) ProtoMessage()

func (*BatchResponse_Response) ProtoReflect 

func (x *BatchResponse_Response) ProtoReflect() protoreflect.Message

func (*BatchResponse_Response) Reset 

func (x *BatchResponse_Response) Reset()

func (*BatchResponse_Response) String 

func (x *BatchResponse_Response) String() string

type BatchResponse_Response_CancelBuild 

type BatchResponse_Response_CancelBuild struct {
	CancelBuild *Build `protobuf:"bytes,4,opt,name=cancel_build,json=cancelBuild,proto3,oneof"`
}

type BatchResponse_Response_Error 

type BatchResponse_Response_Error struct {
	// Error code and details of the unsuccessful RPC.
	Error *status.Status `protobuf:"bytes,100,opt,name=error,proto3,oneof"`
}

type BatchResponse_Response_GetBuild 

type BatchResponse_Response_GetBuild struct {
	GetBuild *Build `protobuf:"bytes,1,opt,name=get_build,json=getBuild,proto3,oneof"`
}

type BatchResponse_Response_ScheduleBuild 

type BatchResponse_Response_ScheduleBuild struct {
	ScheduleBuild *Build `protobuf:"bytes,3,opt,name=schedule_build,json=scheduleBuild,proto3,oneof"`
}

type BatchResponse_Response_SearchBuilds 

type BatchResponse_Response_SearchBuilds struct {
	SearchBuilds *SearchBuildsResponse `protobuf:"bytes,2,opt,name=search_builds,json=searchBuilds,proto3,oneof"`
}

type Bucket 

type Bucket struct {

	// Name of the bucket. Names are unique within one instance of buildbucket.
	// If another project already uses this name, a config will be rejected.
	// Name reservation is first-come first-serve.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// List of access control rules for the bucket.
	// The order does not matter.
	Acls []*Acl `protobuf:"bytes,2,rep,name=acls,proto3" json:"acls,omitempty"`
	// A list of ACL set names. Each ACL in each referenced ACL set will be
	// included in this bucket.
	// The order does not matter.
	AclSets []string `protobuf:"bytes,4,rep,name=acl_sets,json=aclSets,proto3" json:"acl_sets,omitempty"`
	// Buildbucket-swarming integration.
	Swarming *Swarming `protobuf:"bytes,3,opt,name=swarming,proto3" json:"swarming,omitempty"`
	// contains filtered or unexported fields
}

Defines one bucket in buildbucket.cfg

func (*Bucket) Descriptor deprecated 

func (*Bucket) Descriptor() ([]byte, []int)

Deprecated: Use Bucket.ProtoReflect.Descriptor instead.

func (*Bucket) FromProperty 

func (p *Bucket) FromProperty(prop datastore.Property) error

FromProperty implements datastore.PropertyConverter. It parses a '[]byte' into an embedded 'Bucket' when used with the "go.chromium.org/luci/gae" library.

func (*Bucket) GetAclSets 

func (x *Bucket) GetAclSets() []string

func (*Bucket) GetAcls 

func (x *Bucket) GetAcls() []*Acl

func (*Bucket) GetName 

func (x *Bucket) GetName() string

func (*Bucket) GetSwarming 

func (x *Bucket) GetSwarming() *Swarming

func (*Bucket) ProtoMessage 

func (*Bucket) ProtoMessage()

func (*Bucket) ProtoReflect 

func (x *Bucket) ProtoReflect() protoreflect.Message

func (*Bucket) Reset 

func (x *Bucket) Reset()

func (*Bucket) String 

func (x *Bucket) String() string

func (*Bucket) ToProperty 

func (p *Bucket) ToProperty() (prop datastore.Property, err error)

ToProperty implements datastore.PropertyConverter. It causes an embedded 'Bucket' to serialize to an unindexed '[]byte' when used with the "go.chromium.org/luci/gae" library.

type Build 

type Build struct {

	// Identifier of the build, unique per LUCI deployment.
	// IDs are monotonically decreasing.
	Id int64 `protobuf:"varint,1,opt,name=id,proto3" json:"id,omitempty"`
	// Required. The builder this build belongs to.
	//
	// Tuple (builder.project, builder.bucket) defines build ACL
	// which may change after build has ended.
	Builder *BuilderID `protobuf:"bytes,2,opt,name=builder,proto3" json:"builder,omitempty"`
	// Human-readable identifier of the build with the following properties:
	// - unique within the builder
	// - a monotonically increasing number
	// - mostly contiguous
	// - much shorter than id
	//
	// Caution: populated (positive number) iff build numbers were enabled
	// in the builder configuration at the time of build creation.
	//
	// Caution: Build numbers are not guaranteed to be contiguous.
	// There may be gaps during outages.
	//
	// Caution: Build numbers, while monotonically increasing, do not
	// necessarily reflect source-code order. For example, force builds
	// or rebuilds can allocate new, higher, numbers, but build an older-
	// than-HEAD version of the source.
	Number int32 `protobuf:"varint,3,opt,name=number,proto3" json:"number,omitempty"`
	// Verified LUCI identity that created this build.
	CreatedBy string `protobuf:"bytes,4,opt,name=created_by,json=createdBy,proto3" json:"created_by,omitempty"`
	// Verified LUCI identity that canceled this build.
	CanceledBy string `protobuf:"bytes,23,opt,name=canceled_by,json=canceledBy,proto3" json:"canceled_by,omitempty"`
	// When the build was created.
	CreateTime *timestamp.Timestamp `protobuf:"bytes,6,opt,name=create_time,json=createTime,proto3" json:"create_time,omitempty"`
	// When the build started.
	// Required iff status is STARTED, SUCCESS or FAILURE.
	StartTime *timestamp.Timestamp `protobuf:"bytes,7,opt,name=start_time,json=startTime,proto3" json:"start_time,omitempty"`
	// When the build ended.
	// Present iff status is terminal.
	// MUST NOT be before start_time.
	EndTime *timestamp.Timestamp `protobuf:"bytes,8,opt,name=end_time,json=endTime,proto3" json:"end_time,omitempty"`
	// When the build was most recently updated.
	//
	// RPC: can be > end_time if, e.g. new tags were attached to a completed
	// build.
	UpdateTime *timestamp.Timestamp `protobuf:"bytes,9,opt,name=update_time,json=updateTime,proto3" json:"update_time,omitempty"`
	// Status of the build.
	// Must be specified, i.e. not STATUS_UNSPECIFIED.
	//
	// RPC: Responses have most current status.
	//
	// BigQuery: Final status of the build. Cannot be SCHEDULED or STARTED.
	Status Status `protobuf:"varint,12,opt,name=status,proto3,enum=buildbucket.v2.Status" json:"status,omitempty"`
	// Human-readable summary of the build in Markdown format
	// (https://spec.commonmark.org/0.28/).
	// Explains status.
	// Up to 4 KB.
	//
	// BigQuery: excluded from rows.
	SummaryMarkdown string `protobuf:"bytes,20,opt,name=summary_markdown,json=summaryMarkdown,proto3" json:"summary_markdown,omitempty"`
	// If NO, then the build status SHOULD NOT be used to assess correctness of
	// the input gitiles_commit or gerrit_changes.
	// For example, if a pre-submit build has failed, CQ MAY still land the CL.
	// For example, if a post-submit build has failed, CLs MAY continue landing.
	Critical Trinary `protobuf:"varint,21,opt,name=critical,proto3,enum=buildbucket.v2.Trinary" json:"critical,omitempty"`
	// Machine-readable details of the current status.
	// Human-readable status reason is available in summary_markdown.
	StatusDetails *StatusDetails `protobuf:"bytes,22,opt,name=status_details,json=statusDetails,proto3" json:"status_details,omitempty"`
	// Input to the build executable.
	Input *Build_Input `protobuf:"bytes,15,opt,name=input,proto3" json:"input,omitempty"`
	// Output of the build executable.
	// SHOULD depend only on input field and NOT other fields.
	// MUST be unset if build status is SCHEDULED.
	//
	// RPC: By default, this field is excluded from responses.
	// Updated while the build is running and finalized when the build ends.
	Output *Build_Output `protobuf:"bytes,16,opt,name=output,proto3" json:"output,omitempty"`
	// Current list of build steps.
	// Updated as build runs.
	//
	// May take up to 1MB after zlib compression.
	// MUST be unset if build status is SCHEDULED.
	//
	// RPC: By default, this field is excluded from responses.
	Steps []*Step `protobuf:"bytes,17,rep,name=steps,proto3" json:"steps,omitempty"`
	// Build infrastructure used by the build.
	//
	// RPC: By default, this field is excluded from responses.
	Infra *BuildInfra `protobuf:"bytes,18,opt,name=infra,proto3" json:"infra,omitempty"`
	// Arbitrary annotations for the build.
	// One key may have multiple values, which is why this is not a map<string,string>.
	// Indexed by the server, see also BuildPredicate.tags.
	Tags []*StringPair `protobuf:"bytes,19,rep,name=tags,proto3" json:"tags,omitempty"`
	// What to run when the build is ready to start.
	Exe *Executable `protobuf:"bytes,24,opt,name=exe,proto3" json:"exe,omitempty"`
	// DEPRECATED
	//
	// Equivalent to `"luci.buildbucket.canary_software" in input.experiments`.
	//
	// See `Builder.experiments` for well-known experiments.
	Canary bool `protobuf:"varint,25,opt,name=canary,proto3" json:"canary,omitempty"`
	// Maximum build pending time.
	// If the timeout is reached, the build is marked as INFRA_FAILURE status
	// and both status_details.{timeout, resource_exhaustion} are set.
	SchedulingTimeout *duration.Duration `protobuf:"bytes,26,opt,name=scheduling_timeout,json=schedulingTimeout,proto3" json:"scheduling_timeout,omitempty"`
	// Maximum build execution time.
	// Not to be confused with scheduling_timeout.
	// If the timeout is reached, the build is marked as INFRA_FAILURE status
	// and status_details.timeout is set.
	ExecutionTimeout *duration.Duration `protobuf:"bytes,27,opt,name=execution_timeout,json=executionTimeout,proto3" json:"execution_timeout,omitempty"`
	// If set, swarming was requested to wait until it sees at least one bot
	// report a superset of the build's requested dimensions.
	WaitForCapacity bool `protobuf:"varint,28,opt,name=wait_for_capacity,json=waitForCapacity,proto3" json:"wait_for_capacity,omitempty"`
	// contains filtered or unexported fields
}

A single build, identified by an int64 id. Belongs to a builder.

RPC: see Builds service for build creation and retrieval. Some Build fields are marked as excluded from responses by default. Use build_fields request field to specify that a field must be included.

BigQuery: this message also defines schema of a BigQuery table of completed builds. A BigQuery row is inserted soon after build ends, i.e. a row represents a state of a build at completion time and does not change after that. All fields are included.

Next id: 29.

func (*Build) Descriptor deprecated 

func (*Build) Descriptor() ([]byte, []int)

Deprecated: Use Build.ProtoReflect.Descriptor instead.

func (*Build) FromProperty 

func (p *Build) FromProperty(prop datastore.Property) error

FromProperty implements datastore.PropertyConverter. It parses a '[]byte' into an embedded 'Build' when used with the "go.chromium.org/luci/gae" library.

func (*Build) GetBuilder 

func (x *Build) GetBuilder() *BuilderID

func (*Build) GetCanary 

func (x *Build) GetCanary() bool

func (*Build) GetCanceledBy 

func (x *Build) GetCanceledBy() string

func (*Build) GetCreateTime 

func (x *Build) GetCreateTime() *timestamp.Timestamp

func (*Build) GetCreatedBy 

func (x *Build) GetCreatedBy() string

func (*Build) GetCritical 

func (x *Build) GetCritical() Trinary

func (*Build) GetEndTime 

func (x *Build) GetEndTime() *timestamp.Timestamp

func (*Build) GetExe 

func (x *Build) GetExe() *Executable

func (*Build) GetExecutionTimeout 

func (x *Build) GetExecutionTimeout() *duration.Duration

func (*Build) GetId 

func (x *Build) GetId() int64

func (*Build) GetInfra 

func (x *Build) GetInfra() *BuildInfra

func (*Build) GetInput 

func (x *Build) GetInput() *Build_Input

func (*Build) GetNumber 

func (x *Build) GetNumber() int32

func (*Build) GetOutput 

func (x *Build) GetOutput() *Build_Output

func (*Build) GetSchedulingTimeout 

func (x *Build) GetSchedulingTimeout() *duration.Duration

func (*Build) GetStartTime 

func (x *Build) GetStartTime() *timestamp.Timestamp

func (*Build) GetStatus 

func (x *Build) GetStatus() Status

func (*Build) GetStatusDetails 

func (x *Build) GetStatusDetails() *StatusDetails

func (*Build) GetSteps 

func (x *Build) GetSteps() []*Step

func (*Build) GetSummaryMarkdown 

func (x *Build) GetSummaryMarkdown() string

func (*Build) GetTags 

func (x *Build) GetTags() []*StringPair

func (*Build) GetUpdateTime 

func (x *Build) GetUpdateTime() *timestamp.Timestamp

func (*Build) GetWaitForCapacity 

func (x *Build) GetWaitForCapacity() bool

func (*Build) ProtoMessage 

func (*Build) ProtoMessage()

func (*Build) ProtoReflect 

func (x *Build) ProtoReflect() protoreflect.Message

func (*Build) Reset 

func (x *Build) Reset()

func (*Build) String 

func (x *Build) String() string

func (*Build) ToProperty 

func (p *Build) ToProperty() (prop datastore.Property, err error)

ToProperty implements datastore.PropertyConverter. It causes an embedded 'Build' to serialize to an unindexed '[]byte' when used with the "go.chromium.org/luci/gae" library.

type BuildInfra 

type BuildInfra struct {
	Buildbucket *BuildInfra_Buildbucket `protobuf:"bytes,1,opt,name=buildbucket,proto3" json:"buildbucket,omitempty"`
	Swarming    *BuildInfra_Swarming    `protobuf:"bytes,2,opt,name=swarming,proto3" json:"swarming,omitempty"`
	Logdog      *BuildInfra_LogDog      `protobuf:"bytes,3,opt,name=logdog,proto3" json:"logdog,omitempty"`
	Recipe      *BuildInfra_Recipe      `protobuf:"bytes,4,opt,name=recipe,proto3" json:"recipe,omitempty"`
	Resultdb    *BuildInfra_ResultDB    `protobuf:"bytes,5,opt,name=resultdb,proto3" json:"resultdb,omitempty"`
	// contains filtered or unexported fields
}

Build infrastructure that was used for a particular build.

func (*BuildInfra) Descriptor deprecated 

func (*BuildInfra) Descriptor() ([]byte, []int)

Deprecated: Use BuildInfra.ProtoReflect.Descriptor instead.

func (*BuildInfra) FromProperty 

func (p *BuildInfra) FromProperty(prop datastore.Property) error

FromProperty implements datastore.PropertyConverter. It parses a '[]byte' into an embedded 'BuildInfra' when used with the "go.chromium.org/luci/gae" library.

func (*BuildInfra) GetBuildbucket 

func (x *BuildInfra) GetBuildbucket() *BuildInfra_Buildbucket

func (*BuildInfra) GetLogdog 

func (x *BuildInfra) GetLogdog() *BuildInfra_LogDog

func (*BuildInfra) GetRecipe 

func (x *BuildInfra) GetRecipe() *BuildInfra_Recipe

func (*BuildInfra) GetResultdb 

func (x *BuildInfra) GetResultdb() *BuildInfra_ResultDB

func (*BuildInfra) GetSwarming 

func (x *BuildInfra) GetSwarming() *BuildInfra_Swarming

func (*BuildInfra) ProtoMessage 

func (*BuildInfra) ProtoMessage()

func (*BuildInfra) ProtoReflect 

func (x *BuildInfra) ProtoReflect() protoreflect.Message

func (*BuildInfra) Reset 

func (x *BuildInfra) Reset()

func (*BuildInfra) String 

func (x *BuildInfra) String() string

func (*BuildInfra) ToProperty 

func (p *BuildInfra) ToProperty() (prop datastore.Property, err error)

ToProperty implements datastore.PropertyConverter. It causes an embedded 'BuildInfra' to serialize to an unindexed '[]byte' when used with the "go.chromium.org/luci/gae" library.

type BuildInfra_Buildbucket 

type BuildInfra_Buildbucket struct {

	// Version of swarming task template. Defines
	// versions of kitchen, git, git wrapper, python, vpython, etc.
	ServiceConfigRevision string `` /* 126-byte string literal not displayed */
	// Properties that were specified in ScheduleBuildRequest to create this
	// build.
	//
	// In particular, CQ uses this to decide whether the build created by
	// someone else is appropriate for CQ, e.g. it was created with the same
	// properties that CQ would use.
	RequestedProperties *_struct.Struct `protobuf:"bytes,5,opt,name=requested_properties,json=requestedProperties,proto3" json:"requested_properties,omitempty"`
	// Dimensions that were specified in ScheduleBuildRequest to create this
	// build.
	RequestedDimensions []*RequestedDimension `protobuf:"bytes,6,rep,name=requested_dimensions,json=requestedDimensions,proto3" json:"requested_dimensions,omitempty"`
	// Buildbucket hostname, e.g. "cr-buildbucket.appspot.com".
	Hostname string `protobuf:"bytes,7,opt,name=hostname,proto3" json:"hostname,omitempty"`
	// contains filtered or unexported fields
}

Buildbucket-specific information, captured at the build creation time.

func (*BuildInfra_Buildbucket) Descriptor deprecated 

func (*BuildInfra_Buildbucket) Descriptor() ([]byte, []int)

Deprecated: Use BuildInfra_Buildbucket.ProtoReflect.Descriptor instead.

func (*BuildInfra_Buildbucket) GetHostname 

func (x *BuildInfra_Buildbucket) GetHostname() string

func (*BuildInfra_Buildbucket) GetRequestedDimensions 

func (x *BuildInfra_Buildbucket) GetRequestedDimensions() []*RequestedDimension

func (*BuildInfra_Buildbucket) GetRequestedProperties 

func (x *BuildInfra_Buildbucket) GetRequestedProperties() *_struct.Struct

func (*BuildInfra_Buildbucket) GetServiceConfigRevision 

func (x *BuildInfra_Buildbucket) GetServiceConfigRevision() string

func (*BuildInfra_Buildbucket) ProtoMessage 

func (*BuildInfra_Buildbucket) ProtoMessage()

func (*BuildInfra_Buildbucket) ProtoReflect 

func (x *BuildInfra_Buildbucket) ProtoReflect() protoreflect.Message

func (*BuildInfra_Buildbucket) Reset 

func (x *BuildInfra_Buildbucket) Reset()

func (*BuildInfra_Buildbucket) String 

func (x *BuildInfra_Buildbucket) String() string

type BuildInfra_LogDog 

type BuildInfra_LogDog struct {

	// LogDog hostname, e.g. "logs.chromium.org".
	Hostname string `protobuf:"bytes,1,opt,name=hostname,proto3" json:"hostname,omitempty"`
	// LogDog project, e.g. "chromium".
	// Typically matches Build.builder.project.
	Project string `protobuf:"bytes,2,opt,name=project,proto3" json:"project,omitempty"`
	// A slash-separated path prefix shared by all logs and artifacts of this
	// build.
	// No other build can have the same prefix.
	// Can be used to discover logs and/or load log contents.
	//
	// Can be used to construct URL of a page that displays stdout/stderr of all
	// steps of a build. In pseudo-JS:
	//   q_stdout = `${project}/${prefix}/+/**/stdout`;
	//   q_stderr = `${project}/${prefix}/+/**/stderr`;
	//   url = `https://${host}/v/?s=${urlquote(q_stdout)}&s=${urlquote(q_stderr)}`;
	Prefix string `protobuf:"bytes,3,opt,name=prefix,proto3" json:"prefix,omitempty"`
	// contains filtered or unexported fields
}

LogDog-specific information.

func (*BuildInfra_LogDog) Descriptor deprecated 

func (*BuildInfra_LogDog) Descriptor() ([]byte, []int)

Deprecated: Use BuildInfra_LogDog.ProtoReflect.Descriptor instead.

func (*BuildInfra_LogDog) GetHostname 

func (x *BuildInfra_LogDog) GetHostname() string

func (*BuildInfra_LogDog) GetPrefix 

func (x *BuildInfra_LogDog) GetPrefix() string

func (*BuildInfra_LogDog) GetProject 

func (x *BuildInfra_LogDog) GetProject() string

func (*BuildInfra_LogDog) ProtoMessage 

func (*BuildInfra_LogDog) ProtoMessage()

func (*BuildInfra_LogDog) ProtoReflect 

func (x *BuildInfra_LogDog) ProtoReflect() protoreflect.Message

func (*BuildInfra_LogDog) Reset 

func (x *BuildInfra_LogDog) Reset()

func (*BuildInfra_LogDog) String 

func (x *BuildInfra_LogDog) String() string

type BuildInfra_Recipe 

type BuildInfra_Recipe struct {

	// CIPD package name containing the recipe used to run this build.
	CipdPackage string `protobuf:"bytes,1,opt,name=cipd_package,json=cipdPackage,proto3" json:"cipd_package,omitempty"`
	// Name of the recipe used to run this build.
	Name string `protobuf:"bytes,2,opt,name=name,proto3" json:"name,omitempty"`
	// contains filtered or unexported fields
}

Recipe-specific information.

func (*BuildInfra_Recipe) Descriptor deprecated 

func (*BuildInfra_Recipe) Descriptor() ([]byte, []int)

Deprecated: Use BuildInfra_Recipe.ProtoReflect.Descriptor instead.

func (*BuildInfra_Recipe) GetCipdPackage 

func (x *BuildInfra_Recipe) GetCipdPackage() string

func (*BuildInfra_Recipe) GetName 

func (x *BuildInfra_Recipe) GetName() string

func (*BuildInfra_Recipe) ProtoMessage 

func (*BuildInfra_Recipe) ProtoMessage()

func (*BuildInfra_Recipe) ProtoReflect 

func (x *BuildInfra_Recipe) ProtoReflect() protoreflect.Message

func (*BuildInfra_Recipe) Reset 

func (x *BuildInfra_Recipe) Reset()

func (*BuildInfra_Recipe) String 

func (x *BuildInfra_Recipe) String() string

type BuildInfra_ResultDB 

type BuildInfra_ResultDB struct {

	// Hostname of the ResultDB instance, such as "results.api.cr.dev".
	Hostname string `protobuf:"bytes,1,opt,name=hostname,proto3" json:"hostname,omitempty"`
	// Name of the invocation for results of this build.
	// Typically "invocations/build:<build_id>".
	Invocation string `protobuf:"bytes,2,opt,name=invocation,proto3" json:"invocation,omitempty"`
	// contains filtered or unexported fields
}

ResultDB-specific information.

func (*BuildInfra_ResultDB) Descriptor deprecated 

func (*BuildInfra_ResultDB) Descriptor() ([]byte, []int)

Deprecated: Use BuildInfra_ResultDB.ProtoReflect.Descriptor instead.

func (*BuildInfra_ResultDB) GetHostname 

func (x *BuildInfra_ResultDB) GetHostname() string

func (*BuildInfra_ResultDB) GetInvocation 

func (x *BuildInfra_ResultDB) GetInvocation() string

func (*BuildInfra_ResultDB) ProtoMessage 

func (*BuildInfra_ResultDB) ProtoMessage()

func (*BuildInfra_ResultDB) ProtoReflect 

func (x *BuildInfra_ResultDB) ProtoReflect() protoreflect.Message

func (*BuildInfra_ResultDB) Reset 

func (x *BuildInfra_ResultDB) Reset()

func (*BuildInfra_ResultDB) String 

func (x *BuildInfra_ResultDB) String() string

type BuildInfra_Swarming 

type BuildInfra_Swarming struct {

	// Swarming hostname, e.g. "chromium-swarm.appspot.com".
	// Populated at the build creation time.
	Hostname string `protobuf:"bytes,1,opt,name=hostname,proto3" json:"hostname,omitempty"`
	// Swarming task id.
	// Not guaranteed to be populated at the build creation time.
	TaskId string `protobuf:"bytes,2,opt,name=task_id,json=taskId,proto3" json:"task_id,omitempty"`
	// Swarming run id of the parent task from which this build is triggered.
	// If set, swarming promises to ensure this build won't outlive its parent
	// swarming task (which may or may not itself be a Buildbucket build).
	// Populated at the build creation time.
	ParentRunId string `protobuf:"bytes,9,opt,name=parent_run_id,json=parentRunId,proto3" json:"parent_run_id,omitempty"`
	// Task service account email address.
	// This is the service account used for all authenticated requests by the
	// build.
	TaskServiceAccount string `protobuf:"bytes,3,opt,name=task_service_account,json=taskServiceAccount,proto3" json:"task_service_account,omitempty"`
	// Priority of the task. The lower the more important.
	// Valid values are [20..255].
	Priority int32 `protobuf:"varint,4,opt,name=priority,proto3" json:"priority,omitempty"`
	// Swarming dimensions for the task.
	TaskDimensions []*RequestedDimension `protobuf:"bytes,5,rep,name=task_dimensions,json=taskDimensions,proto3" json:"task_dimensions,omitempty"`
	// Swarming dimensions of the bot used for the task.
	BotDimensions []*StringPair `protobuf:"bytes,6,rep,name=bot_dimensions,json=botDimensions,proto3" json:"bot_dimensions,omitempty"`
	// Caches requested by this build.
	Caches []*BuildInfra_Swarming_CacheEntry `protobuf:"bytes,7,rep,name=caches,proto3" json:"caches,omitempty"`
	// Swarming task containment for the task.
	Containment *api.Containment `protobuf:"bytes,8,opt,name=containment,proto3" json:"containment,omitempty"`
	// contains filtered or unexported fields
}

Swarming-specific information.

Next ID: 10.

func (*BuildInfra_Swarming) Descriptor deprecated 

func (*BuildInfra_Swarming) Descriptor() ([]byte, []int)

Deprecated: Use BuildInfra_Swarming.ProtoReflect.Descriptor instead.

func (*BuildInfra_Swarming) GetBotDimensions 

func (x *BuildInfra_Swarming) GetBotDimensions() []*StringPair

func (*BuildInfra_Swarming) GetCaches 

func (x *BuildInfra_Swarming) GetCaches() []*BuildInfra_Swarming_CacheEntry

func (*BuildInfra_Swarming) GetContainment 

func (x *BuildInfra_Swarming) GetContainment() *api.Containment

func (*BuildInfra_Swarming) GetHostname 

func (x *BuildInfra_Swarming) GetHostname() string

func (*BuildInfra_Swarming) GetParentRunId 

func (x *BuildInfra_Swarming) GetParentRunId() string

func (*BuildInfra_Swarming) GetPriority 

func (x *BuildInfra_Swarming) GetPriority() int32

func (*BuildInfra_Swarming) GetTaskDimensions 

func (x *BuildInfra_Swarming) GetTaskDimensions() []*RequestedDimension

func (*BuildInfra_Swarming) GetTaskId 

func (x *BuildInfra_Swarming) GetTaskId() string

func (*BuildInfra_Swarming) GetTaskServiceAccount 

func (x *BuildInfra_Swarming) GetTaskServiceAccount() string

func (*BuildInfra_Swarming) ProtoMessage 

func (*BuildInfra_Swarming) ProtoMessage()

func (*BuildInfra_Swarming) ProtoReflect 

func (x *BuildInfra_Swarming) ProtoReflect() protoreflect.Message

func (*BuildInfra_Swarming) Reset 

func (x *BuildInfra_Swarming) Reset()

func (*BuildInfra_Swarming) String 

func (x *BuildInfra_Swarming) String() string

type BuildInfra_Swarming_CacheEntry 

type BuildInfra_Swarming_CacheEntry struct {

	// Identifier of the cache. Required. Length is limited to 128.
	// Must be unique in the build.
	//
	// If the pool of swarming bots is shared among multiple LUCI projects and
	// projects use same cache name, the cache will be shared across projects.
	// To avoid affecting and being affected by other projects, prefix the
	// cache name with something project-specific, e.g. "v8-".
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Relative path where the cache in mapped into. Required.
	//
	// Must use POSIX format (forward slashes).
	// In most cases, it does not need slashes at all.
	//
	// In recipes, use api.path['cache'].join(path) to get absolute path.
	//
	// Must be unique in the build.
	Path string `protobuf:"bytes,2,opt,name=path,proto3" json:"path,omitempty"`
	// Duration to wait for a bot with a warm cache to pick up the
	// task, before falling back to a bot with a cold (non-existent) cache.
	//
	// The default is 0, which means that no preference will be chosen for a
	// bot with this or without this cache, and a bot without this cache may
	// be chosen instead.
	//
	// If no bot has this cache warm, the task will skip this wait and will
	// immediately fallback to a cold cache request.
	//
	// The value must be multiples of 60 seconds.
	WaitForWarmCache *duration.Duration `protobuf:"bytes,3,opt,name=wait_for_warm_cache,json=waitForWarmCache,proto3" json:"wait_for_warm_cache,omitempty"`
	// Environment variable with this name will be set to the path to the cache
	// directory.
	EnvVar string `protobuf:"bytes,4,opt,name=env_var,json=envVar,proto3" json:"env_var,omitempty"`
	// contains filtered or unexported fields
}

Describes a cache directory persisted on a bot.

If a build requested a cache, the cache directory is available on build startup. If the cache was present on the bot, the directory contains files from the previous run on that bot. The build can read/write to the cache directory while it runs. After build completes, the cache directory is persisted. The next time another build requests the same cache and runs on the same bot, the files will still be there (unless the cache was evicted, perhaps due to disk space reasons).

One bot can keep multiple caches at the same time and one build can request multiple different caches. A cache is identified by its name and mapped to a path.

If the bot is running out of space, caches are evicted in LRU manner before the next build on this bot starts.

Builder cache.

Buildbucket implicitly declares cache 

{"name": "<hash(project/bucket/builder)>", "path": "builder"}.

This means that any LUCI builder has a "personal disk space" on the bot. Builder cache is often a good start before customizing caching. In recipes, it is available at api.buildbucket.builder_cache_path.

func (*BuildInfra_Swarming_CacheEntry) Descriptor deprecated 

func (*BuildInfra_Swarming_CacheEntry) Descriptor() ([]byte, []int)

Deprecated: Use BuildInfra_Swarming_CacheEntry.ProtoReflect.Descriptor instead.

func (*BuildInfra_Swarming_CacheEntry) GetEnvVar 

func (x *BuildInfra_Swarming_CacheEntry) GetEnvVar() string

func (*BuildInfra_Swarming_CacheEntry) GetName 

func (x *BuildInfra_Swarming_CacheEntry) GetName() string

func (*BuildInfra_Swarming_CacheEntry) GetPath 

func (x *BuildInfra_Swarming_CacheEntry) GetPath() string

func (*BuildInfra_Swarming_CacheEntry) GetWaitForWarmCache 

func (x *BuildInfra_Swarming_CacheEntry) GetWaitForWarmCache() *duration.Duration

func (*BuildInfra_Swarming_CacheEntry) ProtoMessage 

func (*BuildInfra_Swarming_CacheEntry) ProtoMessage()

func (*BuildInfra_Swarming_CacheEntry) ProtoReflect 

func (x *BuildInfra_Swarming_CacheEntry) ProtoReflect() protoreflect.Message

func (*BuildInfra_Swarming_CacheEntry) Reset 

func (x *BuildInfra_Swarming_CacheEntry) Reset()

func (*BuildInfra_Swarming_CacheEntry) String 

func (x *BuildInfra_Swarming_CacheEntry) String() string

type BuildPredicate 

type BuildPredicate struct {

	// A build must be in this builder.
	Builder *BuilderID `protobuf:"bytes,1,opt,name=builder,proto3" json:"builder,omitempty"`
	// A build must have this status.
	Status Status `protobuf:"varint,2,opt,name=status,proto3,enum=buildbucket.v2.Status" json:"status,omitempty"`
	// A build's Build.Input.gerrit_changes must include ALL of these changes.
	GerritChanges []*GerritChange `protobuf:"bytes,3,rep,name=gerrit_changes,json=gerritChanges,proto3" json:"gerrit_changes,omitempty"`
	// A build's Build.Output.gitiles_commit must match this commit.
	// One of the following subfield sets must specified:
	// - host, project, id
	// - host, project, ref
	// - host, project, ref, position
	OutputGitilesCommit *GitilesCommit `protobuf:"bytes,4,opt,name=output_gitiles_commit,json=outputGitilesCommit,proto3" json:"output_gitiles_commit,omitempty"`
	// A build must be created by this identity.
	CreatedBy string `protobuf:"bytes,5,opt,name=created_by,json=createdBy,proto3" json:"created_by,omitempty"`
	// A build must have ALL of these tags.
	// For "ANY of these tags" make separate RPCs.
	Tags []*StringPair `protobuf:"bytes,6,rep,name=tags,proto3" json:"tags,omitempty"`
	// A build must have been created within the specified range.
	// Both boundaries are optional.
	CreateTime *TimeRange `protobuf:"bytes,7,opt,name=create_time,json=createTime,proto3" json:"create_time,omitempty"`
	// DEPRECATED
	//
	// If false (the default), equivalent to filtering by experiment
	// "-luci.non_production".
	//
	// If true, has no effect (both production and non_production builds will be
	// returned).
	//
	// See `Builder.experiments` for well-known experiments.
	IncludeExperimental bool `protobuf:"varint,8,opt,name=include_experimental,json=includeExperimental,proto3" json:"include_experimental,omitempty"`
	// A build must be in this build range.
	// A pair of SearchBuildsRequest.predicate.build.start_build_id and
	// SearchBuildsRequest.page_size=1 can be used to find the previous build.
	Build *BuildRange `protobuf:"bytes,9,opt,name=build,proto3" json:"build,omitempty"`
	// DEPRECATED
	//
	// If YES, equivalent to filtering by experiment
	// "+luci.buildbucket.canary_software".
	//
	// If NO, equivalent to filtering by experiment
	// "-luci.buildbucket.canary_software".
	//
	// See `Builder.experiments` for well-known experiments.
	Canary Trinary `protobuf:"varint,10,opt,name=canary,proto3,enum=buildbucket.v2.Trinary" json:"canary,omitempty"`
	// A list of experiments to include or exclude from the search results.
	//
	// Each entry should look like "[-+]$experiment_name".
	//
	// A "+" prefix means that returned builds MUST have that experiment set.
	// A "-" prefix means that returned builds MUST NOT have that experiment set
	//   AND that experiment was known for the builder at the time the build
	//   was scheduled (either via `Builder.experiments` or via
	//   `ScheduleBuildRequest.experiments`). Well-known experiments are always
	//   considered to be available.
	Experiments []string `protobuf:"bytes,11,rep,name=experiments,proto3" json:"experiments,omitempty"`
	// contains filtered or unexported fields
}

A build predicate.

At least one of the following fields is required: builder, gerrit_changes and git_commits.. If a field value is empty, it is ignored, unless stated otherwise.

func (*BuildPredicate) Descriptor deprecated 

func (*BuildPredicate) Descriptor() ([]byte, []int)

Deprecated: Use BuildPredicate.ProtoReflect.Descriptor instead.

func (*BuildPredicate) GetBuild 

func (x *BuildPredicate) GetBuild() *BuildRange

func (*BuildPredicate) GetBuilder 

func (x *BuildPredicate) GetBuilder() *BuilderID

func (*BuildPredicate) GetCanary 

func (x *BuildPredicate) GetCanary() Trinary

func (*BuildPredicate) GetCreateTime 

func (x *BuildPredicate) GetCreateTime() *TimeRange

func (*BuildPredicate) GetCreatedBy 

func (x *BuildPredicate) GetCreatedBy() string

func (*BuildPredicate) GetExperiments 

func (x *BuildPredicate) GetExperiments() []string

func (*BuildPredicate) GetGerritChanges 

func (x *BuildPredicate) GetGerritChanges() []*GerritChange

func (*BuildPredicate) GetIncludeExperimental 

func (x *BuildPredicate) GetIncludeExperimental() bool

func (*BuildPredicate) GetOutputGitilesCommit 

func (x *BuildPredicate) GetOutputGitilesCommit() *GitilesCommit

func (*BuildPredicate) GetStatus 

func (x *BuildPredicate) GetStatus() Status

func (*BuildPredicate) GetTags 

func (x *BuildPredicate) GetTags() []*StringPair

func (*BuildPredicate) ProtoMessage 

func (*BuildPredicate) ProtoMessage()

func (*BuildPredicate) ProtoReflect 

func (x *BuildPredicate) ProtoReflect() protoreflect.Message

func (*BuildPredicate) Reset 

func (x *BuildPredicate) Reset()

func (*BuildPredicate) String 

func (x *BuildPredicate) String() string

type BuildRange 

type BuildRange struct {

	// Inclusive lower boundary. Optional.
	StartBuildId int64 `protobuf:"varint,1,opt,name=start_build_id,json=startBuildId,proto3" json:"start_build_id,omitempty"`
	// Exclusive upper boundary. Optional.
	EndBuildId int64 `protobuf:"varint,2,opt,name=end_build_id,json=endBuildId,proto3" json:"end_build_id,omitempty"`
	// contains filtered or unexported fields
}

Half-open build range. The range is defined on the build order in the context. Usually the order is newest-to-oldest, so start_build_id is a newer build and end_build_id is an older build.

func (*BuildRange) Descriptor deprecated 

func (*BuildRange) Descriptor() ([]byte, []int)

Deprecated: Use BuildRange.ProtoReflect.Descriptor instead.

func (*BuildRange) GetEndBuildId 

func (x *BuildRange) GetEndBuildId() int64

func (*BuildRange) GetStartBuildId 

func (x *BuildRange) GetStartBuildId() int64

func (*BuildRange) ProtoMessage 

func (*BuildRange) ProtoMessage()

func (*BuildRange) ProtoReflect 

func (x *BuildRange) ProtoReflect() protoreflect.Message

func (*BuildRange) Reset 

func (x *BuildRange) Reset()

func (*BuildRange) String 

func (x *BuildRange) String() string

type BuildSecrets 

type BuildSecrets struct {

	// Token to identify RPCs associated with the same build.
	BuildToken string `protobuf:"bytes,1,opt,name=build_token,json=buildToken,proto3" json:"build_token,omitempty"`
	// Token to allow updating this build's invocation in ResultDB.
	ResultdbInvocationUpdateToken string `` /* 152-byte string literal not displayed */
	// contains filtered or unexported fields
}

A collection of build-related secrets we might pass from Buildbucket to Kitchen.

func (*BuildSecrets) Descriptor deprecated 

func (*BuildSecrets) Descriptor() ([]byte, []int)

Deprecated: Use BuildSecrets.ProtoReflect.Descriptor instead.

func (*BuildSecrets) GetBuildToken 

func (x *BuildSecrets) GetBuildToken() string

func (*BuildSecrets) GetResultdbInvocationUpdateToken 

func (x *BuildSecrets) GetResultdbInvocationUpdateToken() string

func (*BuildSecrets) ProtoMessage 

func (*BuildSecrets) ProtoMessage()

func (*BuildSecrets) ProtoReflect 

func (x *BuildSecrets) ProtoReflect() protoreflect.Message

func (*BuildSecrets) Reset 

func (x *BuildSecrets) Reset()

func (*BuildSecrets) String 

func (x *BuildSecrets) String() string

type Build_Input 

type Build_Input struct {

	// Arbitrary JSON object. Available at build run time.
	//
	// RPC: By default, this field is excluded from responses.
	//
	// V1 equivalent: corresponds to "properties" key in "parameters_json".
	Properties *_struct.Struct `protobuf:"bytes,1,opt,name=properties,proto3" json:"properties,omitempty"`
	// The Gitiles commit to run against.
	// Usually present in CI builds, set by LUCI Scheduler.
	// If not present, the build may checkout "refs/heads/master".
	// NOT a blamelist.
	//
	// V1 equivalent: supersedes "revision" property and "buildset"
	// tag that starts with "commit/gitiles/".
	GitilesCommit *GitilesCommit `protobuf:"bytes,2,opt,name=gitiles_commit,json=gitilesCommit,proto3" json:"gitiles_commit,omitempty"`
	// Gerrit patchsets to run against.
	// Usually present in tryjobs, set by CQ, Gerrit, git-cl-try.
	// Applied on top of gitiles_commit if specified, otherwise tip of the tree.
	//
	// V1 equivalent: supersedes patch_* properties and "buildset"
	// tag that starts with "patch/gerrit/".
	GerritChanges []*GerritChange `protobuf:"bytes,3,rep,name=gerrit_changes,json=gerritChanges,proto3" json:"gerrit_changes,omitempty"`
	// DEPRECATED
	//
	// Equivalent to `"luci.non_production" in experiments`.
	//
	// See `Builder.experiments` for well-known experiments.
	Experimental bool `protobuf:"varint,5,opt,name=experimental,proto3" json:"experimental,omitempty"`
	// The sorted list of experiments enabled on this build.
	//
	// See `Builder.experiments` for well-known experiments.
	Experiments []string `protobuf:"bytes,6,rep,name=experiments,proto3" json:"experiments,omitempty"`
	// contains filtered or unexported fields
}

Defines what to build/test.

Behavior of a build executable MAY depend on Input. It MAY NOT modify its behavior based on anything outside of Input. It MAY read non-Input fields to display for debugging or to pass-through to triggered builds. For example the "tags" field may be passed to triggered builds, or the "infra" field may be printed for debugging purposes.

func (*Build_Input) Descriptor deprecated 

func (*Build_Input) Descriptor() ([]byte, []int)

Deprecated: Use Build_Input.ProtoReflect.Descriptor instead.

func (*Build_Input) GetExperimental 

func (x *Build_Input) GetExperimental() bool

func (*Build_Input) GetExperiments 

func (x *Build_Input) GetExperiments() []string

func (*Build_Input) GetGerritChanges 

func (x *Build_Input) GetGerritChanges() []*GerritChange

func (*Build_Input) GetGitilesCommit 

func (x *Build_Input) GetGitilesCommit() *GitilesCommit

func (*Build_Input) GetProperties 

func (x *Build_Input) GetProperties() *_struct.Struct

func (*Build_Input) ProtoMessage 

func (*Build_Input) ProtoMessage()

func (*Build_Input) ProtoReflect 

func (x *Build_Input) ProtoReflect() protoreflect.Message

func (*Build_Input) Reset 

func (x *Build_Input) Reset()

func (*Build_Input) String 

func (x *Build_Input) String() string

type Build_Output 

type Build_Output struct {

	// Arbitrary JSON object produced by the build.
	//
	// In recipes, use step_result.presentation.properties to set these,
	// for example
	//
	//   step_result = api.step(['echo'])
	//   step_result.presentation.properties['foo'] = 'bar'
	//
	// More docs: https://chromium.googlesource.com/infra/luci/recipes-py/+/HEAD/doc/old_user_guide.md#Setting-properties
	//
	// V1 equivalent: corresponds to "properties" key in
	// "result_details_json".
	// In V1 output properties are not populated until build ends.
	Properties *_struct.Struct `protobuf:"bytes,1,opt,name=properties,proto3" json:"properties,omitempty"`
	// Build checked out and executed on this commit.
	//
	// Should correspond to Build.Input.gitiles_commit.
	// May be present even if Build.Input.gitiles_commit is not set, for example
	// in cron builders.
	//
	// V1 equivalent: this supersedes all got_revision output property.
	GitilesCommit *GitilesCommit `protobuf:"bytes,3,opt,name=gitiles_commit,json=gitilesCommit,proto3" json:"gitiles_commit,omitempty"`
	// Logs produced by the build script, typically "stdout" and "stderr".
	Logs []*Log `protobuf:"bytes,5,rep,name=logs,proto3" json:"logs,omitempty"`
	// contains filtered or unexported fields
}

Result of the build executable.

func (*Build_Output) Descriptor deprecated 

func (*Build_Output) Descriptor() ([]byte, []int)

Deprecated: Use Build_Output.ProtoReflect.Descriptor instead.

func (*Build_Output) GetGitilesCommit 

func (x *Build_Output) GetGitilesCommit() *GitilesCommit

func (*Build_Output) GetLogs 

func (x *Build_Output) GetLogs() []*Log

func (*Build_Output) GetProperties 

func (x *Build_Output) GetProperties() *_struct.Struct

func (*Build_Output) ProtoMessage 

func (*Build_Output) ProtoMessage()

func (*Build_Output) ProtoReflect 

func (x *Build_Output) ProtoReflect() protoreflect.Message

func (*Build_Output) Reset 

func (x *Build_Output) Reset()

func (*Build_Output) String 

func (x *Build_Output) String() string

type BuildbucketCfg 

type BuildbucketCfg struct {

	// All buckets defined for this project.
	Buckets []*Bucket `protobuf:"bytes,1,rep,name=buckets,proto3" json:"buckets,omitempty"`
	// A list of ACL sets. Names must be unique.
	AclSets []*AclSet `protobuf:"bytes,2,rep,name=acl_sets,json=aclSets,proto3" json:"acl_sets,omitempty"`
	// A list of builder mixin definitions.
	// A mixin can be referenced in any builder defined within the BuildbucketCfg.
	// See also Buider.mixins field.
	BuilderMixins []*Builder `protobuf:"bytes,3,rep,name=builder_mixins,json=builderMixins,proto3" json:"builder_mixins,omitempty"`
	// contains filtered or unexported fields
}

Schema of buildbucket.cfg file, a project config.

func (*BuildbucketCfg) Descriptor deprecated 

func (*BuildbucketCfg) Descriptor() ([]byte, []int)

Deprecated: Use BuildbucketCfg.ProtoReflect.Descriptor instead.

func (*BuildbucketCfg) GetAclSets 

func (x *BuildbucketCfg) GetAclSets() []*AclSet

func (*BuildbucketCfg) GetBuckets 

func (x *BuildbucketCfg) GetBuckets() []*Bucket

func (*BuildbucketCfg) GetBuilderMixins 

func (x *BuildbucketCfg) GetBuilderMixins() []*Builder

func (*BuildbucketCfg) ProtoMessage 

func (*BuildbucketCfg) ProtoMessage()

func (*BuildbucketCfg) ProtoReflect 

func (x *BuildbucketCfg) ProtoReflect() protoreflect.Message

func (*BuildbucketCfg) Reset 

func (x *BuildbucketCfg) Reset()

func (*BuildbucketCfg) String 

func (x *BuildbucketCfg) String() string

type Builder 

type Builder struct {

	// Name of the builder or builder mixin.
	//
	// If a builder name, will be propagated to "builder" build tag and
	// "buildername" recipe property.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Hostname of the swarming instance, e.g. "chromium-swarm.appspot.com".
	// Required, but defaults to deprecated Swarming.hostname.
	SwarmingHost string `protobuf:"bytes,21,opt,name=swarming_host,json=swarmingHost,proto3" json:"swarming_host,omitempty"`
	// Names of mixins to apply to this builder definition.
	//
	// FLATTENING
	//
	// Final builder/mixin values are computed as follows:
	// - start with an empty builder definition.
	// - if this is a builder, apply values in a bucket's builder_defaults,
	//   flattened in advance.
	// - apply each mixin, flattened in advance, in the same order.
	// - apply values in this builder/mixin.
	//
	// EXAMPLE
	//
	//   A definition
	//
	//     builder_mixins {
	//       name: "foo"
	//       dimensions: "os:Linux"
	//       dimensions: "cpu:x86"
	//       recipe {
	//         repository: "https://example.com"
	//         name: "x"
	//       }
	//     }
	//     builder_mixins {
	//       name: "bar"
	//       dimensions: "cores:8"
	//       dimensions: "cpu:x86-64"
	//     }
	//     bucket {
	//       name: "luci.x.try"
	//       swarming {
	//         builders {
	//           name: "release"
	//           mixins: "foo"
	//           mixins: "bar"
	//           recipe {
	//             name: "y"
	//           }
	//         }
	//       }
	//     }
	//
	//   is equivalent to
	//
	//     bucket {
	//      name: "luci.x.try"
	//      swarming {
	//         builders {
	//           name: "release"
	//           dimensions: "os:Linux"
	//           dimensions: "cpu:x86-64"
	//           dimensions: "cores:8"
	//           recipe {
	//             repository: "https://example.com"
	//             name: "y"
	//           }
	//         }
	//       }
	//     }
	//
	// A NOTE ON DIAMOND MERGES
	//
	// Given
	//   B mixes in A and overrides some values defined in A
	//   C mixes in A
	//   D mixes in B and C
	// B's overrides won't affect D because D mixes in C after B.
	//
	//   builder_mixins {
	//     name: "A"
	//     dimensions: "dim:a"
	//   }
	//   builder_mixins {
	//     name: "B"
	//     mixins: "A"
	//     dimensions: "dim:b"
	//   }
	//   builder_mixins {
	//     name: "C"
	//     mixins: "A"
	//   }
	//   ...
	//   builders {
	//     name: "D"
	//     mixins: "B"
	//     mixins: "C"
	//   }
	//
	// D's dim will be "a", not "b" because it is "a" in C which is applied after
	// B.
	//
	// OTHER
	//
	// Circular references are prohibited.
	Mixins []string `protobuf:"bytes,10,rep,name=mixins,proto3" json:"mixins,omitempty"`
	// Builder category. Will be used for visual grouping, for example in Code Review.
	Category string `protobuf:"bytes,6,opt,name=category,proto3" json:"category,omitempty"`
	// DEPRECATED.
	// Used only to enable "vpython:native-python-wrapper"
	// Does NOT actually propagate to swarming.
	SwarmingTags []string `protobuf:"bytes,2,rep,name=swarming_tags,json=swarmingTags,proto3" json:"swarming_tags,omitempty"`
	// A requirement for a bot to execute the build.
	//
	// Supports 3 forms:
	// - "<key>:" - exclude the defaults for the key.
	//   Mutually exclusive with other forms.
	// - "<key>:<value>" - require a bot with this dimension.
	//   This is a shortcut for "0:<key>:<value>", see below.
	// - "<expiration_secs>:<key>:<value>" - wait for up to expiration_secs.
	//   for a bot with the dimension.
	//   Supports multiple values for different keys and expiration_secs.
	//   expiration_secs must be a multiple of 60.
	//
	// When merging a set of dimensions S1 into S2, all dimensions in S1 with a
	// key K replace all dimensions in S2 with K. This logic is used when applying
	// builder mixins and dimensions specified in a build request.
	//
	// If this builder is defined in a bucket, dimension "pool" is defaulted
	// to the name of the bucket. See Bucket message below.
	Dimensions []string `protobuf:"bytes,3,rep,name=dimensions,proto3" json:"dimensions,omitempty"`
	// Specifies that a recipe to run.
	// DEPRECATED: use exe.
	Recipe *Builder_Recipe `protobuf:"bytes,4,opt,name=recipe,proto3" json:"recipe,omitempty"`
	// What to run when a build is ready to start.
	Exe *Executable `protobuf:"bytes,23,opt,name=exe,proto3" json:"exe,omitempty"`
	// A JSON object representing Build.input.properties.
	// Individual object properties can be overridden with
	// ScheduleBuildRequest.properties.
	Properties string `protobuf:"bytes,24,opt,name=properties,proto3" json:"properties,omitempty"`
	// Swarming task priority.
	// A value between 20 and 255, inclusive.
	// Lower means more important.
	//
	// The default value is configured in
	// https://chrome-internal.googlesource.com/infradata/config/+/master/configs/cr-buildbucket/swarming_task_template.json
	//
	// See also https://chromium.googlesource.com/infra/luci/luci-py.git/+/master/appengine/swarming/doc/User-Guide.md#request
	Priority uint32 `protobuf:"varint,5,opt,name=priority,proto3" json:"priority,omitempty"`
	// Maximum build execution time. Not to be confused with pending time.
	ExecutionTimeoutSecs uint32 `protobuf:"varint,7,opt,name=execution_timeout_secs,json=executionTimeoutSecs,proto3" json:"execution_timeout_secs,omitempty"`
	// Maximum build pending time.
	ExpirationSecs uint32 `protobuf:"varint,20,opt,name=expiration_secs,json=expirationSecs,proto3" json:"expiration_secs,omitempty"`
	// If YES, will request that swarming wait until it sees at least one bot
	// report a superset of the requested dimensions.
	//
	// If UNSET/NO (the default), swarming will immediately reject a build which
	// specifies a dimension set that it's never seen before.
	//
	// Usually you want this to be UNSET/NO, unless you know that some external
	// system is working to add bots to swarming which will match the requested
	// dimensions within expiration_secs. Otherwise you'll have to wait for all of
	// `expiration_secs` until swarming tells you "Sorry, nothing has dimension
	// `os:MadeUpOS`".
	WaitForCapacity Trinary `` /* 138-byte string literal not displayed */
	// Caches that should be present on the bot.
	Caches []*Builder_CacheEntry `protobuf:"bytes,9,rep,name=caches,proto3" json:"caches,omitempty"`
	// If YES, generate monotonically increasing contiguous numbers for each
	// build, unique within the builder.
	// Note: this limits the build creation rate in this builder to 5 per second.
	BuildNumbers Toggle `protobuf:"varint,16,opt,name=build_numbers,json=buildNumbers,proto3,enum=buildbucket.Toggle" json:"build_numbers,omitempty"`
	// Email of a service account to run the build as or literal 'bot' string to
	// use Swarming bot's account (if available). Passed directly to Swarming.
	// Subject to Swarming's ACLs.
	ServiceAccount string `protobuf:"bytes,12,opt,name=service_account,json=serviceAccount,proto3" json:"service_account,omitempty"`
	// If YES, each builder will get extra dimension "builder:<builder name>"
	// added. Default is UNSET.
	//
	// For example, this config
	//
	//   builder {
	//     name: "linux-compiler"
	//     dimension: "builder:linux-compiler"
	//   }
	//
	// is equivalent to this:
	//
	//   builders {
	//     name: "linux-compiler"
	//     auto_builder_dimension: YES
	//   }
	//
	// We've considered providing interpolation like this
	//   builder_defaults {
	//     dimensions: "builder:${BUILDER}"
	//   }
	// (see also http://docs.buildbot.net/0.8.9/manual/cfg-properties.html#interpolate)
	// but are currently against complicating config with this.
	AutoBuilderDimension Toggle `` /* 149-byte string literal not displayed */
	// DEPRECATED
	//
	// Set the "luci.non_production" experiment in the 'experiments' field below,
	// instead.
	//
	// If YES, sets the "luci.non_production" experiment to 100% for
	// builds on this builder.
	//
	// See the documentation on `experiments` for more details about the
	// "luci.non_production" experiment.
	Experimental Toggle `protobuf:"varint,18,opt,name=experimental,proto3,enum=buildbucket.Toggle" json:"experimental,omitempty"`
	// DEPRECATED
	//
	// Set the "luci.buildbucket.canary_software" experiment in the 'experiments'
	// field below, instead.
	//
	// Percentage of builds that should use a canary swarming task template.
	// A value from 0 to 100.
	// If omitted, a global server-defined default percentage is used.
	TaskTemplateCanaryPercentage *wrappers.UInt32Value `` /* 150-byte string literal not displayed */
	// A mapping of experiment name to the percentage chance (0-100) that it will
	// apply to builds generated from this builder. Experiments are simply strings
	// which various parts of the stack (from LUCI services down to your build
	// scripts) may react to in order to enable certain functionality.
	//
	// You may set any experiments you like, but experiments beginning with
	// "luci." are reserved. Experiment names must conform to
	//
	//    [a-z][a-z0-9_]*(\.[a-z][a-z0-9_]*)*
	//
	// Any experiments which are selected for a build show up in
	// `Build.input.experiments`.
	//
	// Its recommended that you confine your experiments to smaller, more explicit
	// targets. For example, prefer the experiment named
	// "my_project.use_mysoftware_v2_crbug_999999" rather than "use_next_gen".
	//
	// It is NOT recommended to 'piggy-back' on top of existing experiment names
	// for a different purpose. However if you want to, you can have your build
	// treat the presence of ANY experiment as equivalent to "luci.non_production"
	// being set for your build (i.e. "if any experiment is set, don't affect
	// production"). This is ulimately up to you, however.
	//
	// Well-known experiments
	//
	// # "luci.non_production"  (default 0%)
	// Builds with this experiment SHOULD NOT affect production resources. This
	// means that they should e.g. skip uploads steps which send data to locations
	// which would overlap with production uploads.
	//
	// This experiment does not directly affect the behavior of any LUCI services,
	// but is set by some LUCI tools/systems (for example `led`). It is very
	// coarse-grained, but is still useful to allow communication from
	// higher-layer systems that the build in question shouldn't impact
	// production.
	//
	// Although it's tempting to enable new functionality when this experiment is
	// set, prefer to create your own experiment names for that purpose. For
	// example:
	//
	//    # Good
	//    upload_bucket = 'gs://production-binaries'
	//    if 'luci.non_production' in experiments:
	//      upload_bucket = 'gs://non-production-binaries'
	//
	//    # Good
	//    if 'luci.non_production' not in experiments:
	//      official_results_service.report(stuff)
	//
	//    # Bad
	//    if 'luci.non_production' in experiments:
	//      enable_wacky_new_functionality()
	//
	//    # Instead
	//    if 'my_project.wacky_new_functionality' in experiments:
	//      enable_wacky_new_functionality()
	//
	// Currently maps to the "recipe_engine/runtime".is_experimental flag in
	// recipes, though getting it directly from build.input.experiments is
	// preferable.
	//
	// # "luci.buildbucket.canary_software"  (default 10%)
	// Builds with this experiment use the canary software versions listed in
	// Buildbucket's service-wide `settings.cfg`.
	//
	// NOTE: There's a good argument for controlling each software package with
	// its own experiment. However, in practice, we don't usually have more than
	// one piece of software in canary at the same time. If we were designing this
	// today, we would likely lean towards individual package control.
	//
	// # "luci.buildbucket.use_bbagent"  (default currently 0%)
	// Builds with this experiment will default to the new 'luciexe'-based
	// protocol, rather than the deprecated '@@@annotation@@@' protocol.
	//
	// Over time we'll be moving the default up from 0%. Ideally we'll be removing
	// the @@@annotation@@@ protocol entirely in 2020Q3.
	Experiments map[string]int32 `` /* 165-byte string literal not displayed */
	// This field will set the default value of the "critical" field of
	// all the builds of this builder. Please refer to build.proto for
	// the meaning of this field.
	//
	// This value can be overridden by ScheduleBuildRequest.critical
	Critical Trinary `protobuf:"varint,25,opt,name=critical,proto3,enum=buildbucket.v2.Trinary" json:"critical,omitempty"`
	// Used to enable and configure ResultDB integration.
	Resultdb *Builder_ResultDB `protobuf:"bytes,26,opt,name=resultdb,proto3" json:"resultdb,omitempty"`
	// Description that helps users understand the purpose of the builder, in
	// HTML.
	DescriptionHtml string `protobuf:"bytes,30,opt,name=description_html,json=descriptionHtml,proto3" json:"description_html,omitempty"`
	// contains filtered or unexported fields
}

Defines a swarmbucket builder or a builder mixin. A builder has a name, a category and specifies what should happen if a build is scheduled to that builder.

SECURITY WARNING: if adding more fields to this message, keep in mind that a user that has permissions to schedule a build to the bucket, can override this config.

Next tag: 31.

func (*Builder) Descriptor deprecated 

func (*Builder) Descriptor() ([]byte, []int)

Deprecated: Use Builder.ProtoReflect.Descriptor instead.

func (*Builder) FromProperty 

func (p *Builder) FromProperty(prop datastore.Property) error

FromProperty implements datastore.PropertyConverter. It parses a '[]byte' into an embedded 'Builder' when used with the "go.chromium.org/luci/gae" library.

func (*Builder) GetAutoBuilderDimension 

func (x *Builder) GetAutoBuilderDimension() Toggle

func (*Builder) GetBuildNumbers 

func (x *Builder) GetBuildNumbers() Toggle

func (*Builder) GetCaches 

func (x *Builder) GetCaches() []*Builder_CacheEntry

func (*Builder) GetCategory 

func (x *Builder) GetCategory() string

func (*Builder) GetCritical 

func (x *Builder) GetCritical() Trinary

func (*Builder) GetDescriptionHtml 

func (x *Builder) GetDescriptionHtml() string

func (*Builder) GetDimensions 

func (x *Builder) GetDimensions() []string

func (*Builder) GetExe 

func (x *Builder) GetExe() *Executable

func (*Builder) GetExecutionTimeoutSecs 

func (x *Builder) GetExecutionTimeoutSecs() uint32

func (*Builder) GetExperimental 

func (x *Builder) GetExperimental() Toggle

func (*Builder) GetExperiments 

func (x *Builder) GetExperiments() map[string]int32

func (*Builder) GetExpirationSecs 

func (x *Builder) GetExpirationSecs() uint32

func (*Builder) GetMixins 

func (x *Builder) GetMixins() []string

func (*Builder) GetName 

func (x *Builder) GetName() string

func (*Builder) GetPriority 

func (x *Builder) GetPriority() uint32

func (*Builder) GetProperties 

func (x *Builder) GetProperties() string

func (*Builder) GetRecipe 

func (x *Builder) GetRecipe() *Builder_Recipe

func (*Builder) GetResultdb 

func (x *Builder) GetResultdb() *Builder_ResultDB

func (*Builder) GetServiceAccount 

func (x *Builder) GetServiceAccount() string

func (*Builder) GetSwarmingHost 

func (x *Builder) GetSwarmingHost() string

func (*Builder) GetSwarmingTags 

func (x *Builder) GetSwarmingTags() []string

func (*Builder) GetTaskTemplateCanaryPercentage 

func (x *Builder) GetTaskTemplateCanaryPercentage() *wrappers.UInt32Value

func (*Builder) GetWaitForCapacity 

func (x *Builder) GetWaitForCapacity() Trinary

func (*Builder) ProtoMessage 

func (*Builder) ProtoMessage()

func (*Builder) ProtoReflect 

func (x *Builder) ProtoReflect() protoreflect.Message

func (*Builder) Reset 

func (x *Builder) Reset()

func (*Builder) String 

func (x *Builder) String() string

func (*Builder) ToProperty 

func (p *Builder) ToProperty() (prop datastore.Property, err error)

ToProperty implements datastore.PropertyConverter. It causes an embedded 'Builder' to serialize to an unindexed '[]byte' when used with the "go.chromium.org/luci/gae" library.

type BuilderID 

type BuilderID struct {

	// Project ID, e.g. "chromium". Unique within a LUCI deployment.
	Project string `protobuf:"bytes,1,opt,name=project,proto3" json:"project,omitempty"`
	// Bucket name, e.g. "try". Unique within the project.
	// Together with project, defines an ACL.
	Bucket string `protobuf:"bytes,2,opt,name=bucket,proto3" json:"bucket,omitempty"`
	// Builder name, e.g. "linux-rel". Unique within the bucket.
	Builder string `protobuf:"bytes,3,opt,name=builder,proto3" json:"builder,omitempty"`
	// contains filtered or unexported fields
}

Identifies a builder. Canonical string representation: "{project}/{bucket}/{builder}".

func (*BuilderID) Descriptor deprecated 

func (*BuilderID) Descriptor() ([]byte, []int)

Deprecated: Use BuilderID.ProtoReflect.Descriptor instead.

func (*BuilderID) GetBucket 

func (x *BuilderID) GetBucket() string

func (*BuilderID) GetBuilder 

func (x *BuilderID) GetBuilder() string

func (*BuilderID) GetProject 

func (x *BuilderID) GetProject() string

func (*BuilderID) ProtoMessage 

func (*BuilderID) ProtoMessage()

func (*BuilderID) ProtoReflect 

func (x *BuilderID) ProtoReflect() protoreflect.Message

func (*BuilderID) Reset 

func (x *BuilderID) Reset()

func (*BuilderID) String 

func (x *BuilderID) String() string

type BuilderItem 

type BuilderItem struct {

	// Uniquely identifies the builder in a given Buildbucket instance.
	Id *BuilderID `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	// User-supplied configuration after normalization.
	// Does not refer to mixins and has defaults inlined.
	Config *Builder `protobuf:"bytes,2,opt,name=config,proto3" json:"config,omitempty"`
	// contains filtered or unexported fields
}

A configured builder.

It is called BuilderItem and not Builder because 1) Builder already exists 2) Name "Builder" is incompatible with proto->Java compiler.

func (*BuilderItem) Descriptor deprecated 

func (*BuilderItem) Descriptor() ([]byte, []int)

Deprecated: Use BuilderItem.ProtoReflect.Descriptor instead.

func (*BuilderItem) GetConfig 

func (x *BuilderItem) GetConfig() *Builder

func (*BuilderItem) GetId 

func (x *BuilderItem) GetId() *BuilderID

func (*BuilderItem) ProtoMessage 

func (*BuilderItem) ProtoMessage()

func (*BuilderItem) ProtoReflect 

func (x *BuilderItem) ProtoReflect() protoreflect.Message

func (*BuilderItem) Reset 

func (x *BuilderItem) Reset()

func (*BuilderItem) String 

func (x *BuilderItem) String() string

type BuilderPredicate 

type BuilderPredicate struct {

	// OR-connected list of regular expressions for a string
	// "{project}/{bucket}/{builder}".
	// Each regex is wrapped in ^ and $ automatically.
	// Examples:
	//
	//   # All builders in "chromium" project
	//   regex: "chromium/.+"
	//   # A specific builder.
	//   regex: "infra/ci/infra-continuous-trusty-64"
	//
	// Defaults to [".*"].
	Regex []string `protobuf:"bytes,1,rep,name=regex,proto3" json:"regex,omitempty"`
	// Like regex field, but negation. Negation always wins.
	RegexExclude []string `protobuf:"bytes,2,rep,name=regex_exclude,json=regexExclude,proto3" json:"regex_exclude,omitempty"`
	// contains filtered or unexported fields
}

A predicate for a builder.

func (*BuilderPredicate) Descriptor deprecated 

func (*BuilderPredicate) Descriptor() ([]byte, []int)

Deprecated: Use BuilderPredicate.ProtoReflect.Descriptor instead.

func (*BuilderPredicate) GetRegex 

func (x *BuilderPredicate) GetRegex() []string

func (*BuilderPredicate) GetRegexExclude 

func (x *BuilderPredicate) GetRegexExclude() []string

func (*BuilderPredicate) ProtoMessage 

func (*BuilderPredicate) ProtoMessage()

func (*BuilderPredicate) ProtoReflect 

func (x *BuilderPredicate) ProtoReflect() protoreflect.Message

func (*BuilderPredicate) Reset 

func (x *BuilderPredicate) Reset()

func (*BuilderPredicate) String 

func (x *BuilderPredicate) String() string

type Builder_CacheEntry 

type Builder_CacheEntry struct {

	// Identifier of the cache. Length is limited to 128.
	// Defaults to path.
	// See also BuildInfra.Swarming.CacheEntry.name in build.proto.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Relative path where the cache in mapped into. Required.
	// See also BuildInfra.Swarming.CacheEntry.path in build.proto.
	Path string `protobuf:"bytes,2,opt,name=path,proto3" json:"path,omitempty"`
	// Number of seconds to wait for a bot with a warm cache to pick up the
	// task, before falling back to a bot with a cold (non-existent) cache.
	// See also BuildInfra.Swarming.CacheEntry.wait_for_warm_cache in build.proto.
	// The value must be multiples of 60 seconds.
	WaitForWarmCacheSecs int32 `` /* 128-byte string literal not displayed */
	// Environment variable with this name will be set to the path to the cache
	// directory.
	EnvVar string `protobuf:"bytes,4,opt,name=env_var,json=envVar,proto3" json:"env_var,omitempty"`
	// contains filtered or unexported fields
}

Describes a cache directory persisted on a bot. Prerequisite reading in BuildInfra.Swarming.CacheEntry message in build.proto.

To share a builder cache among multiple builders, it can be overridden: 

builders {
  name: "a"
  caches {
    path: "builder"
    name: "my_shared_cache"
  }
}
builders {
  name: "b"
  caches {
    path: "builder"
    name: "my_shared_cache"
  }
}

Builders "a" and "b" share their builder cache. If an "a" build ran on a bot and left some files in the builder cache and then a "b" build runs on the same bot, the same files will be available in the builder cache.

func (*Builder_CacheEntry) Descriptor deprecated 

func (*Builder_CacheEntry) Descriptor() ([]byte, []int)

Deprecated: Use Builder_CacheEntry.ProtoReflect.Descriptor instead.

func (*Builder_CacheEntry) GetEnvVar 

func (x *Builder_CacheEntry) GetEnvVar() string

func (*Builder_CacheEntry) GetName 

func (x *Builder_CacheEntry) GetName() string

func (*Builder_CacheEntry) GetPath 

func (x *Builder_CacheEntry) GetPath() string

func (*Builder_CacheEntry) GetWaitForWarmCacheSecs 

func (x *Builder_CacheEntry) GetWaitForWarmCacheSecs() int32

func (*Builder_CacheEntry) ProtoMessage 

func (*Builder_CacheEntry) ProtoMessage()

func (*Builder_CacheEntry) ProtoReflect 

func (x *Builder_CacheEntry) ProtoReflect() protoreflect.Message

func (*Builder_CacheEntry) Reset 

func (x *Builder_CacheEntry) Reset()

func (*Builder_CacheEntry) String 

func (x *Builder_CacheEntry) String() string

type Builder_Recipe 

type Builder_Recipe struct {

	// Name of the recipe to run.
	Name string `protobuf:"bytes,2,opt,name=name,proto3" json:"name,omitempty"`
	// The CIPD package to fetch the recipes from.
	//
	// Typically the package will look like:
	//
	//   infra/recipe_bundles/chromium.googlesource.com/chromium/tools/build
	//
	// Recipes bundled from internal repositories are typically under
	// `infra_internal/recipe_bundles/...`.
	//
	// But if you're building your own recipe bundles, they could be located
	// elsewhere.
	CipdPackage string `protobuf:"bytes,6,opt,name=cipd_package,json=cipdPackage,proto3" json:"cipd_package,omitempty"`
	// The CIPD version to fetch. This can be a lower-cased git ref (like
	// `refs/heads/master` or `head`), or it can be a cipd tag (like
	// `git_revision:dead...beef`).
	//
	// The default is `head`, which corresponds to the git repo's HEAD ref. This
	// is typically (but not always) a symbolic ref for `refs/heads/master`.
	CipdVersion string `protobuf:"bytes,5,opt,name=cipd_version,json=cipdVersion,proto3" json:"cipd_version,omitempty"`
	// Colon-separated build properties to set.
	// Ignored if Builder.properties is set.
	//
	// Use this field for string properties and use properties_j for other
	// types.
	Properties []string `protobuf:"bytes,3,rep,name=properties,proto3" json:"properties,omitempty"`
	// Same as properties, but the value must valid JSON. For example
	//   properties_j: "a:1"
	// means property a is a number 1, not string "1".
	//
	// If null, it means no property must be defined. In particular, it removes
	// a default value for the property, if any.
	//
	// Fields properties and properties_j can be used together, but cannot both
	// specify values for same property.
	PropertiesJ []string `protobuf:"bytes,4,rep,name=properties_j,json=propertiesJ,proto3" json:"properties_j,omitempty"`
	// contains filtered or unexported fields
}

DEPRECATED. See Builder.executable and Builder.properties

To specify a recipe name, pass "$recipe_engine" property which is a JSON object having "recipe" property.

func (*Builder_Recipe) Descriptor deprecated 

func (*Builder_Recipe) Descriptor() ([]byte, []int)

Deprecated: Use Builder_Recipe.ProtoReflect.Descriptor instead.

func (*Builder_Recipe) GetCipdPackage 

func (x *Builder_Recipe) GetCipdPackage() string

func (*Builder_Recipe) GetCipdVersion 

func (x *Builder_Recipe) GetCipdVersion() string

func (*Builder_Recipe) GetName 

func (x *Builder_Recipe) GetName() string

func (*Builder_Recipe) GetProperties 

func (x *Builder_Recipe) GetProperties() []string

func (*Builder_Recipe) GetPropertiesJ 

func (x *Builder_Recipe) GetPropertiesJ() []string

func (*Builder_Recipe) ProtoMessage 

func (*Builder_Recipe) ProtoMessage()

func (*Builder_Recipe) ProtoReflect 

func (x *Builder_Recipe) ProtoReflect() protoreflect.Message

func (*Builder_Recipe) Reset 

func (x *Builder_Recipe) Reset()

func (*Builder_Recipe) String 

func (x *Builder_Recipe) String() string

type Builder_ResultDB 

type Builder_ResultDB struct {

	// Whether to enable ResultDB:Buildbucket integration.
	Enable bool `protobuf:"varint,1,opt,name=enable,proto3" json:"enable,omitempty"`
	// Configuration for exporting test results to BigQuery.
	// This can have multiple values to export results to multiple BigQuery
	// tables, or to support multiple test result predicates.
	BqExports []*v1.BigQueryExport `protobuf:"bytes,2,rep,name=bq_exports,json=bqExports,proto3" json:"bq_exports,omitempty"`
	// contains filtered or unexported fields
}

ResultDB-specific information for a builder.

func (*Builder_ResultDB) Descriptor deprecated 

func (*Builder_ResultDB) Descriptor() ([]byte, []int)

Deprecated: Use Builder_ResultDB.ProtoReflect.Descriptor instead.

func (*Builder_ResultDB) GetBqExports 

func (x *Builder_ResultDB) GetBqExports() []*v1.BigQueryExport

func (*Builder_ResultDB) GetEnable 

func (x *Builder_ResultDB) GetEnable() bool

func (*Builder_ResultDB) ProtoMessage 

func (*Builder_ResultDB) ProtoMessage()

func (*Builder_ResultDB) ProtoReflect 

func (x *Builder_ResultDB) ProtoReflect() protoreflect.Message

func (*Builder_ResultDB) Reset 

func (x *Builder_ResultDB) Reset()

func (*Builder_ResultDB) String 

func (x *Builder_ResultDB) String() string

type BuildersClient 

type BuildersClient interface {
	// Looks up one builder.
	GetBuilder(ctx context.Context, in *GetBuilderRequest, opts ...grpc.CallOption) (*BuilderItem, error)
	// Lists all builders of a project or a bucket.
	ListBuilders(ctx context.Context, in *ListBuildersRequest, opts ...grpc.CallOption) (*ListBuildersResponse, error)
}

BuildersClient is the client API for Builders service.

For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream.

func NewBuildersClient 

func NewBuildersClient(cc grpc.ClientConnInterface) BuildersClient

func NewBuildersPRPCClient 

func NewBuildersPRPCClient(client *prpc.Client) BuildersClient

type BuildersServer 

type BuildersServer interface {
	// Looks up one builder.
	GetBuilder(context.Context, *GetBuilderRequest) (*BuilderItem, error)
	// Lists all builders of a project or a bucket.
	ListBuilders(context.Context, *ListBuildersRequest) (*ListBuildersResponse, error)
}

BuildersServer is the server API for Builders service.

type BuildsClient 

type BuildsClient interface {
	// Gets a build.
	//
	// By default the returned build does not include all fields.
	// See GetBuildRequest.fields.
	//
	// Buildbot: if the specified build is a buildbot build, converts it to Build
	// message with the following rules:
	// * bucket names are full, e.g. "master.chromium". Note that LUCI buckets
	//   in v2 are shortened, e.g. "ci".
	// * if a v2 Build field does not make sense in V1, it is unset/empty.
	// * step support is not implemented for Buildbot builds.
	// Note that it does not support getting a buildbot build by build number.
	GetBuild(ctx context.Context, in *GetBuildRequest, opts ...grpc.CallOption) (*Build, error)
	// Searches for builds.
	//
	// Buildbot: can return Buildbot builds, see GetBuild for conversion rules.
	// For example, response may include a mix of LUCI and Buildbot builds if the
	// predicate is a CL.
	// Cannot search in a buildbot bucket or buildbot builder, e.g.
	// {
	//   "predicate": {
	//     "builder": {
	//       "project": "chromium",
	//       "bucket": "master.chromium",
	//       "builder": "linux-rel"
	//     }
	//   }
	// }
	// will look for builds in "master.chromium" LUCI bucket which probably does
	// not exist.
	SearchBuilds(ctx context.Context, in *SearchBuildsRequest, opts ...grpc.CallOption) (*SearchBuildsResponse, error)
	// Updates a build. Returns an empty build.
	//
	// RPC metadata must include "X-Build-Token" key with a token
	// generated by the server when scheduling the build.
	UpdateBuild(ctx context.Context, in *UpdateBuildRequest, opts ...grpc.CallOption) (*Build, error)
	// Schedules a new build.
	// The requester must have at least SCHEDULER role in the destination bucket.
	ScheduleBuild(ctx context.Context, in *ScheduleBuildRequest, opts ...grpc.CallOption) (*Build, error)
	// Cancels a build.
	// The requester must have at least SCHEDULER role in the destination bucket.
	// Note that cancelling a build in ended state (meaning build is not in
	// STATUS_UNSPECIFIED, SCHEDULED or STARTED status) will be a no-op and
	// directly return up-to-date Build message
	CancelBuild(ctx context.Context, in *CancelBuildRequest, opts ...grpc.CallOption) (*Build, error)
	// Executes multiple requests in a batch.
	// The response code is always OK.
	Batch(ctx context.Context, in *BatchRequest, opts ...grpc.CallOption) (*BatchResponse, error)
}

BuildsClient is the client API for Builds service.

For semantics around ctx use and closing/ending streaming RPCs, please refer to https://godoc.org/google.golang.org/grpc#ClientConn.NewStream.

func NewBuildsClient 

func NewBuildsClient(cc grpc.ClientConnInterface) BuildsClient

func NewBuildsPRPCClient 

func NewBuildsPRPCClient(client *prpc.Client) BuildsClient

type BuildsServer 

type BuildsServer interface {
	// Gets a build.
	//
	// By default the returned build does not include all fields.
	// See GetBuildRequest.fields.
	//
	// Buildbot: if the specified build is a buildbot build, converts it to Build
	// message with the following rules:
	// * bucket names are full, e.g. "master.chromium". Note that LUCI buckets
	//   in v2 are shortened, e.g. "ci".
	// * if a v2 Build field does not make sense in V1, it is unset/empty.
	// * step support is not implemented for Buildbot builds.
	// Note that it does not support getting a buildbot build by build number.
	GetBuild(context.Context, *GetBuildRequest) (*Build, error)
	// Searches for builds.
	//
	// Buildbot: can return Buildbot builds, see GetBuild for conversion rules.
	// For example, response may include a mix of LUCI and Buildbot builds if the
	// predicate is a CL.
	// Cannot search in a buildbot bucket or buildbot builder, e.g.
	// {
	//   "predicate": {
	//     "builder": {
	//       "project": "chromium",
	//       "bucket": "master.chromium",
	//       "builder": "linux-rel"
	//     }
	//   }
	// }
	// will look for builds in "master.chromium" LUCI bucket which probably does
	// not exist.
	SearchBuilds(context.Context, *SearchBuildsRequest) (*SearchBuildsResponse, error)
	// Updates a build. Returns an empty build.
	//
	// RPC metadata must include "X-Build-Token" key with a token
	// generated by the server when scheduling the build.
	UpdateBuild(context.Context, *UpdateBuildRequest) (*Build, error)
	// Schedules a new build.
	// The requester must have at least SCHEDULER role in the destination bucket.
	ScheduleBuild(context.Context, *ScheduleBuildRequest) (*Build, error)
	// Cancels a build.
	// The requester must have at least SCHEDULER role in the destination bucket.
	// Note that cancelling a build in ended state (meaning build is not in
	// STATUS_UNSPECIFIED, SCHEDULED or STARTED status) will be a no-op and
	// directly return up-to-date Build message
	CancelBuild(context.Context, *CancelBuildRequest) (*Build, error)
	// Executes multiple requests in a batch.
	// The response code is always OK.
	Batch(context.Context, *BatchRequest) (*BatchResponse, error)
}

BuildsServer is the server API for Builds service.

type CancelBuildRequest 

type CancelBuildRequest struct {

	// ID of the build to cancel.
	Id int64 `protobuf:"varint,1,opt,name=id,proto3" json:"id,omitempty"`
	// Required. Value for Build.summary_markdown.
	SummaryMarkdown string `protobuf:"bytes,2,opt,name=summary_markdown,json=summaryMarkdown,proto3" json:"summary_markdown,omitempty"`
	// Fields to include in the response. See also GetBuildRequest.fields.
	Fields *field_mask.FieldMask `protobuf:"bytes,100,opt,name=fields,proto3" json:"fields,omitempty"`
	// contains filtered or unexported fields
}

A request message for CancelBuild rpc.

func (*CancelBuildRequest) Descriptor deprecated 

func (*CancelBuildRequest) Descriptor() ([]byte, []int)

Deprecated: Use CancelBuildRequest.ProtoReflect.Descriptor instead.

func (*CancelBuildRequest) GetFields 

func (x *CancelBuildRequest) GetFields() *field_mask.FieldMask

func (*CancelBuildRequest) GetId 

func (x *CancelBuildRequest) GetId() int64

func (*CancelBuildRequest) GetSummaryMarkdown 

func (x *CancelBuildRequest) GetSummaryMarkdown() string

func (*CancelBuildRequest) ProtoMessage 

func (*CancelBuildRequest) ProtoMessage()

func (*CancelBuildRequest) ProtoReflect 

func (x *CancelBuildRequest) ProtoReflect() protoreflect.Message

func (*CancelBuildRequest) Reset 

func (x *CancelBuildRequest) Reset()

func (*CancelBuildRequest) String 

func (x *CancelBuildRequest) String() string

type DecoratedBuilders 

type DecoratedBuilders struct {
	// Service is the service to decorate.
	Service BuildersServer
	// Prelude is called for each method before forwarding the call to Service.
	// If Prelude returns an error, then the call is skipped and the error is
	// processed via the Postlude (if one is defined), or it is returned directly.
	Prelude func(ctx context.Context, methodName string, req proto.Message) (context.Context, error)
	// Postlude is called for each method after Service has processed the call, or
	// after the Prelude has returned an error. This takes the the Service's
	// response proto (which may be nil) and/or any error. The decorated
	// service will return the response (possibly mutated) and error that Postlude
	// returns.
	Postlude func(ctx context.Context, methodName string, rsp proto.Message, err error) error
}

func (*DecoratedBuilders) GetBuilder 

func (s *DecoratedBuilders) GetBuilder(ctx context.Context, req *GetBuilderRequest) (rsp *BuilderItem, err error)

func (*DecoratedBuilders) ListBuilders 

func (s *DecoratedBuilders) ListBuilders(ctx context.Context, req *ListBuildersRequest) (rsp *ListBuildersResponse, err error)

type DecoratedBuilds 

type DecoratedBuilds struct {
	// Service is the service to decorate.
	Service BuildsServer
	// Prelude is called for each method before forwarding the call to Service.
	// If Prelude returns an error, then the call is skipped and the error is
	// processed via the Postlude (if one is defined), or it is returned directly.
	Prelude func(ctx context.Context, methodName string, req proto.Message) (context.Context, error)
	// Postlude is called for each method after Service has processed the call, or
	// after the Prelude has returned an error. This takes the the Service's
	// response proto (which may be nil) and/or any error. The decorated
	// service will return the response (possibly mutated) and error that Postlude
	// returns.
	Postlude func(ctx context.Context, methodName string, rsp proto.Message, err error) error
}

func (*DecoratedBuilds) Batch 

func (s *DecoratedBuilds) Batch(ctx context.Context, req *BatchRequest) (rsp *BatchResponse, err error)

func (*DecoratedBuilds) CancelBuild 

func (s *DecoratedBuilds) CancelBuild(ctx context.Context, req *CancelBuildRequest) (rsp *Build, err error)

func (*DecoratedBuilds) GetBuild 

func (s *DecoratedBuilds) GetBuild(ctx context.Context, req *GetBuildRequest) (rsp *Build, err error)

func (*DecoratedBuilds) ScheduleBuild 

func (s *DecoratedBuilds) ScheduleBuild(ctx context.Context, req *ScheduleBuildRequest) (rsp *Build, err error)

func (*DecoratedBuilds) SearchBuilds 

func (s *DecoratedBuilds) SearchBuilds(ctx context.Context, req *SearchBuildsRequest) (rsp *SearchBuildsResponse, err error)

func (*DecoratedBuilds) UpdateBuild 

func (s *DecoratedBuilds) UpdateBuild(ctx context.Context, req *UpdateBuildRequest) (rsp *Build, err error)

type Executable 

type Executable struct {

	// The CIPD package containing the executable.
	//
	// See the `cmd` field below for how the executable will be located within the
	// package.
	CipdPackage string `protobuf:"bytes,1,opt,name=cipd_package,json=cipdPackage,proto3" json:"cipd_package,omitempty"`
	// The CIPD version to fetch.
	//
	// Optional. If omitted, this defaults to `latest`.
	CipdVersion string `protobuf:"bytes,2,opt,name=cipd_version,json=cipdVersion,proto3" json:"cipd_version,omitempty"`
	// The command to invoke within the package.
	//
	// The 0th argument is taken as relative to the cipd_package root (a.k.a.
	// BBAgentArgs.payload_path), so "foo" would invoke the binary called "foo" in
	// the root of the package. On Windows, this will automatically look
	// first for ".exe" and ".bat" variants. Similarly, "subdir/foo" would
	// look for "foo" in "subdir" of the CIPD package.
	//
	// The other arguments are passed verbatim to the executable.
	//
	// The 'build.proto' binary message will always be passed to stdin, even when
	// this command has arguments (see go.chromium.org/luci/luciexe).
	//
	// RECOMMENDATION: It's advised to rely on the build.proto's Input.Properties
	// field for passing task-specific data. Properties are JSON-typed and can be
	// modeled with a protobuf (using JSONPB). However, supplying additional args
	// can be useful to, e.g., increase logging verbosity, or similar
	// 'system level' settings within the binary.
	//
	// Optional. If omitted, defaults to `['luciexe']`.
	Cmd []string `protobuf:"bytes,3,rep,name=cmd,proto3" json:"cmd,omitempty"`
	// contains filtered or unexported fields
}

An executable to run when the build is ready to start.

Please refer to go.chromium.org/luci/luciexe for the protocol this executable is expected to implement.

In addition to the "Host Application" responsibilities listed there, buildbucket will also ensure that $CWD points to an empty directory when it starts the build.

func (*Executable) Descriptor deprecated 

func (*Executable) Descriptor() ([]byte, []int)

Deprecated: Use Executable.ProtoReflect.Descriptor instead.

func (*Executable) GetCipdPackage 

func (x *Executable) GetCipdPackage() string

func (*Executable) GetCipdVersion 

func (x *Executable) GetCipdVersion() string

func (*Executable) GetCmd 

func (x *Executable) GetCmd() []string

func (*Executable) ProtoMessage 

func (*Executable) ProtoMessage()

func (*Executable) ProtoReflect 

func (x *Executable) ProtoReflect() protoreflect.Message

func (*Executable) Reset 

func (x *Executable) Reset()

func (*Executable) String 

func (x *Executable) String() string

type GerritChange 

type GerritChange struct {

	// Gerrit hostname, e.g. "chromium-review.googlesource.com".
	Host string `protobuf:"bytes,1,opt,name=host,proto3" json:"host,omitempty"`
	// Gerrit project, e.g. "chromium/src".
	Project string `protobuf:"bytes,2,opt,name=project,proto3" json:"project,omitempty"`
	// Change number, e.g. 12345.
	Change int64 `protobuf:"varint,3,opt,name=change,proto3" json:"change,omitempty"`
	// Patch set number, e.g. 1.
	Patchset int64 `protobuf:"varint,4,opt,name=patchset,proto3" json:"patchset,omitempty"`
	// contains filtered or unexported fields
}

A Gerrit patchset.

func (*GerritChange) Descriptor deprecated 

func (*GerritChange) Descriptor() ([]byte, []int)

Deprecated: Use GerritChange.ProtoReflect.Descriptor instead.

func (*GerritChange) GetChange 

func (x *GerritChange) GetChange() int64

func (*GerritChange) GetHost 

func (x *GerritChange) GetHost() string

func (*GerritChange) GetPatchset 

func (x *GerritChange) GetPatchset() int64

func (*GerritChange) GetProject 

func (x *GerritChange) GetProject() string

func (*GerritChange) ProtoMessage 

func (*GerritChange) ProtoMessage()

func (*GerritChange) ProtoReflect 

func (x *GerritChange) ProtoReflect() protoreflect.Message

func (*GerritChange) Reset 

func (x *GerritChange) Reset()

func (*GerritChange) String 

func (x *GerritChange) String() string

type GetBuildRequest 

type GetBuildRequest struct {

	// Build id.
	// Mutually exclusive with builder and number.
	Id int64 `protobuf:"varint,1,opt,name=id,proto3" json:"id,omitempty"`
	// Builder of the build.
	// Requires number. Mutually exclusive with id.
	Builder *BuilderID `protobuf:"bytes,2,opt,name=builder,proto3" json:"builder,omitempty"`
	// Build number.
	// Requires builder. Mutually exclusive with id.
	BuildNumber int32 `protobuf:"varint,3,opt,name=build_number,json=buildNumber,proto3" json:"build_number,omitempty"`
	// Fields to include in the response.
	// If not set, the default mask is used, see Build message comments for the
	// list of fields returned by default.
	//
	// Supports advanced semantics, see
	// https://chromium.googlesource.com/infra/luci/luci-py/+/f9ae69a37c4bdd0e08a8b0f7e123f6e403e774eb/appengine/components/components/protoutil/field_masks.py#7
	// In particular, if the client needs only some output properties, they
	// can be requested with paths "output.properties.fields.foo".
	Fields *field_mask.FieldMask `protobuf:"bytes,100,opt,name=fields,proto3" json:"fields,omitempty"`
	// contains filtered or unexported fields
}

A request message for GetBuild rpc.

func (*GetBuildRequest) Descriptor deprecated 

func (*GetBuildRequest) Descriptor() ([]byte, []int)

Deprecated: Use GetBuildRequest.ProtoReflect.Descriptor instead.

func (*GetBuildRequest) GetBuildNumber 

func (x *GetBuildRequest) GetBuildNumber() int32

func (*GetBuildRequest) GetBuilder 

func (x *GetBuildRequest) GetBuilder() *BuilderID

func (*GetBuildRequest) GetFields 

func (x *GetBuildRequest) GetFields() *field_mask.FieldMask

func (*GetBuildRequest) GetId 

func (x *GetBuildRequest) GetId() int64

func (*GetBuildRequest) ProtoMessage 

func (*GetBuildRequest) ProtoMessage()

func (*GetBuildRequest) ProtoReflect 

func (x *GetBuildRequest) ProtoReflect() protoreflect.Message

func (*GetBuildRequest) Reset 

func (x *GetBuildRequest) Reset()

func (*GetBuildRequest) String 

func (x *GetBuildRequest) String() string

type GetBuilderRequest 

type GetBuilderRequest struct {

	// ID of the builder to return.
	Id *BuilderID `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	// contains filtered or unexported fields
}

A request message for GetBuilder rpc.

func (*GetBuilderRequest) Descriptor deprecated 

func (*GetBuilderRequest) Descriptor() ([]byte, []int)

Deprecated: Use GetBuilderRequest.ProtoReflect.Descriptor instead.

func (*GetBuilderRequest) GetId 

func (x *GetBuilderRequest) GetId() *BuilderID

func (*GetBuilderRequest) ProtoMessage 

func (*GetBuilderRequest) ProtoMessage()

func (*GetBuilderRequest) ProtoReflect 

func (x *GetBuilderRequest) ProtoReflect() protoreflect.Message

func (*GetBuilderRequest) Reset 

func (x *GetBuilderRequest) Reset()

func (*GetBuilderRequest) String 

func (x *GetBuilderRequest) String() string

type GitilesCommit 

type GitilesCommit struct {

	// Gitiles hostname, e.g. "chromium.googlesource.com".
	Host string `protobuf:"bytes,1,opt,name=host,proto3" json:"host,omitempty"`
	// Repository name on the host, e.g. "chromium/src".
	Project string `protobuf:"bytes,2,opt,name=project,proto3" json:"project,omitempty"`
	// Commit HEX SHA1.
	Id string `protobuf:"bytes,3,opt,name=id,proto3" json:"id,omitempty"`
	// Commit ref, e.g. "refs/heads/master".
	// NOT a branch name: if specified, must start with "refs/".
	Ref string `protobuf:"bytes,4,opt,name=ref,proto3" json:"ref,omitempty"`
	// Defines a total order of commits on the ref. Requires ref field.
	// Typically 1-based, monotonically increasing, contiguous integer
	// defined by a Gerrit plugin, goto.google.com/git-numberer.
	// TODO(tandrii): make it a public doc.
	Position uint32 `protobuf:"varint,5,opt,name=position,proto3" json:"position,omitempty"`
	// contains filtered or unexported fields
}

A landed Git commit hosted on Gitiles.

func (*GitilesCommit) Descriptor deprecated 

func (*GitilesCommit) Descriptor() ([]byte, []int)

Deprecated: Use GitilesCommit.ProtoReflect.Descriptor instead.

func (*GitilesCommit) GetHost 

func (x *GitilesCommit) GetHost() string

func (*GitilesCommit) GetId 

func (x *GitilesCommit) GetId() string

func (*GitilesCommit) GetPosition 

func (x *GitilesCommit) GetPosition() uint32

func (*GitilesCommit) GetProject 

func (x *GitilesCommit) GetProject() string

func (*GitilesCommit) GetRef 

func (x *GitilesCommit) GetRef() string

func (*GitilesCommit) ProtoMessage 

func (*GitilesCommit) ProtoMessage()

func (*GitilesCommit) ProtoReflect 

func (x *GitilesCommit) ProtoReflect() protoreflect.Message

func (*GitilesCommit) Reset 

func (x *GitilesCommit) Reset()

func (*GitilesCommit) String 

func (x *GitilesCommit) String() string

type ListBuildersRequest 

type ListBuildersRequest struct {

	// LUCI project, e.g. "chromium".
	Project string `protobuf:"bytes,1,opt,name=project,proto3" json:"project,omitempty"`
	// A bucket in the project, e.g. "try".
	Bucket string `protobuf:"bytes,2,opt,name=bucket,proto3" json:"bucket,omitempty"`
	// The maximum number of builders to return.
	//
	// The service may return fewer than this value.
	// If unspecified, at most 100 builders will be returned.
	// The maximum value is 1000; values above 1000 will be coerced to 1000.
	PageSize int32 `protobuf:"varint,3,opt,name=page_size,json=pageSize,proto3" json:"page_size,omitempty"`
	// A page token, received from a previous `ListBuilders` call.
	// Provide this to retrieve the subsequent page.
	//
	// When paginating, all other parameters provided to `ListBuilders` MUST
	// match the call that provided the page token.
	PageToken string `protobuf:"bytes,4,opt,name=page_token,json=pageToken,proto3" json:"page_token,omitempty"`
	// contains filtered or unexported fields
}

A request message for ListBuilders.

func (*ListBuildersRequest) Descriptor deprecated 

func (*ListBuildersRequest) Descriptor() ([]byte, []int)

Deprecated: Use ListBuildersRequest.ProtoReflect.Descriptor instead.

func (*ListBuildersRequest) GetBucket 

func (x *ListBuildersRequest) GetBucket() string

func (*ListBuildersRequest) GetPageSize 

func (x *ListBuildersRequest) GetPageSize() int32

func (*ListBuildersRequest) GetPageToken 

func (x *ListBuildersRequest) GetPageToken() string

func (*ListBuildersRequest) GetProject 

func (x *ListBuildersRequest) GetProject() string

func (*ListBuildersRequest) ProtoMessage 

func (*ListBuildersRequest) ProtoMessage()

func (*ListBuildersRequest) ProtoReflect 

func (x *ListBuildersRequest) ProtoReflect() protoreflect.Message

func (*ListBuildersRequest) Reset 

func (x *ListBuildersRequest) Reset()

func (*ListBuildersRequest) String 

func (x *ListBuildersRequest) String() string

type ListBuildersResponse 

type ListBuildersResponse struct {

	// Matched builders.
	Builders []*BuilderItem `protobuf:"bytes,1,rep,name=builders,proto3" json:"builders,omitempty"`
	// A token, which can be sent as `page_token` to retrieve the next page.
	// If this field is omitted, there were no subsequent pages at the time of
	// request.
	// If the invocation is not finalized, more results may appear later.
	NextPageToken string `protobuf:"bytes,2,opt,name=next_page_token,json=nextPageToken,proto3" json:"next_page_token,omitempty"`
	// contains filtered or unexported fields
}

A response message for ListBuilders.

func (*ListBuildersResponse) Descriptor deprecated 

func (*ListBuildersResponse) Descriptor() ([]byte, []int)

Deprecated: Use ListBuildersResponse.ProtoReflect.Descriptor instead.

func (*ListBuildersResponse) GetBuilders 

func (x *ListBuildersResponse) GetBuilders() []*BuilderItem

func (*ListBuildersResponse) GetNextPageToken 

func (x *ListBuildersResponse) GetNextPageToken() string

func (*ListBuildersResponse) ProtoMessage 

func (*ListBuildersResponse) ProtoMessage()

func (*ListBuildersResponse) ProtoReflect 

func (x *ListBuildersResponse) ProtoReflect() protoreflect.Message

func (*ListBuildersResponse) Reset 

func (x *ListBuildersResponse) Reset()

func (*ListBuildersResponse) String 

func (x *ListBuildersResponse) String() string

type Log 

type Log struct {

	// Log name, standard ("stdout", "stderr") or custom (e.g. "json.output").
	// Unique within the containing message (step or build).
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// URL of a Human-readable page that displays log contents.
	ViewUrl string `protobuf:"bytes,2,opt,name=view_url,json=viewUrl,proto3" json:"view_url,omitempty"`
	// URL of the log content.
	// As of 2018-09-06, the only supported scheme is "logdog".
	// Typically it has form
	// "logdog://<host>/<project>/<prefix>/+/<stream_name>".
	// See also
	// https://godoc.org/go.chromium.org/luci/logdog/common/types#ParseURL
	Url string `protobuf:"bytes,3,opt,name=url,proto3" json:"url,omitempty"`
	// contains filtered or unexported fields
}

A named log of a step or build.

func (*Log) Descriptor deprecated 

func (*Log) Descriptor() ([]byte, []int)

Deprecated: Use Log.ProtoReflect.Descriptor instead.

func (*Log) GetName 

func (x *Log) GetName() string

func (*Log) GetUrl 

func (x *Log) GetUrl() string

func (*Log) GetViewUrl 

func (x *Log) GetViewUrl() string

func (*Log) ProtoMessage 

func (*Log) ProtoMessage()

func (*Log) ProtoReflect 

func (x *Log) ProtoReflect() protoreflect.Message

func (*Log) Reset 

func (x *Log) Reset()

func (*Log) String 

func (x *Log) String() string

type LogDogSettings 

type LogDogSettings struct {

	// Hostname of the LogDog instance to use, e.g. "logs.chromium.org".
	Hostname string `protobuf:"bytes,1,opt,name=hostname,proto3" json:"hostname,omitempty"`
	// contains filtered or unexported fields
}

func (*LogDogSettings) Descriptor deprecated 

func (*LogDogSettings) Descriptor() ([]byte, []int)

Deprecated: Use LogDogSettings.ProtoReflect.Descriptor instead.

func (*LogDogSettings) GetHostname 

func (x *LogDogSettings) GetHostname() string

func (*LogDogSettings) ProtoMessage 

func (*LogDogSettings) ProtoMessage()

func (*LogDogSettings) ProtoReflect 

func (x *LogDogSettings) ProtoReflect() protoreflect.Message

func (*LogDogSettings) Reset 

func (x *LogDogSettings) Reset()

func (*LogDogSettings) String 

func (x *LogDogSettings) String() string

type MockBuildsClient 

type MockBuildsClient struct {
	// contains filtered or unexported fields
}

MockBuildsClient is a mock of BuildsClient interface.

func NewMockBuildsClient 

func NewMockBuildsClient(ctrl *gomock.Controller) *MockBuildsClient

NewMockBuildsClient creates a new mock instance.

func (*MockBuildsClient) Batch 

func (m *MockBuildsClient) Batch(ctx context.Context, in *BatchRequest, opts ...grpc.CallOption) (*BatchResponse, error)

Batch mocks base method.

func (*MockBuildsClient) CancelBuild 

func (m *MockBuildsClient) CancelBuild(ctx context.Context, in *CancelBuildRequest, opts ...grpc.CallOption) (*Build, error)

CancelBuild mocks base method.

func (*MockBuildsClient) EXPECT 

func (m *MockBuildsClient) EXPECT() *MockBuildsClientMockRecorder

EXPECT returns an object that allows the caller to indicate expected use.

func (*MockBuildsClient) GetBuild 

func (m *MockBuildsClient) GetBuild(ctx context.Context, in *GetBuildRequest, opts ...grpc.CallOption) (*Build, error)

GetBuild mocks base method.

func (*MockBuildsClient) ScheduleBuild 

func (m *MockBuildsClient) ScheduleBuild(ctx context.Context, in *ScheduleBuildRequest, opts ...grpc.CallOption) (*Build, error)

ScheduleBuild mocks base method.

func (*MockBuildsClient) SearchBuilds 

func (m *MockBuildsClient) SearchBuilds(ctx context.Context, in *SearchBuildsRequest, opts ...grpc.CallOption) (*SearchBuildsResponse, error)

SearchBuilds mocks base method.

func (*MockBuildsClient) UpdateBuild 

func (m *MockBuildsClient) UpdateBuild(ctx context.Context, in *UpdateBuildRequest, opts ...grpc.CallOption) (*Build, error)

UpdateBuild mocks base method.

type MockBuildsClientMockRecorder 

type MockBuildsClientMockRecorder struct {
	// contains filtered or unexported fields
}

MockBuildsClientMockRecorder is the mock recorder for MockBuildsClient.

func (*MockBuildsClientMockRecorder) Batch 

func (mr *MockBuildsClientMockRecorder) Batch(ctx, in interface{}, opts ...interface{}) *gomock.Call

Batch indicates an expected call of Batch.

func (*MockBuildsClientMockRecorder) CancelBuild 

func (mr *MockBuildsClientMockRecorder) CancelBuild(ctx, in interface{}, opts ...interface{}) *gomock.Call

CancelBuild indicates an expected call of CancelBuild.

func (*MockBuildsClientMockRecorder) GetBuild 

func (mr *MockBuildsClientMockRecorder) GetBuild(ctx, in interface{}, opts ...interface{}) *gomock.Call

GetBuild indicates an expected call of GetBuild.

func (*MockBuildsClientMockRecorder) ScheduleBuild 

func (mr *MockBuildsClientMockRecorder) ScheduleBuild(ctx, in interface{}, opts ...interface{}) *gomock.Call

ScheduleBuild indicates an expected call of ScheduleBuild.

func (*MockBuildsClientMockRecorder) SearchBuilds 

func (mr *MockBuildsClientMockRecorder) SearchBuilds(ctx, in interface{}, opts ...interface{}) *gomock.Call

SearchBuilds indicates an expected call of SearchBuilds.

func (*MockBuildsClientMockRecorder) UpdateBuild 

func (mr *MockBuildsClientMockRecorder) UpdateBuild(ctx, in interface{}, opts ...interface{}) *gomock.Call

UpdateBuild indicates an expected call of UpdateBuild.

type MockBuildsServer 

type MockBuildsServer struct {
	// contains filtered or unexported fields
}

MockBuildsServer is a mock of BuildsServer interface.

func NewMockBuildsServer 

func NewMockBuildsServer(ctrl *gomock.Controller) *MockBuildsServer

NewMockBuildsServer creates a new mock instance.

func (*MockBuildsServer) Batch 

func (m *MockBuildsServer) Batch(arg0 context.Context, arg1 *BatchRequest) (*BatchResponse, error)

Batch mocks base method.

func (*MockBuildsServer) CancelBuild 

func (m *MockBuildsServer) CancelBuild(arg0 context.Context, arg1 *CancelBuildRequest) (*Build, error)

CancelBuild mocks base method.

func (*MockBuildsServer) EXPECT 

func (m *MockBuildsServer) EXPECT() *MockBuildsServerMockRecorder

EXPECT returns an object that allows the caller to indicate expected use.

func (*MockBuildsServer) GetBuild 

func (m *MockBuildsServer) GetBuild(arg0 context.Context, arg1 *GetBuildRequest) (*Build, error)

GetBuild mocks base method.

func (*MockBuildsServer) ScheduleBuild 

func (m *MockBuildsServer) ScheduleBuild(arg0 context.Context, arg1 *ScheduleBuildRequest) (*Build, error)

ScheduleBuild mocks base method.

func (*MockBuildsServer) SearchBuilds 

func (m *MockBuildsServer) SearchBuilds(arg0 context.Context, arg1 *SearchBuildsRequest) (*SearchBuildsResponse, error)

SearchBuilds mocks base method.

func (*MockBuildsServer) UpdateBuild 

func (m *MockBuildsServer) UpdateBuild(arg0 context.Context, arg1 *UpdateBuildRequest) (*Build, error)

UpdateBuild mocks base method.

type MockBuildsServerMockRecorder 

type MockBuildsServerMockRecorder struct {
	// contains filtered or unexported fields
}

MockBuildsServerMockRecorder is the mock recorder for MockBuildsServer.

func (*MockBuildsServerMockRecorder) Batch 

func (mr *MockBuildsServerMockRecorder) Batch(arg0, arg1 interface{}) *gomock.Call

Batch indicates an expected call of Batch.

func (*MockBuildsServerMockRecorder) CancelBuild 

func (mr *MockBuildsServerMockRecorder) CancelBuild(arg0, arg1 interface{}) *gomock.Call

CancelBuild indicates an expected call of CancelBuild.

func (*MockBuildsServerMockRecorder) GetBuild 

func (mr *MockBuildsServerMockRecorder) GetBuild(arg0, arg1 interface{}) *gomock.Call

GetBuild indicates an expected call of GetBuild.

func (*MockBuildsServerMockRecorder) ScheduleBuild 

func (mr *MockBuildsServerMockRecorder) ScheduleBuild(arg0, arg1 interface{}) *gomock.Call

ScheduleBuild indicates an expected call of ScheduleBuild.

func (*MockBuildsServerMockRecorder) SearchBuilds 

func (mr *MockBuildsServerMockRecorder) SearchBuilds(arg0, arg1 interface{}) *gomock.Call

SearchBuilds indicates an expected call of SearchBuilds.

func (*MockBuildsServerMockRecorder) UpdateBuild 

func (mr *MockBuildsServerMockRecorder) UpdateBuild(arg0, arg1 interface{}) *gomock.Call

UpdateBuild indicates an expected call of UpdateBuild.

type MockisBatchRequest_Request_Request 

type MockisBatchRequest_Request_Request struct {
	// contains filtered or unexported fields
}

MockisBatchRequest_Request_Request is a mock of isBatchRequest_Request_Request interface.

func NewMockisBatchRequest_Request_Request 

func NewMockisBatchRequest_Request_Request(ctrl *gomock.Controller) *MockisBatchRequest_Request_Request

NewMockisBatchRequest_Request_Request creates a new mock instance.

func (*MockisBatchRequest_Request_Request) EXPECT 

func (m *MockisBatchRequest_Request_Request) EXPECT() *MockisBatchRequest_Request_RequestMockRecorder

EXPECT returns an object that allows the caller to indicate expected use.

type MockisBatchRequest_Request_RequestMockRecorder 

type MockisBatchRequest_Request_RequestMockRecorder struct {
	// contains filtered or unexported fields
}

MockisBatchRequest_Request_RequestMockRecorder is the mock recorder for MockisBatchRequest_Request_Request.

type MockisBatchResponse_Response_Response 

type MockisBatchResponse_Response_Response struct {
	// contains filtered or unexported fields
}

MockisBatchResponse_Response_Response is a mock of isBatchResponse_Response_Response interface.

func NewMockisBatchResponse_Response_Response 

func NewMockisBatchResponse_Response_Response(ctrl *gomock.Controller) *MockisBatchResponse_Response_Response

NewMockisBatchResponse_Response_Response creates a new mock instance.

func (*MockisBatchResponse_Response_Response) EXPECT 

func (m *MockisBatchResponse_Response_Response) EXPECT() *MockisBatchResponse_Response_ResponseMockRecorder

EXPECT returns an object that allows the caller to indicate expected use.

type MockisBatchResponse_Response_ResponseMockRecorder 

type MockisBatchResponse_Response_ResponseMockRecorder struct {
	// contains filtered or unexported fields
}

MockisBatchResponse_Response_ResponseMockRecorder is the mock recorder for MockisBatchResponse_Response_Response.

type Notification 

type Notification struct {

	// When this notification was created.
	Timestamp *timestamp.Timestamp `protobuf:"bytes,1,opt,name=timestamp,proto3" json:"timestamp,omitempty"`
	// Cloud Project ID of the Buildbucket instance that sent this notification,
	// e.g. "cr-buildbucket".
	// Useful if a service listens to both prod and dev instances of buildbucket.
	AppId string `protobuf:"bytes,2,opt,name=app_id,json=appId,proto3" json:"app_id,omitempty"`
	// Buildbucket build id.
	// Use GetBuild rpc to load the contents.
	BuildId int64 `protobuf:"varint,3,opt,name=build_id,json=buildId,proto3" json:"build_id,omitempty"`
	// User-defined opaque blob specified in NotificationConfig.user_data.
	UserData []byte `protobuf:"bytes,4,opt,name=user_data,json=userData,proto3" json:"user_data,omitempty"`
	// contains filtered or unexported fields
}

A notification about a build.

func (*Notification) Descriptor deprecated 

func (*Notification) Descriptor() ([]byte, []int)

Deprecated: Use Notification.ProtoReflect.Descriptor instead.

func (*Notification) GetAppId 

func (x *Notification) GetAppId() string

func (*Notification) GetBuildId 

func (x *Notification) GetBuildId() int64

func (*Notification) GetTimestamp 

func (x *Notification) GetTimestamp() *timestamp.Timestamp

func (*Notification) GetUserData 

func (x *Notification) GetUserData() []byte

func (*Notification) ProtoMessage 

func (*Notification) ProtoMessage()

func (*Notification) ProtoReflect 

func (x *Notification) ProtoReflect() protoreflect.Message

func (*Notification) Reset 

func (x *Notification) Reset()

func (*Notification) String 

func (x *Notification) String() string

type NotificationConfig 

type NotificationConfig struct {

	// Target Cloud PubSub topic.
	// Usually has format "projects/{cloud project}/topics/{topic name}".
	//
	// The PubSub message data is a Notification message in binary format.
	//
	// <buildbucket-app-id>@appspot.gserviceaccount.com must have
	// "pubsub.topics.publish" permissions on the topic, where
	// <buildbucket-app-id> is usually "cr-buildbucket."
	PubsubTopic string `protobuf:"bytes,1,opt,name=pubsub_topic,json=pubsubTopic,proto3" json:"pubsub_topic,omitempty"`
	// Will be available in Notification.user_data.
	// Max length: 4096.
	UserData []byte `protobuf:"bytes,2,opt,name=user_data,json=userData,proto3" json:"user_data,omitempty"`
	// contains filtered or unexported fields
}

Configuration of notifications.

func (*NotificationConfig) Descriptor deprecated 

func (*NotificationConfig) Descriptor() ([]byte, []int)

Deprecated: Use NotificationConfig.ProtoReflect.Descriptor instead.

func (*NotificationConfig) GetPubsubTopic 

func (x *NotificationConfig) GetPubsubTopic() string

func (*NotificationConfig) GetUserData 

func (x *NotificationConfig) GetUserData() []byte

func (*NotificationConfig) ProtoMessage 

func (*NotificationConfig) ProtoMessage()

func (*NotificationConfig) ProtoReflect 

func (x *NotificationConfig) ProtoReflect() protoreflect.Message

func (*NotificationConfig) Reset 

func (x *NotificationConfig) Reset()

func (*NotificationConfig) String 

func (x *NotificationConfig) String() string

type RequestedDimension 

type RequestedDimension struct {
	Key   string `protobuf:"bytes,1,opt,name=key,proto3" json:"key,omitempty"`
	Value string `protobuf:"bytes,2,opt,name=value,proto3" json:"value,omitempty"`
	// If set, ignore this dimension after this duration.
	Expiration *duration.Duration `protobuf:"bytes,3,opt,name=expiration,proto3" json:"expiration,omitempty"`
	// contains filtered or unexported fields
}

A requested dimension. Looks like StringPair, but also has an expiration.

func (*RequestedDimension) Descriptor deprecated 

func (*RequestedDimension) Descriptor() ([]byte, []int)

Deprecated: Use RequestedDimension.ProtoReflect.Descriptor instead.

func (*RequestedDimension) GetExpiration 

func (x *RequestedDimension) GetExpiration() *duration.Duration

func (*RequestedDimension) GetKey 

func (x *RequestedDimension) GetKey() string

func (*RequestedDimension) GetValue 

func (x *RequestedDimension) GetValue() string

func (*RequestedDimension) ProtoMessage 

func (*RequestedDimension) ProtoMessage()

func (*RequestedDimension) ProtoReflect 

func (x *RequestedDimension) ProtoReflect() protoreflect.Message

func (*RequestedDimension) Reset 

func (x *RequestedDimension) Reset()

func (*RequestedDimension) String 

func (x *RequestedDimension) String() string

type ResultDBSettings 

type ResultDBSettings struct {

	// Hostname of the ResultDB instance to use, e.g. "results.api.cr.dev".
	Hostname string `protobuf:"bytes,1,opt,name=hostname,proto3" json:"hostname,omitempty"`
	// contains filtered or unexported fields
}

func (*ResultDBSettings) Descriptor deprecated 

func (*ResultDBSettings) Descriptor() ([]byte, []int)

Deprecated: Use ResultDBSettings.ProtoReflect.Descriptor instead.

func (*ResultDBSettings) GetHostname 

func (x *ResultDBSettings) GetHostname() string

func (*ResultDBSettings) ProtoMessage 

func (*ResultDBSettings) ProtoMessage()

func (*ResultDBSettings) ProtoReflect 

func (x *ResultDBSettings) ProtoReflect() protoreflect.Message

func (*ResultDBSettings) Reset 

func (x *ResultDBSettings) Reset()

func (*ResultDBSettings) String 

func (x *ResultDBSettings) String() string

type ScheduleBuildRequest 

type ScheduleBuildRequest struct {

	// ** STRONGLY RECOMMENDED **.
	// A unique string id used for detecting duplicate requests.
	// Should be unique at least per requesting identity.
	// Used to dedup build scheduling requests with same id within 1 min.
	// If a build was successfully scheduled with the same request id in the past
	// minute, the existing build will be returned.
	RequestId string `protobuf:"bytes,1,opt,name=request_id,json=requestId,proto3" json:"request_id,omitempty"`
	// ID of a build to retry as is or altered.
	// When specified, fields below default to the values in the template build.
	TemplateBuildId int64 `protobuf:"varint,2,opt,name=template_build_id,json=templateBuildId,proto3" json:"template_build_id,omitempty"`
	// Value for Build.builder. See its comments.
	// Required, unless template_build_id is specified.
	Builder *BuilderID `protobuf:"bytes,3,opt,name=builder,proto3" json:"builder,omitempty"`
	// DEPRECATED
	//
	// Set "luci.buildbucket.canary_software" in `experiments` instead.
	//
	// YES sets "luci.buildbucket.canary_software" to true in `experiments`.
	// NO sets "luci.buildbucket.canary_software" to false in `experiments`.
	Canary Trinary `protobuf:"varint,4,opt,name=canary,proto3,enum=buildbucket.v2.Trinary" json:"canary,omitempty"`
	// DEPRECATED
	//
	// Set "luci.non_production" in `experiments` instead.
	//
	// YES sets "luci.non_production" to true in `experiments`.
	// NO sets "luci.non_production" to false in `experiments`.
	Experimental Trinary `protobuf:"varint,5,opt,name=experimental,proto3,enum=buildbucket.v2.Trinary" json:"experimental,omitempty"`
	// Sets (or prevents) these experiments on the scheduled build.
	//
	// See `Builder.experiments` for well-known experiments.
	Experiments map[string]bool `` /* 165-byte string literal not displayed */
	// Properties to include in Build.input.properties.
	//
	// Input properties of the created build are result of merging server-defined
	// properties and properties in this field.
	// Each property in this field defines a new or replaces an existing property
	// on the server.
	// If the server config does not allow overriding/adding the property, the
	// request will fail with InvalidArgument error code.
	// A server-defined property cannot be removed, but its value can be
	// replaced with null.
	//
	// Reserved property paths:
	// * ["buildbucket"]
	// * ["buildername"]
	// * ["blamelist""]
	// * ["$recipe_engine/runtime", "is_luci"]
	// * ["$recipe_engine/runtime", "is_experimental"]
	//
	// V1 equivalent: corresponds to "properties" key in "parameters_json".
	Properties *_struct.Struct `protobuf:"bytes,6,opt,name=properties,proto3" json:"properties,omitempty"`
	// Value for Build.input.gitiles_commit.
	//
	// Setting this field will cause the created build to have a "buildset"
	// tag with value "commit/gitiles/{hostname}/{project}/+/{id}".
	//
	// GitilesCommit objects MUST have host, project, ref fields set.
	//
	// V1 equivalent: supersedes "revision" property and "buildset"
	// tag that starts with "commit/gitiles/".
	GitilesCommit *GitilesCommit `protobuf:"bytes,7,opt,name=gitiles_commit,json=gitilesCommit,proto3" json:"gitiles_commit,omitempty"`
	// Value for Build.input.gerrit_changes.
	// Usually present in tryjobs, set by CQ, Gerrit, git-cl-try.
	// Applied on top of gitiles_commit if specified, otherwise tip of the tree.
	// All GerritChange fields are required.
	//
	// Setting this field will cause the created build to have a "buildset"
	// tag with value "patch/gerrit/{hostname}/{change}/{patchset}"
	// for each change.
	//
	// V1 equivalent: supersedes patch_* properties and "buildset"
	// tag that starts with "patch/gerrit/".
	GerritChanges []*GerritChange `protobuf:"bytes,8,rep,name=gerrit_changes,json=gerritChanges,proto3" json:"gerrit_changes,omitempty"`
	// Tags to include in Build.tags of the created build, see Build.tags
	// comments.
	// Note: tags of the created build may include other tags defined on the
	// server.
	Tags []*StringPair `protobuf:"bytes,9,rep,name=tags,proto3" json:"tags,omitempty"`
	// Overrides default dimensions defined by builder config or template build.
	//
	// A set of entries with the same key defines a new or replaces an existing
	// dimension with the same key.
	// If the config does not allow overriding/adding the dimension, the request
	// will fail with InvalidArgument error code.
	//
	// After merging, dimensions with empty value will be excluded.
	//
	// A dimension expiration must be a multiple of 1min.
	Dimensions []*RequestedDimension `protobuf:"bytes,10,rep,name=dimensions,proto3" json:"dimensions,omitempty"`
	// If not zero, overrides swarming task priority.
	// See also Build.infra.swarming.priority.
	Priority int32 `protobuf:"varint,11,opt,name=priority,proto3" json:"priority,omitempty"`
	// A per-build notification configuration.
	Notify *NotificationConfig `protobuf:"bytes,12,opt,name=notify,proto3" json:"notify,omitempty"`
	// Fields to include in the response. See also GetBuildRequest.fields.
	Fields *field_mask.FieldMask `protobuf:"bytes,100,opt,name=fields,proto3" json:"fields,omitempty"`
	// Value for Build.critical.
	Critical Trinary `protobuf:"varint,13,opt,name=critical,proto3,enum=buildbucket.v2.Trinary" json:"critical,omitempty"`
	// Overrides Builder.exe in the config.
	// Supported subfields: cipd_version.
	Exe *Executable `protobuf:"bytes,14,opt,name=exe,proto3" json:"exe,omitempty"`
	// Swarming specific part of the build request.
	Swarming *ScheduleBuildRequest_Swarming `protobuf:"bytes,15,opt,name=swarming,proto3" json:"swarming,omitempty"`
	// contains filtered or unexported fields
}

A request message for ScheduleBuild rpc.

Next ID: 17.

func (*ScheduleBuildRequest) Descriptor deprecated 

func (*ScheduleBuildRequest) Descriptor() ([]byte, []int)

Deprecated: Use ScheduleBuildRequest.ProtoReflect.Descriptor instead.

func (*ScheduleBuildRequest) GetBuilder 

func (x *ScheduleBuildRequest) GetBuilder() *BuilderID

func (*ScheduleBuildRequest) GetCanary 

func (x *ScheduleBuildRequest) GetCanary() Trinary

func (*ScheduleBuildRequest) GetCritical 

func (x *ScheduleBuildRequest) GetCritical() Trinary

func (*ScheduleBuildRequest) GetDimensions 

func (x *ScheduleBuildRequest) GetDimensions() []*RequestedDimension

func (*ScheduleBuildRequest) GetExe 

func (x *ScheduleBuildRequest) GetExe() *Executable

func (*ScheduleBuildRequest) GetExperimental 

func (x *ScheduleBuildRequest) GetExperimental() Trinary

func (*ScheduleBuildRequest) GetExperiments 

func (x *ScheduleBuildRequest) GetExperiments() map[string]bool

func (*ScheduleBuildRequest) GetFields 

func (x *ScheduleBuildRequest) GetFields() *field_mask.FieldMask

func (*ScheduleBuildRequest) GetGerritChanges 

func (x *ScheduleBuildRequest) GetGerritChanges() []*GerritChange

func (*ScheduleBuildRequest) GetGitilesCommit 

func (x *ScheduleBuildRequest) GetGitilesCommit() *GitilesCommit

func (*ScheduleBuildRequest) GetNotify 

func (x *ScheduleBuildRequest) GetNotify() *NotificationConfig

func (*ScheduleBuildRequest) GetPriority 

func (x *ScheduleBuildRequest) GetPriority() int32

func (*ScheduleBuildRequest) GetProperties 

func (x *ScheduleBuildRequest) GetProperties() *_struct.Struct

func (*ScheduleBuildRequest) GetRequestId 

func (x *ScheduleBuildRequest) GetRequestId() string

func (*ScheduleBuildRequest) GetSwarming 

func (x *ScheduleBuildRequest) GetSwarming() *ScheduleBuildRequest_Swarming

func (*ScheduleBuildRequest) GetTags 

func (x *ScheduleBuildRequest) GetTags() []*StringPair

func (*ScheduleBuildRequest) GetTemplateBuildId 

func (x *ScheduleBuildRequest) GetTemplateBuildId() int64

func (*ScheduleBuildRequest) ProtoMessage 

func (*ScheduleBuildRequest) ProtoMessage()

func (*ScheduleBuildRequest) ProtoReflect 

func (x *ScheduleBuildRequest) ProtoReflect() protoreflect.Message

func (*ScheduleBuildRequest) Reset 

func (x *ScheduleBuildRequest) Reset()

func (*ScheduleBuildRequest) String 

func (x *ScheduleBuildRequest) String() string

type ScheduleBuildRequest_Swarming 

type ScheduleBuildRequest_Swarming struct {

	// If specified, parent_run_id should match actual Swarming task run ID the
	// caller is running as and results in swarming server ensuring that the newly
	// triggered build will not outlive its parent.
	//
	// Typical use is for triggering and waiting on child build(s) from within
	// 1 parent build and if child build(s) on their own aren't useful. Then,
	// if parent build ends for whatever reason, all not yet finished child
	// builds aren't useful and it's desirable to terminate them, too.
	//
	// If the Builder config does not specify a swarming backend, the request
	// will fail with InvalidArgument error code.
	//
	// The parent_run_id is assumed to be from the same swarming server as the
	// one the new build is to be executed on. The ScheduleBuildRequest doesn't
	// check if parent_run_id refers to actually existing task, but eventually
	// the new build will fail if so.
	ParentRunId string `protobuf:"bytes,1,opt,name=parent_run_id,json=parentRunId,proto3" json:"parent_run_id,omitempty"`
	// contains filtered or unexported fields
}

Swarming specific part of the build request.

func (*ScheduleBuildRequest_Swarming) Descriptor deprecated 

func (*ScheduleBuildRequest_Swarming) Descriptor() ([]byte, []int)

Deprecated: Use ScheduleBuildRequest_Swarming.ProtoReflect.Descriptor instead.

func (*ScheduleBuildRequest_Swarming) GetParentRunId 

func (x *ScheduleBuildRequest_Swarming) GetParentRunId() string

func (*ScheduleBuildRequest_Swarming) ProtoMessage 

func (*ScheduleBuildRequest_Swarming) ProtoMessage()

func (*ScheduleBuildRequest_Swarming) ProtoReflect 

func (x *ScheduleBuildRequest_Swarming) ProtoReflect() protoreflect.Message

func (*ScheduleBuildRequest_Swarming) Reset 

func (x *ScheduleBuildRequest_Swarming) Reset()

func (*ScheduleBuildRequest_Swarming) String 

func (x *ScheduleBuildRequest_Swarming) String() string

type SearchBuildsRequest 

type SearchBuildsRequest struct {

	// Returned builds must satisfy this predicate. Required.
	Predicate *BuildPredicate `protobuf:"bytes,1,opt,name=predicate,proto3" json:"predicate,omitempty"`
	// Fields to include in the response, see GetBuildRequest.fields.
	// Note that this applies to the response, not each build, so e.g. steps must
	// be requested with a path "builds.*.steps".
	Fields *field_mask.FieldMask `protobuf:"bytes,100,opt,name=fields,proto3" json:"fields,omitempty"`
	// Number of builds to return.
	// Defaults to 100.
	// Any value >1000 is interpreted as 1000.
	PageSize int32 `protobuf:"varint,101,opt,name=page_size,json=pageSize,proto3" json:"page_size,omitempty"`
	// Value of SearchBuildsResponse.next_page_token from the previous response.
	// Use it to continue searching.
	// The predicate and page_size in this request MUST be exactly same as in the
	// previous request.
	PageToken string `protobuf:"bytes,102,opt,name=page_token,json=pageToken,proto3" json:"page_token,omitempty"`
	// contains filtered or unexported fields
}

A request message for SearchBuilds rpc.

func (*SearchBuildsRequest) Descriptor deprecated 

func (*SearchBuildsRequest) Descriptor() ([]byte, []int)

Deprecated: Use SearchBuildsRequest.ProtoReflect.Descriptor instead.

func (*SearchBuildsRequest) GetFields 

func (x *SearchBuildsRequest) GetFields() *field_mask.FieldMask

func (*SearchBuildsRequest) GetPageSize 

func (x *SearchBuildsRequest) GetPageSize() int32

func (*SearchBuildsRequest) GetPageToken 

func (x *SearchBuildsRequest) GetPageToken() string

func (*SearchBuildsRequest) GetPredicate 

func (x *SearchBuildsRequest) GetPredicate() *BuildPredicate

func (*SearchBuildsRequest) ProtoMessage 

func (*SearchBuildsRequest) ProtoMessage()

func (*SearchBuildsRequest) ProtoReflect 

func (x *SearchBuildsRequest) ProtoReflect() protoreflect.Message

func (*SearchBuildsRequest) Reset 

func (x *SearchBuildsRequest) Reset()

func (*SearchBuildsRequest) String 

func (x *SearchBuildsRequest) String() string

type SearchBuildsResponse 

type SearchBuildsResponse struct {

	// Search results.
	//
	// Ordered by build id, descending. Ids are monotonically decreasing, so in
	// other words the order is newest-to-oldest.
	Builds []*Build `protobuf:"bytes,1,rep,name=builds,proto3" json:"builds,omitempty"`
	// Value for SearchBuildsRequest.page_token to continue searching.
	NextPageToken string `protobuf:"bytes,100,opt,name=next_page_token,json=nextPageToken,proto3" json:"next_page_token,omitempty"`
	// contains filtered or unexported fields
}

A response message for SearchBuilds rpc.

func (*SearchBuildsResponse) Descriptor deprecated 

func (*SearchBuildsResponse) Descriptor() ([]byte, []int)

Deprecated: Use SearchBuildsResponse.ProtoReflect.Descriptor instead.

func (*SearchBuildsResponse) GetBuilds 

func (x *SearchBuildsResponse) GetBuilds() []*Build

func (*SearchBuildsResponse) GetNextPageToken 

func (x *SearchBuildsResponse) GetNextPageToken() string

func (*SearchBuildsResponse) ProtoMessage 

func (*SearchBuildsResponse) ProtoMessage()

func (*SearchBuildsResponse) ProtoReflect 

func (x *SearchBuildsResponse) ProtoReflect() protoreflect.Message

func (*SearchBuildsResponse) Reset 

func (x *SearchBuildsResponse) Reset()

func (*SearchBuildsResponse) String 

func (x *SearchBuildsResponse) String() string

type SettingsCfg 

type SettingsCfg struct {

	// Swarmbucket settings.
	Swarming *SwarmingSettings `protobuf:"bytes,1,opt,name=swarming,proto3" json:"swarming,omitempty"`
	Logdog   *LogDogSettings   `protobuf:"bytes,2,opt,name=logdog,proto3" json:"logdog,omitempty"`
	Resultdb *ResultDBSettings `protobuf:"bytes,4,opt,name=resultdb,proto3" json:"resultdb,omitempty"`
	// List of Gerrit hosts to force git authentication for.
	//
	// By default public hosts are accessed anonymously, and the anonymous access
	// has very low quota. Context needs to know all such hostnames in advance to
	// be able to force authenticated access to them.
	KnownPublicGerritHosts []string `` /* 131-byte string literal not displayed */
	// contains filtered or unexported fields
}

Schema of settings.cfg file, a service config.

func (*SettingsCfg) Descriptor deprecated 

func (*SettingsCfg) Descriptor() ([]byte, []int)

Deprecated: Use SettingsCfg.ProtoReflect.Descriptor instead.

func (*SettingsCfg) GetKnownPublicGerritHosts 

func (x *SettingsCfg) GetKnownPublicGerritHosts() []string

func (*SettingsCfg) GetLogdog 

func (x *SettingsCfg) GetLogdog() *LogDogSettings

func (*SettingsCfg) GetResultdb 

func (x *SettingsCfg) GetResultdb() *ResultDBSettings

func (*SettingsCfg) GetSwarming 

func (x *SettingsCfg) GetSwarming() *SwarmingSettings

func (*SettingsCfg) ProtoMessage 

func (*SettingsCfg) ProtoMessage()

func (*SettingsCfg) ProtoReflect 

func (x *SettingsCfg) ProtoReflect() protoreflect.Message

func (*SettingsCfg) Reset 

func (x *SettingsCfg) Reset()

func (*SettingsCfg) String 

func (x *SettingsCfg) String() string

type Status 

type Status int32

Status of a build or a step. 

const (
	// Unspecified state. Meaning depends on the context.
	Status_STATUS_UNSPECIFIED Status = 0
	// Build was scheduled, but did not start or end yet.
	Status_SCHEDULED Status = 1
	// Build/step has started.
	Status_STARTED Status = 2
	// A union of all terminal statuses.
	// Can be used in BuildPredicate.status.
	// A concrete build/step cannot have this status.
	// Can be used as a bitmask to check that a build/step ended.
	Status_ENDED_MASK Status = 4
	// A build/step ended successfully.
	// This is a terminal status. It may not transition to another status.
	Status_SUCCESS Status = 12 // 8 | ENDED
	// A build/step ended unsuccessfully due to its Build.Input,
	// e.g. tests failed, and NOT due to a build infrastructure failure.
	// This is a terminal status. It may not transition to another status.
	Status_FAILURE Status = 20 // 16 | ENDED
	// A build/step ended unsuccessfully due to a failure independent of the
	// input, e.g. swarming failed, not enough capacity or the recipe was unable
	// to read the patch from gerrit.
	// start_time is not required for this status.
	// This is a terminal status. It may not transition to another status.
	Status_INFRA_FAILURE Status = 36 // 32 | ENDED
	// A build was cancelled explicitly, e.g. via an RPC.
	// This is a terminal status. It may not transition to another status.
	Status_CANCELED Status = 68 // 64 | ENDED
)

func (Status) Descriptor 

func (Status) Descriptor() protoreflect.EnumDescriptor

func (Status) Enum 

func (x Status) Enum() *Status

func (Status) EnumDescriptor deprecated 

func (Status) EnumDescriptor() ([]byte, []int)

Deprecated: Use Status.Descriptor instead.

func (Status) Number 

func (x Status) Number() protoreflect.EnumNumber

func (Status) String 

func (x Status) String() string

func (Status) Type 

func (Status) Type() protoreflect.EnumType

type StatusDetails 

type StatusDetails struct {

	// If set, indicates that the failure was due to a resource exhaustion / quota
	// denial.
	// Applicable in FAILURE and INFRA_FAILURE statuses.
	ResourceExhaustion *StatusDetails_ResourceExhaustion `protobuf:"bytes,3,opt,name=resource_exhaustion,json=resourceExhaustion,proto3" json:"resource_exhaustion,omitempty"`
	// If set, indicates that the failure was due to a timeout.
	// Applicable in FAILURE and INFRA_FAILURE statuses.
	Timeout *StatusDetails_Timeout `protobuf:"bytes,4,opt,name=timeout,proto3" json:"timeout,omitempty"`
	// contains filtered or unexported fields
}

Machine-readable details of a status. Human-readble details are present in a sibling summary_markdown field.

func (*StatusDetails) Descriptor deprecated 

func (*StatusDetails) Descriptor() ([]byte, []int)

Deprecated: Use StatusDetails.ProtoReflect.Descriptor instead.

func (*StatusDetails) GetResourceExhaustion 

func (x *StatusDetails) GetResourceExhaustion() *StatusDetails_ResourceExhaustion

func (*StatusDetails) GetTimeout 

func (x *StatusDetails) GetTimeout() *StatusDetails_Timeout

func (*StatusDetails) ProtoMessage 

func (*StatusDetails) ProtoMessage()

func (*StatusDetails) ProtoReflect 

func (x *StatusDetails) ProtoReflect() protoreflect.Message

func (*StatusDetails) Reset 

func (x *StatusDetails) Reset()

func (*StatusDetails) String 

func (x *StatusDetails) String() string

type StatusDetails_ResourceExhaustion 

type StatusDetails_ResourceExhaustion struct {
	// contains filtered or unexported fields
}

func (*StatusDetails_ResourceExhaustion) Descriptor deprecated 

func (*StatusDetails_ResourceExhaustion) Descriptor() ([]byte, []int)

Deprecated: Use StatusDetails_ResourceExhaustion.ProtoReflect.Descriptor instead.

func (*StatusDetails_ResourceExhaustion) ProtoMessage 

func (*StatusDetails_ResourceExhaustion) ProtoMessage()

func (*StatusDetails_ResourceExhaustion) ProtoReflect 

func (x *StatusDetails_ResourceExhaustion) ProtoReflect() protoreflect.Message

func (*StatusDetails_ResourceExhaustion) Reset 

func (x *StatusDetails_ResourceExhaustion) Reset()

func (*StatusDetails_ResourceExhaustion) String 

func (x *StatusDetails_ResourceExhaustion) String() string

type StatusDetails_Timeout 

type StatusDetails_Timeout struct {
	// contains filtered or unexported fields
}

func (*StatusDetails_Timeout) Descriptor deprecated 

func (*StatusDetails_Timeout) Descriptor() ([]byte, []int)

Deprecated: Use StatusDetails_Timeout.ProtoReflect.Descriptor instead.

func (*StatusDetails_Timeout) ProtoMessage 

func (*StatusDetails_Timeout) ProtoMessage()

func (*StatusDetails_Timeout) ProtoReflect 

func (x *StatusDetails_Timeout) ProtoReflect() protoreflect.Message

func (*StatusDetails_Timeout) Reset 

func (x *StatusDetails_Timeout) Reset()

func (*StatusDetails_Timeout) String 

func (x *StatusDetails_Timeout) String() string

type Step 

type Step struct {

	// Name of the step, unique within the build.
	// Identifies the step.
	//
	// Pipe character ("|") is reserved to separate parent and child step names.
	// For example, value "a|b" indicates step "b" under step "a".
	// If this is a child step, a parent MUST exist and MUST precede this step in
	// the list of steps.
	// All step names, including child and parent names recursively,
	// MUST NOT be an empty string.
	// For example, all of the below names are invalid.
	// - |a
	// - a|
	// - a||b
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// The timestamp when the step started.
	// Required iff status is STARTED, SUCCESS or FAILURE, or if the step has
	// children.
	// MUST NOT be after start_time/end_time of any of the children.
	StartTime *timestamp.Timestamp `protobuf:"bytes,2,opt,name=start_time,json=startTime,proto3" json:"start_time,omitempty"`
	// The timestamp when the step ended.
	// Present iff status is terminal.
	// MUST NOT be before start_time.
	// MUST NOT be before start/end_time of any of the children.
	EndTime *timestamp.Timestamp `protobuf:"bytes,3,opt,name=end_time,json=endTime,proto3" json:"end_time,omitempty"`
	// Status of the step.
	// Must be specified, i.e. not STATUS_UNSPECIFIED.
	//
	// If the step has children
	//   status MUST NOT be SCHEDULED.
	//   status MUST be STARTED if status of any child is not terminal.
	//
	//   status MUST NOT be "better" than statuses of its children,
	//   where "better" relation is defined by the following order,
	//   from good to bad:
	//     SUCCESS
	//     FAILURE
	//     INFRA_FAILURE
	//     CANCELED
	//   Note that this defines "better" relation only for some statuses.
	//   For those statuses where "better" is not defined, this rule does not
	//   apply.
	Status Status `protobuf:"varint,4,opt,name=status,proto3,enum=buildbucket.v2.Status" json:"status,omitempty"`
	// Logs produced by the step.
	// Log order is up to the step.
	//
	// BigQuery: excluded from rows.
	Logs []*Log `protobuf:"bytes,5,rep,name=logs,proto3" json:"logs,omitempty"`
	// Human-readable summary of the step provided by the step itself,
	// in Markdown format (https://spec.commonmark.org/0.28/).
	//
	// V1 equivalent: combines and supersedes Buildbot's step_text and step links and also supports
	// other formatted text.
	//
	// BigQuery: excluded from rows.
	SummaryMarkdown string `protobuf:"bytes,7,opt,name=summary_markdown,json=summaryMarkdown,proto3" json:"summary_markdown,omitempty"`
	// contains filtered or unexported fields
}

A build step.

A step may have children, see name field.

func (*Step) Descriptor deprecated 

func (*Step) Descriptor() ([]byte, []int)

Deprecated: Use Step.ProtoReflect.Descriptor instead.

func (*Step) GetEndTime 

func (x *Step) GetEndTime() *timestamp.Timestamp

func (*Step) GetLogs 

func (x *Step) GetLogs() []*Log

func (*Step) GetName 

func (x *Step) GetName() string

func (*Step) GetStartTime 

func (x *Step) GetStartTime() *timestamp.Timestamp

func (*Step) GetStatus 

func (x *Step) GetStatus() Status

func (*Step) GetSummaryMarkdown 

func (x *Step) GetSummaryMarkdown() string

func (*Step) ProtoMessage 

func (*Step) ProtoMessage()

func (*Step) ProtoReflect 

func (x *Step) ProtoReflect() protoreflect.Message

func (*Step) Reset 

func (x *Step) Reset()

func (*Step) String 

func (x *Step) String() string

type StringPair 

type StringPair struct {
	Key   string `protobuf:"bytes,1,opt,name=key,proto3" json:"key,omitempty"`
	Value string `protobuf:"bytes,2,opt,name=value,proto3" json:"value,omitempty"`
	// contains filtered or unexported fields
}

A key-value pair of strings.

func (*StringPair) Descriptor deprecated 

func (*StringPair) Descriptor() ([]byte, []int)

Deprecated: Use StringPair.ProtoReflect.Descriptor instead.

func (*StringPair) GetKey 

func (x *StringPair) GetKey() string

func (*StringPair) GetValue 

func (x *StringPair) GetValue() string

func (*StringPair) ProtoMessage 

func (*StringPair) ProtoMessage()

func (*StringPair) ProtoReflect 

func (x *StringPair) ProtoReflect() protoreflect.Message

func (*StringPair) Reset 

func (x *StringPair) Reset()

func (*StringPair) String 

func (x *StringPair) String() string

type Swarming 

type Swarming struct {

	// DEPRECATED. Use builder_defaults.swarming_host instead.
	// Setting this fields sets builder_defaults.swarming_host.
	Hostname string `protobuf:"bytes,1,opt,name=hostname,proto3" json:"hostname,omitempty"`
	// DEPRECATED, IGNORED.
	// Used to generate a URL for Build, may contain parameters
	// {swarming_hostname}, {task_id}, {bucket} and {builder}. Defaults to:
	// https://{swarming_hostname}/user/task/{task_id}
	UrlFormat string `protobuf:"bytes,2,opt,name=url_format,json=urlFormat,proto3" json:"url_format,omitempty"`
	// Defines default values for builders.
	BuilderDefaults *Builder `protobuf:"bytes,3,opt,name=builder_defaults,json=builderDefaults,proto3" json:"builder_defaults,omitempty"`
	// Configuration for each builder.
	// Swarming tasks are created only for builds for builders that are not
	// explicitly specified.
	Builders []*Builder `protobuf:"bytes,4,rep,name=builders,proto3" json:"builders,omitempty"`
	// DEPRECATED. Use builder_defaults.task_template_canary_percentage instead.
	// Setting this field sets builder_defaults.task_template_canary_percentage.
	TaskTemplateCanaryPercentage *wrappers.UInt32Value `` /* 149-byte string literal not displayed */
	// contains filtered or unexported fields
}

Configuration of buildbucket-swarming integration for one bucket.

func (*Swarming) Descriptor deprecated 

func (*Swarming) Descriptor() ([]byte, []int)

Deprecated: Use Swarming.ProtoReflect.Descriptor instead.

func (*Swarming) GetBuilderDefaults 

func (x *Swarming) GetBuilderDefaults() *Builder

func (*Swarming) GetBuilders 

func (x *Swarming) GetBuilders() []*Builder

func (*Swarming) GetHostname 

func (x *Swarming) GetHostname() string

func (*Swarming) GetTaskTemplateCanaryPercentage 

func (x *Swarming) GetTaskTemplateCanaryPercentage() *wrappers.UInt32Value

func (*Swarming) GetUrlFormat 

func (x *Swarming) GetUrlFormat() string

func (*Swarming) ProtoMessage 

func (*Swarming) ProtoMessage()

func (*Swarming) ProtoReflect 

func (x *Swarming) ProtoReflect() protoreflect.Message

func (*Swarming) Reset 

func (x *Swarming) Reset()

func (*Swarming) String 

func (x *Swarming) String() string

type SwarmingSettings 

type SwarmingSettings struct {

	// Swarmbucket build URLs will point to this Milo instance.
	MiloHostname string `protobuf:"bytes,2,opt,name=milo_hostname,json=miloHostname,proto3" json:"milo_hostname,omitempty"`
	// These caches are available to all builders implicitly.
	// A builder may override a cache specified here.
	GlobalCaches []*Builder_CacheEntry `protobuf:"bytes,4,rep,name=global_caches,json=globalCaches,proto3" json:"global_caches,omitempty"`
	// Packages available to the user executable in $PATH.
	// Installed in "{TASK_RUN_DIR}/cipd_bin_packages".
	// "{TASK_RUN_DIR}/cipd_bin_packages" and
	// "{TASK_RUN_DIR}/cipd_bin_packages/bin" are prepended to $PATH.
	UserPackages []*SwarmingSettings_Package `protobuf:"bytes,5,rep,name=user_packages,json=userPackages,proto3" json:"user_packages,omitempty"`
	// Package of buildbucket agent,
	// https://chromium.googlesource.com/infra/luci/luci-go/+/HEAD/buildbucket/cmd/bbagent
	// used to run LUCI executables.
	BbagentPackage *SwarmingSettings_Package `protobuf:"bytes,8,opt,name=bbagent_package,json=bbagentPackage,proto3" json:"bbagent_package,omitempty"`
	// CIPD package of kitchen binary. DEPRECATED. TODO(nodir): remove.
	KitchenPackage *SwarmingSettings_Package `protobuf:"bytes,7,opt,name=kitchen_package,json=kitchenPackage,proto3" json:"kitchen_package,omitempty"`
	// contains filtered or unexported fields
}

Swarmbucket settings.

func (*SwarmingSettings) Descriptor deprecated 

func (*SwarmingSettings) Descriptor() ([]byte, []int)

Deprecated: Use SwarmingSettings.ProtoReflect.Descriptor instead.

func (*SwarmingSettings) GetBbagentPackage 

func (x *SwarmingSettings) GetBbagentPackage() *SwarmingSettings_Package

func (*SwarmingSettings) GetGlobalCaches 

func (x *SwarmingSettings) GetGlobalCaches() []*Builder_CacheEntry

func (*SwarmingSettings) GetKitchenPackage 

func (x *SwarmingSettings) GetKitchenPackage() *SwarmingSettings_Package

func (*SwarmingSettings) GetMiloHostname 

func (x *SwarmingSettings) GetMiloHostname() string

func (*SwarmingSettings) GetUserPackages 

func (x *SwarmingSettings) GetUserPackages() []*SwarmingSettings_Package

func (*SwarmingSettings) ProtoMessage 

func (*SwarmingSettings) ProtoMessage()

func (*SwarmingSettings) ProtoReflect 

func (x *SwarmingSettings) ProtoReflect() protoreflect.Message

func (*SwarmingSettings) Reset 

func (x *SwarmingSettings) Reset()

func (*SwarmingSettings) String 

func (x *SwarmingSettings) String() string

type SwarmingSettings_Package 

type SwarmingSettings_Package struct {

	// CIPD package name, e.g. "infra/python/cpython/${platform}"
	PackageName string `protobuf:"bytes,1,opt,name=package_name,json=packageName,proto3" json:"package_name,omitempty"`
	// CIPD instance version, e.g. "version:2.7.15.chromium14".
	// Used for non-canary builds.
	Version string `protobuf:"bytes,2,opt,name=version,proto3" json:"version,omitempty"`
	// CIPD instance version for canary builds.
	// Defaults to version.
	VersionCanary string `protobuf:"bytes,3,opt,name=version_canary,json=versionCanary,proto3" json:"version_canary,omitempty"`
	// Include in builders matching the predicate.
	Builders *BuilderPredicate `protobuf:"bytes,4,opt,name=builders,proto3" json:"builders,omitempty"`
	// Subdirectory to install the package into, relative to the installation
	// root. Useful if installing two packages at the same root would conflict.
	Subdir string `protobuf:"bytes,5,opt,name=subdir,proto3" json:"subdir,omitempty"`
	// contains filtered or unexported fields
}

CIPD package. Does not specify installation path.

func (*SwarmingSettings_Package) Descriptor deprecated 

func (*SwarmingSettings_Package) Descriptor() ([]byte, []int)

Deprecated: Use SwarmingSettings_Package.ProtoReflect.Descriptor instead.

func (*SwarmingSettings_Package) GetBuilders 

func (x *SwarmingSettings_Package) GetBuilders() *BuilderPredicate

func (*SwarmingSettings_Package) GetPackageName 

func (x *SwarmingSettings_Package) GetPackageName() string

func (*SwarmingSettings_Package) GetSubdir 

func (x *SwarmingSettings_Package) GetSubdir() string

func (*SwarmingSettings_Package) GetVersion 

func (x *SwarmingSettings_Package) GetVersion() string

func (*SwarmingSettings_Package) GetVersionCanary 

func (x *SwarmingSettings_Package) GetVersionCanary() string

func (*SwarmingSettings_Package) ProtoMessage 

func (*SwarmingSettings_Package) ProtoMessage()

func (*SwarmingSettings_Package) ProtoReflect 

func (x *SwarmingSettings_Package) ProtoReflect() protoreflect.Message

func (*SwarmingSettings_Package) Reset 

func (x *SwarmingSettings_Package) Reset()

func (*SwarmingSettings_Package) String 

func (x *SwarmingSettings_Package) String() string

type TimeRange 

type TimeRange struct {

	// Inclusive lower boundary. Optional.
	StartTime *timestamp.Timestamp `protobuf:"bytes,1,opt,name=start_time,json=startTime,proto3" json:"start_time,omitempty"`
	// Exclusive upper boundary. Optional.
	EndTime *timestamp.Timestamp `protobuf:"bytes,2,opt,name=end_time,json=endTime,proto3" json:"end_time,omitempty"`
	// contains filtered or unexported fields
}

Half-open time range.

func (*TimeRange) Descriptor deprecated 

func (*TimeRange) Descriptor() ([]byte, []int)

Deprecated: Use TimeRange.ProtoReflect.Descriptor instead.

func (*TimeRange) GetEndTime 

func (x *TimeRange) GetEndTime() *timestamp.Timestamp

func (*TimeRange) GetStartTime 

func (x *TimeRange) GetStartTime() *timestamp.Timestamp

func (*TimeRange) ProtoMessage 

func (*TimeRange) ProtoMessage()

func (*TimeRange) ProtoReflect 

func (x *TimeRange) ProtoReflect() protoreflect.Message

func (*TimeRange) Reset 

func (x *TimeRange) Reset()

func (*TimeRange) String 

func (x *TimeRange) String() string

type Toggle 

type Toggle int32

Toggle is a boolean with an extra state UNSET. When protobuf messages are merged, UNSET does not overwrite an existing value. TODO(nodir): replace with Trinary in ../common.proto. 

const (
	Toggle_UNSET Toggle = 0
	Toggle_YES   Toggle = 1
	Toggle_NO    Toggle = 2
)

func (Toggle) Descriptor 

func (Toggle) Descriptor() protoreflect.EnumDescriptor

func (Toggle) Enum 

func (x Toggle) Enum() *Toggle

func (Toggle) EnumDescriptor deprecated 

func (Toggle) EnumDescriptor() ([]byte, []int)

Deprecated: Use Toggle.Descriptor instead.

func (Toggle) Number 

func (x Toggle) Number() protoreflect.EnumNumber

func (Toggle) String 

func (x Toggle) String() string

func (Toggle) Type 

func (Toggle) Type() protoreflect.EnumType

type Trinary 

type Trinary int32

A boolean with an undefined value. 

const (
	Trinary_UNSET Trinary = 0
	Trinary_YES   Trinary = 1
	Trinary_NO    Trinary = 2
)

func (Trinary) Descriptor 

func (Trinary) Descriptor() protoreflect.EnumDescriptor

func (Trinary) Enum 

func (x Trinary) Enum() *Trinary

func (Trinary) EnumDescriptor deprecated 

func (Trinary) EnumDescriptor() ([]byte, []int)

Deprecated: Use Trinary.Descriptor instead.

func (Trinary) Number 

func (x Trinary) Number() protoreflect.EnumNumber

func (Trinary) String 

func (x Trinary) String() string

func (Trinary) Type 

func (Trinary) Type() protoreflect.EnumType

type UnimplementedBuildersServer 

type UnimplementedBuildersServer struct {
}

UnimplementedBuildersServer can be embedded to have forward compatible implementations.

func (*UnimplementedBuildersServer) GetBuilder 

func (*UnimplementedBuildersServer) GetBuilder(context.Context, *GetBuilderRequest) (*BuilderItem, error)

func (*UnimplementedBuildersServer) ListBuilders 

func (*UnimplementedBuildersServer) ListBuilders(context.Context, *ListBuildersRequest) (*ListBuildersResponse, error)

type UnimplementedBuildsServer 

type UnimplementedBuildsServer struct {
}

UnimplementedBuildsServer can be embedded to have forward compatible implementations.

func (*UnimplementedBuildsServer) Batch 

func (*UnimplementedBuildsServer) Batch(context.Context, *BatchRequest) (*BatchResponse, error)

func (*UnimplementedBuildsServer) CancelBuild 

func (*UnimplementedBuildsServer) CancelBuild(context.Context, *CancelBuildRequest) (*Build, error)

func (*UnimplementedBuildsServer) GetBuild 

func (*UnimplementedBuildsServer) GetBuild(context.Context, *GetBuildRequest) (*Build, error)

func (*UnimplementedBuildsServer) ScheduleBuild 

func (*UnimplementedBuildsServer) ScheduleBuild(context.Context, *ScheduleBuildRequest) (*Build, error)

func (*UnimplementedBuildsServer) SearchBuilds 

func (*UnimplementedBuildsServer) SearchBuilds(context.Context, *SearchBuildsRequest) (*SearchBuildsResponse, error)

func (*UnimplementedBuildsServer) UpdateBuild 

func (*UnimplementedBuildsServer) UpdateBuild(context.Context, *UpdateBuildRequest) (*Build, error)

type UpdateBuildRequest 

type UpdateBuildRequest struct {

	// Build to update, with new field values.
	Build *Build `protobuf:"bytes,1,opt,name=build,proto3" json:"build,omitempty"`
	// Build fields to update.
	// See also
	// https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#fieldmask
	//
	// Currently supports only the following path strings:
	// - build.output
	// - build.output.properties
	// - build.output.gitiles_commit
	// - build.status
	// - build.status_details
	// - build.steps
	// - build.summary_markdown
	// - build.tags
	UpdateMask *field_mask.FieldMask `protobuf:"bytes,2,opt,name=update_mask,json=updateMask,proto3" json:"update_mask,omitempty"`
	// Fields to include in the response. See also GetBuildRequest.fields.
	Fields *field_mask.FieldMask `protobuf:"bytes,100,opt,name=fields,proto3" json:"fields,omitempty"`
	// contains filtered or unexported fields
}

A request message for UpdateBuild rpc.

func (*UpdateBuildRequest) Descriptor deprecated 

func (*UpdateBuildRequest) Descriptor() ([]byte, []int)

Deprecated: Use UpdateBuildRequest.ProtoReflect.Descriptor instead.

func (*UpdateBuildRequest) GetBuild 

func (x *UpdateBuildRequest) GetBuild() *Build

func (*UpdateBuildRequest) GetFields 

func (x *UpdateBuildRequest) GetFields() *field_mask.FieldMask

func (*UpdateBuildRequest) GetUpdateMask 

func (x *UpdateBuildRequest) GetUpdateMask() *field_mask.FieldMask

func (*UpdateBuildRequest) ProtoMessage 

func (*UpdateBuildRequest) ProtoMessage()

func (*UpdateBuildRequest) ProtoReflect 

func (x *UpdateBuildRequest) ProtoReflect() protoreflect.Message

func (*UpdateBuildRequest) Reset 

func (x *UpdateBuildRequest) Reset()

func (*UpdateBuildRequest) String 

func (x *UpdateBuildRequest) String() string

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.