buildbucketpb

package
v0.0.0-...-1f88c41 Latest Latest
Warning

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

Go to latest
Published: Apr 17, 2024 License: Apache-2.0 Imports: 25 Imported by: 116

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 (
	BuildInfra_Buildbucket_ExperimentReason_name = map[int32]string{
		0: "EXPERIMENT_REASON_UNSET",
		1: "EXPERIMENT_REASON_GLOBAL_DEFAULT",
		2: "EXPERIMENT_REASON_BUILDER_CONFIG",
		3: "EXPERIMENT_REASON_GLOBAL_MINIMUM",
		4: "EXPERIMENT_REASON_REQUESTED",
		5: "EXPERIMENT_REASON_GLOBAL_INACTIVE",
	}
	BuildInfra_Buildbucket_ExperimentReason_value = map[string]int32{
		"EXPERIMENT_REASON_UNSET":           0,
		"EXPERIMENT_REASON_GLOBAL_DEFAULT":  1,
		"EXPERIMENT_REASON_BUILDER_CONFIG":  2,
		"EXPERIMENT_REASON_GLOBAL_MINIMUM":  3,
		"EXPERIMENT_REASON_REQUESTED":       4,
		"EXPERIMENT_REASON_GLOBAL_INACTIVE": 5,
	}
)

Enum value maps for BuildInfra_Buildbucket_ExperimentReason.

View Source
var (
	BuildInfra_Buildbucket_Agent_Purpose_name = map[int32]string{
		0: "PURPOSE_UNSPECIFIED",
		1: "PURPOSE_EXE_PAYLOAD",
		2: "PURPOSE_BBAGENT_UTILITY",
	}
	BuildInfra_Buildbucket_Agent_Purpose_value = map[string]int32{
		"PURPOSE_UNSPECIFIED":     0,
		"PURPOSE_EXE_PAYLOAD":     1,
		"PURPOSE_BBAGENT_UTILITY": 2,
	}
)

Enum value maps for BuildInfra_Buildbucket_Agent_Purpose.

View Source
var (
	BuildFieldVisibility_name = map[int32]string{
		0: "FIELD_VISIBILITY_UNSPECIFIED",
		1: "BUILDS_GET_PERMISSION",
		2: "BUILDS_GET_LIMITED_PERMISSION",
		3: "BUILDS_LIST_PERMISSION",
	}
	BuildFieldVisibility_value = map[string]int32{
		"FIELD_VISIBILITY_UNSPECIFIED":  0,
		"BUILDS_GET_PERMISSION":         1,
		"BUILDS_GET_LIMITED_PERMISSION": 2,
		"BUILDS_LIST_PERMISSION":        3,
	}
)

Enum value maps for BuildFieldVisibility.

View Source
var (
	BuilderMask_BuilderMaskType_name = map[int32]string{
		0: "BUILDER_MASK_TYPE_UNSPECIFIED",
		1: "CONFIG_ONLY",
		2: "ALL",
		3: "METADATA_ONLY",
	}
	BuilderMask_BuilderMaskType_value = map[string]int32{
		"BUILDER_MASK_TYPE_UNSPECIFIED": 0,
		"CONFIG_ONLY":                   1,
		"ALL":                           2,
		"METADATA_ONLY":                 3,
	}
)

Enum value maps for BuilderMask_BuilderMaskType.

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 (
	Compression_name = map[int32]string{
		0: "ZLIB",
		1: "ZSTD",
	}
	Compression_value = map[string]int32{
		"ZLIB": 0,
		"ZSTD": 1,
	}
)

Enum value maps for Compression.

View Source
var (
	// optional buildbucket.v2.CreateBuildFieldOption create_build_field_option = 54321;
	E_CreateBuildFieldOption = &file_go_chromium_org_luci_buildbucket_proto_field_option_proto_extTypes[0]
	// Custom repeatable field option that allows user to require some fields for
	// a specific rpc. Set this value equal to RPC when using protowalk Field
	// Processor.
	//
	// repeated string required_by_rpc = 54323;
	E_RequiredByRpc = &file_go_chromium_org_luci_buildbucket_proto_field_option_proto_extTypes[1]
)

Extension fields to descriptorpb.FieldOptions.

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 (
	TokenBody_Purpose_name = map[int32]string{
		0: "PURPOSE_UNSPECIFIED",
		1: "BUILD",
		2: "TASK",
		3: "START_BUILD",
		4: "START_BUILD_TASK",
	}
	TokenBody_Purpose_value = map[string]int32{
		"PURPOSE_UNSPECIFIED": 0,
		"BUILD":               1,
		"TASK":                2,
		"START_BUILD":         3,
		"START_BUILD_TASK":    4,
	}
)

Enum value maps for TokenBody_Purpose.

View Source
var (
	TokenEnvelope_Version_name = map[int32]string{
		0: "VERSION_UNSPECIFIED",
		1: "UNENCRYPTED_PASSWORD_LIKE",
		2: "ENCRYPTED",
	}
	TokenEnvelope_Version_value = map[string]int32{
		"VERSION_UNSPECIFIED":       0,
		"UNENCRYPTED_PASSWORD_LIKE": 1,
		"ENCRYPTED":                 2,
	}
)

Enum value maps for TokenEnvelope_Version.

View Source
var (
	// Can be used to indicate that a buildbucket.v2.Build field should be visible
	// to users with the specified permission. By default, buildbucket.builds.get
	// is required to see fields, but this annotation allows that access to be
	// expanded.
	//
	// Note that we assume that users with GET_LIMITED also have LIST, and users
	// with GET also have GET_LIMITED and LIST.
	//
	// optional buildbucket.v2.BuildFieldVisibility visible_with = 910567;
	E_VisibleWith = &file_go_chromium_org_luci_buildbucket_proto_build_field_visibility_proto_extTypes[0]
)

Extension fields to descriptorpb.FieldOptions.

View Source
var File_go_chromium_org_luci_buildbucket_proto_backend_proto protoreflect.FileDescriptor
View Source
var File_go_chromium_org_luci_buildbucket_proto_build_field_visibility_proto protoreflect.FileDescriptor
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_common_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_field_option_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_log_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
View Source
var File_go_chromium_org_luci_buildbucket_proto_task_proto protoreflect.FileDescriptor
View Source
var File_go_chromium_org_luci_buildbucket_proto_token_proto protoreflect.FileDescriptor

Functions

func FileDescriptorSet

func FileDescriptorSet() *descriptorpb.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)

func RegisterTaskBackendLiteServer

func RegisterTaskBackendLiteServer(s prpc.Registrar, srv TaskBackendLiteServer)

func RegisterTaskBackendServer

func RegisterTaskBackendServer(s prpc.Registrar, srv TaskBackendServer)

Types

type Acl

type Acl struct {

	// Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/project_config.proto.
	Role Acl_Role `protobuf:"varint,1,opt,name=role,proto3,enum=buildbucket.Acl_Role" json:"role,omitempty"`
	// Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/project_config.proto.
	Group string `protobuf:"bytes,2,opt,name=group,proto3" json:"group,omitempty"`
	// Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/project_config.proto.
	Identity string `protobuf:"bytes,3,opt,name=identity,proto3" json:"identity,omitempty"`
	// contains filtered or unexported fields
}

Deprecated in favor of LUCI Realms. This proto is totally unused now, exists only to not break older configs that still may have deprecated fields populated.

func (*Acl) Descriptor deprecated

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

Deprecated: Use Acl.ProtoReflect.Descriptor instead.

func (*Acl) GetGroup deprecated

func (x *Acl) GetGroup() string

Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/project_config.proto.

func (*Acl) GetIdentity deprecated

func (x *Acl) GetIdentity() string

Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/project_config.proto.

func (*Acl) GetRole deprecated

func (x *Acl) GetRole() Acl_Role

Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/project_config.proto.

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 Acl_Role

type Acl_Role int32
const (
	Acl_READER    Acl_Role = 0
	Acl_SCHEDULER Acl_Role = 1
	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

type BBAgentArgs

type BBAgentArgs struct {

	// Path to the user executable.
	//
	// Deprecated. Superseded 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 BackendSetting

type BackendSetting struct {

	// Target backend. e.g. "swarming://chromium-swarm".
	Target string `protobuf:"bytes,1,opt,name=target,proto3" json:"target,omitempty"`
	// hostname for the target backend. e.g. chromium-swarm.appspot.com
	Hostname string `protobuf:"bytes,2,opt,name=hostname,proto3" json:"hostname,omitempty"`
	// The associated UpdateBuildTask pubsub id for this task backend.
	// This must be set in order for buildbucket to recieve task updates and send
	// a pubsup topic that the task backend can use to send updates to.
	// This id is provided by the backend owner, but added to buildbucket's service
	// config by the buildbucket team.
	// Buildbucket will subscribe to the pubsub subscription, which itself is
	// subscribed to the topic that task backends send messages to.
	// i.e.
	//
	//	For this pubsub subscription:
	//	    project/cr-buildbucket/subscriptions/chormium-swarm-backend
	//	and topic:
	//	    project/cr-buildbucket/topics/chormium-swarm-backend
	//	The pubsub_id would be:
	//	    chormium-swarm-backend
	//
	// DEPRECATED: please set into `full_mode` field.
	//
	// Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/service_config.proto.
	PubsubId string `protobuf:"bytes,3,opt,name=pubsub_id,json=pubsubId,proto3" json:"pubsub_id,omitempty"`
	// DEPRECATED: please set into `full_mode` field.
	//
	// Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/service_config.proto.
	BuildSyncSetting *BackendSetting_BuildSyncSetting `protobuf:"bytes,4,opt,name=build_sync_setting,json=buildSyncSetting,proto3" json:"build_sync_setting,omitempty"`
	// The mode of the backend.
	//
	// Types that are assignable to Mode:
	//
	//	*BackendSetting_FullMode_
	//	*BackendSetting_LiteMode_
	Mode isBackendSetting_Mode `protobuf_oneof:"Mode"`
	// Maximum time for Buildbucket to retry creating a task.
	//
	// Default timeout is 10 minutes.
	//
	// If the timeout is reached, the build is marked as INFRA_FAILURE status.
	TaskCreatingTimeout *durationpb.Duration `protobuf:"bytes,7,opt,name=task_creating_timeout,json=taskCreatingTimeout,proto3" json:"task_creating_timeout,omitempty"`
	// contains filtered or unexported fields
}

Backend setting.

func (*BackendSetting) Descriptor deprecated

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

Deprecated: Use BackendSetting.ProtoReflect.Descriptor instead.

func (*BackendSetting) GetBuildSyncSetting deprecated

func (x *BackendSetting) GetBuildSyncSetting() *BackendSetting_BuildSyncSetting

Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/service_config.proto.

func (*BackendSetting) GetFullMode

func (x *BackendSetting) GetFullMode() *BackendSetting_FullMode

func (*BackendSetting) GetHostname

func (x *BackendSetting) GetHostname() string

func (*BackendSetting) GetLiteMode

func (x *BackendSetting) GetLiteMode() *BackendSetting_LiteMode

func (*BackendSetting) GetMode

func (m *BackendSetting) GetMode() isBackendSetting_Mode

func (*BackendSetting) GetPubsubId deprecated

func (x *BackendSetting) GetPubsubId() string

Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/service_config.proto.

func (*BackendSetting) GetTarget

func (x *BackendSetting) GetTarget() string

func (*BackendSetting) GetTaskCreatingTimeout

func (x *BackendSetting) GetTaskCreatingTimeout() *durationpb.Duration

func (*BackendSetting) ProtoMessage

func (*BackendSetting) ProtoMessage()

func (*BackendSetting) ProtoReflect

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

func (*BackendSetting) Reset

func (x *BackendSetting) Reset()

func (*BackendSetting) String

func (x *BackendSetting) String() string

type BackendSetting_BuildSyncSetting

type BackendSetting_BuildSyncSetting struct {

	// Number of shards for Buildbucket to save the update_time of the builds on
	// this backend.
	//
	// In Build model, we need to keep an index on the build update time in order
	// to get all builds it haven't heard for a while.
	// To avoid hotspotting, a new computed property NextBackendSyncTime is added
	// for indexing, with format
	// <backend_target>--<project>--<shard index>--<update_time>.
	//
	// Because some backends serves significantly larger amount of builds than
	// other backends, we need different number of shards for each backend.
	//
	// Must be greater than or equal to 0, while 0 effectively means 1 shard.
	//
	// Note: when updating this field, the new number MUST be greater than the
	// old one.
	Shards int32 `protobuf:"varint,1,opt,name=shards,proto3" json:"shards,omitempty"`
	// How often should a incomplete build get updated. If Buildbucket doesn't
	// hear from this build for sync_interval, it will sync it with its backend
	// task.
	//
	// Buildbucket runs a cron job to find builds to sync every minute, so
	// sync_interval_seconds must be greater than or equal to 60.
	//
	// If unset, a default threshold of 5min will be applied.
	SyncIntervalSeconds int32 `protobuf:"varint,2,opt,name=sync_interval_seconds,json=syncIntervalSeconds,proto3" json:"sync_interval_seconds,omitempty"`
	// contains filtered or unexported fields
}

Setting for the fetch tasks cron job.

func (*BackendSetting_BuildSyncSetting) Descriptor deprecated

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

Deprecated: Use BackendSetting_BuildSyncSetting.ProtoReflect.Descriptor instead.

func (*BackendSetting_BuildSyncSetting) GetShards

func (x *BackendSetting_BuildSyncSetting) GetShards() int32

func (*BackendSetting_BuildSyncSetting) GetSyncIntervalSeconds

func (x *BackendSetting_BuildSyncSetting) GetSyncIntervalSeconds() int32

func (*BackendSetting_BuildSyncSetting) ProtoMessage

func (*BackendSetting_BuildSyncSetting) ProtoMessage()

func (*BackendSetting_BuildSyncSetting) ProtoReflect

func (*BackendSetting_BuildSyncSetting) Reset

func (*BackendSetting_BuildSyncSetting) String

type BackendSetting_FullMode

type BackendSetting_FullMode struct {

	// The associated UpdateBuildTask pubsub id for this task backend.
	// This must be set in order for buildbucket to recieve task updates and send
	// a pubsup topic that the task backend can use to send updates to.
	// This id is provided by the backend owner, but added to buildbucket's service
	// config by the buildbucket team.
	// Buildbucket will subscribe to the pubsub subscription, which itself is
	// subscribed to the topic that task backends send messages to.
	// i.e.
	//
	//	For this pubsub subscription:
	//	    project/cr-buildbucket/subscriptions/chormium-swarm-backend
	//	and topic:
	//	    project/cr-buildbucket/topics/chormium-swarm-backend
	//	The pubsub_id would be:
	//	    chormium-swarm-backend
	PubsubId string `protobuf:"bytes,1,opt,name=pubsub_id,json=pubsubId,proto3" json:"pubsub_id,omitempty"`
	// The setting for syncing backend tasks.
	BuildSyncSetting *BackendSetting_BuildSyncSetting `protobuf:"bytes,2,opt,name=build_sync_setting,json=buildSyncSetting,proto3" json:"build_sync_setting,omitempty"`
	// If set to true, visiting "cr-buildbucket.appspot.com/build/<build_id>"
	// will be redirected to the corresponding task page instead of the Milo
	// build page.
	RedirectToTaskPage bool `protobuf:"varint,3,opt,name=redirect_to_task_page,json=redirectToTaskPage,proto3" json:"redirect_to_task_page,omitempty"`
	// contains filtered or unexported fields
}

The corresponding backend should be a full-featured `TaskBackend` implementation.

func (*BackendSetting_FullMode) Descriptor deprecated

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

Deprecated: Use BackendSetting_FullMode.ProtoReflect.Descriptor instead.

func (*BackendSetting_FullMode) GetBuildSyncSetting

func (x *BackendSetting_FullMode) GetBuildSyncSetting() *BackendSetting_BuildSyncSetting

func (*BackendSetting_FullMode) GetPubsubId

func (x *BackendSetting_FullMode) GetPubsubId() string

func (*BackendSetting_FullMode) GetRedirectToTaskPage

func (x *BackendSetting_FullMode) GetRedirectToTaskPage() bool

func (*BackendSetting_FullMode) ProtoMessage

func (*BackendSetting_FullMode) ProtoMessage()

func (*BackendSetting_FullMode) ProtoReflect

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

func (*BackendSetting_FullMode) Reset

func (x *BackendSetting_FullMode) Reset()

func (*BackendSetting_FullMode) String

func (x *BackendSetting_FullMode) String() string

type BackendSetting_FullMode_

type BackendSetting_FullMode_ struct {
	FullMode *BackendSetting_FullMode `protobuf:"bytes,5,opt,name=full_mode,json=fullMode,proto3,oneof"`
}

type BackendSetting_LiteMode

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

The corresponding backend should be a `TaskBackendLite` implementation, where it doesn't support the task update and sync.

func (*BackendSetting_LiteMode) Descriptor deprecated

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

Deprecated: Use BackendSetting_LiteMode.ProtoReflect.Descriptor instead.

func (*BackendSetting_LiteMode) ProtoMessage

func (*BackendSetting_LiteMode) ProtoMessage()

func (*BackendSetting_LiteMode) ProtoReflect

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

func (*BackendSetting_LiteMode) Reset

func (x *BackendSetting_LiteMode) Reset()

func (*BackendSetting_LiteMode) String

func (x *BackendSetting_LiteMode) String() string

type BackendSetting_LiteMode_

type BackendSetting_LiteMode_ struct {
	LiteMode *BackendSetting_LiteMode `protobuf:"bytes,6,opt,name=lite_mode,json=liteMode,proto3,oneof"`
}

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.
	//   - There's no guaranteed order of execution between batch items (i.e.
	//     consider them to all operate independently).
	//   - There is a limit of 200 requests per batch.
	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
	//	*BatchRequest_Request_GetBuildStatus
	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) GetGetBuildStatus

func (x *BatchRequest_Request) GetGetBuildStatus() *GetBuildStatusRequest

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_GetBuildStatus

type BatchRequest_Request_GetBuildStatus struct {
	GetBuildStatus *GetBuildStatusRequest `protobuf:"bytes,5,opt,name=get_build_status,json=getBuildStatus,proto3,oneof"`
}

type BatchRequest_Request_ScheduleBuild

type BatchRequest_Request_ScheduleBuild struct {
	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_GetBuildStatus
	//	*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) GetGetBuildStatus

func (x *BatchResponse_Response) GetGetBuildStatus() *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_GetBuildStatus

type BatchResponse_Response_GetBuildStatus struct {
	GetBuildStatus *Build `protobuf:"bytes,5,opt,name=get_build_status,json=getBuildStatus,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.
	// Regex: ^[a-z0-9\-_.]{1,100}$
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Deprecated and ignored. Use Realms ACLs instead.
	//
	// Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/project_config.proto.
	Acls []*Acl `protobuf:"bytes,2,rep,name=acls,proto3" json:"acls,omitempty"`
	// Buildbucket-swarming integration.
	// Mutually exclusive with builder_template.
	Swarming *Swarming `protobuf:"bytes,3,opt,name=swarming,proto3" json:"swarming,omitempty"`
	// Name of this bucket's shadow bucket for the led builds to use.
	//
	// If omitted, it implies that led builds of this bucket reuse this bucket.
	// This is allowed, but note that it means the led builds will be in
	// the same bucket/builder with the real builds, which means Any users with
	// led access will be able to do ANYTHING that this bucket's bots and
	// service_accounts can do.
	//
	// It could also be noisy, such as:
	//   - On the LUCI UI, led builds will show under the same builder as the real builds,
	//   - Led builds will share the same ResultDB config as the real builds, so
	//     their test results will be exported to the same BigQuery tables.
	//   - Subscribers of Buildbucket PubSub need to filter them out.
	//
	// Note: Don't set it if it's a dynamic bucket. Currently, a dynamic bucket is
	// not allowed to have a shadow bucket.
	Shadow string `protobuf:"bytes,5,opt,name=shadow,proto3" json:"shadow,omitempty"`
	// Security constraints of the bucket.
	//
	// This field is used by CreateBuild on this bucket to constrain proposed
	// Builds. If a build doesn't meet the constraints, it will be rejected.
	// For shadow buckets, this is what prevents the bucket from allowing
	// totally arbitrary Builds.
	//
	// `lucicfg` will automatically populate this for the "primary" bucket
	// when using `luci.builder`.
	//
	// Buildbuceket.CreateBuild will validate the incoming requests to make sure
	// they meet these constraints.
	Constraints *Bucket_Constraints `protobuf:"bytes,6,opt,name=constraints,proto3" json:"constraints,omitempty"`
	// Template of builders in a dynamic bucket.
	// Mutually exclusive with swarming.
	//
	// If is not nil, the bucket is a dynamic LUCI bucket.
	// If a bucket has both swarming and dynamic_builder_template as nil,
	// the bucket is a legacy one.
	DynamicBuilderTemplate *Bucket_DynamicBuilderTemplate `` /* 129-byte string literal not displayed */
	// 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) GetAcls deprecated

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

Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/project_config.proto.

func (*Bucket) GetConstraints

func (x *Bucket) GetConstraints() *Bucket_Constraints

func (*Bucket) GetDynamicBuilderTemplate

func (x *Bucket) GetDynamicBuilderTemplate() *Bucket_DynamicBuilderTemplate

func (*Bucket) GetName

func (x *Bucket) GetName() string

func (*Bucket) GetShadow

func (x *Bucket) GetShadow() 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

type Bucket_Constraints

type Bucket_Constraints struct {

	// Constraints allowed pools.
	// Builds in this bucket must have a "pool" dimension which matches an entry in this list.
	Pools []string `protobuf:"bytes,1,rep,name=pools,proto3" json:"pools,omitempty"`
	// Only service accounts in this list are allowed.
	ServiceAccounts []string `protobuf:"bytes,2,rep,name=service_accounts,json=serviceAccounts,proto3" json:"service_accounts,omitempty"`
	// contains filtered or unexported fields
}

Constraints for a bucket.

Buildbucket.CreateBuild will validate the incoming requests to make sure they meet these constraints.

func (*Bucket_Constraints) Descriptor deprecated

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

Deprecated: Use Bucket_Constraints.ProtoReflect.Descriptor instead.

func (*Bucket_Constraints) GetPools

func (x *Bucket_Constraints) GetPools() []string

func (*Bucket_Constraints) GetServiceAccounts

func (x *Bucket_Constraints) GetServiceAccounts() []string

func (*Bucket_Constraints) ProtoMessage

func (*Bucket_Constraints) ProtoMessage()

func (*Bucket_Constraints) ProtoReflect

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

func (*Bucket_Constraints) Reset

func (x *Bucket_Constraints) Reset()

func (*Bucket_Constraints) String

func (x *Bucket_Constraints) String() string

type Bucket_DynamicBuilderTemplate

type Bucket_DynamicBuilderTemplate struct {

	// The Builder template which is shared among all builders in this dynamic
	// bucket.
	Template *BuilderConfig `protobuf:"bytes,1,opt,name=template,proto3" json:"template,omitempty"`
	// contains filtered or unexported fields
}

Template of builders in a dynamic bucket.

func (*Bucket_DynamicBuilderTemplate) Descriptor deprecated

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

Deprecated: Use Bucket_DynamicBuilderTemplate.ProtoReflect.Descriptor instead.

func (*Bucket_DynamicBuilderTemplate) GetTemplate

func (x *Bucket_DynamicBuilderTemplate) GetTemplate() *BuilderConfig

func (*Bucket_DynamicBuilderTemplate) ProtoMessage

func (*Bucket_DynamicBuilderTemplate) ProtoMessage()

func (*Bucket_DynamicBuilderTemplate) ProtoReflect

func (*Bucket_DynamicBuilderTemplate) Reset

func (x *Bucket_DynamicBuilderTemplate) Reset()

func (*Bucket_DynamicBuilderTemplate) String

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"`
	BuilderInfo *Build_BuilderInfo `protobuf:"bytes,34,opt,name=builder_info,json=builderInfo,proto3" json:"builder_info,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"`
	// Redirect url for the build.
	ViewUrl string `protobuf:"bytes,5,opt,name=view_url,json=viewUrl,proto3" json:"view_url,omitempty"`
	// Verified LUCI identity that canceled this build.
	//
	// Special values:
	// * buildbucket: The build is canceled by buildbucket. This can happen if the
	// build's parent has ended, and the build cannot outlive its parent.
	// * backend: The build's backend task is canceled. For example the build's
	// Swarming task is killed.
	CanceledBy string `protobuf:"bytes,23,opt,name=canceled_by,json=canceledBy,proto3" json:"canceled_by,omitempty"`
	// When the build was created.
	CreateTime *timestamppb.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 *timestamppb.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 *timestamppb.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 *timestamppb.Timestamp `protobuf:"bytes,9,opt,name=update_time,json=updateTime,proto3" json:"update_time,omitempty"`
	// When the cancel process of the build started.
	// Note it's not the time that the cancellation completed, which would be
	// tracked by end_time.
	//
	// During the cancel process, the build still accepts updates.
	//
	// bbagent checks this field at the frequency of
	// buildbucket.MinUpdateBuildInterval. When bbagent sees the build is in
	// cancel process, there are two states:
	//   - it has NOT yet started the exe payload,
	//   - it HAS started the exe payload.
	//
	// In the first state, bbagent will immediately terminate the build without
	// invoking the exe payload at all.
	//
	// In the second state, bbagent will send SIGTERM/CTRL-BREAK to the exe
	// (according to the deadline protocol described in
	// https://chromium.googlesource.com/infra/luci/luci-py/+/HEAD/client/LUCI_CONTEXT.md).
	// After grace_period it will then try to kill the exe.
	//
	// NOTE: There is a race condition here; If bbagent starts the luciexe and
	// then immediately notices that the build is canceled, it's possible that
	// bbagent can send SIGTERM/CTRL-BREAK to the exe before that exe sets up
	// interrupt handlers. There is a bug on file (crbug.com/1311821)
	// which we plan to implement at some point as a mitigation for this.
	//
	// Additionally, the Buildbucket service itself will launch an asynchronous
	// task to terminate the build via the backend API (e.g. Swarming cancellation)
	// if bbagent cannot successfully terminate the exe in time.
	CancelTime *timestamppb.Timestamp `protobuf:"bytes,32,opt,name=cancel_time,json=cancelTime,proto3" json:"cancel_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.
	SummaryMarkdown string `protobuf:"bytes,20,opt,name=summary_markdown,json=summaryMarkdown,proto3" json:"summary_markdown,omitempty"`
	// Markdown reasoning for cancelling the build.
	// Human readable and should be following https://spec.commonmark.org/0.28/.
	CancellationMarkdown string `protobuf:"bytes,33,opt,name=cancellation_markdown,json=cancellationMarkdown,proto3" json:"cancellation_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 *durationpb.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 task will be signaled according to the
	// `deadline` section of
	// https://chromium.googlesource.com/infra/luci/luci-py/+/HEAD/client/LUCI_CONTEXT.md
	// and status_details.timeout is set.
	//
	// The task will have `grace_period` amount of time to handle cleanup
	// before being forcefully terminated.
	ExecutionTimeout *durationpb.Duration `protobuf:"bytes,27,opt,name=execution_timeout,json=executionTimeout,proto3" json:"execution_timeout,omitempty"`
	// Amount of cleanup time after execution_timeout.
	//
	// After being signaled according to execution_timeout, the task will
	// have this duration to clean up before being forcefully terminated.
	//
	// The signalling process is explained in the `deadline` section of
	// https://chromium.googlesource.com/infra/luci/luci-py/+/HEAD/client/LUCI_CONTEXT.md.
	GracePeriod *durationpb.Duration `protobuf:"bytes,29,opt,name=grace_period,json=gracePeriod,proto3" json:"grace_period,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"`
	// Flag to control if the build can outlive its parent.
	//
	// This field is only meaningful if the build has ancestors.
	// If the build has ancestors and the value is false, it means that the build
	// SHOULD reach a terminal status (SUCCESS, FAILURE, INFRA_FAILURE or
	// CANCELED) before its parent. If the child fails to do so, Buildbucket will
	// cancel it some time after the parent build reaches a terminal status.
	//
	// A build that can outlive its parent can also outlive its parent's ancestors.
	CanOutliveParent bool `protobuf:"varint,30,opt,name=can_outlive_parent,json=canOutliveParent,proto3" json:"can_outlive_parent,omitempty"`
	// IDs of the build's ancestors. This includes all parents/grandparents/etc.
	// This is ordered from top-to-bottom so `ancestor_ids[0]` is the root of
	// the builds tree, and `ancestor_ids[-1]` is this build's immediate parent.
	// This does not include any "siblings" at higher levels of the tree, just
	// the direct chain of ancestors from root to this build.
	AncestorIds []int64 `protobuf:"varint,31,rep,packed,name=ancestor_ids,json=ancestorIds,proto3" json:"ancestor_ids,omitempty"`
	// If UNSET, retrying the build is implicitly allowed;
	// If YES, retrying the build is explicitly allowed;
	// If NO, retrying the build is explicitly disallowed,
	//   - any UI displaying the build should remove "retry" button(s),
	//   - ScheduleBuild using the build as template should fail,
	//   - but the build can still be synthesized by SynthesizeBuild.
	Retriable Trinary `protobuf:"varint,35,opt,name=retriable,proto3,enum=buildbucket.v2.Trinary" json:"retriable,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 "mask" 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: 36.

func (*Build) Descriptor deprecated

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

Deprecated: Use Build.ProtoReflect.Descriptor instead.

func (*Build) GetAncestorIds

func (x *Build) GetAncestorIds() []int64

func (*Build) GetBuilder

func (x *Build) GetBuilder() *BuilderID

func (*Build) GetBuilderInfo

func (x *Build) GetBuilderInfo() *Build_BuilderInfo

func (*Build) GetCanOutliveParent

func (x *Build) GetCanOutliveParent() bool

func (*Build) GetCanary

func (x *Build) GetCanary() bool

func (*Build) GetCancelTime

func (x *Build) GetCancelTime() *timestamppb.Timestamp

func (*Build) GetCanceledBy

func (x *Build) GetCanceledBy() string

func (*Build) GetCancellationMarkdown

func (x *Build) GetCancellationMarkdown() string

func (*Build) GetCreateTime

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

func (*Build) GetCreatedBy

func (x *Build) GetCreatedBy() string

func (*Build) GetCritical

func (x *Build) GetCritical() Trinary

func (*Build) GetEndTime

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

func (*Build) GetExe

func (x *Build) GetExe() *Executable

func (*Build) GetExecutionTimeout

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

func (*Build) GetGracePeriod

func (x *Build) GetGracePeriod() *durationpb.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) GetRetriable

func (x *Build) GetRetriable() Trinary

func (*Build) GetSchedulingTimeout

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

func (*Build) GetStartTime

func (x *Build) GetStartTime() *timestamppb.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() *timestamppb.Timestamp

func (*Build) GetViewUrl

func (x *Build) GetViewUrl() string

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

type BuildFieldVisibility

type BuildFieldVisibility int32

Can be used to indicate that a buildbucket.v2.Build field should be visible to users with the specified permission. By default, buildbucket.builds.get is required to see fields, but this enum allows that access to be expanded.

Note that we assume that users with GET_LIMITED also have LIST, and users with GET also have GET_LIMITED and LIST.

IMPORTANT: this enum must be ordered such that permissions that grant more access (e.g. BUILDS_GET_PERMISSION) must always have lower enum numbers than permissions that grant less access (e.g. BUILDS_LIST_PERMISSION).

const (
	// No visibility specified. In this case the visibility defaults to
	// requiring the buildbucket.builds.get permission.
	BuildFieldVisibility_FIELD_VISIBILITY_UNSPECIFIED BuildFieldVisibility = 0
	// Indicates the field will only be visible to users with the
	// buildbucket.builds.get permission.
	BuildFieldVisibility_BUILDS_GET_PERMISSION BuildFieldVisibility = 1
	// Indicates the field will be visible to users with either the
	// buildbucket.builds.getLimited or buildbucket.builds.get permission.
	BuildFieldVisibility_BUILDS_GET_LIMITED_PERMISSION BuildFieldVisibility = 2
	// Indicates the field will be visible to users with either the
	// buildbucket.builds.list, buildbucket.builds.getLimited or
	// buildbucket.builds.get permission.
	BuildFieldVisibility_BUILDS_LIST_PERMISSION BuildFieldVisibility = 3
)

func (BuildFieldVisibility) Descriptor

func (BuildFieldVisibility) Enum

func (BuildFieldVisibility) EnumDescriptor deprecated

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

Deprecated: Use BuildFieldVisibility.Descriptor instead.

func (BuildFieldVisibility) Number

func (BuildFieldVisibility) String

func (x BuildFieldVisibility) String() string

func (BuildFieldVisibility) Type

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"`
	Bbagent     *BuildInfra_BBAgent     `protobuf:"bytes,6,opt,name=bbagent,proto3" json:"bbagent,omitempty"`
	Backend     *BuildInfra_Backend     `protobuf:"bytes,7,opt,name=backend,proto3" json:"backend,omitempty"`
	// It should only be set for led builds.
	Led *BuildInfra_Led `protobuf:"bytes,8,opt,name=led,proto3" json:"led,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) GetBackend

func (x *BuildInfra) GetBackend() *BuildInfra_Backend

func (*BuildInfra) GetBbagent

func (x *BuildInfra) GetBbagent() *BuildInfra_BBAgent

func (*BuildInfra) GetBuildbucket

func (x *BuildInfra) GetBuildbucket() *BuildInfra_Buildbucket

func (*BuildInfra) GetLed

func (x *BuildInfra) GetLed() *BuildInfra_Led

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

type BuildInfra_BBAgent

type BuildInfra_BBAgent struct {

	// Path to the base of the user executable package.
	//
	// Required.
	PayloadPath string `protobuf:"bytes,1,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.
	//
	// Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/build.proto.
	KnownPublicGerritHosts []string `` /* 131-byte string literal not displayed */
	// DEPRECATED: Use build.Infra.Buildbucket.Agent.Input instead.
	//
	// Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/build.proto.
	Input *BuildInfra_BBAgent_Input `protobuf:"bytes,4,opt,name=input,proto3" json:"input,omitempty"`
	// contains filtered or unexported fields
}

BBAgent-specific information.

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

func (*BuildInfra_BBAgent) Descriptor deprecated

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

Deprecated: Use BuildInfra_BBAgent.ProtoReflect.Descriptor instead.

func (*BuildInfra_BBAgent) GetCacheDir

func (x *BuildInfra_BBAgent) GetCacheDir() string

func (*BuildInfra_BBAgent) GetInput deprecated

Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/build.proto.

func (*BuildInfra_BBAgent) GetKnownPublicGerritHosts deprecated

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

Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/build.proto.

func (*BuildInfra_BBAgent) GetPayloadPath

func (x *BuildInfra_BBAgent) GetPayloadPath() string

func (*BuildInfra_BBAgent) ProtoMessage

func (*BuildInfra_BBAgent) ProtoMessage()

func (*BuildInfra_BBAgent) ProtoReflect

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

func (*BuildInfra_BBAgent) Reset

func (x *BuildInfra_BBAgent) Reset()

func (*BuildInfra_BBAgent) String

func (x *BuildInfra_BBAgent) String() string

type BuildInfra_BBAgent_Input

type BuildInfra_BBAgent_Input struct {
	CipdPackages []*BuildInfra_BBAgent_Input_CIPDPackage `protobuf:"bytes,1,rep,name=cipd_packages,json=cipdPackages,proto3" json:"cipd_packages,omitempty"`
	// contains filtered or unexported fields
}

BBAgent-specific input.

func (*BuildInfra_BBAgent_Input) Descriptor deprecated

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

Deprecated: Use BuildInfra_BBAgent_Input.ProtoReflect.Descriptor instead.

func (*BuildInfra_BBAgent_Input) GetCipdPackages

func (*BuildInfra_BBAgent_Input) ProtoMessage

func (*BuildInfra_BBAgent_Input) ProtoMessage()

func (*BuildInfra_BBAgent_Input) ProtoReflect

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

func (*BuildInfra_BBAgent_Input) Reset

func (x *BuildInfra_BBAgent_Input) Reset()

func (*BuildInfra_BBAgent_Input) String

func (x *BuildInfra_BBAgent_Input) String() string

type BuildInfra_BBAgent_Input_CIPDPackage

type BuildInfra_BBAgent_Input_CIPDPackage struct {

	// Name of this CIPD package.
	//
	// Required.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// CIPD package version.
	//
	// Required.
	Version string `protobuf:"bytes,2,opt,name=version,proto3" json:"version,omitempty"`
	// CIPD server to fetch this package from.
	//
	// Required.
	Server string `protobuf:"bytes,3,opt,name=server,proto3" json:"server,omitempty"`
	// Path where this CIPD package should be installed.
	//
	// Required.
	Path string `protobuf:"bytes,4,opt,name=path,proto3" json:"path,omitempty"`
	// contains filtered or unexported fields
}

CIPD Packages to make available for this build.

func (*BuildInfra_BBAgent_Input_CIPDPackage) Descriptor deprecated

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

Deprecated: Use BuildInfra_BBAgent_Input_CIPDPackage.ProtoReflect.Descriptor instead.

func (*BuildInfra_BBAgent_Input_CIPDPackage) GetName

func (*BuildInfra_BBAgent_Input_CIPDPackage) GetPath

func (*BuildInfra_BBAgent_Input_CIPDPackage) GetServer

func (*BuildInfra_BBAgent_Input_CIPDPackage) GetVersion

func (*BuildInfra_BBAgent_Input_CIPDPackage) ProtoMessage

func (*BuildInfra_BBAgent_Input_CIPDPackage) ProtoMessage()

func (*BuildInfra_BBAgent_Input_CIPDPackage) ProtoReflect

func (*BuildInfra_BBAgent_Input_CIPDPackage) Reset

func (*BuildInfra_BBAgent_Input_CIPDPackage) String

type BuildInfra_Backend

type BuildInfra_Backend struct {

	// Configuration supplied to the backend at the time it was instructed to
	// run this build.
	Config *structpb.Struct `protobuf:"bytes,1,opt,name=config,proto3" json:"config,omitempty"`
	// Current backend task status.
	// Updated as build runs.
	Task *Task `protobuf:"bytes,2,opt,name=task,proto3" json:"task,omitempty"`
	// Caches requested by this build.
	Caches []*CacheEntry `protobuf:"bytes,3,rep,name=caches,proto3" json:"caches,omitempty"`
	// Dimensions for the task.
	TaskDimensions []*RequestedDimension `protobuf:"bytes,5,rep,name=task_dimensions,json=taskDimensions,proto3" json:"task_dimensions,omitempty"`
	// Hostname is the hostname for the backend itself.
	Hostname string `protobuf:"bytes,6,opt,name=hostname,proto3" json:"hostname,omitempty"`
	// contains filtered or unexported fields
}

Backend-specific information.

func (*BuildInfra_Backend) Descriptor deprecated

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

Deprecated: Use BuildInfra_Backend.ProtoReflect.Descriptor instead.

func (*BuildInfra_Backend) GetCaches

func (x *BuildInfra_Backend) GetCaches() []*CacheEntry

func (*BuildInfra_Backend) GetConfig

func (x *BuildInfra_Backend) GetConfig() *structpb.Struct

func (*BuildInfra_Backend) GetHostname

func (x *BuildInfra_Backend) GetHostname() string

func (*BuildInfra_Backend) GetTask

func (x *BuildInfra_Backend) GetTask() *Task

func (*BuildInfra_Backend) GetTaskDimensions

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

func (*BuildInfra_Backend) ProtoMessage

func (*BuildInfra_Backend) ProtoMessage()

func (*BuildInfra_Backend) ProtoReflect

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

func (*BuildInfra_Backend) Reset

func (x *BuildInfra_Backend) Reset()

func (*BuildInfra_Backend) String

func (x *BuildInfra_Backend) String() string

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 *structpb.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"`
	// This contains a map of all the experiments involved for this build, as
	// well as which bit of configuration lead to them being set (or unset).
	//
	// Note that if the reason here is EXPERIMENT_REASON_GLOBAL_INACTIVE,
	// then that means that the experiment is completely disabled and has no
	// effect, but your builder or ScheduleBuildRequest still indicated that
	// the experiment should be set. If you see this, then please remove it
	// from your configuration and/or requests.
	ExperimentReasons map[string]BuildInfra_Buildbucket_ExperimentReason `` /* 261-byte string literal not displayed */
	// The agent binary (bbagent or kitchen) resolutions Buildbucket made for this build.
	// This includes all agent_executable references supplied to
	// the TaskBackend in "original" (CIPD) form, to facilitate debugging.
	// DEPRECATED: Use agent.source instead.
	//
	// Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/build.proto.
	AgentExecutable        map[string]*ResolvedDataRef   `` /* 194-byte string literal not displayed */
	Agent                  *BuildInfra_Buildbucket_Agent `protobuf:"bytes,10,opt,name=agent,proto3" json:"agent,omitempty"`
	KnownPublicGerritHosts []string                      `` /* 132-byte string literal not displayed */
	// Flag for if the build should have a build number.
	BuildNumber bool `protobuf:"varint,12,opt,name=build_number,json=buildNumber,proto3" json:"build_number,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) GetAgent

func (*BuildInfra_Buildbucket) GetAgentExecutable deprecated

func (x *BuildInfra_Buildbucket) GetAgentExecutable() map[string]*ResolvedDataRef

Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/build.proto.

func (*BuildInfra_Buildbucket) GetBuildNumber

func (x *BuildInfra_Buildbucket) GetBuildNumber() bool

func (*BuildInfra_Buildbucket) GetExperimentReasons

func (*BuildInfra_Buildbucket) GetHostname

func (x *BuildInfra_Buildbucket) GetHostname() string

func (*BuildInfra_Buildbucket) GetKnownPublicGerritHosts

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

func (*BuildInfra_Buildbucket) GetRequestedDimensions

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

func (*BuildInfra_Buildbucket) GetRequestedProperties

func (x *BuildInfra_Buildbucket) GetRequestedProperties() *structpb.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_Buildbucket_Agent

type BuildInfra_Buildbucket_Agent struct {

	// TODO(crbug.com/1297809): for a long-term solution, we may need to add
	// a top-level `on_path` array field in the input and read the value from
	// configuration files (eg.settings.cfg, builder configs). So it can store
	// the intended order of PATH env var. Then the per-inputDataRef level
	// `on_path` field will be deprecated.
	// Currently, the new BBagent flow merges all inputDataRef-level `on_path`
	// values and sort. This mimics the same behavior of PyBB backend in order
	// to have the cipd_installation migration to roll out first under a minimal risk.
	Input  *BuildInfra_Buildbucket_Agent_Input  `protobuf:"bytes,1,opt,name=input,proto3" json:"input,omitempty"`
	Output *BuildInfra_Buildbucket_Agent_Output `protobuf:"bytes,2,opt,name=output,proto3" json:"output,omitempty"`
	Source *BuildInfra_Buildbucket_Agent_Source `protobuf:"bytes,3,opt,name=source,proto3" json:"source,omitempty"`
	// Maps the relative-to-root directory path in both `input` and `output`
	// to the Purpose of the software in that directory.
	//
	// If a path is not listed here, it is the same as PURPOSE_UNSPECIFIED.
	Purposes map[string]BuildInfra_Buildbucket_Agent_Purpose `` /* 215-byte string literal not displayed */
	// Cache for the cipd client.
	// The cache name should be in the format like `cipd_client_<sha(client_version)>`.
	CipdClientCache *CacheEntry `protobuf:"bytes,5,opt,name=cipd_client_cache,json=cipdClientCache,proto3" json:"cipd_client_cache,omitempty"`
	// Cache for the cipd packages.
	// The cache name should be in the format like `cipd_cache_<sha(task_service_account)>`.
	CipdPackagesCache *CacheEntry `protobuf:"bytes,6,opt,name=cipd_packages_cache,json=cipdPackagesCache,proto3" json:"cipd_packages_cache,omitempty"`
	// contains filtered or unexported fields
}

bbagent will interpret Agent.input, as well as update Agent.output.

func (*BuildInfra_Buildbucket_Agent) Descriptor deprecated

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

Deprecated: Use BuildInfra_Buildbucket_Agent.ProtoReflect.Descriptor instead.

func (*BuildInfra_Buildbucket_Agent) GetCipdClientCache

func (x *BuildInfra_Buildbucket_Agent) GetCipdClientCache() *CacheEntry

func (*BuildInfra_Buildbucket_Agent) GetCipdPackagesCache

func (x *BuildInfra_Buildbucket_Agent) GetCipdPackagesCache() *CacheEntry

func (*BuildInfra_Buildbucket_Agent) GetInput

func (*BuildInfra_Buildbucket_Agent) GetOutput

func (*BuildInfra_Buildbucket_Agent) GetPurposes

func (*BuildInfra_Buildbucket_Agent) GetSource

func (*BuildInfra_Buildbucket_Agent) ProtoMessage

func (*BuildInfra_Buildbucket_Agent) ProtoMessage()

func (*BuildInfra_Buildbucket_Agent) ProtoReflect

func (*BuildInfra_Buildbucket_Agent) Reset

func (x *BuildInfra_Buildbucket_Agent) Reset()

func (*BuildInfra_Buildbucket_Agent) String

type BuildInfra_Buildbucket_Agent_Input

type BuildInfra_Buildbucket_Agent_Input struct {

	// Maps relative-to-root directory to the data.
	//
	// For now, data is only allowed at the 'leaves', e.g. you cannot
	// specify data at "a/b/c" and "a/b" (but "a/b/c" and "a/q" would be OK).
	// All directories beginning with "luci." are reserved for Buildbucket's own use.
	//
	// TODO(crbug.com/1266060): Enforce the above constraints in a later phase.
	// Currently users don't have the flexibility to set the parent directory path.
	Data map[string]*InputDataRef `` /* 149-byte string literal not displayed */
	// Maps relative-to-root directory to the cipd package itself.
	// This is the CIPD client itself and  should be downloaded first so that
	// the packages in the data field above can be downloaded.
	CipdSource map[string]*InputDataRef `` /* 179-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (*BuildInfra_Buildbucket_Agent_Input) Descriptor deprecated

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

Deprecated: Use BuildInfra_Buildbucket_Agent_Input.ProtoReflect.Descriptor instead.

func (*BuildInfra_Buildbucket_Agent_Input) GetCipdSource

func (x *BuildInfra_Buildbucket_Agent_Input) GetCipdSource() map[string]*InputDataRef

func (*BuildInfra_Buildbucket_Agent_Input) GetData

func (*BuildInfra_Buildbucket_Agent_Input) ProtoMessage

func (*BuildInfra_Buildbucket_Agent_Input) ProtoMessage()

func (*BuildInfra_Buildbucket_Agent_Input) ProtoReflect

func (*BuildInfra_Buildbucket_Agent_Input) Reset

func (*BuildInfra_Buildbucket_Agent_Input) String

type BuildInfra_Buildbucket_Agent_Output

type BuildInfra_Buildbucket_Agent_Output struct {

	// Maps relative-to-root directory to the fully-resolved ref.
	//
	// This will always have 1:1 mapping to Agent.Input.data
	ResolvedData  map[string]*ResolvedDataRef `` /* 185-byte string literal not displayed */
	Status        Status                      `protobuf:"varint,2,opt,name=status,proto3,enum=buildbucket.v2.Status" json:"status,omitempty"`
	StatusDetails *StatusDetails              `protobuf:"bytes,3,opt,name=status_details,json=statusDetails,proto3" json:"status_details,omitempty"`
	// Deprecated. Use summary_markdown instead.
	//
	// Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/build.proto.
	SummaryHtml string `protobuf:"bytes,4,opt,name=summary_html,json=summaryHtml,proto3" json:"summary_html,omitempty"`
	// The agent's resolved CIPD ${platform} (e.g. "linux-amd64",
	// "windows-386", etc.).
	//
	// This is trivial for bbagent to calculate (unlike trying to embed
	// its cipd package version inside or along with the executable).
	// Buildbucket is doing a full package -> instance ID resolution at
	// CreateBuild time anyway, so Agent.Source.resolved_instances
	// will give the mapping from `agent_platform` to a precise instance_id
	// which was used.
	AgentPlatform string `protobuf:"bytes,5,opt,name=agent_platform,json=agentPlatform,proto3" json:"agent_platform,omitempty"`
	// Total installation duration for all input data. Currently only record
	// cipd packages installation time.
	TotalDuration   *durationpb.Duration `protobuf:"bytes,6,opt,name=total_duration,json=totalDuration,proto3" json:"total_duration,omitempty"`
	SummaryMarkdown string               `protobuf:"bytes,7,opt,name=summary_markdown,json=summaryMarkdown,proto3" json:"summary_markdown,omitempty"`
	// contains filtered or unexported fields
}

func (*BuildInfra_Buildbucket_Agent_Output) Descriptor deprecated

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

Deprecated: Use BuildInfra_Buildbucket_Agent_Output.ProtoReflect.Descriptor instead.

func (*BuildInfra_Buildbucket_Agent_Output) GetAgentPlatform

func (x *BuildInfra_Buildbucket_Agent_Output) GetAgentPlatform() string

func (*BuildInfra_Buildbucket_Agent_Output) GetResolvedData

func (*BuildInfra_Buildbucket_Agent_Output) GetStatus

func (*BuildInfra_Buildbucket_Agent_Output) GetStatusDetails

func (x *BuildInfra_Buildbucket_Agent_Output) GetStatusDetails() *StatusDetails

func (*BuildInfra_Buildbucket_Agent_Output) GetSummaryHtml deprecated

func (x *BuildInfra_Buildbucket_Agent_Output) GetSummaryHtml() string

Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/build.proto.

func (*BuildInfra_Buildbucket_Agent_Output) GetSummaryMarkdown

func (x *BuildInfra_Buildbucket_Agent_Output) GetSummaryMarkdown() string

func (*BuildInfra_Buildbucket_Agent_Output) GetTotalDuration

func (*BuildInfra_Buildbucket_Agent_Output) ProtoMessage

func (*BuildInfra_Buildbucket_Agent_Output) ProtoMessage()

func (*BuildInfra_Buildbucket_Agent_Output) ProtoReflect

func (*BuildInfra_Buildbucket_Agent_Output) Reset

func (*BuildInfra_Buildbucket_Agent_Output) String

type BuildInfra_Buildbucket_Agent_Purpose

type BuildInfra_Buildbucket_Agent_Purpose int32
const (
	// No categorized/known purpose.
	BuildInfra_Buildbucket_Agent_PURPOSE_UNSPECIFIED BuildInfra_Buildbucket_Agent_Purpose = 0
	// This path contains the contents of the build's `exe.cipd_package`.
	BuildInfra_Buildbucket_Agent_PURPOSE_EXE_PAYLOAD BuildInfra_Buildbucket_Agent_Purpose = 1
	// This path contains data specifically for bbagent's own use.
	//
	// There's a proposal currently to add `nsjail` support to bbagent, and it
	// would need to bring a copy of `nsjail` in order to run the user binary
	// but we wouldn't necessarily want to expose it to the user binary.
	BuildInfra_Buildbucket_Agent_PURPOSE_BBAGENT_UTILITY BuildInfra_Buildbucket_Agent_Purpose = 2
)

func (BuildInfra_Buildbucket_Agent_Purpose) Descriptor

func (BuildInfra_Buildbucket_Agent_Purpose) Enum

func (BuildInfra_Buildbucket_Agent_Purpose) EnumDescriptor deprecated

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

Deprecated: Use BuildInfra_Buildbucket_Agent_Purpose.Descriptor instead.

func (BuildInfra_Buildbucket_Agent_Purpose) Number

func (BuildInfra_Buildbucket_Agent_Purpose) String

func (BuildInfra_Buildbucket_Agent_Purpose) Type

type BuildInfra_Buildbucket_Agent_Source

type BuildInfra_Buildbucket_Agent_Source struct {

	// Types that are assignable to DataType:
	//
	//	*BuildInfra_Buildbucket_Agent_Source_Cipd
	DataType isBuildInfra_Buildbucket_Agent_Source_DataType `protobuf_oneof:"data_type"`
	// contains filtered or unexported fields
}

Source describes where the Agent should be fetched from.

func (*BuildInfra_Buildbucket_Agent_Source) Descriptor deprecated

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

Deprecated: Use BuildInfra_Buildbucket_Agent_Source.ProtoReflect.Descriptor instead.

func (*BuildInfra_Buildbucket_Agent_Source) GetCipd

func (*BuildInfra_Buildbucket_Agent_Source) GetDataType

func (m *BuildInfra_Buildbucket_Agent_Source) GetDataType() isBuildInfra_Buildbucket_Agent_Source_DataType

func (*BuildInfra_Buildbucket_Agent_Source) ProtoMessage

func (*BuildInfra_Buildbucket_Agent_Source) ProtoMessage()

func (*BuildInfra_Buildbucket_Agent_Source) ProtoReflect

func (*BuildInfra_Buildbucket_Agent_Source) Reset

func (*BuildInfra_Buildbucket_Agent_Source) String

type BuildInfra_Buildbucket_Agent_Source_CIPD

type BuildInfra_Buildbucket_Agent_Source_CIPD struct {

	// The CIPD package to use for the agent.
	//
	// Must end in "/${platform}" with no other CIPD variables.
	//
	// If using an experimental agent binary, please make sure the package
	// prefix has been configured here -
	// https://chrome-internal.googlesource.com/infradata/config/+/refs/heads/main/configs/chrome-infra-packages/bootstrap.cfg
	Package string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	// The CIPD version to use for the agent.
	Version string `protobuf:"bytes,2,opt,name=version,proto3" json:"version,omitempty"`
	// The CIPD server to use.
	Server string `protobuf:"bytes,3,opt,name=server,proto3" json:"server,omitempty"`
	// maps ${platform} -> instance_id for resolved agent packages.
	//
	// Will be overwritten at CreateBuild time, should be left empty
	// when creating a new Build.
	ResolvedInstances map[string]string `` /* 200-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (*BuildInfra_Buildbucket_Agent_Source_CIPD) Descriptor deprecated

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

Deprecated: Use BuildInfra_Buildbucket_Agent_Source_CIPD.ProtoReflect.Descriptor instead.

func (*BuildInfra_Buildbucket_Agent_Source_CIPD) GetPackage

func (*BuildInfra_Buildbucket_Agent_Source_CIPD) GetResolvedInstances

func (x *BuildInfra_Buildbucket_Agent_Source_CIPD) GetResolvedInstances() map[string]string

func (*BuildInfra_Buildbucket_Agent_Source_CIPD) GetServer

func (*BuildInfra_Buildbucket_Agent_Source_CIPD) GetVersion

func (*BuildInfra_Buildbucket_Agent_Source_CIPD) ProtoMessage

func (*BuildInfra_Buildbucket_Agent_Source_CIPD) ProtoReflect

func (*BuildInfra_Buildbucket_Agent_Source_CIPD) Reset

func (*BuildInfra_Buildbucket_Agent_Source_CIPD) String

type BuildInfra_Buildbucket_Agent_Source_Cipd

type BuildInfra_Buildbucket_Agent_Source_Cipd struct {
	Cipd *BuildInfra_Buildbucket_Agent_Source_CIPD `protobuf:"bytes,1,opt,name=cipd,proto3,oneof"`
}

type BuildInfra_Buildbucket_ExperimentReason

type BuildInfra_Buildbucket_ExperimentReason int32
const (
	// This value is unused (i.e. if you see this, it's a bug).
	BuildInfra_Buildbucket_EXPERIMENT_REASON_UNSET BuildInfra_Buildbucket_ExperimentReason = 0
	// This experiment was configured from the 'default_value' of a global
	// experiment.
	//
	// See go/buildbucket-settings.cfg for the list of global experiments.
	BuildInfra_Buildbucket_EXPERIMENT_REASON_GLOBAL_DEFAULT BuildInfra_Buildbucket_ExperimentReason = 1
	// This experiment was configured from the Builder configuration.
	BuildInfra_Buildbucket_EXPERIMENT_REASON_BUILDER_CONFIG BuildInfra_Buildbucket_ExperimentReason = 2
	// This experiment was configured from the 'minimum_value' of a global
	// experiment.
	//
	// See go/buildbucket-settings.cfg for the list of global experiments.
	BuildInfra_Buildbucket_EXPERIMENT_REASON_GLOBAL_MINIMUM BuildInfra_Buildbucket_ExperimentReason = 3
	// This experiment was explicitly set from the ScheduleBuildRequest.
	BuildInfra_Buildbucket_EXPERIMENT_REASON_REQUESTED BuildInfra_Buildbucket_ExperimentReason = 4
	// This experiment is inactive and so was removed from the Build.
	//
	// See go/buildbucket-settings.cfg for the list of global experiments.
	BuildInfra_Buildbucket_EXPERIMENT_REASON_GLOBAL_INACTIVE BuildInfra_Buildbucket_ExperimentReason = 5
)

func (BuildInfra_Buildbucket_ExperimentReason) Descriptor

func (BuildInfra_Buildbucket_ExperimentReason) Enum

func (BuildInfra_Buildbucket_ExperimentReason) EnumDescriptor deprecated

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

Deprecated: Use BuildInfra_Buildbucket_ExperimentReason.Descriptor instead.

func (BuildInfra_Buildbucket_ExperimentReason) Number

func (BuildInfra_Buildbucket_ExperimentReason) String

func (BuildInfra_Buildbucket_ExperimentReason) Type

type BuildInfra_Led

type BuildInfra_Led struct {

	// The original bucket this led build is shadowing.
	ShadowedBucket string `protobuf:"bytes,1,opt,name=shadowed_bucket,json=shadowedBucket,proto3" json:"shadowed_bucket,omitempty"`
	// contains filtered or unexported fields
}

Led specific information.

func (*BuildInfra_Led) Descriptor deprecated

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

Deprecated: Use BuildInfra_Led.ProtoReflect.Descriptor instead.

func (*BuildInfra_Led) GetShadowedBucket

func (x *BuildInfra_Led) GetShadowedBucket() string

func (*BuildInfra_Led) ProtoMessage

func (*BuildInfra_Led) ProtoMessage()

func (*BuildInfra_Led) ProtoReflect

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

func (*BuildInfra_Led) Reset

func (x *BuildInfra_Led) Reset()

func (*BuildInfra_Led) String

func (x *BuildInfra_Led) 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.
	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"`
	// Whether to enable ResultDB:Buildbucket integration.
	Enable bool `protobuf:"varint,3,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,4,rep,name=bq_exports,json=bqExports,proto3" json:"bq_exports,omitempty"`
	// Deprecated. Any values specified here are ignored.
	HistoryOptions *v1.HistoryOptions `protobuf:"bytes,5,opt,name=history_options,json=historyOptions,proto3" json:"history_options,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) GetBqExports

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

func (*BuildInfra_ResultDB) GetEnable

func (x *BuildInfra_ResultDB) GetEnable() bool

func (*BuildInfra_ResultDB) GetHistoryOptions

func (x *BuildInfra_ResultDB) GetHistoryOptions() *v1.HistoryOptions

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"`
	// 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 (*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_dir.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 *durationpb.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 (*BuildInfra_Swarming_CacheEntry) GetPath

func (*BuildInfra_Swarming_CacheEntry) GetWaitForWarmCache

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

func (*BuildInfra_Swarming_CacheEntry) ProtoMessage

func (*BuildInfra_Swarming_CacheEntry) ProtoMessage()

func (*BuildInfra_Swarming_CacheEntry) ProtoReflect

func (*BuildInfra_Swarming_CacheEntry) Reset

func (x *BuildInfra_Swarming_CacheEntry) Reset()

func (*BuildInfra_Swarming_CacheEntry) String

type BuildMask

type BuildMask struct {

	// Fields of the Build proto to include.
	//
	// Follows the standard FieldMask semantics as documented at e.g.
	// https://pkg.go.dev/google.golang.org/protobuf/types/known/fieldmaskpb.
	//
	// If not set, the default mask is used, see Build message comments for the
	// list of fields returned by default.
	Fields *fieldmaskpb.FieldMask `protobuf:"bytes,1,opt,name=fields,proto3" json:"fields,omitempty"`
	// Defines a subset of `input.properties` to return.
	//
	// When not empty, implicitly adds the corresponding field to `fields`.
	InputProperties []*structmask.StructMask `protobuf:"bytes,2,rep,name=input_properties,json=inputProperties,proto3" json:"input_properties,omitempty"`
	// Defines a subset of `output.properties` to return.
	//
	// When not empty, implicitly adds the corresponding field to `fields`.
	OutputProperties []*structmask.StructMask `protobuf:"bytes,3,rep,name=output_properties,json=outputProperties,proto3" json:"output_properties,omitempty"`
	// Defines a subset of `infra.buildbucket.requested_properties` to return.
	//
	// When not empty, implicitly adds the corresponding field to `fields`.
	RequestedProperties []*structmask.StructMask `protobuf:"bytes,4,rep,name=requested_properties,json=requestedProperties,proto3" json:"requested_properties,omitempty"`
	// Flag for including all fields.
	//
	// Mutually exclusive with `fields`, `input_properties`, `output_properties`,
	// and `requested_properties`.
	AllFields bool `protobuf:"varint,5,opt,name=all_fields,json=allFields,proto3" json:"all_fields,omitempty"`
	// A status to filter returned `steps` by. If unspecified, no filter is
	// applied. Otherwise filters by the union of the given statuses.
	//
	// No effect unless `fields` specifies that `steps` should be returned or
	// `all_fields` is true.
	StepStatus []Status `` /* 126-byte string literal not displayed */
	// contains filtered or unexported fields
}

Defines a subset of Build fields and properties to return.

func (*BuildMask) Descriptor deprecated

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

Deprecated: Use BuildMask.ProtoReflect.Descriptor instead.

func (*BuildMask) GetAllFields

func (x *BuildMask) GetAllFields() bool

func (*BuildMask) GetFields

func (x *BuildMask) GetFields() *fieldmaskpb.FieldMask

func (*BuildMask) GetInputProperties

func (x *BuildMask) GetInputProperties() []*structmask.StructMask

func (*BuildMask) GetOutputProperties

func (x *BuildMask) GetOutputProperties() []*structmask.StructMask

func (*BuildMask) GetRequestedProperties

func (x *BuildMask) GetRequestedProperties() []*structmask.StructMask

func (*BuildMask) GetStepStatus

func (x *BuildMask) GetStepStatus() []Status

func (*BuildMask) ProtoMessage

func (*BuildMask) ProtoMessage()

func (*BuildMask) ProtoReflect

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

func (*BuildMask) Reset

func (x *BuildMask) Reset()

func (*BuildMask) String

func (x *BuildMask) 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"`
	// DEPRECATED
	//
	// Never implemented.
	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"`
	// 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).
	//
	// NOTE: If you explicitly search for non_production builds with the experiment
	// filter "+luci.non_production", this is implied to be true.
	//
	// 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.
	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"`
	// A build ID.
	//
	// Returned builds will be descendants of this build (e.g. "100" means
	// "any build transitively scheduled starting from build 100").
	//
	// Mutually exclusive with `child_of`.
	DescendantOf int64 `protobuf:"varint,12,opt,name=descendant_of,json=descendantOf,proto3" json:"descendant_of,omitempty"`
	// A build ID.
	//
	// Returned builds will be only the immediate children of this build.
	//
	// Mutually exclusive with `descendant_of`.
	ChildOf int64 `protobuf:"varint,13,opt,name=child_of,json=childOf,proto3" json:"child_of,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) GetChildOf

func (x *BuildPredicate) GetChildOf() int64

func (*BuildPredicate) GetCreateTime

func (x *BuildPredicate) GetCreateTime() *TimeRange

func (*BuildPredicate) GetCreatedBy

func (x *BuildPredicate) GetCreatedBy() string

func (*BuildPredicate) GetDescendantOf

func (x *BuildPredicate) GetDescendantOf() int64

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 (less recent build) boundary. Optional.
	StartBuildId int64 `protobuf:"varint,1,opt,name=start_build_id,json=startBuildId,proto3" json:"start_build_id,omitempty"`
	// Inclusive upper (more recent build) 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
}

Open build range.

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 {

	// A BUILD token to identify UpdateBuild 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 */
	// A START_BUILD token to identify StartBuild RPCs associated with
	// the same build.
	StartBuildToken string `protobuf:"bytes,3,opt,name=start_build_token,json=startBuildToken,proto3" json:"start_build_token,omitempty"`
	// 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) GetStartBuildToken

func (x *BuildSecrets) GetStartBuildToken() 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 BuildTaskUpdate

type BuildTaskUpdate struct {

	// A build ID.
	BuildId string `protobuf:"bytes,1,opt,name=build_id,json=buildId,proto3" json:"build_id,omitempty"`
	// Task
	Task *Task `protobuf:"bytes,2,opt,name=task,proto3" json:"task,omitempty"`
	// contains filtered or unexported fields
}

A message sent by task backends as part of the payload to a pubsub topic corresponding with that backend. Buildbucket handles these pubsub messages with the UpdateBuildTask cloud task. Backends must use this proto when sending pubsub updates to buildbucket.

NOTE: If the task has not been registered with buildbucket yet (by means of RunTask returning or StartBuild doing an initial associaton of the task to the build), then the message will be dropped and lost forever. Use with caution.

func (*BuildTaskUpdate) Descriptor deprecated

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

Deprecated: Use BuildTaskUpdate.ProtoReflect.Descriptor instead.

func (*BuildTaskUpdate) GetBuildId

func (x *BuildTaskUpdate) GetBuildId() string

func (*BuildTaskUpdate) GetTask

func (x *BuildTaskUpdate) GetTask() *Task

func (*BuildTaskUpdate) ProtoMessage

func (*BuildTaskUpdate) ProtoMessage()

func (*BuildTaskUpdate) ProtoReflect

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

func (*BuildTaskUpdate) Reset

func (x *BuildTaskUpdate) Reset()

func (*BuildTaskUpdate) String

func (x *BuildTaskUpdate) String() string

type Build_BuilderInfo

type Build_BuilderInfo struct {
	Description string `protobuf:"bytes,1,opt,name=description,proto3" json:"description,omitempty"`
	// contains filtered or unexported fields
}

Information of the builder, propagated from builder config.

The info captures the state of the builder at creation time. If any information is updated, all future builds will have the new information, while the historical builds persist the old information.

func (*Build_BuilderInfo) Descriptor deprecated

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

Deprecated: Use Build_BuilderInfo.ProtoReflect.Descriptor instead.

func (*Build_BuilderInfo) GetDescription

func (x *Build_BuilderInfo) GetDescription() string

func (*Build_BuilderInfo) ProtoMessage

func (*Build_BuilderInfo) ProtoMessage()

func (*Build_BuilderInfo) ProtoReflect

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

func (*Build_BuilderInfo) Reset

func (x *Build_BuilderInfo) Reset()

func (*Build_BuilderInfo) String

func (x *Build_BuilderInfo) 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 *structpb.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 a detailed breakdown on how experiments
	// work, and go/buildbucket-settings.cfg for the current state of global
	// 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() *structpb.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 *structpb.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"`
	// Build status which is reported by the client via StartBuild or UpdateBuild.
	Status        Status         `protobuf:"varint,6,opt,name=status,proto3,enum=buildbucket.v2.Status" json:"status,omitempty"`
	StatusDetails *StatusDetails `protobuf:"bytes,7,opt,name=status_details,json=statusDetails,proto3" json:"status_details,omitempty"`
	// Deprecated. Use summary_markdown instead.
	//
	// Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/build.proto.
	SummaryHtml     string `protobuf:"bytes,8,opt,name=summary_html,json=summaryHtml,proto3" json:"summary_html,omitempty"`
	SummaryMarkdown string `protobuf:"bytes,2,opt,name=summary_markdown,json=summaryMarkdown,proto3" json:"summary_markdown,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() *structpb.Struct

func (*Build_Output) GetStatus

func (x *Build_Output) GetStatus() Status

func (*Build_Output) GetStatusDetails

func (x *Build_Output) GetStatusDetails() *StatusDetails

func (*Build_Output) GetSummaryHtml deprecated

func (x *Build_Output) GetSummaryHtml() string

Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/build.proto.

func (*Build_Output) GetSummaryMarkdown

func (x *Build_Output) GetSummaryMarkdown() string

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 BuildbucketAgentContext

type BuildbucketAgentContext struct {

	// Should match the task_id that was sent to buildbucket in
	// either RunTaskResposne.Task.Id.Id or in
	// StartBuildTaskRequest.Task.Id.Id
	TaskId string `protobuf:"bytes,1,opt,name=task_id,json=taskId,proto3" json:"task_id,omitempty"`
	// The secrets that was provided to the backend from
	// RunTaskRequest or StartBuildTaskResponse.
	//
	// During the task backend migration, the BuildToken secret
	// bytes sent to swarming will be populated here. Bbagent will
	// read LUCI_CONTEXT provided by raw swarming tasks and convert it to
	// BuildbucketAgentContext. All swarming tasks ran as task backend tasks
	// will use BuildbucketAgentContext directly.
	Secrets *BuildSecrets `protobuf:"bytes,2,opt,name=secrets,proto3" json:"secrets,omitempty"`
	// contains filtered or unexported fields
}

func (*BuildbucketAgentContext) Descriptor deprecated

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

Deprecated: Use BuildbucketAgentContext.ProtoReflect.Descriptor instead.

func (*BuildbucketAgentContext) GetSecrets

func (x *BuildbucketAgentContext) GetSecrets() *BuildSecrets

func (*BuildbucketAgentContext) GetTaskId

func (x *BuildbucketAgentContext) GetTaskId() string

func (*BuildbucketAgentContext) ProtoMessage

func (*BuildbucketAgentContext) ProtoMessage()

func (*BuildbucketAgentContext) ProtoReflect

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

func (*BuildbucketAgentContext) Reset

func (x *BuildbucketAgentContext) Reset()

func (*BuildbucketAgentContext) String

func (x *BuildbucketAgentContext) 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"`
	// Global configs are shared among all buckets and builders defined inside
	// this project.
	CommonConfig *BuildbucketCfg_CommonConfig `protobuf:"bytes,5,opt,name=common_config,json=commonConfig,proto3" json:"common_config,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) GetBuckets

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

func (*BuildbucketCfg) GetCommonConfig

func (x *BuildbucketCfg) GetCommonConfig() *BuildbucketCfg_CommonConfig

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 BuildbucketCfg_CommonConfig

type BuildbucketCfg_CommonConfig struct {

	// A list of PubSub topics that Buildbucket will publish notifications for
	// build status changes in this project.
	// The message data schema can be found in message `BuildsV2PubSub` in
	// https://chromium.googlesource.com/infra/luci/luci-go/+/main/buildbucket/proto/notification.proto
	// Attributes on the pubsub messages:
	// - "project"
	// - "bucket"
	// - "builder"
	// - "is_completed" (The value is either "true" or "false" in string.)
	//
	// Note: `pubsub.topics.publish` permission must be granted to the
	// corresponding luci-project-scoped accounts in the cloud project(s) hosting
	// the topics.
	BuildsNotificationTopics []*BuildbucketCfg_Topic `` /* 135-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (*BuildbucketCfg_CommonConfig) Descriptor deprecated

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

Deprecated: Use BuildbucketCfg_CommonConfig.ProtoReflect.Descriptor instead.

func (*BuildbucketCfg_CommonConfig) GetBuildsNotificationTopics

func (x *BuildbucketCfg_CommonConfig) GetBuildsNotificationTopics() []*BuildbucketCfg_Topic

func (*BuildbucketCfg_CommonConfig) ProtoMessage

func (*BuildbucketCfg_CommonConfig) ProtoMessage()

func (*BuildbucketCfg_CommonConfig) ProtoReflect

func (*BuildbucketCfg_CommonConfig) Reset

func (x *BuildbucketCfg_CommonConfig) Reset()

func (*BuildbucketCfg_CommonConfig) String

func (x *BuildbucketCfg_CommonConfig) String() string

type BuildbucketCfg_Topic

type BuildbucketCfg_Topic struct {

	// Topic name format should be like
	// "projects/<projid>/topics/<topicid>" and conforms to the guideline:
	// https://cloud.google.com/pubsub/docs/admin#resource_names.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// The compression method that  `build_large_fields` uses in pubsub message
	// data. By default, it's ZLIB as this is the most common one and is the
	// built-in lib in many programming languages.
	Compression Compression `protobuf:"varint,2,opt,name=compression,proto3,enum=buildbucket.v2.Compression" json:"compression,omitempty"`
	// contains filtered or unexported fields
}

func (*BuildbucketCfg_Topic) Descriptor deprecated

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

Deprecated: Use BuildbucketCfg_Topic.ProtoReflect.Descriptor instead.

func (*BuildbucketCfg_Topic) GetCompression

func (x *BuildbucketCfg_Topic) GetCompression() Compression

func (*BuildbucketCfg_Topic) GetName

func (x *BuildbucketCfg_Topic) GetName() string

func (*BuildbucketCfg_Topic) ProtoMessage

func (*BuildbucketCfg_Topic) ProtoMessage()

func (*BuildbucketCfg_Topic) ProtoReflect

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

func (*BuildbucketCfg_Topic) Reset

func (x *BuildbucketCfg_Topic) Reset()

func (*BuildbucketCfg_Topic) String

func (x *BuildbucketCfg_Topic) String() string

type BuilderConfig

type BuilderConfig struct {

	// Name of the builder.
	//
	// If a builder name, will be propagated to "builder" build tag and
	// "buildername" recipe property.
	//
	// A builder name must be unique within the bucket, and match regex
	// ^[a-zA-Z0-9\-_.\(\) ]{1,128}$.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// Backend for this builder.
	// If unset, builds are scheduled using the legacy pipeline.
	Backend *BuilderConfig_Backend `protobuf:"bytes,32,opt,name=backend,proto3" json:"backend,omitempty"`
	// Alternate backend to use for this builder when the
	// "luci.buildbucket.backend_alt" experiment is enabled. Works even when
	// `backend` is empty. Useful for migrations to new backends.
	BackendAlt *BuilderConfig_Backend `protobuf:"bytes,33,opt,name=backend_alt,json=backendAlt,proto3" json:"backend_alt,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"`
	// 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 2 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.
	//
	// 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 *BuilderConfig_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"`
	// A list of top-level property names which can be overridden in
	// ScheduleBuildRequest.
	//
	// If this field is the EXACT value `["*"]` then all properties are permitted
	// to be overridden.
	//
	// NOTE: Some executables (such as the recipe engine) can have drastic
	// behavior differences based on some properties (for example, the "recipe"
	// property). If you allow the "recipe" property to be overridden, then anyone
	// with the 'buildbucket.builds.add' permission could create a Build for this
	// Builder running a different recipe (from the same recipe repo).
	AllowedPropertyOverrides []string `` /* 136-byte string literal not displayed */
	// 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.
	//
	// If the timeout is reached, the task will be signaled according to the
	// `deadline` section of
	// https://chromium.googlesource.com/infra/luci/luci-py/+/HEAD/client/LUCI_CONTEXT.md
	// and status_details.timeout is set.
	//
	// The task will have `grace_period` amount of time to handle cleanup
	// before being forcefully terminated.
	//
	// NOTE: This corresponds with Build.execution_timeout and
	// ScheduleBuildRequest.execution_timeout; The name `execution_timeout_secs` and
	// uint32 type are relics of the past.
	ExecutionTimeoutSecs uint32 `protobuf:"varint,7,opt,name=execution_timeout_secs,json=executionTimeoutSecs,proto3" json:"execution_timeout_secs,omitempty"`
	// Maximum amount of time to wait for the next heartbeat(i.e UpdateBuild).
	//
	// After a build is started, the client can send heartbeat requests
	// periodically. Buildbucket will mark the build as INFRA_FAILURE, if the
	// timeout threshold reaches. It’s to fail a build more quickly, rather than
	// waiting for `execution_timeout_secs` to expire. Some V1 users, which don't
	// have real task backends, can utilize this feature.
	//
	// By default, the value is 0, which means no timeout threshold is applied.
	//
	// Note: this field only takes effect for TaskBackendLite builds. For builds
	// with full-featured TaskBackend Implementation, `sync_backend_tasks` cron
	// job fulfills the similar functionality.
	HeartbeatTimeoutSecs uint32 `protobuf:"varint,39,opt,name=heartbeat_timeout_secs,json=heartbeatTimeoutSecs,proto3" json:"heartbeat_timeout_secs,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.
	//
	// NOTE: This corresponds with Build.scheduling_timeout and
	// ScheduleBuildRequest.scheduling_timeout; The name `expiration_secs` and
	// uint32 type are relics of the past.
	ExpirationSecs uint32 `protobuf:"varint,20,opt,name=expiration_secs,json=expirationSecs,proto3" json:"expiration_secs,omitempty"`
	// Amount of cleanup time after execution_timeout_secs.
	//
	// After being signaled according to execution_timeout_secs, the task will
	// have this many seconds to clean up before being forcefully terminated.
	//
	// The signalling process is explained in the `deadline` section of
	// https://chromium.googlesource.com/infra/luci/luci-py/+/HEAD/client/LUCI_CONTEXT.md.
	//
	// Defaults to 30s if unspecified or 0.
	GracePeriod *durationpb.Duration `protobuf:"bytes,31,opt,name=grace_period,json=gracePeriod,proto3" json:"grace_period,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 []*BuilderConfig_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
	//	}
	//
	// (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 *wrapperspb.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
	//
	// Buildbucket has a number of 'global' experiments which are in various
	// states of deployment at any given time. For the current state, see
	// go/buildbucket-settings.cfg.
	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 *BuilderConfig_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"`
	ShadowBuilderAdjustments *BuilderConfig_ShadowBuilderAdjustments `` /* 136-byte string literal not displayed */
	// This field will set the default value of the "retriable" 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.retriable
	Retriable                 Trinary                           `protobuf:"varint,36,opt,name=retriable,proto3,enum=buildbucket.v2.Trinary" json:"retriable,omitempty"`
	BuilderHealthMetricsLinks *BuilderConfig_BuilderHealthLinks `` /* 141-byte string literal not displayed */
	// The owning team's contact email. This team is responsible for fixing
	// any builder health issues (see Builder.Metadata.HealthSpec).
	// Will be validated as an email address, but nothing else.
	// It will display on milo and could be public facing, so please don't put anything sensitive.
	ContactTeamEmail string `protobuf:"bytes,38,opt,name=contact_team_email,json=contactTeamEmail,proto3" json:"contact_team_email,omitempty"`
	// contains filtered or unexported fields
}

Defines a swarmbucket builder. 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: 40.

func (*BuilderConfig) Descriptor deprecated

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

Deprecated: Use BuilderConfig.ProtoReflect.Descriptor instead.

func (*BuilderConfig) GetAllowedPropertyOverrides

func (x *BuilderConfig) GetAllowedPropertyOverrides() []string

func (*BuilderConfig) GetAutoBuilderDimension

func (x *BuilderConfig) GetAutoBuilderDimension() Toggle

func (*BuilderConfig) GetBackend

func (x *BuilderConfig) GetBackend() *BuilderConfig_Backend

func (*BuilderConfig) GetBackendAlt

func (x *BuilderConfig) GetBackendAlt() *BuilderConfig_Backend

func (*BuilderConfig) GetBuildNumbers

func (x *BuilderConfig) GetBuildNumbers() Toggle
func (x *BuilderConfig) GetBuilderHealthMetricsLinks() *BuilderConfig_BuilderHealthLinks

func (*BuilderConfig) GetCaches

func (x *BuilderConfig) GetCaches() []*BuilderConfig_CacheEntry

func (*BuilderConfig) GetCategory

func (x *BuilderConfig) GetCategory() string

func (*BuilderConfig) GetContactTeamEmail

func (x *BuilderConfig) GetContactTeamEmail() string

func (*BuilderConfig) GetCritical

func (x *BuilderConfig) GetCritical() Trinary

func (*BuilderConfig) GetDescriptionHtml

func (x *BuilderConfig) GetDescriptionHtml() string

func (*BuilderConfig) GetDimensions

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

func (*BuilderConfig) GetExe

func (x *BuilderConfig) GetExe() *Executable

func (*BuilderConfig) GetExecutionTimeoutSecs

func (x *BuilderConfig) GetExecutionTimeoutSecs() uint32

func (*BuilderConfig) GetExperimental

func (x *BuilderConfig) GetExperimental() Toggle

func (*BuilderConfig) GetExperiments

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

func (*BuilderConfig) GetExpirationSecs

func (x *BuilderConfig) GetExpirationSecs() uint32

func (*BuilderConfig) GetGracePeriod

func (x *BuilderConfig) GetGracePeriod() *durationpb.Duration

func (*BuilderConfig) GetHeartbeatTimeoutSecs

func (x *BuilderConfig) GetHeartbeatTimeoutSecs() uint32

func (*BuilderConfig) GetName

func (x *BuilderConfig) GetName() string

func (*BuilderConfig) GetPriority

func (x *BuilderConfig) GetPriority() uint32

func (*BuilderConfig) GetProperties

func (x *BuilderConfig) GetProperties() string

func (*BuilderConfig) GetRecipe

func (x *BuilderConfig) GetRecipe() *BuilderConfig_Recipe

func (*BuilderConfig) GetResultdb

func (x *BuilderConfig) GetResultdb() *BuilderConfig_ResultDB

func (*BuilderConfig) GetRetriable

func (x *BuilderConfig) GetRetriable() Trinary

func (*BuilderConfig) GetServiceAccount

func (x *BuilderConfig) GetServiceAccount() string

func (*BuilderConfig) GetShadowBuilderAdjustments

func (x *BuilderConfig) GetShadowBuilderAdjustments() *BuilderConfig_ShadowBuilderAdjustments

func (*BuilderConfig) GetSwarmingHost

func (x *BuilderConfig) GetSwarmingHost() string

func (*BuilderConfig) GetSwarmingTags

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

func (*BuilderConfig) GetTaskTemplateCanaryPercentage

func (x *BuilderConfig) GetTaskTemplateCanaryPercentage() *wrapperspb.UInt32Value

func (*BuilderConfig) GetWaitForCapacity

func (x *BuilderConfig) GetWaitForCapacity() Trinary

func (*BuilderConfig) ProtoMessage

func (*BuilderConfig) ProtoMessage()

func (*BuilderConfig) ProtoReflect

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

func (*BuilderConfig) Reset

func (x *BuilderConfig) Reset()

func (*BuilderConfig) String

func (x *BuilderConfig) String() string

type BuilderConfig_Backend

type BuilderConfig_Backend struct {

	// URI for this backend, e.g. "swarming://chromium-swarm".
	Target string `protobuf:"bytes,1,opt,name=target,proto3" json:"target,omitempty"`
	// A string interpreted as JSON encapsulating configuration for this
	// backend.
	// TODO(crbug.com/1042991): Move priority, wait_for_capacity, etc. here.
	ConfigJson string `protobuf:"bytes,2,opt,name=config_json,json=configJson,proto3" json:"config_json,omitempty"`
	// contains filtered or unexported fields
}

Buildbucket backend-specific information for a builder.

func (*BuilderConfig_Backend) Descriptor deprecated

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

Deprecated: Use BuilderConfig_Backend.ProtoReflect.Descriptor instead.

func (*BuilderConfig_Backend) GetConfigJson

func (x *BuilderConfig_Backend) GetConfigJson() string

func (*BuilderConfig_Backend) GetTarget

func (x *BuilderConfig_Backend) GetTarget() string

func (*BuilderConfig_Backend) ProtoMessage

func (*BuilderConfig_Backend) ProtoMessage()

func (*BuilderConfig_Backend) ProtoReflect

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

func (*BuilderConfig_Backend) Reset

func (x *BuilderConfig_Backend) Reset()

func (*BuilderConfig_Backend) String

func (x *BuilderConfig_Backend) String() string
type BuilderConfig_BuilderHealthLinks struct {

	// Mapping of username domain to clickable link for documentation on the health
	// metrics and how they were calculated.
	//
	// The empty domain value will be used as a fallback for anonymous users, or
	// if the user identity domain doesn't have a matching entry in this map.
	//
	// If linking an internal google link (say g3doc), use a go-link instead of a
	// raw url.
	DocLinks map[string]string `` /* 173-byte string literal not displayed */
	// Mapping of username domain to clickable link for data visualization or
	// dashboards for the health metrics.
	//
	// Similar to doc_links, the empty domain value will be used as a fallback for
	// anonymous users, or if the user identity domain doesn't have a matching
	// entry in this map.
	//
	// If linking an internal google link (say g3doc), use a go-link instead of a
	// raw url.
	DataLinks map[string]string `` /* 176-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (*BuilderConfig_BuilderHealthLinks) Descriptor deprecated

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

Deprecated: Use BuilderConfig_BuilderHealthLinks.ProtoReflect.Descriptor instead.

func (x *BuilderConfig_BuilderHealthLinks) GetDataLinks() map[string]string
func (x *BuilderConfig_BuilderHealthLinks) GetDocLinks() map[string]string

func (*BuilderConfig_BuilderHealthLinks) ProtoMessage

func (*BuilderConfig_BuilderHealthLinks) ProtoMessage()

func (*BuilderConfig_BuilderHealthLinks) ProtoReflect

func (*BuilderConfig_BuilderHealthLinks) Reset

func (*BuilderConfig_BuilderHealthLinks) String

type BuilderConfig_CacheEntry

type BuilderConfig_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 (*BuilderConfig_CacheEntry) Descriptor deprecated

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

Deprecated: Use BuilderConfig_CacheEntry.ProtoReflect.Descriptor instead.

func (*BuilderConfig_CacheEntry) GetEnvVar

func (x *BuilderConfig_CacheEntry) GetEnvVar() string

func (*BuilderConfig_CacheEntry) GetName

func (x *BuilderConfig_CacheEntry) GetName() string

func (*BuilderConfig_CacheEntry) GetPath

func (x *BuilderConfig_CacheEntry) GetPath() string

func (*BuilderConfig_CacheEntry) GetWaitForWarmCacheSecs

func (x *BuilderConfig_CacheEntry) GetWaitForWarmCacheSecs() int32

func (*BuilderConfig_CacheEntry) ProtoMessage

func (*BuilderConfig_CacheEntry) ProtoMessage()

func (*BuilderConfig_CacheEntry) ProtoReflect

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

func (*BuilderConfig_CacheEntry) Reset

func (x *BuilderConfig_CacheEntry) Reset()

func (*BuilderConfig_CacheEntry) String

func (x *BuilderConfig_CacheEntry) String() string

type BuilderConfig_Recipe

type BuilderConfig_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/main` 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 BuilderConfig.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 BuilderConfig.executable and BuilderConfig.properties

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

func (*BuilderConfig_Recipe) Descriptor deprecated

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

Deprecated: Use BuilderConfig_Recipe.ProtoReflect.Descriptor instead.

func (*BuilderConfig_Recipe) GetCipdPackage

func (x *BuilderConfig_Recipe) GetCipdPackage() string

func (*BuilderConfig_Recipe) GetCipdVersion

func (x *BuilderConfig_Recipe) GetCipdVersion() string

func (*BuilderConfig_Recipe) GetName

func (x *BuilderConfig_Recipe) GetName() string

func (*BuilderConfig_Recipe) GetProperties

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

func (*BuilderConfig_Recipe) GetPropertiesJ

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

func (*BuilderConfig_Recipe) ProtoMessage

func (*BuilderConfig_Recipe) ProtoMessage()

func (*BuilderConfig_Recipe) ProtoReflect

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

func (*BuilderConfig_Recipe) Reset

func (x *BuilderConfig_Recipe) Reset()

func (*BuilderConfig_Recipe) String

func (x *BuilderConfig_Recipe) String() string

type BuilderConfig_ResultDB

type BuilderConfig_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"`
	// Deprecated. Any values specified here are ignored.
	HistoryOptions *v1.HistoryOptions `protobuf:"bytes,3,opt,name=history_options,json=historyOptions,proto3" json:"history_options,omitempty"`
	// contains filtered or unexported fields
}

ResultDB-specific information for a builder.

func (*BuilderConfig_ResultDB) Descriptor deprecated

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

Deprecated: Use BuilderConfig_ResultDB.ProtoReflect.Descriptor instead.

func (*BuilderConfig_ResultDB) GetBqExports

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

func (*BuilderConfig_ResultDB) GetEnable

func (x *BuilderConfig_ResultDB) GetEnable() bool

func (*BuilderConfig_ResultDB) GetHistoryOptions

func (x *BuilderConfig_ResultDB) GetHistoryOptions() *v1.HistoryOptions

func (*BuilderConfig_ResultDB) ProtoMessage

func (*BuilderConfig_ResultDB) ProtoMessage()

func (*BuilderConfig_ResultDB) ProtoReflect

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

func (*BuilderConfig_ResultDB) Reset

func (x *BuilderConfig_ResultDB) Reset()

func (*BuilderConfig_ResultDB) String

func (x *BuilderConfig_ResultDB) String() string

type BuilderConfig_ShadowBuilderAdjustments

type BuilderConfig_ShadowBuilderAdjustments struct {
	ServiceAccount string `protobuf:"bytes,1,opt,name=service_account,json=serviceAccount,proto3" json:"service_account,omitempty"`
	Pool           string `protobuf:"bytes,2,opt,name=pool,proto3" json:"pool,omitempty"`
	// A JSON object contains properties to override Build.input.properties
	// when creating the led build.
	// Same as ScheduleBuild, the top-level properties here will override the
	// ones in builder config, instead of deep merge.
	Properties string `protobuf:"bytes,3,opt,name=properties,proto3" json:"properties,omitempty"`
	// Overrides default dimensions defined by builder config.
	// Same as ScheduleBuild,
	// * dimensions with empty value will be excluded.
	// * same key dimensions with both empty and non-empty values are disallowed.
	//
	// Note: for historical reason, pool can be adjusted individually.
	// If pool is adjusted individually, the same change should be reflected in
	// dimensions, and vice versa.
	Dimensions []string `protobuf:"bytes,4,rep,name=dimensions,proto3" json:"dimensions,omitempty"`
	// contains filtered or unexported fields
}

Configurations that need to be replaced when running a led build for this Builder.

Note: Builders in a dynamic bucket cannot have ShadowBuilderAdjustments.

func (*BuilderConfig_ShadowBuilderAdjustments) Descriptor deprecated

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

Deprecated: Use BuilderConfig_ShadowBuilderAdjustments.ProtoReflect.Descriptor instead.

func (*BuilderConfig_ShadowBuilderAdjustments) GetDimensions

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

func (*BuilderConfig_ShadowBuilderAdjustments) GetPool

func (*BuilderConfig_ShadowBuilderAdjustments) GetProperties

func (*BuilderConfig_ShadowBuilderAdjustments) GetServiceAccount

func (x *BuilderConfig_ShadowBuilderAdjustments) GetServiceAccount() string

func (*BuilderConfig_ShadowBuilderAdjustments) ProtoMessage

func (*BuilderConfig_ShadowBuilderAdjustments) ProtoReflect

func (*BuilderConfig_ShadowBuilderAdjustments) Reset

func (*BuilderConfig_ShadowBuilderAdjustments) String

type BuilderID

type BuilderID struct {

	// Project ID, e.g. "chromium". Unique within a LUCI deployment.
	// Regex: ^[a-z0-9\-_]+$
	Project string `protobuf:"bytes,1,opt,name=project,proto3" json:"project,omitempty"`
	// Bucket name, e.g. "try". Unique within the project.
	// Regex: ^[a-z0-9\-_.]{1,100}$
	// 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.
	// Regex: ^[a-zA-Z0-9\-_.\(\) ]{1,128}$
	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 *BuilderConfig `protobuf:"bytes,2,opt,name=config,proto3" json:"config,omitempty"`
	// Metadata surrounding the builder.
	Metadata *BuilderMetadata `protobuf:"bytes,3,opt,name=metadata,proto3" json:"metadata,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() *BuilderConfig

func (*BuilderItem) GetId

func (x *BuilderItem) GetId() *BuilderID

func (*BuilderItem) GetMetadata

func (x *BuilderItem) GetMetadata() *BuilderMetadata

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 BuilderMask

type BuilderMask struct {

	// Type of mask to use to filter BuilderItem.
	Type BuilderMask_BuilderMaskType `protobuf:"varint,1,opt,name=type,proto3,enum=buildbucket.v2.BuilderMask_BuilderMaskType" json:"type,omitempty"`
	// contains filtered or unexported fields
}

func (*BuilderMask) Descriptor deprecated

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

Deprecated: Use BuilderMask.ProtoReflect.Descriptor instead.

func (*BuilderMask) GetType

func (*BuilderMask) ProtoMessage

func (*BuilderMask) ProtoMessage()

func (*BuilderMask) ProtoReflect

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

func (*BuilderMask) Reset

func (x *BuilderMask) Reset()

func (*BuilderMask) String

func (x *BuilderMask) String() string

type BuilderMask_BuilderMaskType

type BuilderMask_BuilderMaskType int32
const (
	BuilderMask_BUILDER_MASK_TYPE_UNSPECIFIED BuilderMask_BuilderMaskType = 0
	// Default. Returns ID + Config fields in BuilderItem.
	BuilderMask_CONFIG_ONLY BuilderMask_BuilderMaskType = 1
	// Returns all fields in BuilderItem.
	BuilderMask_ALL BuilderMask_BuilderMaskType = 2
	// Returns ID + METADATA fields in BuilderItem.
	BuilderMask_METADATA_ONLY BuilderMask_BuilderMaskType = 3
)

func (BuilderMask_BuilderMaskType) Descriptor

func (BuilderMask_BuilderMaskType) Enum

func (BuilderMask_BuilderMaskType) EnumDescriptor deprecated

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

Deprecated: Use BuilderMask_BuilderMaskType.Descriptor instead.

func (BuilderMask_BuilderMaskType) Number

func (BuilderMask_BuilderMaskType) String

func (BuilderMask_BuilderMaskType) Type

type BuilderMetadata

type BuilderMetadata struct {

	// Team that owns the builder
	Owner string `protobuf:"bytes,1,opt,name=owner,proto3" json:"owner,omitempty"`
	// Builders current health status
	Health *HealthStatus `protobuf:"bytes,2,opt,name=health,proto3" json:"health,omitempty"`
	// contains filtered or unexported fields
}

func (*BuilderMetadata) Descriptor deprecated

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

Deprecated: Use BuilderMetadata.ProtoReflect.Descriptor instead.

func (*BuilderMetadata) GetHealth

func (x *BuilderMetadata) GetHealth() *HealthStatus

func (*BuilderMetadata) GetOwner

func (x *BuilderMetadata) GetOwner() string

func (*BuilderMetadata) ProtoMessage

func (*BuilderMetadata) ProtoMessage()

func (*BuilderMetadata) ProtoReflect

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

func (*BuilderMetadata) Reset

func (x *BuilderMetadata) Reset()

func (*BuilderMetadata) String

func (x *BuilderMetadata) 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 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)
	// SetBuilderHealth allows a Builder's health to be set.
	SetBuilderHealth(ctx context.Context, in *SetBuilderHealthRequest, opts ...grpc.CallOption) (*SetBuilderHealthResponse, 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)
	// SetBuilderHealth allows a Builder's health to be set.
	SetBuilderHealth(context.Context, *SetBuilderHealthRequest) (*SetBuilderHealthResponse, 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.mask.
	//
	// Buildbot: if the specified build is a buildbot build, converts it to Build
	// message with the following rules:
	//   - bucket names are full, e.g. "luci.infra.try". Note that LUCI buckets
	//     in v2 are shortened, e.g. "try".
	//   - 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.
	// Examples: go/buildbucket-rpc#getbuild
	//
	// GetBuild is good for getting detailed information for a build.
	// For use cases that only requires build status checking (e.g. wait for a
	// build to complete), please use GetBuildStatus instead.
	GetBuild(ctx context.Context, in *GetBuildRequest, opts ...grpc.CallOption) (*Build, error)
	// Searches for builds.
	// Examples: go/buildbucket-rpc#searchbuilds
	SearchBuilds(ctx context.Context, in *SearchBuildsRequest, opts ...grpc.CallOption) (*SearchBuildsResponse, error)
	// Updates a build.
	//
	// RPC metadata must include "x-buildbucket-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.
	// Example: go/buildbucket-rpc#schedulebuild
	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.
	//
	// When called, Buildbucket will set the build's cancelTime to "now".  It
	// will also recursively start the cancellation process for any children of
	// this build which are marked as can_outlive_parent=false.
	//
	// The next time the build checks in (which happens periodically in
	// `bbagent`), bbagent will see the cancelTime, and start the cancellation
	// process described by the 'deadline' section in
	// https://chromium.googlesource.com/infra/luci/luci-py/+/HEAD/client/LUCI_CONTEXT.md.
	//
	// If the build ends before the build's grace_period, then the final status
	// reported from the build is accepted; this is considered 'graceful termination'.
	//
	// If the build doesn't end within the build's grace_period, Buildbucket will
	// forcibly cancel the build.
	CancelBuild(ctx context.Context, in *CancelBuildRequest, opts ...grpc.CallOption) (*Build, error)
	// Executes multiple requests in a batch.
	// The response code is always OK.
	// Examples: go/buildbucket-rpc#batch
	Batch(ctx context.Context, in *BatchRequest, opts ...grpc.CallOption) (*BatchResponse, error)
	// Creates a new build for the provided build proto.
	//
	// If build with the given ID already exists, returns ALREADY_EXISTS
	// error code.
	CreateBuild(ctx context.Context, in *CreateBuildRequest, opts ...grpc.CallOption) (*Build, error)
	// Synthesizes a build proto.
	//
	// This RPC is exclusively for generating led builds.
	SynthesizeBuild(ctx context.Context, in *SynthesizeBuildRequest, opts ...grpc.CallOption) (*Build, error)
	// Gets a build's status.
	//
	// The returned build contains the requested build id or
	// (builder + build number), and build status.
	//
	// It's useful when a user only wants to check the build's status (i.e. wait
	// for a build to complete).
	GetBuildStatus(ctx context.Context, in *GetBuildStatusRequest, opts ...grpc.CallOption) (*Build, error)
	// Starts a build.
	//
	// RPC metadata must include "x-buildbucket-token" key with
	//   - a BUILD type token generated by the server when it creates a Swarming
	//     task for the build (builds on Swarming) or
	//   - a START_BUILD type token generated by the server when it attempts to run
	//     a backend task (builds on TaskBackend).
	//
	// Agent must call it before making any UpdateBuild calls.
	//
	// StartBuild will associate a task with a build if the association is not done
	// after RunTaskResponse is returned to buildbucket.
	StartBuild(ctx context.Context, in *StartBuildRequest, opts ...grpc.CallOption) (*StartBuildResponse, 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.mask.
	//
	// Buildbot: if the specified build is a buildbot build, converts it to Build
	// message with the following rules:
	//   - bucket names are full, e.g. "luci.infra.try". Note that LUCI buckets
	//     in v2 are shortened, e.g. "try".
	//   - 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.
	// Examples: go/buildbucket-rpc#getbuild
	//
	// GetBuild is good for getting detailed information for a build.
	// For use cases that only requires build status checking (e.g. wait for a
	// build to complete), please use GetBuildStatus instead.
	GetBuild(context.Context, *GetBuildRequest) (*Build, error)
	// Searches for builds.
	// Examples: go/buildbucket-rpc#searchbuilds
	SearchBuilds(context.Context, *SearchBuildsRequest) (*SearchBuildsResponse, error)
	// Updates a build.
	//
	// RPC metadata must include "x-buildbucket-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.
	// Example: go/buildbucket-rpc#schedulebuild
	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.
	//
	// When called, Buildbucket will set the build's cancelTime to "now".  It
	// will also recursively start the cancellation process for any children of
	// this build which are marked as can_outlive_parent=false.
	//
	// The next time the build checks in (which happens periodically in
	// `bbagent`), bbagent will see the cancelTime, and start the cancellation
	// process described by the 'deadline' section in
	// https://chromium.googlesource.com/infra/luci/luci-py/+/HEAD/client/LUCI_CONTEXT.md.
	//
	// If the build ends before the build's grace_period, then the final status
	// reported from the build is accepted; this is considered 'graceful termination'.
	//
	// If the build doesn't end within the build's grace_period, Buildbucket will
	// forcibly cancel the build.
	CancelBuild(context.Context, *CancelBuildRequest) (*Build, error)
	// Executes multiple requests in a batch.
	// The response code is always OK.
	// Examples: go/buildbucket-rpc#batch
	Batch(context.Context, *BatchRequest) (*BatchResponse, error)
	// Creates a new build for the provided build proto.
	//
	// If build with the given ID already exists, returns ALREADY_EXISTS
	// error code.
	CreateBuild(context.Context, *CreateBuildRequest) (*Build, error)
	// Synthesizes a build proto.
	//
	// This RPC is exclusively for generating led builds.
	SynthesizeBuild(context.Context, *SynthesizeBuildRequest) (*Build, error)
	// Gets a build's status.
	//
	// The returned build contains the requested build id or
	// (builder + build number), and build status.
	//
	// It's useful when a user only wants to check the build's status (i.e. wait
	// for a build to complete).
	GetBuildStatus(context.Context, *GetBuildStatusRequest) (*Build, error)
	// Starts a build.
	//
	// RPC metadata must include "x-buildbucket-token" key with
	//   - a BUILD type token generated by the server when it creates a Swarming
	//     task for the build (builds on Swarming) or
	//   - a START_BUILD type token generated by the server when it attempts to run
	//     a backend task (builds on TaskBackend).
	//
	// Agent must call it before making any UpdateBuild calls.
	//
	// StartBuild will associate a task with a build if the association is not done
	// after RunTaskResponse is returned to buildbucket.
	StartBuild(context.Context, *StartBuildRequest) (*StartBuildResponse, error)
}

BuildsServer is the server API for Builds service.

type BuildsV2PubSub

type BuildsV2PubSub struct {

	// Contains all field except large fields
	Build *Build `protobuf:"bytes,1,opt,name=build,proto3" json:"build,omitempty"`
	// A Compressed bytes in proto binary format of buildbucket.v2.Build where
	// it only contains the large build fields - build.input.properties,
	// build.output.properties and build.steps.
	BuildLargeFields []byte `protobuf:"bytes,2,opt,name=build_large_fields,json=buildLargeFields,proto3" json:"build_large_fields,omitempty"`
	// The compression method the above `build_large_fields` uses. By default, it
	// is ZLIB as this is the most common one and is the built-in lib in many
	// programming languages.
	Compression Compression `protobuf:"varint,3,opt,name=compression,proto3,enum=buildbucket.v2.Compression" json:"compression,omitempty"`
	// contains filtered or unexported fields
}

BuildsV2PubSub is the "builds_v2" pubsub topic message data schema. Attributes of this pubsub message: - "project" - "bucket" - "builder" - "is_completed" (The value is either "true" or "false" in string.) - "version" (The value is "v2". To help distinguish messages from the old `builds` topic)

func (*BuildsV2PubSub) Descriptor deprecated

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

Deprecated: Use BuildsV2PubSub.ProtoReflect.Descriptor instead.

func (*BuildsV2PubSub) GetBuild

func (x *BuildsV2PubSub) GetBuild() *Build

func (*BuildsV2PubSub) GetBuildLargeFields

func (x *BuildsV2PubSub) GetBuildLargeFields() []byte

func (*BuildsV2PubSub) GetCompression

func (x *BuildsV2PubSub) GetCompression() Compression

func (*BuildsV2PubSub) ProtoMessage

func (*BuildsV2PubSub) ProtoMessage()

func (*BuildsV2PubSub) ProtoReflect

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

func (*BuildsV2PubSub) Reset

func (x *BuildsV2PubSub) Reset()

func (*BuildsV2PubSub) String

func (x *BuildsV2PubSub) String() string

type CacheEntry

type 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_dir.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 *durationpb.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
}

This message is a duplicate of Build.Infra.Swarming.CacheEntry, however we will be moving from hardcoded swarming -> task backends. This message will remain as the desired CacheEntry and eventually Build.Infra.Swarming will be deprecated, so this will remain.

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.

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.

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 (*CacheEntry) Descriptor deprecated

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

Deprecated: Use CacheEntry.ProtoReflect.Descriptor instead.

func (*CacheEntry) GetEnvVar

func (x *CacheEntry) GetEnvVar() string

func (*CacheEntry) GetName

func (x *CacheEntry) GetName() string

func (*CacheEntry) GetPath

func (x *CacheEntry) GetPath() string

func (*CacheEntry) GetWaitForWarmCache

func (x *CacheEntry) GetWaitForWarmCache() *durationpb.Duration

func (*CacheEntry) ProtoMessage

func (*CacheEntry) ProtoMessage()

func (*CacheEntry) ProtoReflect

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

func (*CacheEntry) Reset

func (x *CacheEntry) Reset()

func (*CacheEntry) String

func (x *CacheEntry) String() string

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.cancellation_markdown. Will be appended to
	// Build.summary_markdown when exporting to bigquery and returned via GetBuild.
	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.
	//
	// DEPRECATED: Use mask instead.
	//
	// Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/builds_service.proto.
	Fields *fieldmaskpb.FieldMask `protobuf:"bytes,100,opt,name=fields,proto3" json:"fields,omitempty"`
	// What portion of the Build message to return.
	//
	// If not set, the default mask is used, see Build message comments for the
	// list of fields returned by default.
	Mask *BuildMask `protobuf:"bytes,101,opt,name=mask,proto3" json:"mask,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 deprecated

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

Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/builds_service.proto.

func (*CancelBuildRequest) GetId

func (x *CancelBuildRequest) GetId() int64

func (*CancelBuildRequest) GetMask

func (x *CancelBuildRequest) GetMask() *BuildMask

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 CancelTasksRequest

type CancelTasksRequest struct {

	// The number of TaskID will never be more than 500.
	TaskIds []*TaskID `protobuf:"bytes,1,rep,name=task_ids,json=taskIds,proto3" json:"task_ids,omitempty"`
	// contains filtered or unexported fields
}

func (*CancelTasksRequest) Descriptor deprecated

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

Deprecated: Use CancelTasksRequest.ProtoReflect.Descriptor instead.

func (*CancelTasksRequest) GetTaskIds

func (x *CancelTasksRequest) GetTaskIds() []*TaskID

func (*CancelTasksRequest) ProtoMessage

func (*CancelTasksRequest) ProtoMessage()

func (*CancelTasksRequest) ProtoReflect

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

func (*CancelTasksRequest) Reset

func (x *CancelTasksRequest) Reset()

func (*CancelTasksRequest) String

func (x *CancelTasksRequest) String() string

type CancelTasksResponse

type CancelTasksResponse struct {

	// These represent the current state of the tasks.
	//
	// If they're not indicated as canceled, Buildbucket will continue
	// to call FetchTasks, or wait until the TaskBackend calls UpdateBuildTask.
	// In other words, cancellation may be sync OR async (and this is up to
	// the specific backend).
	//
	// The TaskBackend SHOULD only indicate a Task is in the canceled when that
	// task has actually stopped execution. For example, if cancelation entails
	// leaving a note for the bot to do the cancelation, ideally these Task
	// objects should only contain the canceled status once the bot has actually
	// terminated (not just when the 'please cancel' note was written).
	Tasks []*Task `protobuf:"bytes,1,rep,name=tasks,proto3" json:"tasks,omitempty"`
	// contains filtered or unexported fields
}

func (*CancelTasksResponse) Descriptor deprecated

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

Deprecated: Use CancelTasksResponse.ProtoReflect.Descriptor instead.

func (*CancelTasksResponse) GetTasks

func (x *CancelTasksResponse) GetTasks() []*Task

func (*CancelTasksResponse) ProtoMessage

func (*CancelTasksResponse) ProtoMessage()

func (*CancelTasksResponse) ProtoReflect

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

func (*CancelTasksResponse) Reset

func (x *CancelTasksResponse) Reset()

func (*CancelTasksResponse) String

func (x *CancelTasksResponse) String() string

type CipdSettings

type CipdSettings struct {

	// default CIPD server to use for this setting configuration,
	// e.g. "chrome-infra-packages.appspot.com".
	Server string `protobuf:"bytes,1,opt,name=server,proto3" json:"server,omitempty"`
	// Source of the cipd package itself
	Source *CipdSettings_Source `protobuf:"bytes,2,opt,name=source,proto3" json:"source,omitempty"`
	// contains filtered or unexported fields
}

func (*CipdSettings) Descriptor deprecated

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

Deprecated: Use CipdSettings.ProtoReflect.Descriptor instead.

func (*CipdSettings) GetServer

func (x *CipdSettings) GetServer() string

func (*CipdSettings) GetSource

func (x *CipdSettings) GetSource() *CipdSettings_Source

func (*CipdSettings) ProtoMessage

func (*CipdSettings) ProtoMessage()

func (*CipdSettings) ProtoReflect

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

func (*CipdSettings) Reset

func (x *CipdSettings) Reset()

func (*CipdSettings) String

func (x *CipdSettings) String() string

type CipdSettings_Source

type CipdSettings_Source struct {

	// CIPD package name, e.g. "infra/tools/cipd/${platform}"
	PackageName string `protobuf:"bytes,2,opt,name=package_name,json=packageName,proto3" json:"package_name,omitempty"`
	// CIPD instance version, e.g. "L34sd94gsdgs4gsd" or some hash.
	// Used for non-canary builds.
	Version string `protobuf:"bytes,3,opt,name=version,proto3" json:"version,omitempty"`
	// CIPD instance version for canary builds.
	// Defaults to version.
	VersionCanary string `protobuf:"bytes,4,opt,name=version_canary,json=versionCanary,proto3" json:"version_canary,omitempty"`
	// contains filtered or unexported fields
}

func (*CipdSettings_Source) Descriptor deprecated

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

Deprecated: Use CipdSettings_Source.ProtoReflect.Descriptor instead.

func (*CipdSettings_Source) GetPackageName

func (x *CipdSettings_Source) GetPackageName() string

func (*CipdSettings_Source) GetVersion

func (x *CipdSettings_Source) GetVersion() string

func (*CipdSettings_Source) GetVersionCanary

func (x *CipdSettings_Source) GetVersionCanary() string

func (*CipdSettings_Source) ProtoMessage

func (*CipdSettings_Source) ProtoMessage()

func (*CipdSettings_Source) ProtoReflect

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

func (*CipdSettings_Source) Reset

func (x *CipdSettings_Source) Reset()

func (*CipdSettings_Source) String

func (x *CipdSettings_Source) String() string

type Compression

type Compression int32

Compression method used in the corresponding data.

const (
	Compression_ZLIB Compression = 0
	Compression_ZSTD Compression = 1
)

func (Compression) Descriptor

func (Compression) Enum

func (x Compression) Enum() *Compression

func (Compression) EnumDescriptor deprecated

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

Deprecated: Use Compression.Descriptor instead.

func (Compression) Number

func (x Compression) Number() protoreflect.EnumNumber

func (Compression) String

func (x Compression) String() string

func (Compression) Type

type CreateBuildFieldOption

type CreateBuildFieldOption struct {
	FieldBehavior annotations.FieldBehavior `` /* 131-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (*CreateBuildFieldOption) Descriptor deprecated

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

Deprecated: Use CreateBuildFieldOption.ProtoReflect.Descriptor instead.

func (*CreateBuildFieldOption) GetFieldBehavior

func (x *CreateBuildFieldOption) GetFieldBehavior() annotations.FieldBehavior

func (*CreateBuildFieldOption) ProtoMessage

func (*CreateBuildFieldOption) ProtoMessage()

func (*CreateBuildFieldOption) ProtoReflect

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

func (*CreateBuildFieldOption) Reset

func (x *CreateBuildFieldOption) Reset()

func (*CreateBuildFieldOption) String

func (x *CreateBuildFieldOption) String() string

type CreateBuildRequest

type CreateBuildRequest struct {

	// The Build to be created.
	Build *Build `protobuf:"bytes,1,opt,name=build,proto3" json:"build,omitempty"`
	// A unique identifier for this request.
	// A random UUID is recommended.
	// This request is only idempotent if a `request_id` is provided.
	RequestId string `protobuf:"bytes,2,opt,name=request_id,json=requestId,proto3" json:"request_id,omitempty"`
	// What portion of the Build message to return.
	//
	// If not set, the default mask is used, see Build message comments for the
	// list of fields returned by default.
	Mask *BuildMask `protobuf:"bytes,3,opt,name=mask,proto3" json:"mask,omitempty"`
	// contains filtered or unexported fields
}

A request message for CreateBuild RPC.

func (*CreateBuildRequest) Descriptor deprecated

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

Deprecated: Use CreateBuildRequest.ProtoReflect.Descriptor instead.

func (*CreateBuildRequest) GetBuild

func (x *CreateBuildRequest) GetBuild() *Build

func (*CreateBuildRequest) GetMask

func (x *CreateBuildRequest) GetMask() *BuildMask

func (*CreateBuildRequest) GetRequestId

func (x *CreateBuildRequest) GetRequestId() string

func (*CreateBuildRequest) ProtoMessage

func (*CreateBuildRequest) ProtoMessage()

func (*CreateBuildRequest) ProtoReflect

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

func (*CreateBuildRequest) Reset

func (x *CreateBuildRequest) Reset()

func (*CreateBuildRequest) String

func (x *CreateBuildRequest) 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 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)

func (*DecoratedBuilders) SetBuilderHealth

func (s *DecoratedBuilders) SetBuilderHealth(ctx context.Context, req *SetBuilderHealthRequest) (rsp *SetBuilderHealthResponse, 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 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) CreateBuild

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

func (*DecoratedBuilds) GetBuild

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

func (*DecoratedBuilds) GetBuildStatus

func (s *DecoratedBuilds) GetBuildStatus(ctx context.Context, req *GetBuildStatusRequest) (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) StartBuild

func (s *DecoratedBuilds) StartBuild(ctx context.Context, req *StartBuildRequest) (rsp *StartBuildResponse, err error)

func (*DecoratedBuilds) SynthesizeBuild

func (s *DecoratedBuilds) SynthesizeBuild(ctx context.Context, req *SynthesizeBuildRequest) (rsp *Build, 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"`
	// Wrapper is a command and its args which will be used to 'wrap' the
	// execution of `cmd`.
	// Given:
	//
	//	wrapper = ['/some/exe', '--arg']
	//	cmd = ['my_exe', '--other-arg']
	//
	// Buildbucket's agent will invoke
	//
	//	/some/exe --arg -- /path/to/task/root/dir/my_exe --other-arg
	//
	// Note that '--' is always inserted between the wrapper and the target
	// cmd
	//
	// The wrapper program MUST maintain all the invariants specified in
	// go.chromium.org/luci/luciexe (likely by passing-through
	// most of this responsibility to `cmd`).
	//
	// wrapper[0] MAY be an absolute path. If https://pkg.go.dev/path/filepath#IsAbs
	// returns `true` for wrapper[0], it will be interpreted as an absolute
	// path. In this case, it is your responsibility to ensure that the target
	// binary is correctly deployed an any machine where the Build might run
	// (by whatever means you use to prepare/adjust your system image). Failure to do
	// so will cause the build to terminate with INFRA_FAILURE.
	//
	// If wrapper[0] is non-absolute, but does not contain a path separator,
	// it will be looked for in $PATH (and the same rules apply for
	// pre-distribution as in the absolute path case).
	//
	// If wrapper[0] begins with a "./" (or ".\") or contains a path separator
	// anywhere, it will be considered relative to the task root.
	//
	// Example wrapper[0]:
	//
	// Absolute path (*nix): /some/prog
	// Absolute path (Windows): C:\some\prog.exe
	// $PATH or %PATH% lookup: prog
	// task-relative (*nix): ./prog ($taskRoot/prog)
	// task-relative (*nix): dir/prog ($taskRoot/dir/prog)
	// task-relative (Windows): .\prog.exe ($taskRoot\\prog.exe)
	// task-relative (Windows): dir\prog.exe ($taskRoot\\dir\\prog.exe)
	Wrapper []string `protobuf:"bytes,4,rep,name=wrapper,proto3" json:"wrapper,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) GetWrapper

func (x *Executable) GetWrapper() []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 ExperimentSettings

type ExperimentSettings struct {
	Experiments []*ExperimentSettings_Experiment `protobuf:"bytes,1,rep,name=experiments,proto3" json:"experiments,omitempty"`
	// contains filtered or unexported fields
}

ExperimentSettings controls all well-known global experiment values.

func (*ExperimentSettings) Descriptor deprecated

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

Deprecated: Use ExperimentSettings.ProtoReflect.Descriptor instead.

func (*ExperimentSettings) GetExperiments

func (x *ExperimentSettings) GetExperiments() []*ExperimentSettings_Experiment

func (*ExperimentSettings) ProtoMessage

func (*ExperimentSettings) ProtoMessage()

func (*ExperimentSettings) ProtoReflect

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

func (*ExperimentSettings) Reset

func (x *ExperimentSettings) Reset()

func (*ExperimentSettings) String

func (x *ExperimentSettings) String() string

type ExperimentSettings_Experiment

type ExperimentSettings_Experiment struct {

	// The name of the global experiment.
	Name string `protobuf:"bytes,1,opt,name=name,proto3" json:"name,omitempty"`
	// The default_value (% chance, 0 - 100) of the global experiment.
	//
	// This must be greater than or equal to minimum_value.
	DefaultValue int32 `protobuf:"varint,2,opt,name=default_value,json=defaultValue,proto3" json:"default_value,omitempty"`
	// The minimum_value (% chance, 0 - 100) of the global experiment.
	//
	// This will override lower Builder-defined experiment values.
	MinimumValue int32 `protobuf:"varint,3,opt,name=minimum_value,json=minimumValue,proto3" json:"minimum_value,omitempty"`
	// Allows temporary exclusion of builders from the experiment.
	// Each line here should have a corresponding bug to remove the exclusion.
	//
	// If a builder is excluded from this experiment, it acts as though
	// default_value and minimum_value are both 0.
	Builders *BuilderPredicate `protobuf:"bytes,4,opt,name=builders,proto3" json:"builders,omitempty"`
	// If this is true it means that the experiment has no effect, and is safe
	// to stop setting in user configs. Additionally, Buildbucket will stop
	// setting this experiment negatively on Builds.
	//
	// When removing a global experiment, set this to true rather than removing
	// the experiment entirely, because Buildbucket still needs this to permit
	// (and ignore) user configs which still mention reserved experiments (e.g.
	// if we have "luci.something" which someone explicitly specifies, and we
	// ramp it to 100% and remove it from the global spec, Buildbucket will
	// start complaining that users are using a reserved experiment name, rather
	// than just ignoring it).
	//
	// If inactive experiments appear in user configurations, it may cause
	// warnings to be printed e.g. at config validation time and/or on the LUCI
	// UI, etc.
	Inactive bool `protobuf:"varint,5,opt,name=inactive,proto3" json:"inactive,omitempty"`
	// contains filtered or unexported fields
}

func (*ExperimentSettings_Experiment) Descriptor deprecated

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

Deprecated: Use ExperimentSettings_Experiment.ProtoReflect.Descriptor instead.

func (*ExperimentSettings_Experiment) GetBuilders

func (*ExperimentSettings_Experiment) GetDefaultValue

func (x *ExperimentSettings_Experiment) GetDefaultValue() int32

func (*ExperimentSettings_Experiment) GetInactive

func (x *ExperimentSettings_Experiment) GetInactive() bool

func (*ExperimentSettings_Experiment) GetMinimumValue

func (x *ExperimentSettings_Experiment) GetMinimumValue() int32

func (*ExperimentSettings_Experiment) GetName

func (*ExperimentSettings_Experiment) ProtoMessage

func (*ExperimentSettings_Experiment) ProtoMessage()

func (*ExperimentSettings_Experiment) ProtoReflect

func (*ExperimentSettings_Experiment) Reset

func (x *ExperimentSettings_Experiment) Reset()

func (*ExperimentSettings_Experiment) String

type FetchTasksRequest

type FetchTasksRequest struct {

	// The number of TaskID will never be more than 1000.
	TaskIds []*TaskID `protobuf:"bytes,1,rep,name=task_ids,json=taskIds,proto3" json:"task_ids,omitempty"`
	// contains filtered or unexported fields
}

func (*FetchTasksRequest) Descriptor deprecated

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

Deprecated: Use FetchTasksRequest.ProtoReflect.Descriptor instead.

func (*FetchTasksRequest) GetTaskIds

func (x *FetchTasksRequest) GetTaskIds() []*TaskID

func (*FetchTasksRequest) ProtoMessage

func (*FetchTasksRequest) ProtoMessage()

func (*FetchTasksRequest) ProtoReflect

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

func (*FetchTasksRequest) Reset

func (x *FetchTasksRequest) Reset()

func (*FetchTasksRequest) String

func (x *FetchTasksRequest) String() string

type FetchTasksResponse

type FetchTasksResponse struct {

	// These should represent the current state of the requested tasks.
	Responses []*FetchTasksResponse_Response `protobuf:"bytes,1,rep,name=responses,proto3" json:"responses,omitempty"`
	// contains filtered or unexported fields
}

func (*FetchTasksResponse) Descriptor deprecated

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

Deprecated: Use FetchTasksResponse.ProtoReflect.Descriptor instead.

func (*FetchTasksResponse) GetResponses

func (x *FetchTasksResponse) GetResponses() []*FetchTasksResponse_Response

func (*FetchTasksResponse) ProtoMessage

func (*FetchTasksResponse) ProtoMessage()

func (*FetchTasksResponse) ProtoReflect

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

func (*FetchTasksResponse) Reset

func (x *FetchTasksResponse) Reset()

func (*FetchTasksResponse) String

func (x *FetchTasksResponse) String() string

type FetchTasksResponse_Response

type FetchTasksResponse_Response struct {

	// Types that are assignable to Response:
	//
	//	*FetchTasksResponse_Response_Task
	//	*FetchTasksResponse_Response_Error
	Response isFetchTasksResponse_Response_Response `protobuf_oneof:"response"`
	// contains filtered or unexported fields
}

func (*FetchTasksResponse_Response) Descriptor deprecated

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

Deprecated: Use FetchTasksResponse_Response.ProtoReflect.Descriptor instead.

func (*FetchTasksResponse_Response) GetError

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

func (*FetchTasksResponse_Response) GetResponse

func (m *FetchTasksResponse_Response) GetResponse() isFetchTasksResponse_Response_Response

func (*FetchTasksResponse_Response) GetTask

func (x *FetchTasksResponse_Response) GetTask() *Task

func (*FetchTasksResponse_Response) ProtoMessage

func (*FetchTasksResponse_Response) ProtoMessage()

func (*FetchTasksResponse_Response) ProtoReflect

func (*FetchTasksResponse_Response) Reset

func (x *FetchTasksResponse_Response) Reset()

func (*FetchTasksResponse_Response) String

func (x *FetchTasksResponse_Response) String() string

type FetchTasksResponse_Response_Error

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

type FetchTasksResponse_Response_Task

type FetchTasksResponse_Response_Task struct {
	// The backend task.
	Task *Task `protobuf:"bytes,1,opt,name=task,proto3,oneof"`
}

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.
	//
	// DEPRECATED: Use mask instead.
	//
	// 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".
	//
	// Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/builds_service.proto.
	Fields *fieldmaskpb.FieldMask `protobuf:"bytes,100,opt,name=fields,proto3" json:"fields,omitempty"`
	// What portion of the Build message to return.
	//
	// If not set, the default mask is used, see Build message comments for the
	// list of fields returned by default.
	Mask *BuildMask `protobuf:"bytes,101,opt,name=mask,proto3" json:"mask,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 deprecated

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

Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/builds_service.proto.

func (*GetBuildRequest) GetId

func (x *GetBuildRequest) GetId() int64

func (*GetBuildRequest) GetMask

func (x *GetBuildRequest) GetMask() *BuildMask

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 GetBuildStatusRequest

type GetBuildStatusRequest 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"`
	// contains filtered or unexported fields
}

A request message for GetBuildStatus RPC.

func (*GetBuildStatusRequest) Descriptor deprecated

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

Deprecated: Use GetBuildStatusRequest.ProtoReflect.Descriptor instead.

func (*GetBuildStatusRequest) GetBuildNumber

func (x *GetBuildStatusRequest) GetBuildNumber() int32

func (*GetBuildStatusRequest) GetBuilder

func (x *GetBuildStatusRequest) GetBuilder() *BuilderID

func (*GetBuildStatusRequest) GetId

func (x *GetBuildStatusRequest) GetId() int64

func (*GetBuildStatusRequest) ProtoMessage

func (*GetBuildStatusRequest) ProtoMessage()

func (*GetBuildStatusRequest) ProtoReflect

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

func (*GetBuildStatusRequest) Reset

func (x *GetBuildStatusRequest) Reset()

func (*GetBuildStatusRequest) String

func (x *GetBuildStatusRequest) 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"`
	// Mask for which fields to include in the response.
	//
	// If not set, the default mask is CONFIG_ONLY.
	Mask *BuilderMask `protobuf:"bytes,2,opt,name=mask,proto3" json:"mask,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) GetMask

func (x *GetBuilderRequest) GetMask() *BuilderMask

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/".
	// If id is set, ref SHOULD also be set, so that git clients can
	// know how to obtain the commit by id.
	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 HealthStatus

type HealthStatus struct {

	// A numeric score for a builder's health.
	// The scores must respect the following:
	//   - 0: Unknown status
	//   - 1: The worst possible health
	//     e.g.
	//   - all bots are dead.
	//   - every single build has ended in INFRA_FAILURE in the configured
	//     time period.
	//   - 10: Completely healthy.
	//     e.g. Every single build has ended in SUCCESS or CANCELLED in the
	//     configured time period.
	//
	// Reasoning for scores from 2 to 9 are to be configured by the builder owner.
	// Since each set of metrics used to calculate the health score can vary, the
	// builder owners must provide the score and reasoning (using the description
	// field). This allows for complicated metric calculation while preserving a
	// binary solution for less complex forms of metric calculation.
	HealthScore int64 `protobuf:"varint,1,opt,name=health_score,json=healthScore,proto3" json:"health_score,omitempty"`
	// A map of metric label to value. This will allow milo to display the metrics
	// used to construct the health score. There is no generic set of metrics for
	// this since each set of metrics can vary from team to team.
	//
	// Buildbucket will not use this information to calculate the health score.
	// These metrics are for display only.
	HealthMetrics map[string]float32 `` /* 190-byte string literal not displayed */
	// A human readable summary of why the health is the way it is, without
	// the user having to go to the dashboard to find it themselves.
	//
	// E.g.
	//
	//	"the p90 pending time has been greater than 50 minutes for at least 3
	//	 of the last 7 days"
	Description string `protobuf:"bytes,3,opt,name=description,proto3" json:"description,omitempty"`
	// Mapping of username domain to clickable link for documentation on the health
	// metrics and how they were calculated.
	//
	// The empty domain value will be used as a fallback for anonymous users, or
	// if the user identity domain doesn't have a matching entry in this map.
	//
	// If linking an internal google link (say g3doc), use a go-link instead of a
	// raw url.
	DocLinks map[string]string `` /* 173-byte string literal not displayed */
	// Mapping of username domain to clickable link for data visualization or
	// dashboards for the health metrics.
	//
	// Similar to doc_links, the empty domain value will be used as a fallback for
	// anonymous users, or if the user identity domain doesn't have a matching
	// entry in this map.
	//
	// If linking an internal google link (say g3doc), use a go-link instead of a
	// raw url.
	DataLinks map[string]string `` /* 176-byte string literal not displayed */
	// Entity that reported the health status, A luci-auth identity.
	// E.g.
	//
	//	anonymous:anonymous, user:someuser@example.com, project:chromeos
	//
	// Set by Buildbucket. Output only.
	Reporter string `protobuf:"bytes,6,opt,name=reporter,proto3" json:"reporter,omitempty"`
	// Set by Buildbucket. Output only.
	ReportedTime *timestamppb.Timestamp `protobuf:"bytes,7,opt,name=reported_time,json=reportedTime,proto3" json:"reported_time,omitempty"`
	// A contact email for the builder's owning team, for the purpose of fixing builder health issues
	// See contact_team_email field in project_config.BuilderConfig
	ContactTeamEmail string `protobuf:"bytes,8,opt,name=contact_team_email,json=contactTeamEmail,proto3" json:"contact_team_email,omitempty"`
	// contains filtered or unexported fields
}

func (*HealthStatus) Descriptor deprecated

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

Deprecated: Use HealthStatus.ProtoReflect.Descriptor instead.

func (*HealthStatus) GetContactTeamEmail

func (x *HealthStatus) GetContactTeamEmail() string
func (x *HealthStatus) GetDataLinks() map[string]string

func (*HealthStatus) GetDescription

func (x *HealthStatus) GetDescription() string
func (x *HealthStatus) GetDocLinks() map[string]string

func (*HealthStatus) GetHealthMetrics

func (x *HealthStatus) GetHealthMetrics() map[string]float32

func (*HealthStatus) GetHealthScore

func (x *HealthStatus) GetHealthScore() int64

func (*HealthStatus) GetReportedTime

func (x *HealthStatus) GetReportedTime() *timestamppb.Timestamp

func (*HealthStatus) GetReporter

func (x *HealthStatus) GetReporter() string

func (*HealthStatus) ProtoMessage

func (*HealthStatus) ProtoMessage()

func (*HealthStatus) ProtoReflect

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

func (*HealthStatus) Reset

func (x *HealthStatus) Reset()

func (*HealthStatus) String

func (x *HealthStatus) String() string

type InputDataRef

type InputDataRef struct {

	// Types that are assignable to DataType:
	//
	//	*InputDataRef_Cas
	//	*InputDataRef_Cipd
	DataType isInputDataRef_DataType `protobuf_oneof:"data_type"`
	// TODO(crbug.com/1266060): TBD. `on_path` may need to move out to be incorporated into a field which captures other envvars.
	// Subdirectories relative to the root of `ref` which should be set as a prefix to
	// the $PATH variable.
	//
	// A substitute of `env_prefixes` in SwarmingRpcsTaskProperties field -
	// https://chromium.googlesource.com/infra/luci/luci-go/+/0048a84944e872776fba3542aa96d5943ae64bab/common/api/swarming/swarming/v1/swarming-gen.go#1495
	OnPath []string `protobuf:"bytes,3,rep,name=on_path,json=onPath,proto3" json:"on_path,omitempty"`
	// contains filtered or unexported fields
}

func (*InputDataRef) Descriptor deprecated

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

Deprecated: Use InputDataRef.ProtoReflect.Descriptor instead.

func (*InputDataRef) GetCas

func (x *InputDataRef) GetCas() *InputDataRef_CAS

func (*InputDataRef) GetCipd

func (x *InputDataRef) GetCipd() *InputDataRef_CIPD

func (*InputDataRef) GetDataType

func (m *InputDataRef) GetDataType() isInputDataRef_DataType

func (*InputDataRef) GetOnPath

func (x *InputDataRef) GetOnPath() []string

func (*InputDataRef) ProtoMessage

func (*InputDataRef) ProtoMessage()

func (*InputDataRef) ProtoReflect

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

func (*InputDataRef) Reset

func (x *InputDataRef) Reset()

func (*InputDataRef) String

func (x *InputDataRef) String() string

type InputDataRef_CAS

type InputDataRef_CAS struct {

	// Full name of RBE-CAS instance. `projects/{project_id}/instances/{instance}`.
	// e.g. projects/chromium-swarm/instances/default_instance
	CasInstance string                   `protobuf:"bytes,1,opt,name=cas_instance,json=casInstance,proto3" json:"cas_instance,omitempty"`
	Digest      *InputDataRef_CAS_Digest `protobuf:"bytes,2,opt,name=digest,proto3" json:"digest,omitempty"`
	// contains filtered or unexported fields
}

func (*InputDataRef_CAS) Descriptor deprecated

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

Deprecated: Use InputDataRef_CAS.ProtoReflect.Descriptor instead.

func (*InputDataRef_CAS) GetCasInstance

func (x *InputDataRef_CAS) GetCasInstance() string

func (*InputDataRef_CAS) GetDigest

func (x *InputDataRef_CAS) GetDigest() *InputDataRef_CAS_Digest

func (*InputDataRef_CAS) ProtoMessage

func (*InputDataRef_CAS) ProtoMessage()

func (*InputDataRef_CAS) ProtoReflect

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

func (*InputDataRef_CAS) Reset

func (x *InputDataRef_CAS) Reset()

func (*InputDataRef_CAS) String

func (x *InputDataRef_CAS) String() string

type InputDataRef_CAS_Digest

type InputDataRef_CAS_Digest struct {
	Hash      string `protobuf:"bytes,1,opt,name=hash,proto3" json:"hash,omitempty"`
	SizeBytes int64  `protobuf:"varint,2,opt,name=size_bytes,json=sizeBytes,proto3" json:"size_bytes,omitempty"`
	// contains filtered or unexported fields
}

This is a [Digest][build.bazel.remote.execution.v2.Digest] of a blob on RBE-CAS. See the explanations at the original definition. https://github.com/bazelbuild/remote-apis/blob/77cfb44a88577a7ade5dd2400425f6d50469ec6d/build/bazel/remote/execution/v2/remote_execution.proto#L753-L791

func (*InputDataRef_CAS_Digest) Descriptor deprecated

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

Deprecated: Use InputDataRef_CAS_Digest.ProtoReflect.Descriptor instead.

func (*InputDataRef_CAS_Digest) GetHash

func (x *InputDataRef_CAS_Digest) GetHash() string

func (*InputDataRef_CAS_Digest) GetSizeBytes

func (x *InputDataRef_CAS_Digest) GetSizeBytes() int64

func (*InputDataRef_CAS_Digest) ProtoMessage

func (*InputDataRef_CAS_Digest) ProtoMessage()

func (*InputDataRef_CAS_Digest) ProtoReflect

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

func (*InputDataRef_CAS_Digest) Reset

func (x *InputDataRef_CAS_Digest) Reset()

func (*InputDataRef_CAS_Digest) String

func (x *InputDataRef_CAS_Digest) String() string

type InputDataRef_CIPD

type InputDataRef_CIPD struct {
	Server string                       `protobuf:"bytes,1,opt,name=server,proto3" json:"server,omitempty"`
	Specs  []*InputDataRef_CIPD_PkgSpec `protobuf:"bytes,2,rep,name=specs,proto3" json:"specs,omitempty"`
	// contains filtered or unexported fields
}

func (*InputDataRef_CIPD) Descriptor deprecated

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

Deprecated: Use InputDataRef_CIPD.ProtoReflect.Descriptor instead.

func (*InputDataRef_CIPD) GetServer

func (x *InputDataRef_CIPD) GetServer() string

func (*InputDataRef_CIPD) GetSpecs

func (*InputDataRef_CIPD) ProtoMessage

func (*InputDataRef_CIPD) ProtoMessage()

func (*InputDataRef_CIPD) ProtoReflect

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

func (*InputDataRef_CIPD) Reset

func (x *InputDataRef_CIPD) Reset()

func (*InputDataRef_CIPD) String

func (x *InputDataRef_CIPD) String() string

type InputDataRef_CIPD_PkgSpec

type InputDataRef_CIPD_PkgSpec struct {

	// Package MAY include CIPD variables, including conditional variables like
	// `${os=windows}`. Additionally, version may be a ref or a tag.
	Package string `protobuf:"bytes,1,opt,name=package,proto3" json:"package,omitempty"`
	Version string `protobuf:"bytes,2,opt,name=version,proto3" json:"version,omitempty"`
	// contains filtered or unexported fields
}

func (*InputDataRef_CIPD_PkgSpec) Descriptor deprecated

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

Deprecated: Use InputDataRef_CIPD_PkgSpec.ProtoReflect.Descriptor instead.

func (*InputDataRef_CIPD_PkgSpec) GetPackage

func (x *InputDataRef_CIPD_PkgSpec) GetPackage() string

func (*InputDataRef_CIPD_PkgSpec) GetVersion

func (x *InputDataRef_CIPD_PkgSpec) GetVersion() string

func (*InputDataRef_CIPD_PkgSpec) ProtoMessage

func (*InputDataRef_CIPD_PkgSpec) ProtoMessage()

func (*InputDataRef_CIPD_PkgSpec) ProtoReflect

func (*InputDataRef_CIPD_PkgSpec) Reset

func (x *InputDataRef_CIPD_PkgSpec) Reset()

func (*InputDataRef_CIPD_PkgSpec) String

func (x *InputDataRef_CIPD_PkgSpec) String() string

type InputDataRef_Cas

type InputDataRef_Cas struct {
	Cas *InputDataRef_CAS `protobuf:"bytes,1,opt,name=cas,proto3,oneof"`
}

type InputDataRef_Cipd

type InputDataRef_Cipd struct {
	Cipd *InputDataRef_CIPD `protobuf:"bytes,2,opt,name=cipd,proto3,oneof"`
}

type ListBuildersRequest

type ListBuildersRequest struct {

	// LUCI project, e.g. "chromium". Omit to list all builders.
	//
	// Required when bucket is specified.
	Project string `protobuf:"bytes,1,opt,name=project,proto3" json:"project,omitempty"`
	// A bucket in the project, e.g. "try".
	//
	// Omit to list all builders or all builders in a project.
	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 MockBuildersClient

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

MockBuildersClient is a mock of BuildersClient interface.

func NewMockBuildersClient

func NewMockBuildersClient(ctrl *gomock.Controller) *MockBuildersClient

NewMockBuildersClient creates a new mock instance.

func (*MockBuildersClient) EXPECT

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

func (*MockBuildersClient) GetBuilder

func (m *MockBuildersClient) GetBuilder(ctx context.Context, in *GetBuilderRequest, opts ...grpc.CallOption) (*BuilderItem, error)

GetBuilder mocks base method.

func (*MockBuildersClient) ListBuilders

ListBuilders mocks base method.

func (*MockBuildersClient) SetBuilderHealth

SetBuilderHealth mocks base method.

type MockBuildersClientMockRecorder

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

MockBuildersClientMockRecorder is the mock recorder for MockBuildersClient.

func (*MockBuildersClientMockRecorder) GetBuilder

func (mr *MockBuildersClientMockRecorder) GetBuilder(ctx, in interface{}, opts ...interface{}) *gomock.Call

GetBuilder indicates an expected call of GetBuilder.

func (*MockBuildersClientMockRecorder) ListBuilders

func (mr *MockBuildersClientMockRecorder) ListBuilders(ctx, in interface{}, opts ...interface{}) *gomock.Call

ListBuilders indicates an expected call of ListBuilders.

func (*MockBuildersClientMockRecorder) SetBuilderHealth

func (mr *MockBuildersClientMockRecorder) SetBuilderHealth(ctx, in interface{}, opts ...interface{}) *gomock.Call

SetBuilderHealth indicates an expected call of SetBuilderHealth.

type MockBuildersServer

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

MockBuildersServer is a mock of BuildersServer interface.

func NewMockBuildersServer

func NewMockBuildersServer(ctrl *gomock.Controller) *MockBuildersServer

NewMockBuildersServer creates a new mock instance.

func (*MockBuildersServer) EXPECT

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

func (*MockBuildersServer) GetBuilder

func (m *MockBuildersServer) GetBuilder(arg0 context.Context, arg1 *GetBuilderRequest) (*BuilderItem, error)

GetBuilder mocks base method.

func (*MockBuildersServer) ListBuilders

ListBuilders mocks base method.

func (*MockBuildersServer) SetBuilderHealth

SetBuilderHealth mocks base method.

type MockBuildersServerMockRecorder

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

MockBuildersServerMockRecorder is the mock recorder for MockBuildersServer.

func (*MockBuildersServerMockRecorder) GetBuilder

func (mr *MockBuildersServerMockRecorder) GetBuilder(arg0, arg1 interface{}) *gomock.Call

GetBuilder indicates an expected call of GetBuilder.

func (*MockBuildersServerMockRecorder) ListBuilders

func (mr *MockBuildersServerMockRecorder) ListBuilders(arg0, arg1 interface{}) *gomock.Call

ListBuilders indicates an expected call of ListBuilders.

func (*MockBuildersServerMockRecorder) SetBuilderHealth

func (mr *MockBuildersServerMockRecorder) SetBuilderHealth(arg0, arg1 interface{}) *gomock.Call

SetBuilderHealth indicates an expected call of SetBuilderHealth.

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

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) CreateBuild

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

CreateBuild mocks base method.

func (*MockBuildsClient) EXPECT

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) GetBuildStatus

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

GetBuildStatus 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

SearchBuilds mocks base method.

func (*MockBuildsClient) StartBuild

StartBuild mocks base method.

func (*MockBuildsClient) SynthesizeBuild

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

SynthesizeBuild 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) CreateBuild

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

CreateBuild indicates an expected call of CreateBuild.

func (*MockBuildsClientMockRecorder) GetBuild

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

GetBuild indicates an expected call of GetBuild.

func (*MockBuildsClientMockRecorder) GetBuildStatus

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

GetBuildStatus indicates an expected call of GetBuildStatus.

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) StartBuild

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

StartBuild indicates an expected call of StartBuild.

func (*MockBuildsClientMockRecorder) SynthesizeBuild

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

SynthesizeBuild indicates an expected call of SynthesizeBuild.

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) CreateBuild

func (m *MockBuildsServer) CreateBuild(arg0 context.Context, arg1 *CreateBuildRequest) (*Build, error)

CreateBuild mocks base method.

func (*MockBuildsServer) EXPECT

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) GetBuildStatus

func (m *MockBuildsServer) GetBuildStatus(arg0 context.Context, arg1 *GetBuildStatusRequest) (*Build, error)

GetBuildStatus mocks base method.

func (*MockBuildsServer) ScheduleBuild

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

ScheduleBuild mocks base method.

func (*MockBuildsServer) SearchBuilds

SearchBuilds mocks base method.

func (*MockBuildsServer) StartBuild

StartBuild mocks base method.

func (*MockBuildsServer) SynthesizeBuild

func (m *MockBuildsServer) SynthesizeBuild(arg0 context.Context, arg1 *SynthesizeBuildRequest) (*Build, error)

SynthesizeBuild 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) CreateBuild

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

CreateBuild indicates an expected call of CreateBuild.

func (*MockBuildsServerMockRecorder) GetBuild

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

GetBuild indicates an expected call of GetBuild.

func (*MockBuildsServerMockRecorder) GetBuildStatus

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

GetBuildStatus indicates an expected call of GetBuildStatus.

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) StartBuild

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

StartBuild indicates an expected call of StartBuild.

func (*MockBuildsServerMockRecorder) SynthesizeBuild

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

SynthesizeBuild indicates an expected call of SynthesizeBuild.

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

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

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 MockisSetBuilderHealthResponse_Response_Response

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

MockisSetBuilderHealthResponse_Response_Response is a mock of isSetBuilderHealthResponse_Response_Response interface.

func NewMockisSetBuilderHealthResponse_Response_Response

func NewMockisSetBuilderHealthResponse_Response_Response(ctrl *gomock.Controller) *MockisSetBuilderHealthResponse_Response_Response

NewMockisSetBuilderHealthResponse_Response_Response creates a new mock instance.

func (*MockisSetBuilderHealthResponse_Response_Response) EXPECT

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

type MockisSetBuilderHealthResponse_Response_ResponseMockRecorder

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

MockisSetBuilderHealthResponse_Response_ResponseMockRecorder is the mock recorder for MockisSetBuilderHealthResponse_Response_Response.

type NotificationConfig

type NotificationConfig struct {

	// Target Cloud PubSub topic.
	// Usually has format "projects/{cloud project}/topics/{topic name}".
	//
	// The PubSub message data schema is defined in `PubSubCallBack` in this file.
	//
	// The legacy schema is:
	//
	//	 {
	//	  'build': ${BuildMessage},
	//	  'user_data': ${NotificationConfig.user_data}
	//	  'hostname': 'cr-buildbucket.appspot.com',
	//	}
	//
	// where the BuildMessage is
	// https://chromium.googlesource.com/infra/infra.git/+/b3204748243a9e4bf815a7024e921be46e3e1747/appengine/cr-buildbucket/legacy/api_common.py#94
	//
	// Note: The legacy data schema is deprecated. Only a few old users are using
	// it and will be migrated soon.
	//
	// <buildbucket-app-id>@appspot.gserviceaccount.com must have
	// "pubsub.topics.publish" and "pubsub.topics.get" 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 PubSubCallBack.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 for per-build notification. It's usually set by the caller on each ScheduleBuild request.

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 PRPCRequestLog

type PRPCRequestLog struct {

	// An ID associated with this request log.
	Id string `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	// Any parent ID associated with this request log.
	// Typically a parent will be the batch request containing this request.
	Parent string `protobuf:"bytes,2,opt,name=parent,proto3" json:"parent,omitempty"`
	// When the request being logged was received (microseconds since epoch).
	CreationTime int64 `protobuf:"varint,3,opt,name=creation_time,json=creationTime,proto3" json:"creation_time,omitempty"`
	// Duration of the request in microseconds.
	Duration int64 `protobuf:"varint,4,opt,name=duration,proto3" json:"duration,omitempty"`
	// Method called. e.g. "Builds.GetBuild".
	Method string `protobuf:"bytes,5,opt,name=method,proto3" json:"method,omitempty"`
	// Caller auth identity (e.g. "<kind>:<id>"). Only set when the caller is a
	// robot or anonymous.
	User string `protobuf:"bytes,6,opt,name=user,proto3" json:"user,omitempty"`
	// contains filtered or unexported fields
}

A pRPC request log.

func (*PRPCRequestLog) Descriptor deprecated

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

Deprecated: Use PRPCRequestLog.ProtoReflect.Descriptor instead.

func (*PRPCRequestLog) GetCreationTime

func (x *PRPCRequestLog) GetCreationTime() int64

func (*PRPCRequestLog) GetDuration

func (x *PRPCRequestLog) GetDuration() int64

func (*PRPCRequestLog) GetId

func (x *PRPCRequestLog) GetId() string

func (*PRPCRequestLog) GetMethod

func (x *PRPCRequestLog) GetMethod() string

func (*PRPCRequestLog) GetParent

func (x *PRPCRequestLog) GetParent() string

func (*PRPCRequestLog) GetUser

func (x *PRPCRequestLog) GetUser() string

func (*PRPCRequestLog) ProtoMessage

func (*PRPCRequestLog) ProtoMessage()

func (*PRPCRequestLog) ProtoReflect

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

func (*PRPCRequestLog) Reset

func (x *PRPCRequestLog) Reset()

func (*PRPCRequestLog) String

func (x *PRPCRequestLog) String() string

type PubSubCallBack

type PubSubCallBack struct {

	// Buildbucket build
	BuildPubsub *BuildsV2PubSub `protobuf:"bytes,1,opt,name=build_pubsub,json=buildPubsub,proto3" json:"build_pubsub,omitempty"`
	// User-defined opaque blob specified in NotificationConfig.user_data.
	UserData []byte `protobuf:"bytes,2,opt,name=user_data,json=userData,proto3" json:"user_data,omitempty"`
	// contains filtered or unexported fields
}

PubSubCallBack is the message data schema for the ad-hoc pubsub notification specified per ScheduleBuild request level. Attributes of this pubsub message: - "project" - "bucket" - "builder" - "is_completed" (The value is either "true" or "false" in string.) - "version" (The value is "v2". To help distinguish messages from the old `builds` topic)

func (*PubSubCallBack) Descriptor deprecated

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

Deprecated: Use PubSubCallBack.ProtoReflect.Descriptor instead.

func (*PubSubCallBack) GetBuildPubsub

func (x *PubSubCallBack) GetBuildPubsub() *BuildsV2PubSub

func (*PubSubCallBack) GetUserData

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

func (*PubSubCallBack) ProtoMessage

func (*PubSubCallBack) ProtoMessage()

func (*PubSubCallBack) ProtoReflect

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

func (*PubSubCallBack) Reset

func (x *PubSubCallBack) Reset()

func (*PubSubCallBack) String

func (x *PubSubCallBack) 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 *durationpb.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() *durationpb.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 ResolvedDataRef

type ResolvedDataRef struct {

	// Types that are assignable to DataType:
	//
	//	*ResolvedDataRef_Cas
	//	*ResolvedDataRef_Cipd
	DataType isResolvedDataRef_DataType `protobuf_oneof:"data_type"`
	// contains filtered or unexported fields
}

func (*ResolvedDataRef) Descriptor deprecated

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

Deprecated: Use ResolvedDataRef.ProtoReflect.Descriptor instead.

func (*ResolvedDataRef) GetCas

func (x *ResolvedDataRef) GetCas() *ResolvedDataRef_CAS

func (*ResolvedDataRef) GetCipd

func (x *ResolvedDataRef) GetCipd() *ResolvedDataRef_CIPD

func (*ResolvedDataRef) GetDataType

func (m *ResolvedDataRef) GetDataType() isResolvedDataRef_DataType

func (*ResolvedDataRef) ProtoMessage

func (*ResolvedDataRef) ProtoMessage()

func (*ResolvedDataRef) ProtoReflect

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

func (*ResolvedDataRef) Reset

func (x *ResolvedDataRef) Reset()

func (*ResolvedDataRef) String

func (x *ResolvedDataRef) String() string

type ResolvedDataRef_CAS

type ResolvedDataRef_CAS struct {

	// TODO(crbug.com/1266060): potential fields can be
	// int64 cache_hits = ?;
	// int64 cache_hit_size = ?:
	// int64 cache_misses = ?;
	// int64 cache_miss_size = ?;
	// need more thinking and better to determine when starting writing code
	// to download binaries in bbagent.
	Timing *ResolvedDataRef_Timing `protobuf:"bytes,1,opt,name=timing,proto3" json:"timing,omitempty"`
	// contains filtered or unexported fields
}

func (*ResolvedDataRef_CAS) Descriptor deprecated

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

Deprecated: Use ResolvedDataRef_CAS.ProtoReflect.Descriptor instead.

func (*ResolvedDataRef_CAS) GetTiming

func (*ResolvedDataRef_CAS) ProtoMessage

func (*ResolvedDataRef_CAS) ProtoMessage()

func (*ResolvedDataRef_CAS) ProtoReflect

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

func (*ResolvedDataRef_CAS) Reset

func (x *ResolvedDataRef_CAS) Reset()

func (*ResolvedDataRef_CAS) String

func (x *ResolvedDataRef_CAS) String() string

type ResolvedDataRef_CIPD

type ResolvedDataRef_CIPD struct {
	Specs []*ResolvedDataRef_CIPD_PkgSpec `protobuf:"bytes,2,rep,name=specs,proto3" json:"specs,omitempty"`
	// contains filtered or unexported fields
}

func (*ResolvedDataRef_CIPD) Descriptor deprecated

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

Deprecated: Use ResolvedDataRef_CIPD.ProtoReflect.Descriptor instead.

func (*ResolvedDataRef_CIPD) GetSpecs

func (*ResolvedDataRef_CIPD) ProtoMessage

func (*ResolvedDataRef_CIPD) ProtoMessage()

func (*ResolvedDataRef_CIPD) ProtoReflect

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

func (*ResolvedDataRef_CIPD) Reset

func (x *ResolvedDataRef_CIPD) Reset()

func (*ResolvedDataRef_CIPD) String

func (x *ResolvedDataRef_CIPD) String() string

type ResolvedDataRef_CIPD_PkgSpec

type ResolvedDataRef_CIPD_PkgSpec struct {

	// True if this package wasn't installed because `package` contained a
	// non-applicable conditional (e.g. ${os=windows} on a mac machine).
	Skipped   bool                    `protobuf:"varint,1,opt,name=skipped,proto3" json:"skipped,omitempty"`
	Package   string                  `protobuf:"bytes,2,opt,name=package,proto3" json:"package,omitempty"` // fully resolved
	Version   string                  `protobuf:"bytes,3,opt,name=version,proto3" json:"version,omitempty"` // fully resolved
	WasCached Trinary                 `protobuf:"varint,4,opt,name=was_cached,json=wasCached,proto3,enum=buildbucket.v2.Trinary" json:"was_cached,omitempty"`
	Timing    *ResolvedDataRef_Timing `protobuf:"bytes,5,opt,name=timing,proto3" json:"timing,omitempty"` // optional
	// contains filtered or unexported fields
}

func (*ResolvedDataRef_CIPD_PkgSpec) Descriptor deprecated

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

Deprecated: Use ResolvedDataRef_CIPD_PkgSpec.ProtoReflect.Descriptor instead.

func (*ResolvedDataRef_CIPD_PkgSpec) GetPackage

func (x *ResolvedDataRef_CIPD_PkgSpec) GetPackage() string

func (*ResolvedDataRef_CIPD_PkgSpec) GetSkipped

func (x *ResolvedDataRef_CIPD_PkgSpec) GetSkipped() bool

func (*ResolvedDataRef_CIPD_PkgSpec) GetTiming

func (*ResolvedDataRef_CIPD_PkgSpec) GetVersion

func (x *ResolvedDataRef_CIPD_PkgSpec) GetVersion() string

func (*ResolvedDataRef_CIPD_PkgSpec) GetWasCached

func (x *ResolvedDataRef_CIPD_PkgSpec) GetWasCached() Trinary

func (*ResolvedDataRef_CIPD_PkgSpec) ProtoMessage

func (*ResolvedDataRef_CIPD_PkgSpec) ProtoMessage()

func (*ResolvedDataRef_CIPD_PkgSpec) ProtoReflect

func (*ResolvedDataRef_CIPD_PkgSpec) Reset

func (x *ResolvedDataRef_CIPD_PkgSpec) Reset()

func (*ResolvedDataRef_CIPD_PkgSpec) String

type ResolvedDataRef_Cas

type ResolvedDataRef_Cas struct {
	Cas *ResolvedDataRef_CAS `protobuf:"bytes,1,opt,name=cas,proto3,oneof"`
}

type ResolvedDataRef_Cipd

type ResolvedDataRef_Cipd struct {
	Cipd *ResolvedDataRef_CIPD `protobuf:"bytes,2,opt,name=cipd,proto3,oneof"`
}

type ResolvedDataRef_Timing

type ResolvedDataRef_Timing struct {
	FetchDuration   *durationpb.Duration `protobuf:"bytes,1,opt,name=fetch_duration,json=fetchDuration,proto3" json:"fetch_duration,omitempty"`
	InstallDuration *durationpb.Duration `protobuf:"bytes,2,opt,name=install_duration,json=installDuration,proto3" json:"install_duration,omitempty"`
	// contains filtered or unexported fields
}

func (*ResolvedDataRef_Timing) Descriptor deprecated

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

Deprecated: Use ResolvedDataRef_Timing.ProtoReflect.Descriptor instead.

func (*ResolvedDataRef_Timing) GetFetchDuration

func (x *ResolvedDataRef_Timing) GetFetchDuration() *durationpb.Duration

func (*ResolvedDataRef_Timing) GetInstallDuration

func (x *ResolvedDataRef_Timing) GetInstallDuration() *durationpb.Duration

func (*ResolvedDataRef_Timing) ProtoMessage

func (*ResolvedDataRef_Timing) ProtoMessage()

func (*ResolvedDataRef_Timing) ProtoReflect

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

func (*ResolvedDataRef_Timing) Reset

func (x *ResolvedDataRef_Timing) Reset()

func (*ResolvedDataRef_Timing) String

func (x *ResolvedDataRef_Timing) 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 RunTaskRequest

type RunTaskRequest struct {

	// A string supplied by the builder configuration which will be interpreted
	// by this backend. This should be used to encapsulate the connection
	// information needed to target the specific backend host.
	//
	// For example, a backend might accept a target of
	// 'swarming://chromium-swarm.appspot.com' to indicate "swarming"
	// protocol and which Swarming instance it should issue the task on.
	//
	// In this example, we use 'swarming://' to allow for the possibility
	// of a single backend handling multiple different protocols.
	Target string `protobuf:"bytes,1,opt,name=target,proto3" json:"target,omitempty"`
	// A REGISTER_TASK token that the backend can use to register the backend task
	// to Buildbucket via the RegisterBuildTask RPC.
	// DEPRECATED: The StartBuildToken in RunTaskRequest.Secrets will be used.
	//
	// Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/backend.proto.
	RegisterBackendTaskToken string `` /* 137-byte string literal not displayed */
	// The LUCI Realm that the created task should be associated with.
	Realm string `protobuf:"bytes,3,opt,name=realm,proto3" json:"realm,omitempty"`
	// The backend must run the agent with the given command line arguments
	// (see `agent_args`) for full functionality.
	Agent *RunTaskRequest_AgentExecutable `protobuf:"bytes,4,opt,name=agent,proto3" json:"agent,omitempty"`
	// An opaque argv[1:] to be passed to the agent.
	//
	// Must contain build-id and hostname.
	// i.e.
	//
	//	`-build-id=<build id>`
	//	`-host=cr-buildbucket@appspot.com`
	//
	// Named caches set for this Build must be mounted all under some directory
	// and that root directory must be passed by appending a CLI argument:
	//
	//	`-cache-base=/path/to/cache/base`.
	//
	// Additionally, the Backend must arrange for the agent to know the backend
	// task id. This must exactly match the task id used by UpdateBuildTask,
	// and the agent will use it to make UpdateBuild calls. The backend must
	// supply the task id to the agent by appending a CLI argument:
	//
	//	`-task-id=<task id>`
	//
	// Also see `secrets` for one more potential CLI argument.
	//
	// For full functionality, the Backend must run the agent with this
	// list of arguments. The agent knows how to execute the Build as defined
	// by Buildbucket.
	//
	// Implementation note; I'd like to fix crbug.com/1219018 at the same time
	// that we implement this. Otherwise we will continue to have the
	// command-line-length issues that we do today, but they may get worse from
	// e.g. -task-id and -cache-base.
	AgentArgs []string `protobuf:"bytes,5,rep,name=agent_args,json=agentArgs,proto3" json:"agent_args,omitempty"`
	// Secrets contains key material for clients to call StartBuild or UpdateBuild.
	// This should be added to the BuildbucketAgentContext file for use in the agent.
	// Alternatively (but not suggested), this can be passed via LUCI_CONTEXT['secrets']
	// to the agent. There should be no CLI support for secrets in the agent.
	Secrets *BuildSecrets `protobuf:"bytes,6,opt,name=secrets,proto3" json:"secrets,omitempty"`
	// The hostname of the buildbucket service to send RPCs back to.
	//
	// e.g. `cr-buildbucket.appspot.com`.
	BuildbucketHost string `protobuf:"bytes,7,opt,name=buildbucket_host,json=buildbucketHost,proto3" json:"buildbucket_host,omitempty"`
	// The id of the build that this request is for.
	//
	// For backends which are NOT using the agent, they can use this build_id to
	// directly service the build (e.g. by calling UpdateBuild).
	//
	// It's possible for multiple RunTaskRequests to be issued for the same
	// build_id; See `request_id` for how this could happen.
	BuildId string `protobuf:"bytes,8,opt,name=build_id,json=buildId,proto3" json:"build_id,omitempty"`
	// Dimensions are key/value pairs which describe the type of "bot" which
	// can process this build. The specific values depend on the Backend.
	//
	// These also detail how long the Backend should wait for each of these
	// before dropping them as a requirement.
	//
	// NOTE: These do not include Swarming's "special" named cache dimensions.
	// see `caches` for that information.
	Dimensions []*RequestedDimension `protobuf:"bytes,9,rep,name=dimensions,proto3" json:"dimensions,omitempty"`
	// Start deadline is the absolute timestamp of when this Build must start
	// by before Buildbucket marks it as INFRA_FAILURE.
	StartDeadline *timestamppb.Timestamp `protobuf:"bytes,10,opt,name=start_deadline,json=startDeadline,proto3" json:"start_deadline,omitempty"`
	// Execution timeout is the amount of time after the Build starts that
	// the Backend should allow it to run before beginning the graceful shutdown
	// process (described in LUCI_CONTEXT['deadline']).
	//
	// Builds which run for longer than this will be marked as INFRA_FAILURE.
	ExecutionTimeout *durationpb.Duration `protobuf:"bytes,11,opt,name=execution_timeout,json=executionTimeout,proto3" json:"execution_timeout,omitempty"`
	// The amount of time on either `execution_timeout` or on a `cancel` event
	// that the agent should be given to shut down.
	//
	// See LUCI_CONTEXT['deadline'].
	//
	// Buildbucket may mark the build as INFRA_FAILURE if it fails to terminate
	// this much time after being canceled, or after hitting execution_timeout.
	GracePeriod *durationpb.Duration `protobuf:"bytes,12,opt,name=grace_period,json=gracePeriod,proto3" json:"grace_period,omitempty"`
	// Describes the list of cache ids, their paths (relative to the cache root)
	// and how long the Backend should wait for a bot with a warm cache to
	// become available.
	Caches []*CacheEntry `protobuf:"bytes,13,rep,name=caches,proto3" json:"caches,omitempty"`
	// Additional backend-specific settings. For Swarming this would include:
	//   - priority
	//   - wait_for_capacity
	//   - containment
	BackendConfig *structpb.Struct `protobuf:"bytes,14,opt,name=backend_config,json=backendConfig,proto3" json:"backend_config,omitempty"`
	// Experiments are provided in order to allow Backends to roll out new
	// features or behaviors triggered on experiments.
	//
	// This will be the full set of experiments selected for this Build
	// (as they might appear in Build.input.experiments).
	Experiments []string `protobuf:"bytes,15,rep,name=experiments,proto3" json:"experiments,omitempty"`
	// Buildbucket will provide a request id (formatted as a UUID), which the
	// TaskBackend SHOULD use to deduplicate the RunTaskRequest within a 10
	// minute window.
	//
	// If the backend does NOT deduplicate the requests, it will put extra
	// burden on the backend (because some useless tasks will be scheduled).
	// However proper deduplication can be difficult to properly implement,
	// so it may be worth the tradeoff for simple backends to just accept
	// the possibility of occasional duplicated, useless, work.
	RequestId string `protobuf:"bytes,16,opt,name=request_id,json=requestId,proto3" json:"request_id,omitempty"`
	// The pubsub topic that the backend will use to send
	// UpdateBuildTask messages to buildbucket. It is set by buildbucket using
	// service_config and the current buildbucket host.
	PubsubTopic string `protobuf:"bytes,17,opt,name=pubsub_topic,json=pubsubTopic,proto3" json:"pubsub_topic,omitempty"`
	// contains filtered or unexported fields
}

func (*RunTaskRequest) Descriptor deprecated

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

Deprecated: Use RunTaskRequest.ProtoReflect.Descriptor instead.

func (*RunTaskRequest) GetAgent

func (*RunTaskRequest) GetAgentArgs

func (x *RunTaskRequest) GetAgentArgs() []string

func (*RunTaskRequest) GetBackendConfig

func (x *RunTaskRequest) GetBackendConfig() *structpb.Struct

func (*RunTaskRequest) GetBuildId

func (x *RunTaskRequest) GetBuildId() string

func (*RunTaskRequest) GetBuildbucketHost

func (x *RunTaskRequest) GetBuildbucketHost() string

func (*RunTaskRequest) GetCaches

func (x *RunTaskRequest) GetCaches() []*CacheEntry

func (*RunTaskRequest) GetDimensions

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

func (*RunTaskRequest) GetExecutionTimeout

func (x *RunTaskRequest) GetExecutionTimeout() *durationpb.Duration

func (*RunTaskRequest) GetExperiments

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

func (*RunTaskRequest) GetGracePeriod

func (x *RunTaskRequest) GetGracePeriod() *durationpb.Duration

func (*RunTaskRequest) GetPubsubTopic

func (x *RunTaskRequest) GetPubsubTopic() string

func (*RunTaskRequest) GetRealm

func (x *RunTaskRequest) GetRealm() string

func (*RunTaskRequest) GetRegisterBackendTaskToken deprecated

func (x *RunTaskRequest) GetRegisterBackendTaskToken() string

Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/backend.proto.

func (*RunTaskRequest) GetRequestId

func (x *RunTaskRequest) GetRequestId() string

func (*RunTaskRequest) GetSecrets

func (x *RunTaskRequest) GetSecrets() *BuildSecrets

func (*RunTaskRequest) GetStartDeadline

func (x *RunTaskRequest) GetStartDeadline() *timestamppb.Timestamp

func (*RunTaskRequest) GetTarget

func (x *RunTaskRequest) GetTarget() string

func (*RunTaskRequest) ProtoMessage

func (*RunTaskRequest) ProtoMessage()

func (*RunTaskRequest) ProtoReflect

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

func (*RunTaskRequest) Reset

func (x *RunTaskRequest) Reset()

func (*RunTaskRequest) String

func (x *RunTaskRequest) String() string

type RunTaskRequest_AgentExecutable

type RunTaskRequest_AgentExecutable struct {

	// Mapping of cipd "${platform}" values to the direct download URL
	// and sha256+size of the agent binary.
	//
	// ${platform} has the form $OS-$ARCH.
	//
	// $OS values:
	//   - mac
	//   - windows
	//   - linux
	//
	// $ARCH values:
	//   - amd64
	//   - arm64
	//   - i386
	//
	// The urls will be guaranteed to be valid until at least
	// start_deadline+execution_timeout.
	Source map[string]*RunTaskRequest_AgentExecutable_AgentSource `` /* 153-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (*RunTaskRequest_AgentExecutable) Descriptor deprecated

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

Deprecated: Use RunTaskRequest_AgentExecutable.ProtoReflect.Descriptor instead.

func (*RunTaskRequest_AgentExecutable) GetSource

func (*RunTaskRequest_AgentExecutable) ProtoMessage

func (*RunTaskRequest_AgentExecutable) ProtoMessage()

func (*RunTaskRequest_AgentExecutable) ProtoReflect

func (*RunTaskRequest_AgentExecutable) Reset

func (x *RunTaskRequest_AgentExecutable) Reset()

func (*RunTaskRequest_AgentExecutable) String

type RunTaskRequest_AgentExecutable_AgentSource

type RunTaskRequest_AgentExecutable_AgentSource struct {
	Sha256    string `protobuf:"bytes,1,opt,name=sha256,proto3" json:"sha256,omitempty"`                         // required
	SizeBytes int64  `protobuf:"varint,2,opt,name=size_bytes,json=sizeBytes,proto3" json:"size_bytes,omitempty"` // required
	Url       string `protobuf:"bytes,3,opt,name=url,proto3" json:"url,omitempty"`                               // required
	// contains filtered or unexported fields
}

func (*RunTaskRequest_AgentExecutable_AgentSource) Descriptor deprecated

Deprecated: Use RunTaskRequest_AgentExecutable_AgentSource.ProtoReflect.Descriptor instead.

func (*RunTaskRequest_AgentExecutable_AgentSource) GetSha256

func (*RunTaskRequest_AgentExecutable_AgentSource) GetSizeBytes

func (*RunTaskRequest_AgentExecutable_AgentSource) GetUrl

func (*RunTaskRequest_AgentExecutable_AgentSource) ProtoMessage

func (*RunTaskRequest_AgentExecutable_AgentSource) ProtoReflect

func (*RunTaskRequest_AgentExecutable_AgentSource) Reset

func (*RunTaskRequest_AgentExecutable_AgentSource) String

type RunTaskResponse

type RunTaskResponse struct {

	// The backend task created by RunTask.
	Task *Task `protobuf:"bytes,1,opt,name=task,proto3" json:"task,omitempty"`
	// contains filtered or unexported fields
}

func (*RunTaskResponse) Descriptor deprecated

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

Deprecated: Use RunTaskResponse.ProtoReflect.Descriptor instead.

func (*RunTaskResponse) GetTask

func (x *RunTaskResponse) GetTask() *Task

func (*RunTaskResponse) ProtoMessage

func (*RunTaskResponse) ProtoMessage()

func (*RunTaskResponse) ProtoReflect

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

func (*RunTaskResponse) Reset

func (x *RunTaskResponse) Reset()

func (*RunTaskResponse) String

func (x *RunTaskResponse) 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:
	//
	//	["$recipe_engine/buildbucket"]
	//	["$recipe_engine/runtime", "is_experimental"]
	//	["$recipe_engine/runtime", "is_luci"]
	//	["branch"]
	//	["buildbucket"]
	//	["buildername"]
	//	["repository"]
	//
	// The Builder configuration specifies which top-level property names are
	// overridable via the `allowed_property_overrides` field. ScheduleBuild
	// requests which attempt to override a property which isn't allowed will
	// fail with InvalidArgument.
	//
	// V1 equivalent: corresponds to "properties" key in "parameters_json".
	Properties *structpb.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.
	//
	// Note: For the same key dimensions, it won't allow to pass empty and
	// non-empty values at the same time in the request.
	//
	// Note: "caches" and "pool" dimensions may only be specified in builder
	// configs. Setting them hear will fail the request.
	//
	// 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.
	//
	// DEPRECATED: Use mask instead.
	//
	// Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/builds_service.proto.
	Fields *fieldmaskpb.FieldMask `protobuf:"bytes,100,opt,name=fields,proto3" json:"fields,omitempty"`
	// What portion of the Build message to return.
	//
	// If not set, the default mask is used, see Build message comments for the
	// list of fields returned by default.
	Mask *BuildMask `protobuf:"bytes,101,opt,name=mask,proto3" json:"mask,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"`
	// Maximum build pending time.
	//
	// If set, overrides the default `expiration_secs` set in builder config.
	// Only supports seconds precision for now.
	// For more information, see Build.scheduling_timeout in build.proto.
	SchedulingTimeout *durationpb.Duration `protobuf:"bytes,17,opt,name=scheduling_timeout,json=schedulingTimeout,proto3" json:"scheduling_timeout,omitempty"`
	// Maximum build execution time.
	//
	// If set, overrides the default `execution_timeout_secs` set in builder config.
	// Only supports seconds precision for now.
	// For more information, see Build.execution_timeout in build.proto.
	ExecutionTimeout *durationpb.Duration `protobuf:"bytes,18,opt,name=execution_timeout,json=executionTimeout,proto3" json:"execution_timeout,omitempty"`
	// Amount of cleanup time after execution_timeout.
	//
	// If set, overrides the default `grace_period` set in builder config.
	// Only supports seconds precision for now.
	// For more information, see Build.grace_period in build.proto.
	GracePeriod *durationpb.Duration `protobuf:"bytes,19,opt,name=grace_period,json=gracePeriod,proto3" json:"grace_period,omitempty"`
	// Whether or not this request constitutes a dry run.
	//
	// A dry run returns the build proto without actually scheduling it. All
	// fields except those which can only be computed at run-time are filled in.
	// Does not cause side-effects. When batching, all requests must specify the
	// same value for dry_run.
	DryRun bool `protobuf:"varint,20,opt,name=dry_run,json=dryRun,proto3" json:"dry_run,omitempty"`
	// Flag to control if the build can outlive its parent.
	//
	// If the value is UNSET, it means this build doesn't have any parent, so
	// the request must not have a head with any BuildToken.
	//
	// If the value is anything other than UNSET, then the BuildToken for the
	// parent build must be set as a header.
	// Note: it's not currently possible to establish parent/child relationship
	// except via the parent build at the time the build is launched.
	//
	// If the value is NO, it means that the build SHOULD reach a terminal status
	// (SUCCESS, FAILURE, INFRA_FAILURE or CANCELED) before its parent. If the
	// child fails to do so, Buildbucket will cancel it some time after the
	// parent build reaches a terminal status.
	//
	// A build that can outlive its parent can also outlive its parent's ancestors.
	//
	// If schedule a build without parent, this field must be UNSET.
	//
	// If schedule a build with parent, this field should be YES or NO.
	// But UNSET is also accepted for now, and it has the same effect as YES.
	// TODO(crbug.com/1031205): after the parent tracking feature is stable,
	// require this field to be set when scheduling a build with parent.
	CanOutliveParent Trinary `` /* 141-byte string literal not displayed */
	// Value for Build.retriable.
	Retriable Trinary `protobuf:"varint,22,opt,name=retriable,proto3,enum=buildbucket.v2.Trinary" json:"retriable,omitempty"`
	// Input for scheduling a build in the shadow bucket.
	//
	// If this field is set, it means the build to be scheduled will
	//   - be scheduled in the shadow bucket of the requested bucket, with shadow
	//     adjustments on service_account, dimensions and properties.
	//   - inherit its parent build's agent input and agent source if it has a parent.
	ShadowInput *ScheduleBuildRequest_ShadowInput `protobuf:"bytes,23,opt,name=shadow_input,json=shadowInput,proto3" json:"shadow_input,omitempty"`
	// contains filtered or unexported fields
}

A request message for ScheduleBuild RPC.

Next ID: 24.

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) GetCanOutliveParent

func (x *ScheduleBuildRequest) GetCanOutliveParent() Trinary

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) GetDryRun

func (x *ScheduleBuildRequest) GetDryRun() bool

func (*ScheduleBuildRequest) GetExe

func (x *ScheduleBuildRequest) GetExe() *Executable

func (*ScheduleBuildRequest) GetExecutionTimeout

func (x *ScheduleBuildRequest) GetExecutionTimeout() *durationpb.Duration

func (*ScheduleBuildRequest) GetExperimental

func (x *ScheduleBuildRequest) GetExperimental() Trinary

func (*ScheduleBuildRequest) GetExperiments

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

func (*ScheduleBuildRequest) GetFields deprecated

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

Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/builds_service.proto.

func (*ScheduleBuildRequest) GetGerritChanges

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

func (*ScheduleBuildRequest) GetGitilesCommit

func (x *ScheduleBuildRequest) GetGitilesCommit() *GitilesCommit

func (*ScheduleBuildRequest) GetGracePeriod

func (x *ScheduleBuildRequest) GetGracePeriod() *durationpb.Duration

func (*ScheduleBuildRequest) GetMask

func (x *ScheduleBuildRequest) GetMask() *BuildMask

func (*ScheduleBuildRequest) GetNotify

func (x *ScheduleBuildRequest) GetNotify() *NotificationConfig

func (*ScheduleBuildRequest) GetPriority

func (x *ScheduleBuildRequest) GetPriority() int32

func (*ScheduleBuildRequest) GetProperties

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

func (*ScheduleBuildRequest) GetRequestId

func (x *ScheduleBuildRequest) GetRequestId() string

func (*ScheduleBuildRequest) GetRetriable

func (x *ScheduleBuildRequest) GetRetriable() Trinary

func (*ScheduleBuildRequest) GetSchedulingTimeout

func (x *ScheduleBuildRequest) GetSchedulingTimeout() *durationpb.Duration

func (*ScheduleBuildRequest) GetShadowInput

func (*ScheduleBuildRequest) GetSwarming

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_ShadowInput

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

Information for scheduling a build as a shadow build.

func (*ScheduleBuildRequest_ShadowInput) Descriptor deprecated

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

Deprecated: Use ScheduleBuildRequest_ShadowInput.ProtoReflect.Descriptor instead.

func (*ScheduleBuildRequest_ShadowInput) ProtoMessage

func (*ScheduleBuildRequest_ShadowInput) ProtoMessage()

func (*ScheduleBuildRequest_ShadowInput) ProtoReflect

func (*ScheduleBuildRequest_ShadowInput) Reset

func (*ScheduleBuildRequest_ShadowInput) 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 (*ScheduleBuildRequest_Swarming) Reset

func (x *ScheduleBuildRequest_Swarming) Reset()

func (*ScheduleBuildRequest_Swarming) 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.
	//
	// DEPRECATED: Use mask instead.
	//
	// Note that this applies to the response, not each build, so e.g. steps must
	// be requested with a path "builds.*.steps".
	//
	// Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/builds_service.proto.
	Fields *fieldmaskpb.FieldMask `protobuf:"bytes,100,opt,name=fields,proto3" json:"fields,omitempty"`
	// What portion of the Build message to return.
	//
	// If not set, the default mask is used, see Build message comments for the
	// list of fields returned by default.
	Mask *BuildMask `protobuf:"bytes,103,opt,name=mask,proto3" json:"mask,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 deprecated

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

Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/builds_service.proto.

func (*SearchBuildsRequest) GetMask

func (x *SearchBuildsRequest) GetMask() *BuildMask

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 SetBuilderHealthRequest

type SetBuilderHealthRequest struct {
	Health []*SetBuilderHealthRequest_BuilderHealth `protobuf:"bytes,1,rep,name=health,proto3" json:"health,omitempty"`
	// contains filtered or unexported fields
}

A request message for SetBuilderHealth RPC.

func (*SetBuilderHealthRequest) Descriptor deprecated

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

Deprecated: Use SetBuilderHealthRequest.ProtoReflect.Descriptor instead.

func (*SetBuilderHealthRequest) GetHealth

func (*SetBuilderHealthRequest) ProtoMessage

func (*SetBuilderHealthRequest) ProtoMessage()

func (*SetBuilderHealthRequest) ProtoReflect

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

func (*SetBuilderHealthRequest) Reset

func (x *SetBuilderHealthRequest) Reset()

func (*SetBuilderHealthRequest) String

func (x *SetBuilderHealthRequest) String() string

type SetBuilderHealthRequest_BuilderHealth

type SetBuilderHealthRequest_BuilderHealth struct {

	// Required. Builder to set the health score for.
	// You must have the 'buildbucket.builders.set_health' permission for
	// each of them.
	Id *BuilderID `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	// Required. Health status of the builder.
	Health *HealthStatus `protobuf:"bytes,2,opt,name=health,proto3" json:"health,omitempty"`
	// contains filtered or unexported fields
}

BuilderHealth needs BuilderID so that SetBuilderHealth RPC can properly update the Builder datastore entity with the updated HealthStatus.

func (*SetBuilderHealthRequest_BuilderHealth) Descriptor deprecated

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

Deprecated: Use SetBuilderHealthRequest_BuilderHealth.ProtoReflect.Descriptor instead.

func (*SetBuilderHealthRequest_BuilderHealth) GetHealth

func (*SetBuilderHealthRequest_BuilderHealth) GetId

func (*SetBuilderHealthRequest_BuilderHealth) ProtoMessage

func (*SetBuilderHealthRequest_BuilderHealth) ProtoMessage()

func (*SetBuilderHealthRequest_BuilderHealth) ProtoReflect

func (*SetBuilderHealthRequest_BuilderHealth) Reset

func (*SetBuilderHealthRequest_BuilderHealth) String

type SetBuilderHealthResponse

type SetBuilderHealthResponse struct {

	// Responses should be empty protos or errors. They will map
	// directly with the repeated health fields from SetBuilderHealthRequest.
	Responses []*SetBuilderHealthResponse_Response `protobuf:"bytes,1,rep,name=responses,proto3" json:"responses,omitempty"`
	// contains filtered or unexported fields
}

A response message for SetBuilderHealth RPC.

func (*SetBuilderHealthResponse) Descriptor deprecated

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

Deprecated: Use SetBuilderHealthResponse.ProtoReflect.Descriptor instead.

func (*SetBuilderHealthResponse) GetResponses

func (*SetBuilderHealthResponse) ProtoMessage

func (*SetBuilderHealthResponse) ProtoMessage()

func (*SetBuilderHealthResponse) ProtoReflect

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

func (*SetBuilderHealthResponse) Reset

func (x *SetBuilderHealthResponse) Reset()

func (*SetBuilderHealthResponse) String

func (x *SetBuilderHealthResponse) String() string

type SetBuilderHealthResponse_Response

type SetBuilderHealthResponse_Response struct {

	// Types that are assignable to Response:
	//
	//	*SetBuilderHealthResponse_Response_Result
	//	*SetBuilderHealthResponse_Response_Error
	Response isSetBuilderHealthResponse_Response_Response `protobuf_oneof:"response"`
	// contains filtered or unexported fields
}

func (*SetBuilderHealthResponse_Response) Descriptor deprecated

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

Deprecated: Use SetBuilderHealthResponse_Response.ProtoReflect.Descriptor instead.

func (*SetBuilderHealthResponse_Response) GetError

func (*SetBuilderHealthResponse_Response) GetResponse

func (m *SetBuilderHealthResponse_Response) GetResponse() isSetBuilderHealthResponse_Response_Response

func (*SetBuilderHealthResponse_Response) GetResult

func (*SetBuilderHealthResponse_Response) ProtoMessage

func (*SetBuilderHealthResponse_Response) ProtoMessage()

func (*SetBuilderHealthResponse_Response) ProtoReflect

func (*SetBuilderHealthResponse_Response) Reset

func (*SetBuilderHealthResponse_Response) String

type SetBuilderHealthResponse_Response_Error

type SetBuilderHealthResponse_Response_Error struct {
	Error *status.Status `protobuf:"bytes,100,opt,name=error,proto3,oneof"`
}

type SetBuilderHealthResponse_Response_Result

type SetBuilderHealthResponse_Response_Result struct {
	Result *emptypb.Empty `protobuf:"bytes,1,opt,name=result,proto3,oneof"`
}

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"`
	Experiment *ExperimentSettings `protobuf:"bytes,5,opt,name=experiment,proto3" json:"experiment,omitempty"`
	Cipd       *CipdSettings       `protobuf:"bytes,6,opt,name=cipd,proto3" json:"cipd,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 */
	// List of known backend configurations.
	Backends []*BackendSetting `protobuf:"bytes,7,rep,name=backends,proto3" json:"backends,omitempty"`
	// A swarming_host -> backend_target map.
	// It's used during the raw swarming to swarming based backend migration to
	// derive a backend config from swarming related configs.
	// So we could control the migration process behind the scene.
	SwarmingBackends map[string]string `` /* 197-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) GetBackends

func (x *SettingsCfg) GetBackends() []*BackendSetting

func (*SettingsCfg) GetCipd

func (x *SettingsCfg) GetCipd() *CipdSettings

func (*SettingsCfg) GetExperiment

func (x *SettingsCfg) GetExperiment() *ExperimentSettings

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) GetSwarmingBackends

func (x *SettingsCfg) GetSwarmingBackends() map[string]string

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 StartBuildRequest

type StartBuildRequest struct {

	// A nonce to deduplicate requests.
	RequestId string `protobuf:"bytes,1,opt,name=request_id,json=requestId,proto3" json:"request_id,omitempty"`
	// Id of the build to start.
	BuildId int64 `protobuf:"varint,2,opt,name=build_id,json=buildId,proto3" json:"build_id,omitempty"`
	// Id of the task running the started build.
	TaskId string `protobuf:"bytes,3,opt,name=task_id,json=taskId,proto3" json:"task_id,omitempty"`
	// contains filtered or unexported fields
}

A request message for StartBuild RPC.

func (*StartBuildRequest) Descriptor deprecated

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

Deprecated: Use StartBuildRequest.ProtoReflect.Descriptor instead.

func (*StartBuildRequest) GetBuildId

func (x *StartBuildRequest) GetBuildId() int64

func (*StartBuildRequest) GetRequestId

func (x *StartBuildRequest) GetRequestId() string

func (*StartBuildRequest) GetTaskId

func (x *StartBuildRequest) GetTaskId() string

func (*StartBuildRequest) ProtoMessage

func (*StartBuildRequest) ProtoMessage()

func (*StartBuildRequest) ProtoReflect

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

func (*StartBuildRequest) Reset

func (x *StartBuildRequest) Reset()

func (*StartBuildRequest) String

func (x *StartBuildRequest) String() string

type StartBuildResponse

type StartBuildResponse struct {

	// The whole proto of the started build.
	Build *Build `protobuf:"bytes,1,opt,name=build,proto3" json:"build,omitempty"`
	// a build token for agent to use when making subsequent UpdateBuild calls.
	UpdateBuildToken string `protobuf:"bytes,2,opt,name=update_build_token,json=updateBuildToken,proto3" json:"update_build_token,omitempty"`
	// contains filtered or unexported fields
}

A response message for StartBuild RPC.

func (*StartBuildResponse) Descriptor deprecated

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

Deprecated: Use StartBuildResponse.ProtoReflect.Descriptor instead.

func (*StartBuildResponse) GetBuild

func (x *StartBuildResponse) GetBuild() *Build

func (*StartBuildResponse) GetUpdateBuildToken

func (x *StartBuildResponse) GetUpdateBuildToken() string

func (*StartBuildResponse) ProtoMessage

func (*StartBuildResponse) ProtoMessage()

func (*StartBuildResponse) ProtoReflect

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

func (*StartBuildResponse) Reset

func (x *StartBuildResponse) Reset()

func (*StartBuildResponse) String

func (x *StartBuildResponse) 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 build ended due to the expiration_timeout or
	// scheduling_timeout set for the build.
	//
	// Applicable in all final statuses.
	//
	// SUCCESS+timeout would indicate a successful recovery from a timeout signal
	// during the build's grace_period.
	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 (*StatusDetails_ResourceExhaustion) Reset

func (*StatusDetails_ResourceExhaustion) 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.
	//
	// MUST NOT be specified, if status is SCHEDULED.
	// MUST be specified, if status is STARTED, SUCCESS, FAILURE, or INFRA_FAILURE
	// MAY be specified, if status is CANCELED.
	StartTime *timestamppb.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.
	EndTime *timestamppb.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.
	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"`
	// MergeBuild is used for go.chromium.org/luci/luciexe to indicate to the
	// luciexe host process if some Build stream should be merged under this step.
	//
	// BigQuery: excluded from rows.
	MergeBuild *Step_MergeBuild `protobuf:"bytes,6,opt,name=merge_build,json=mergeBuild,proto3" json:"merge_build,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"`
	// Arbitrary annotations for the step.
	//
	// One key may have multiple values, which is why this is not a map<string,string>.
	//
	// These are NOT interpreted by Buildbucket.
	//
	// Tag keys SHOULD indicate the domain/system that interprets them, e.g.:
	//
	//	my_service.category = COMPILE
	//
	// Rather than
	//
	//	is_compile = true
	//
	// This will help contextualize the tag values when looking at a build (who
	// set this tag? who will interpret this tag?))
	//
	// The 'luci.' key prefix is reserved for LUCI's own usage.
	//
	// The Key may not exceed 256 bytes.
	// The Value may not exceed 1024 bytes.
	//
	// Key and Value may not be empty.
	Tags []*StringPair `protobuf:"bytes,8,rep,name=tags,proto3" json:"tags,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() *timestamppb.Timestamp

func (*Step) GetLogs

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

func (*Step) GetMergeBuild

func (x *Step) GetMergeBuild() *Step_MergeBuild

func (*Step) GetName

func (x *Step) GetName() string

func (*Step) GetStartTime

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

func (*Step) GetStatus

func (x *Step) GetStatus() Status

func (*Step) GetSummaryMarkdown

func (x *Step) GetSummaryMarkdown() string

func (*Step) GetTags

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

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 Step_MergeBuild

type Step_MergeBuild struct {

	// If set, then this stream is expected to be a datagram stream
	// containing Build messages.
	//
	// This should be the stream name relative to the current build's
	// $LOGDOG_NAMESPACE.
	FromLogdogStream string `protobuf:"bytes,1,opt,name=from_logdog_stream,json=fromLogdogStream,proto3" json:"from_logdog_stream,omitempty"`
	// If set, then this stream will be merged "in line" with this step.
	//
	// Properties emitted by the merge build stream will overwrite global
	// outputs with the same top-level key.
	//
	// Steps emitted by the merge build stream will NOT have their names
	// namespaced (though the log stream names are still expected to
	// adhere to the regular luciexe rules).
	//
	// Because this is a legacy feature, this intentionally omits other fields
	// which "could be" merged, because there was no affordance to emit them
	// under the legacy annotator scheme:
	//   - output.gitiles_commit will not be merged.
	//   - output.logs will not be merged.
	//   - summary_markdown will not be merged.
	//
	// This is NOT a recommended mode of operation, but legacy ChromeOS
	// builders rely on this behavior.
	//
	// See crbug.com/1310155.
	LegacyGlobalNamespace bool `` /* 127-byte string literal not displayed */
	// contains filtered or unexported fields
}

func (*Step_MergeBuild) Descriptor deprecated

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

Deprecated: Use Step_MergeBuild.ProtoReflect.Descriptor instead.

func (*Step_MergeBuild) GetFromLogdogStream

func (x *Step_MergeBuild) GetFromLogdogStream() string

func (*Step_MergeBuild) GetLegacyGlobalNamespace

func (x *Step_MergeBuild) GetLegacyGlobalNamespace() bool

func (*Step_MergeBuild) ProtoMessage

func (*Step_MergeBuild) ProtoMessage()

func (*Step_MergeBuild) ProtoReflect

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

func (*Step_MergeBuild) Reset

func (x *Step_MergeBuild) Reset()

func (*Step_MergeBuild) String

func (x *Step_MergeBuild) 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 {

	// Configuration for each builder.
	// Swarming tasks are created only for builds for builders that are not
	// explicitly specified.
	Builders []*BuilderConfig `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 *wrapperspb.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) GetBuilders

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

func (*Swarming) GetTaskTemplateCanaryPercentage

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

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 []*BuilderConfig_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"`
	// Package of alternative buildbucket agent sources.
	// They should only be used in certain situations (i.e. in an experiment),
	// so they should have constraints on either omit_on_experiment
	// or include_on_experiment.
	AlternativeAgentPackages []*SwarmingSettings_Package `` /* 135-byte string literal not displayed */
	// Packages for bbagent to use.
	// Installed in "{TASK_RUN_DIR}/bbagent_utility_packages".
	BbagentUtilityPackages []*SwarmingSettings_Package `` /* 130-byte string literal not displayed */
	// contains filtered or unexported fields
}

Swarmbucket settings.

func (*SwarmingSettings) Descriptor deprecated

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

Deprecated: Use SwarmingSettings.ProtoReflect.Descriptor instead.

func (*SwarmingSettings) GetAlternativeAgentPackages

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

func (*SwarmingSettings) GetBbagentPackage

func (x *SwarmingSettings) GetBbagentPackage() *SwarmingSettings_Package

func (*SwarmingSettings) GetBbagentUtilityPackages

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

func (*SwarmingSettings) GetGlobalCaches

func (x *SwarmingSettings) GetGlobalCaches() []*BuilderConfig_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"`
	// Omit this package from the build having any of these experiments.
	OmitOnExperiment []string `protobuf:"bytes,6,rep,name=omit_on_experiment,json=omitOnExperiment,proto3" json:"omit_on_experiment,omitempty"`
	// If non-empty, include this package only on builds which have any of these
	// experiments set. `omit_on_experiment` takes precedence if an experiment
	// is in both of these lists.
	IncludeOnExperiment []string `protobuf:"bytes,7,rep,name=include_on_experiment,json=includeOnExperiment,proto3" json:"include_on_experiment,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) GetIncludeOnExperiment

func (x *SwarmingSettings_Package) GetIncludeOnExperiment() []string

func (*SwarmingSettings_Package) GetOmitOnExperiment

func (x *SwarmingSettings_Package) GetOmitOnExperiment() []string

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 SynthesizeBuildRequest

type SynthesizeBuildRequest struct {

	// ID of a build to use as the template.
	// Mutually exclusive with builder.
	TemplateBuildId int64 `protobuf:"varint,1,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,2,opt,name=builder,proto3" json:"builder,omitempty"`
	// Sets (or prevents) these experiments on the synthesized build.
	//
	// See `Builder.experiments` for well-known experiments.
	Experiments map[string]bool `` /* 164-byte string literal not displayed */
	// contains filtered or unexported fields
}

A request message for SynthesizeBuild RPC.

func (*SynthesizeBuildRequest) Descriptor deprecated

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

Deprecated: Use SynthesizeBuildRequest.ProtoReflect.Descriptor instead.

func (*SynthesizeBuildRequest) GetBuilder

func (x *SynthesizeBuildRequest) GetBuilder() *BuilderID

func (*SynthesizeBuildRequest) GetExperiments

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

func (*SynthesizeBuildRequest) GetTemplateBuildId

func (x *SynthesizeBuildRequest) GetTemplateBuildId() int64

func (*SynthesizeBuildRequest) ProtoMessage

func (*SynthesizeBuildRequest) ProtoMessage()

func (*SynthesizeBuildRequest) ProtoReflect

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

func (*SynthesizeBuildRequest) Reset

func (x *SynthesizeBuildRequest) Reset()

func (*SynthesizeBuildRequest) String

func (x *SynthesizeBuildRequest) String() string

type Task

type Task struct {
	Id *TaskID `protobuf:"bytes,1,opt,name=id,proto3" json:"id,omitempty"`
	// (optional) Human-clickable link to the status page for this task.
	// This should be populated as part of the Task response in RunTaskResponse.
	// Any update to this via the Task field in BuildTaskUpdate will override the
	// existing link that was provided in RunTaskResponse.
	Link string `protobuf:"bytes,2,opt,name=link,proto3" json:"link,omitempty"`
	// The backend's status for handling this task.
	Status Status `protobuf:"varint,3,opt,name=status,proto3,enum=buildbucket.v2.Status" json:"status,omitempty"`
	// The 'status_details' around handling this task.
	StatusDetails *StatusDetails `protobuf:"bytes,4,opt,name=status_details,json=statusDetails,proto3" json:"status_details,omitempty"`
	// Deprecated. Use summary_markdown instead.
	SummaryHtml string `protobuf:"bytes,5,opt,name=summary_html,json=summaryHtml,proto3" json:"summary_html,omitempty"`
	// Additional backend-specific details about the task.
	//
	// This could be used to indicate things like named-cache status, task
	// startup/end time, etc.
	//
	// This is limited to 10KB (binary PB + gzip(5))
	//
	// This should be populated as part of the Task response in RunTaskResponse.
	// Any update to this via the Task field in BuildTaskUpdate will override the
	// existing details that were provided in RunTaskResponse.
	Details *structpb.Struct `protobuf:"bytes,6,opt,name=details,proto3" json:"details,omitempty"`
	// A monotonically increasing integer set by the backend to track
	// which task is the most up to date when calling UpdateBuildTask.
	// When the build is first created, this will be set to 0.
	// When RunTask is called and returns a task, this should not be 0 or nil.
	// Each UpdateBuildTask call will check this to ensure the latest task is
	// being stored in datastore.
	UpdateId int64 `protobuf:"varint,7,opt,name=update_id,json=updateId,proto3" json:"update_id,omitempty"`
	// Human-readable commentary around the handling of this task.
	SummaryMarkdown string `protobuf:"bytes,8,opt,name=summary_markdown,json=summaryMarkdown,proto3" json:"summary_markdown,omitempty"`
	// contains filtered or unexported fields
}

A backend task. Next id: 9.

func (*Task) Descriptor deprecated

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

Deprecated: Use Task.ProtoReflect.Descriptor instead.

func (*Task) GetDetails

func (x *Task) GetDetails() *structpb.Struct

func (*Task) GetId

func (x *Task) GetId() *TaskID
func (x *Task) GetLink() string

func (*Task) GetStatus

func (x *Task) GetStatus() Status

func (*Task) GetStatusDetails

func (x *Task) GetStatusDetails() *StatusDetails

func (*Task) GetSummaryHtml

func (x *Task) GetSummaryHtml() string

func (*Task) GetSummaryMarkdown

func (x *Task) GetSummaryMarkdown() string

func (*Task) GetUpdateId

func (x *Task) GetUpdateId() int64

func (*Task) ProtoMessage

func (*Task) ProtoMessage()

func (*Task) ProtoReflect

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

func (*Task) Reset

func (x *Task) Reset()

func (*Task) String

func (x *Task) String() string

type TaskBackendClient

type TaskBackendClient interface {
	// RunTask instructs the backend to run a task (which contains payload for
	// executing a Buildbucket Build).
	//
	// The RunTaskResponse should contain the created task.
	// And the implementation of this RPC should be idempotent.
	//
	// Buildbucket will invoke this RPC with the Project-scoped identity.
	RunTask(ctx context.Context, in *RunTaskRequest, opts ...grpc.CallOption) (*RunTaskResponse, error)
	// Buildbucket will call FetchTasks when it needs to understand the current
	// status of tasks.
	//
	// This will happen at a regular, unspecified, interval when
	// UpdateBuild/UpdateBuildTask haven't been called recently.
	//
	// Once the build is in a terminal state, FetchTasks SHOULD return
	// the same response every time.
	//
	// Buildbucket will invoke this RPC with the Project-scoped identity.
	FetchTasks(ctx context.Context, in *FetchTasksRequest, opts ...grpc.CallOption) (*FetchTasksResponse, error)
	// Buildbucket will call this if it was requested to cancel some build(s).
	// The backend SHOULD implement cancelation as best as it can, but
	// simple backends may choose to ignore this (because the next call
	// to UpdateBuild will indicate that the build is Canceled, and so the
	// agent would quit).
	//
	// Buildbucket will invoke this RPC with the Project-scoped identity.
	CancelTasks(ctx context.Context, in *CancelTasksRequest, opts ...grpc.CallOption) (*CancelTasksResponse, error)
	// Buildbucket will call this when it is asked to validate project
	// configuration i.e. the Builder.backend.config_json field.
	//
	// Buildbucket will invoke this RPC with the Project-scoped identity.
	ValidateConfigs(ctx context.Context, in *ValidateConfigsRequest, opts ...grpc.CallOption) (*ValidateConfigsResponse, error)
}

TaskBackendClient is the client API for TaskBackend service.

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

func NewTaskBackendPRPCClient

func NewTaskBackendPRPCClient(client *prpc.Client) TaskBackendClient

type TaskBackendLiteClient

type TaskBackendLiteClient interface {
	// RunTask instructs the backend to run a task (which contains payload for
	// executing a Buildbucket Build).
	//
	// This should return a dummy or empty task.
	//
	// While idempotency is not required, it's still nice to have if possible.
	//
	// Buildbucket will invoke this RPC with the Project-scoped identity.
	RunTask(ctx context.Context, in *RunTaskRequest, opts ...grpc.CallOption) (*RunTaskResponse, error)
}

TaskBackendLiteClient is the client API for TaskBackendLite service.

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

func NewTaskBackendLitePRPCClient

func NewTaskBackendLitePRPCClient(client *prpc.Client) TaskBackendLiteClient

type TaskBackendLiteServer

type TaskBackendLiteServer interface {
	// RunTask instructs the backend to run a task (which contains payload for
	// executing a Buildbucket Build).
	//
	// This should return a dummy or empty task.
	//
	// While idempotency is not required, it's still nice to have if possible.
	//
	// Buildbucket will invoke this RPC with the Project-scoped identity.
	RunTask(context.Context, *RunTaskRequest) (*RunTaskResponse, error)
}

TaskBackendLiteServer is the server API for TaskBackendLite service.

type TaskBackendServer

type TaskBackendServer interface {
	// RunTask instructs the backend to run a task (which contains payload for
	// executing a Buildbucket Build).
	//
	// The RunTaskResponse should contain the created task.
	// And the implementation of this RPC should be idempotent.
	//
	// Buildbucket will invoke this RPC with the Project-scoped identity.
	RunTask(context.Context, *RunTaskRequest) (*RunTaskResponse, error)
	// Buildbucket will call FetchTasks when it needs to understand the current
	// status of tasks.
	//
	// This will happen at a regular, unspecified, interval when
	// UpdateBuild/UpdateBuildTask haven't been called recently.
	//
	// Once the build is in a terminal state, FetchTasks SHOULD return
	// the same response every time.
	//
	// Buildbucket will invoke this RPC with the Project-scoped identity.
	FetchTasks(context.Context, *FetchTasksRequest) (*FetchTasksResponse, error)
	// Buildbucket will call this if it was requested to cancel some build(s).
	// The backend SHOULD implement cancelation as best as it can, but
	// simple backends may choose to ignore this (because the next call
	// to UpdateBuild will indicate that the build is Canceled, and so the
	// agent would quit).
	//
	// Buildbucket will invoke this RPC with the Project-scoped identity.
	CancelTasks(context.Context, *CancelTasksRequest) (*CancelTasksResponse, error)
	// Buildbucket will call this when it is asked to validate project
	// configuration i.e. the Builder.backend.config_json field.
	//
	// Buildbucket will invoke this RPC with the Project-scoped identity.
	ValidateConfigs(context.Context, *ValidateConfigsRequest) (*ValidateConfigsResponse, error)
}

TaskBackendServer is the server API for TaskBackend service.

type TaskID

type TaskID struct {

	// Target backend. e.g. "swarming://chromium-swarm".
	Target string `protobuf:"bytes,1,opt,name=target,proto3" json:"target,omitempty"`
	// An ID unique to the target used to identify this task. e.g. Swarming task
	// ID.
	Id string `protobuf:"bytes,2,opt,name=id,proto3" json:"id,omitempty"`
	// contains filtered or unexported fields
}

A unique identifier for tasks.

func (*TaskID) Descriptor deprecated

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

Deprecated: Use TaskID.ProtoReflect.Descriptor instead.

func (*TaskID) GetId

func (x *TaskID) GetId() string

func (*TaskID) GetTarget

func (x *TaskID) GetTarget() string

func (*TaskID) ProtoMessage

func (*TaskID) ProtoMessage()

func (*TaskID) ProtoReflect

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

func (*TaskID) Reset

func (x *TaskID) Reset()

func (*TaskID) String

func (x *TaskID) String() string

type TimeRange

type TimeRange struct {

	// Inclusive lower boundary. Optional.
	StartTime *timestamppb.Timestamp `protobuf:"bytes,1,opt,name=start_time,json=startTime,proto3" json:"start_time,omitempty"`
	// Exclusive upper boundary. Optional.
	EndTime *timestamppb.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() *timestamppb.Timestamp

func (*TimeRange) GetStartTime

func (x *TimeRange) GetStartTime() *timestamppb.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 TokenBody

type TokenBody struct {

	// Id of the build this token is generated for.
	BuildId int64 `protobuf:"varint,1,opt,name=build_id,json=buildId,proto3" json:"build_id,omitempty"`
	// Purpose of the token.
	Purpose TokenBody_Purpose `protobuf:"varint,2,opt,name=purpose,proto3,enum=buildbucket.v2.TokenBody_Purpose" json:"purpose,omitempty"`
	// An additional random byte slice to be used to generate the token.
	State []byte `protobuf:"bytes,3,opt,name=state,proto3" json:"state,omitempty"`
	// contains filtered or unexported fields
}

TokenBody describes internal structure of the token.

func (*TokenBody) Descriptor deprecated

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

Deprecated: Use TokenBody.ProtoReflect.Descriptor instead.

func (*TokenBody) GetBuildId

func (x *TokenBody) GetBuildId() int64

func (*TokenBody) GetPurpose

func (x *TokenBody) GetPurpose() TokenBody_Purpose

func (*TokenBody) GetState

func (x *TokenBody) GetState() []byte

func (*TokenBody) ProtoMessage

func (*TokenBody) ProtoMessage()

func (*TokenBody) ProtoReflect

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

func (*TokenBody) Reset

func (x *TokenBody) Reset()

func (*TokenBody) String

func (x *TokenBody) String() string

type TokenBody_Purpose

type TokenBody_Purpose int32

Possible purposes of the token.

const (
	// The default value. This value is used if purpose is omitted.
	TokenBody_PURPOSE_UNSPECIFIED TokenBody_Purpose = 0
	// The token is a token for updating a build.
	TokenBody_BUILD TokenBody_Purpose = 1
	// The token is a token for updating a backend task. DO NOT USE. DEPRECATED.
	//
	// Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/token.proto.
	TokenBody_TASK TokenBody_Purpose = 2
	// The token is a token for starting a build.
	TokenBody_START_BUILD TokenBody_Purpose = 3
	// The token is a token for starting and registering a backend task with the
	// build it runs.
	TokenBody_START_BUILD_TASK TokenBody_Purpose = 4
)

func (TokenBody_Purpose) Descriptor

func (TokenBody_Purpose) Enum

func (TokenBody_Purpose) EnumDescriptor deprecated

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

Deprecated: Use TokenBody_Purpose.Descriptor instead.

func (TokenBody_Purpose) Number

func (TokenBody_Purpose) String

func (x TokenBody_Purpose) String() string

func (TokenBody_Purpose) Type

type TokenEnvelope

type TokenEnvelope struct {

	// Version of the token.
	Version TokenEnvelope_Version `protobuf:"varint,1,opt,name=version,proto3,enum=buildbucket.v2.TokenEnvelope_Version" json:"version,omitempty"`
	// Serialized and potentially encrypted TokenBody.
	Payload []byte `protobuf:"bytes,2,opt,name=payload,proto3" json:"payload,omitempty"`
	// contains filtered or unexported fields
}

TokenEnvelope is what is actually being serialized and represented as a token (after being encoded using base64 standard raw encoding).

func (*TokenEnvelope) Descriptor deprecated

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

Deprecated: Use TokenEnvelope.ProtoReflect.Descriptor instead.

func (*TokenEnvelope) GetPayload

func (x *TokenEnvelope) GetPayload() []byte

func (*TokenEnvelope) GetVersion

func (x *TokenEnvelope) GetVersion() TokenEnvelope_Version

func (*TokenEnvelope) ProtoMessage

func (*TokenEnvelope) ProtoMessage()

func (*TokenEnvelope) ProtoReflect

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

func (*TokenEnvelope) Reset

func (x *TokenEnvelope) Reset()

func (*TokenEnvelope) String

func (x *TokenEnvelope) String() string

type TokenEnvelope_Version

type TokenEnvelope_Version int32

Possible version of the token.

const (
	// The default value. This value is used if version is omitted.
	TokenEnvelope_VERSION_UNSPECIFIED TokenEnvelope_Version = 0
	// The token is saved in model.Build like a password.
	TokenEnvelope_UNENCRYPTED_PASSWORD_LIKE TokenEnvelope_Version = 1
	// The token is encrypted using go.chromium.org/luci/server/secrets.
	TokenEnvelope_ENCRYPTED TokenEnvelope_Version = 2
)

func (TokenEnvelope_Version) Descriptor

func (TokenEnvelope_Version) Enum

func (TokenEnvelope_Version) EnumDescriptor deprecated

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

Deprecated: Use TokenEnvelope_Version.Descriptor instead.

func (TokenEnvelope_Version) Number

func (TokenEnvelope_Version) String

func (x TokenEnvelope_Version) String() string

func (TokenEnvelope_Version) Type

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) ListBuilders

func (*UnimplementedBuildersServer) SetBuilderHealth

type UnimplementedBuildsServer

type UnimplementedBuildsServer struct {
}

UnimplementedBuildsServer can be embedded to have forward compatible implementations.

func (*UnimplementedBuildsServer) Batch

func (*UnimplementedBuildsServer) CancelBuild

func (*UnimplementedBuildsServer) CreateBuild

func (*UnimplementedBuildsServer) GetBuild

func (*UnimplementedBuildsServer) GetBuildStatus

func (*UnimplementedBuildsServer) ScheduleBuild

func (*UnimplementedBuildsServer) SearchBuilds

func (*UnimplementedBuildsServer) StartBuild

func (*UnimplementedBuildsServer) SynthesizeBuild

func (*UnimplementedBuildsServer) UpdateBuild

type UnimplementedTaskBackendLiteServer

type UnimplementedTaskBackendLiteServer struct {
}

UnimplementedTaskBackendLiteServer can be embedded to have forward compatible implementations.

func (*UnimplementedTaskBackendLiteServer) RunTask

type UnimplementedTaskBackendServer

type UnimplementedTaskBackendServer struct {
}

UnimplementedTaskBackendServer can be embedded to have forward compatible implementations.

func (*UnimplementedTaskBackendServer) CancelTasks

func (*UnimplementedTaskBackendServer) FetchTasks

func (*UnimplementedTaskBackendServer) RunTask

func (*UnimplementedTaskBackendServer) ValidateConfigs

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.output.status
	// - build.output.status_details
	// - build.output.summary_markdown
	// - build.status
	// - build.status_details
	// - build.steps
	// - build.summary_markdown
	// - build.tags
	// - build.infra.buildbucket.agent.output
	// - build.infra.buildbucket.agent.purposes
	//
	// Note, "build.output.status" is required explicitly to update the field.
	// If there is only "build.output" in update_mask, build.output.status will not
	// be updated.
	//
	// If omitted, Buildbucket will update the Build's update_time, but nothing else.
	UpdateMask *fieldmaskpb.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.
	//
	// DEPRECATED: Use mask instead.
	//
	// Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/builds_service.proto.
	Fields *fieldmaskpb.FieldMask `protobuf:"bytes,100,opt,name=fields,proto3" json:"fields,omitempty"`
	// What portion of the Build message to return.
	//
	// If not set, an empty build will be returned.
	Mask *BuildMask `protobuf:"bytes,101,opt,name=mask,proto3" json:"mask,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 deprecated

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

Deprecated: Marked as deprecated in go.chromium.org/luci/buildbucket/proto/builds_service.proto.

func (*UpdateBuildRequest) GetMask

func (x *UpdateBuildRequest) GetMask() *BuildMask

func (*UpdateBuildRequest) GetUpdateMask

func (x *UpdateBuildRequest) GetUpdateMask() *fieldmaskpb.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

type ValidateConfigsRequest

type ValidateConfigsRequest struct {

	// A list of all unique target+config_jsons that Buildbucket is requesting
	// validation for.
	Configs []*ValidateConfigsRequest_ConfigContext `protobuf:"bytes,1,rep,name=configs,proto3" json:"configs,omitempty"`
	// contains filtered or unexported fields
}

func (*ValidateConfigsRequest) Descriptor deprecated

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

Deprecated: Use ValidateConfigsRequest.ProtoReflect.Descriptor instead.

func (*ValidateConfigsRequest) GetConfigs

func (*ValidateConfigsRequest) ProtoMessage

func (*ValidateConfigsRequest) ProtoMessage()

func (*ValidateConfigsRequest) ProtoReflect

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

func (*ValidateConfigsRequest) Reset

func (x *ValidateConfigsRequest) Reset()

func (*ValidateConfigsRequest) String

func (x *ValidateConfigsRequest) String() string

type ValidateConfigsRequest_ConfigContext

type ValidateConfigsRequest_ConfigContext struct {
	Target     string           `protobuf:"bytes,1,opt,name=target,proto3" json:"target,omitempty"`
	ConfigJson *structpb.Struct `protobuf:"bytes,2,opt,name=config_json,json=configJson,proto3" json:"config_json,omitempty"` // guaranteed to be valid JSON
	// contains filtered or unexported fields
}

func (*ValidateConfigsRequest_ConfigContext) Descriptor deprecated

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

Deprecated: Use ValidateConfigsRequest_ConfigContext.ProtoReflect.Descriptor instead.

func (*ValidateConfigsRequest_ConfigContext) GetConfigJson

func (*ValidateConfigsRequest_ConfigContext) GetTarget

func (*ValidateConfigsRequest_ConfigContext) ProtoMessage

func (*ValidateConfigsRequest_ConfigContext) ProtoMessage()

func (*ValidateConfigsRequest_ConfigContext) ProtoReflect

func (*ValidateConfigsRequest_ConfigContext) Reset

func (*ValidateConfigsRequest_ConfigContext) String

type ValidateConfigsResponse

type ValidateConfigsResponse struct {

	// Must be sorted by `index`, and multiple ErrorDetails for the same index
	// should be assumed to be in an order which makes sense to the backend.
	ConfigErrors []*ValidateConfigsResponse_ErrorDetail `protobuf:"bytes,1,rep,name=config_errors,json=configErrors,proto3" json:"config_errors,omitempty"`
	// contains filtered or unexported fields
}

func (*ValidateConfigsResponse) Descriptor deprecated

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

Deprecated: Use ValidateConfigsResponse.ProtoReflect.Descriptor instead.

func (*ValidateConfigsResponse) GetConfigErrors

func (*ValidateConfigsResponse) ProtoMessage

func (*ValidateConfigsResponse) ProtoMessage()

func (*ValidateConfigsResponse) ProtoReflect

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

func (*ValidateConfigsResponse) Reset

func (x *ValidateConfigsResponse) Reset()

func (*ValidateConfigsResponse) String

func (x *ValidateConfigsResponse) String() string

type ValidateConfigsResponse_ErrorDetail

type ValidateConfigsResponse_ErrorDetail struct {

	// The 0-based index in the ValidateConfigsRequest.configs list.
	//
	// Note: `config_errors` can contain multiple ErrorDetail messages with
	// the same `index` value, to indicate multiple errors on the same item.
	Index int32  `protobuf:"varint,1,opt,name=index,proto3" json:"index,omitempty"`
	Error string `protobuf:"bytes,2,opt,name=error,proto3" json:"error,omitempty"`
	// contains filtered or unexported fields
}

func (*ValidateConfigsResponse_ErrorDetail) Descriptor deprecated

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

Deprecated: Use ValidateConfigsResponse_ErrorDetail.ProtoReflect.Descriptor instead.

func (*ValidateConfigsResponse_ErrorDetail) GetError

func (*ValidateConfigsResponse_ErrorDetail) GetIndex

func (*ValidateConfigsResponse_ErrorDetail) ProtoMessage

func (*ValidateConfigsResponse_ErrorDetail) ProtoMessage()

func (*ValidateConfigsResponse_ErrorDetail) ProtoReflect

func (*ValidateConfigsResponse_ErrorDetail) Reset

func (*ValidateConfigsResponse_ErrorDetail) String

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL