buildbucket

package
v0.0.0-...-678bb0e Latest Latest
Warning

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

Go to latest
Published: Aug 8, 2017 License: Apache-2.0 Imports: 3 Imported by: 0

Documentation

Overview

Package buildbucket is a generated protocol buffer package.

It is generated from these files:

github.com/luci/luci-go/buildbucket/client/cmd/buildbucket/proto/project_config.proto

It has these top-level messages:

Acl
AclSet
Swarming
Bucket
BuildbucketCfg

Index

Constants

This section is empty.

Variables

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

Functions

This section is empty.

Types

type Acl

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

A single access control rule.

func (*Acl) Descriptor

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

func (*Acl) GetGroup

func (m *Acl) GetGroup() string

func (*Acl) GetIdentity

func (m *Acl) GetIdentity() string

func (*Acl) GetRole

func (m *Acl) GetRole() Acl_Role

func (*Acl) ProtoMessage

func (*Acl) ProtoMessage()

func (*Acl) Reset

func (m *Acl) Reset()

func (*Acl) String

func (m *Acl) String() string

type AclSet

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

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

func (*AclSet) Descriptor

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

func (*AclSet) GetAcls

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

func (*AclSet) GetName

func (m *AclSet) GetName() string

func (*AclSet) ProtoMessage

func (*AclSet) ProtoMessage()

func (*AclSet) Reset

func (m *AclSet) Reset()

func (*AclSet) String

func (m *AclSet) String() string

type Acl_Role

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

func (Acl_Role) Enum

func (x Acl_Role) Enum() *Acl_Role

func (Acl_Role) EnumDescriptor

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

func (Acl_Role) String

func (x Acl_Role) String() string

func (*Acl_Role) UnmarshalJSON

func (x *Acl_Role) UnmarshalJSON(data []byte) error

type Bucket

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

Defines one bucket in buildbucket.cfg

func (*Bucket) Descriptor

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

func (*Bucket) GetAclSets

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

func (*Bucket) GetAcls

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

func (*Bucket) GetName

func (m *Bucket) GetName() string

func (*Bucket) GetSwarming

func (m *Bucket) GetSwarming() *Swarming

func (*Bucket) ProtoMessage

func (*Bucket) ProtoMessage()

func (*Bucket) Reset

func (m *Bucket) Reset()

func (*Bucket) String

func (m *Bucket) String() string

type BuildbucketCfg

type BuildbucketCfg struct {
	// All buckets defined for this project.
	Buckets []*Bucket `protobuf:"bytes,1,rep,name=buckets" json:"buckets,omitempty"`
	// A list of ACL sets. Names must be unique.
	AclSets          []*AclSet `protobuf:"bytes,2,rep,name=acl_sets,json=aclSets" json:"acl_sets,omitempty"`
	XXX_unrecognized []byte    `json:"-"`
}

Schema of buildbucket.cfg file, a project config.

func (*BuildbucketCfg) Descriptor

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

func (*BuildbucketCfg) GetAclSets

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

func (*BuildbucketCfg) GetBuckets

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

func (*BuildbucketCfg) ProtoMessage

func (*BuildbucketCfg) ProtoMessage()

func (*BuildbucketCfg) Reset

func (m *BuildbucketCfg) Reset()

func (*BuildbucketCfg) String

func (m *BuildbucketCfg) String() string

type Swarming

type Swarming struct {
	// Hostname of the swarming instance, e.g. "chromium-swarm.appspot.com".
	Hostname *string `protobuf:"bytes,1,opt,name=hostname" json:"hostname,omitempty"`
	// Used to generate a URL for Build, may contain parameters
	// {swarming_hostname}, {task_id}, {bucket} and {builder}. Defaults to:
	// https://{swarming_hostname}/user/task/{task_id}
	UrlFormat *string `protobuf:"bytes,2,opt,name=url_format,json=urlFormat" json:"url_format,omitempty"`
	// Defines default values for builders.
	BuilderDefaults *Swarming_Builder `protobuf:"bytes,3,opt,name=builder_defaults,json=builderDefaults" json:"builder_defaults,omitempty"`
	// Configuration for each builder.
	// Swarming tasks are created only for builds for builders that are not
	// explicitly specified.
	Builders []*Swarming_Builder `protobuf:"bytes,4,rep,name=builders" json:"builders,omitempty"`
	// Percentage of builds that should use a canary swarming task template.
	// A value from 0 to 100.
	TaskTemplateCanaryPercentage *uint32 `` /* 143-byte string literal not displayed */
	XXX_unrecognized             []byte  `json:"-"`
}

Configuration of buildbucket-swarming integration for one bucket.

func (*Swarming) Descriptor

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

func (*Swarming) GetBuilderDefaults

func (m *Swarming) GetBuilderDefaults() *Swarming_Builder

func (*Swarming) GetBuilders

func (m *Swarming) GetBuilders() []*Swarming_Builder

func (*Swarming) GetHostname

func (m *Swarming) GetHostname() string

func (*Swarming) GetTaskTemplateCanaryPercentage

func (m *Swarming) GetTaskTemplateCanaryPercentage() uint32

func (*Swarming) GetUrlFormat

func (m *Swarming) GetUrlFormat() string

func (*Swarming) ProtoMessage

func (*Swarming) ProtoMessage()

func (*Swarming) Reset

func (m *Swarming) Reset()

func (*Swarming) String

func (m *Swarming) String() string

type Swarming_Builder

type Swarming_Builder struct {
	// Name of the builder. Will be propagated to "builder" build tag and
	// "buildername" recipe property.
	Name *string `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"`
	// Builder category. Will be used for visual grouping, for example in Code Review.
	Category *string `protobuf:"bytes,6,opt,name=category" json:"category,omitempty"`
	// Will be become to swarming task tags.
	// Each tag will end up in "swarming_tag" buildbucket tag, for example
	// "swarming_tag:builder:release"
	SwarmingTags []string `protobuf:"bytes,2,rep,name=swarming_tags,json=swarmingTags" json:"swarming_tags,omitempty"`
	// Colon-delimited key-value pair of task dimensions.
	//
	// If value is not specified ("<key>:"), then it excludes a default value.
	Dimensions []string `protobuf:"bytes,3,rep,name=dimensions" json:"dimensions,omitempty"`
	// CIPD packages to install on the builder.
	CipdPackages []*Swarming_Builder_CipdPackage `protobuf:"bytes,8,rep,name=cipd_packages,json=cipdPackages" json:"cipd_packages,omitempty"`
	// Specifies that a recipe to run.
	Recipe *Swarming_Recipe `protobuf:"bytes,4,opt,name=recipe" json:"recipe,omitempty"`
	// Swarming task priority.
	Priority *uint32 `protobuf:"varint,5,opt,name=priority" json:"priority,omitempty"`
	// Maximum build execution time. Not to be confused with pending time.
	ExecutionTimeoutSecs *uint32 `protobuf:"varint,7,opt,name=execution_timeout_secs,json=executionTimeoutSecs" json:"execution_timeout_secs,omitempty"`
	// Caches that should be present on the bot.
	Caches           []*Swarming_Builder_CacheEntry `protobuf:"bytes,9,rep,name=caches" json:"caches,omitempty"`
	XXX_unrecognized []byte                         `json:"-"`
}

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.

func (*Swarming_Builder) Descriptor

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

func (*Swarming_Builder) GetCaches

func (*Swarming_Builder) GetCategory

func (m *Swarming_Builder) GetCategory() string

func (*Swarming_Builder) GetCipdPackages

func (m *Swarming_Builder) GetCipdPackages() []*Swarming_Builder_CipdPackage

func (*Swarming_Builder) GetDimensions

func (m *Swarming_Builder) GetDimensions() []string

func (*Swarming_Builder) GetExecutionTimeoutSecs

func (m *Swarming_Builder) GetExecutionTimeoutSecs() uint32

func (*Swarming_Builder) GetName

func (m *Swarming_Builder) GetName() string

func (*Swarming_Builder) GetPriority

func (m *Swarming_Builder) GetPriority() uint32

func (*Swarming_Builder) GetRecipe

func (m *Swarming_Builder) GetRecipe() *Swarming_Recipe

func (*Swarming_Builder) GetSwarmingTags

func (m *Swarming_Builder) GetSwarmingTags() []string

func (*Swarming_Builder) ProtoMessage

func (*Swarming_Builder) ProtoMessage()

func (*Swarming_Builder) Reset

func (m *Swarming_Builder) Reset()

func (*Swarming_Builder) String

func (m *Swarming_Builder) String() string

type Swarming_Builder_CacheEntry

type Swarming_Builder_CacheEntry struct {
	// Unique name of the cache. Required. Length is limited to 4096.
	Name *string `protobuf:"bytes,1,opt,name=name" json:"name,omitempty"`
	// Relative path to the directory that will be linked to the named cache.
	// Required.
	// A path cannot be shared among multiple caches or CIPD installations.
	// A task will fail if a file/dir with the same name already exists.
	Path             *string `protobuf:"bytes,2,opt,name=path" json:"path,omitempty"`
	XXX_unrecognized []byte  `json:"-"`
}

Describes a named cache that should be present on the bot. See also https://github.com/luci/luci-py/blob/3a2941345cf011a96bcd83d76328395323245bb5/appengine/swarming/swarming_rpcs.py#L166

func (*Swarming_Builder_CacheEntry) Descriptor

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

func (*Swarming_Builder_CacheEntry) GetName

func (m *Swarming_Builder_CacheEntry) GetName() string

func (*Swarming_Builder_CacheEntry) GetPath

func (m *Swarming_Builder_CacheEntry) GetPath() string

func (*Swarming_Builder_CacheEntry) ProtoMessage

func (*Swarming_Builder_CacheEntry) ProtoMessage()

func (*Swarming_Builder_CacheEntry) Reset

func (m *Swarming_Builder_CacheEntry) Reset()

func (*Swarming_Builder_CacheEntry) String

func (m *Swarming_Builder_CacheEntry) String() string

type Swarming_Builder_CipdPackage

type Swarming_Builder_CipdPackage struct {
	// A template of a full CIPD package name, e.g
	// "infra/tools/authutil/${platform}". This can be parametrized using
	// ${platform} and ${os_ver} parameters, where ${platform} will be
	// expanded into "<os>-<architecture>" and ${os_ver} will be expanded to
	// OS version name.
	PackageName *string `protobuf:"bytes,1,opt,name=package_name,json=packageName" json:"package_name,omitempty"`
	// Path to dir, relative to the task working dir, where to install the
	// package. The path cannot be empty or start with a slash.
	Path *string `protobuf:"bytes,2,opt,name=path" json:"path,omitempty"`
	// Valid package version for all packages matched by package name.
	Version          *string `protobuf:"bytes,3,opt,name=version" json:"version,omitempty"`
	XXX_unrecognized []byte  `json:"-"`
}

func (*Swarming_Builder_CipdPackage) Descriptor

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

func (*Swarming_Builder_CipdPackage) GetPackageName

func (m *Swarming_Builder_CipdPackage) GetPackageName() string

func (*Swarming_Builder_CipdPackage) GetPath

func (m *Swarming_Builder_CipdPackage) GetPath() string

func (*Swarming_Builder_CipdPackage) GetVersion

func (m *Swarming_Builder_CipdPackage) GetVersion() string

func (*Swarming_Builder_CipdPackage) ProtoMessage

func (*Swarming_Builder_CipdPackage) ProtoMessage()

func (*Swarming_Builder_CipdPackage) Reset

func (m *Swarming_Builder_CipdPackage) Reset()

func (*Swarming_Builder_CipdPackage) String

type Swarming_Recipe

type Swarming_Recipe struct {
	// Repository URL of the recipe package.
	Repository *string `protobuf:"bytes,1,opt,name=repository" json:"repository,omitempty"`
	// Name of the recipe to run.
	Name *string `protobuf:"bytes,2,opt,name=name" json:"name,omitempty"`
	// colon-separated build properties to set.
	// A property can be overriden by "properties" build parameter.
	//
	// Use this field for string properties and use properties_j for other
	// types.
	Properties []string `protobuf:"bytes,3,rep,name=properties" 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" json:"properties_j,omitempty"`
	XXX_unrecognized []byte   `json:"-"`
}

func (*Swarming_Recipe) Descriptor

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

func (*Swarming_Recipe) GetName

func (m *Swarming_Recipe) GetName() string

func (*Swarming_Recipe) GetProperties

func (m *Swarming_Recipe) GetProperties() []string

func (*Swarming_Recipe) GetPropertiesJ

func (m *Swarming_Recipe) GetPropertiesJ() []string

func (*Swarming_Recipe) GetRepository

func (m *Swarming_Recipe) GetRepository() string

func (*Swarming_Recipe) ProtoMessage

func (*Swarming_Recipe) ProtoMessage()

func (*Swarming_Recipe) Reset

func (m *Swarming_Recipe) Reset()

func (*Swarming_Recipe) String

func (m *Swarming_Recipe) String() string

Jump to

Keyboard shortcuts

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