dashboard

Documentation

Overview

Package dashboard contains shared configuration and logic used by various pieces of the Go continuous build system.

Index

• Variables
• type BuildConfig
  • func (c *BuildConfig) AllScript() string
  • func (c *BuildConfig) AllScriptArgs() []string
  • func (c *BuildConfig) BuildSubrepos() bool
  • func (c *BuildConfig) BuildletBinaryURL() string
  • func (c *BuildConfig) Env() []string
  • func (c *BuildConfig) FilePathJoin(x ...string) string
  • func (c *BuildConfig) GCENumCPU() int
  • func (c *BuildConfig) GOARCH() string
  • func (c *BuildConfig) GOOS() string
  • func (c *BuildConfig) GorootFinal() string
  • func (c *BuildConfig) IsRace() bool
  • func (c *BuildConfig) MachineType() string
  • func (c *BuildConfig) MakeScript() string
  • func (c *BuildConfig) MakeScriptArgs() []string
  • func (c *BuildConfig) RunScript() string
  • func (c *BuildConfig) RunScriptArgs() []string
  • func (c *BuildConfig) SetBuildletBinaryURL(u string)
  • func (c BuildConfig) ShortOwner() string
  • func (c *BuildConfig) SplitMakeRun() bool

Variables

var Builders = map[string]BuildConfig{}

Builders are the different build configurations. The keys are like "darwin-amd64" or "linux-386-387". This map should not be modified by other packages.

var BuildletBucket = "go-builder-data"

BuildletBucket is the GCS storage bucket which holds the buildlet binaries. Tools working in the dev project may change this.

Types

type BuildConfig

type BuildConfig struct {
	// Name is the unique name of the builder, in the form of
	// "darwin-386" or "linux-amd64-race".
	Name string

	Notes   string // notes for humans
	Owner   string // e.g. "bradfitz@golang.org", empty means golang-dev
	VMImage string // e.g. "openbsd-amd64-56"

	Go14URL string // URL to built Go 1.4 tar.gz

	IsReverse   bool // if true, only use the reverse buildlet pool
	RegularDisk bool // if true, use spinning disk instead of SSD
	TryOnly     bool // only used for trybots, and not regular builds

	// NumTestHelpers is the number of _additional_ buildlets
	// past the first help out with sharded tests.
	NumTestHelpers int

	// BuildletType optionally specifies the type of buildlet to
	// request from the buildlet pool. If empty, it defaults to
	// the value of Name.
	//
	// These should be used to minimize builder types, so the buildlet pool
	// implementations can reuse buildlets from similar-enough builds.
	// (e.g. a shared linux-386 trybot can be reused for some linux-amd64
	// or linux-amd64-race tests, etc)
	//
	// TODO(bradfitz): break BuildConfig up into BuildConfig and
	// BuildletConfig and have a BuildConfig refer to a
	// BuildletConfig. There's no much confusion now.
	BuildletType string
	// contains filtered or unexported fields
}

A BuildConfig describes how to run a builder.

func (*BuildConfig) AllScript

func (c *BuildConfig) AllScript() string

AllScript returns the relative path to the operating system's script to do the build and run its standard set of tests. Example values are "src/all.bash", "src/all.bat", "src/all.rc".

func (*BuildConfig) AllScriptArgs

func (c *BuildConfig) AllScriptArgs() []string

AllScriptArgs returns the set of arguments that should be passed to the all.bash-equivalent script. Usually empty.

func (*BuildConfig) BuildSubrepos

func (c *BuildConfig) BuildSubrepos() bool

func (*BuildConfig) BuildletBinaryURL

func (c *BuildConfig) BuildletBinaryURL() string

BuildletBinaryURL returns the public URL of this builder's buildlet.

func (*BuildConfig) Env

func (c *BuildConfig) Env() []string

func (*BuildConfig) FilePathJoin

func (c *BuildConfig) FilePathJoin(x ...string) string

FilePathJoin is mostly like filepath.Join (without the cleaning) except it uses the path separator of c.GOOS instead of the host system's.

func (*BuildConfig) GCENumCPU

func (c *BuildConfig) GCENumCPU() int

GCENumCPU reports the number of GCE CPUs this buildlet requires.

func (*BuildConfig) GOARCH

func (c *BuildConfig) GOARCH() string

func (*BuildConfig) GOOS

func (c *BuildConfig) GOOS() string

func (*BuildConfig) GorootFinal

func (c *BuildConfig) GorootFinal() string

GorootFinal returns the default install location for releases for this platform.

func (*BuildConfig) IsRace

func (c *BuildConfig) IsRace() bool

func (*BuildConfig) MachineType

func (c *BuildConfig) MachineType() string

MachineType returns the GCE machine type to use for this builder.

func (*BuildConfig) MakeScript

func (c *BuildConfig) MakeScript() string

MakeScript returns the relative path to the operating system's script to do the build. Example values are "src/make.bash", "src/make.bat", "src/make.rc".

func (*BuildConfig) MakeScriptArgs

func (c *BuildConfig) MakeScriptArgs() []string

MakeScriptArgs returns the set of arguments that should be passed to the make.bash-equivalent script. Usually empty.

func (*BuildConfig) RunScript

func (c *BuildConfig) RunScript() string

RunScript returns the relative path to the operating system's script to run the test suite. Example values are "src/run.bash", "src/run.bat", "src/run.rc".

func (*BuildConfig) RunScriptArgs

func (c *BuildConfig) RunScriptArgs() []string

RunScriptArgs returns the set of arguments that should be passed to the run.bash-equivalent script.

func (*BuildConfig) SetBuildletBinaryURL

func (c *BuildConfig) SetBuildletBinaryURL(u string)

SetBuildletBinaryURL sets the public URL of this builder's buildlet.

func (BuildConfig) ShortOwner

func (c BuildConfig) ShortOwner() string

ShortOwner returns a short human-readable owner.

func (*BuildConfig) SplitMakeRun

func (c *BuildConfig) SplitMakeRun() bool

SplitMakeRun reports whether the coordinator should first compile (using c.MakeScript), then snapshot, then run the tests (ideally sharded) using c.RunScript. Eventually this function should always return true (and then be deleted) but for now we've only set up the scripts and verified that the main configurations work.