buildbucket

Documentation

Overview

Package buildbucket is a client library for Buildbucket service.

Index

• Constants
• Variables
• func WithoutDisallowedTagKeys(tags []*pb.StringPair) []*pb.StringPair

Constants

const (
	ExperimentBackendAlt          = "luci.buildbucket.backend_alt"
	ExperimentBackendGo           = "luci.buildbucket.backend_go"
	ExperimentBBAgent             = "luci.buildbucket.use_bbagent"
	ExperimentBBAgentDownloadCipd = "luci.buildbucket.agent.cipd_installation"
	ExperimentBBAgentGetBuild     = "luci.buildbucket.bbagent_getbuild"
	ExperimentBBCanarySoftware    = "luci.buildbucket.canary_software"
	ExperimentBqExporterGo        = "luci.buildbucket.bq_exporter_go"
	ExperimentNonProduction       = "luci.non_production"
	ExperimentParentTracking      = "luci.buildbucket.parent_tracking"
	ExperimentWaitForCapacity     = "luci.buildbucket.wait_for_capacity_in_slices"
)

Well-known experiment strings.

See the Builder.experiments field documentation.

const BuildTokenHeader = "x-build-token"

BuildTokenHeader is the old name of the gRPC metadata header indicating the build token (see BuildSecrets.BuildToken). It is still used by `kitchen`, but is otherwise deprecated in favor of BuildbucketTokenHeader for all uses.

DEPRECATED

const BuildbucketTokenHeader = "x-buildbucket-token"

BuildbucketTokenHeader is the name of gRPC metadata header indicating a buildbucket token.

Tokens include an authenticatable purpose field, we only need one header for all incoming RPCs.

const DummyBuildbucketToken = "dummy token"

DummyBuildbucketToken is the dummy token for led builds.

const MinUpdateBuildInterval = 30 * time.Second

MinUpdateBuildInterval is the minimum interval bbagent should call UpdateBuild.

Variables

var (
	// DuplicateTask means the backend has created multiple tasks for the same build.
	// After the build has associated with one of those tasks (either by StartBuild or RegisterBuildTask),
	// requests of associating other tasks with the build will fail with this error.
	DuplicateTask = errors.BoolTag{Key: errors.NewTagKey("duplicate_backend_task")}
	// TaskWithCollidedRequestID the backend has created multiple tasks for the same build,
	// and two tasks among them have generated the same request_id for calling RegisterBuildTask.
	TaskWithCollidedRequestID = errors.BoolTag{Key: errors.NewTagKey("task_with_collided_request_id")}
)

var (
	// DisallowedAppendTagKeys is the set of tag keys which cannot be set via
	// UpdateBuild. Clients calling UpdateBuild must strip these before making
	// the request.
	DisallowedAppendTagKeys = stringset.NewFromSlice("build_address", "buildset", "builder")
)

Functions

func WithoutDisallowedTagKeys

func WithoutDisallowedTagKeys(tags []*pb.StringPair) []*pb.StringPair

WithoutDisallowedTagKeys returns tags whose key are not in `DisallowedAppendTagKeys`.