build

Documentation

Index

• Variables
• func AddFile(a Archive, file string) error
• func CopyFile(dst, src string, mode os.FileMode)
• func ExpandPackagesNoVendor(patterns []string) []string
• func GOPATH() string
• func GoTool(tool string, args ...string) *exec.Cmd
• func MustRun(cmd *exec.Cmd)
• func MustRunCommand(cmd string, args ...string)
• func Render(templateFile, outputFile string, outputPerm os.FileMode, x interface{})
• func RenderString(templateContent, outputFile string, outputPerm os.FileMode, x interface{})
• func RunGit(args ...string) string
• func UploadSFTP(identityFile, host, dir string, files []string) error
• func WriteArchive(name string, files []string) (err error)
• type Archive
  • func NewArchive(file *os.File) (Archive, string)
  • func NewTarballArchive(w io.WriteCloser) Archive
  • func NewZipArchive(w io.WriteCloser) Archive
• type Environment
  • func Env() Environment
  • func LocalEnv() Environment
  • func (env Environment) String() string
• type TarballArchive
  • func (a *TarballArchive) Close() error
  • func (a *TarballArchive) Directory(name string) error
  • func (a *TarballArchive) Header(fi os.FileInfo) (io.Writer, error)
• type ZipArchive
  • func (a *ZipArchive) Close() error
  • func (a *ZipArchive) Directory(name string) error
  • func (a *ZipArchive) Header(fi os.FileInfo) (io.Writer, error)

Variables

var (
	// These flags override values in build env.
	GitCommitFlag   = flag.String("git-commit", "", `Overrides git commit hash embedded into executables`)
	GitBranchFlag   = flag.String("git-branch", "", `Overrides git branch being built`)
	GitTagFlag      = flag.String("git-tag", "", `Overrides git tag being built`)
	BuildnumFlag    = flag.String("buildnum", "", `Overrides CI build number`)
	PullRequestFlag = flag.Bool("pull-request", false, `Overrides pull request status of the build`)
	CronJobFlag     = flag.Bool("cron-job", false, `Overrides cron job status of the build`)
)

var DryRunFlag = flag.Bool("n", false, "dry run, don't execute commands")

Functions

func AddFile

func AddFile(a Archive, file string) error

AddFile appends an existing file to an archive.

func CopyFile

func CopyFile(dst, src string, mode os.FileMode)

CopyFile copies a file.

func ExpandPackagesNoVendor

func ExpandPackagesNoVendor(patterns []string) []string

ExpandPackagesNoVendor expands a cmd/go import path pattern, skipping vendored packages.

func GOPATH

func GOPATH() string

GOPATH returns the value that the GOPATH environment variable should be set to.

func GoTool

func GoTool(tool string, args ...string) *exec.Cmd

GoTool returns the command that runs a go tool. This uses go from GOROOT instead of PATH so that go commands executed by build use the same version of Go as the 'host' that runs build code. e.g.

/usr/lib/go-1.11/bin/go run build/ci.go ...

runs using go 1.11 and invokes go 1.11 tools from the same GOROOT. This is also important because runtime.Version checks on the host should match the tools that are run.

func MustRun

func MustRun(cmd *exec.Cmd)

MustRun executes the given command and exits the host process for any error.

func MustRunCommand

func MustRunCommand(cmd string, args ...string)

func Render

func Render(templateFile, outputFile string, outputPerm os.FileMode, x interface{})

Render renders the given template file into outputFile.

func RenderString

func RenderString(templateContent, outputFile string, outputPerm os.FileMode, x interface{})

RenderString renders the given template string into outputFile.

func RunGit

func RunGit(args ...string) string

RunGit runs a git subcommand and returns its output. The command must complete successfully.

func UploadSFTP

func UploadSFTP(identityFile, host, dir string, files []string) error

UploadSFTP uploads files to a remote host using the sftp command line tool. The destination host may be specified either as [user@]host[: or as a URI in the form sftp://[user@]host[:port].

func WriteArchive

func WriteArchive(name string, files []string) (err error)

WriteArchive creates an archive containing the given files.

Types

type Archive

type Archive interface {
	// Directory adds a new directory entry to the archive and sets the
	// directory for subsequent calls to Header.
	Directory(name string) error

	// Header adds a new file to the archive. The file is added to the directory
	// set by Directory. The content of the file must be written to the returned
	// writer.
	Header(os.FileInfo) (io.Writer, error)

	// Close flushes the archive and closes the underlying file.
	Close() error
}

func NewArchive

func NewArchive(file *os.File) (Archive, string)

func NewTarballArchive

func NewTarballArchive(w io.WriteCloser) Archive

func NewZipArchive

func NewZipArchive(w io.WriteCloser) Archive

type Environment

type Environment struct {
	Name                string // name of the environment
	Repo                string // name of GitHub repo
	Commit, Branch, Tag string // Git info
	Buildnum            string
	IsPullRequest       bool
	IsCronJob           bool
}

Environment contains metadata provided by the build environment.

func Env

func Env() Environment

Env returns metadata about the current CI environment, falling back to LocalEnv if not running on CI.

func LocalEnv

func LocalEnv() Environment

LocalEnv returns build environment metadata gathered from git.

func (Environment) String

func (env Environment) String() string

type TarballArchive

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

func (*TarballArchive) Close

func (a *TarballArchive) Close() error

func (*TarballArchive) Directory

func (a *TarballArchive) Directory(name string) error

func (*TarballArchive) Header

func (a *TarballArchive) Header(fi os.FileInfo) (io.Writer, error)

type ZipArchive

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

func (*ZipArchive) Close

func (a *ZipArchive) Close() error

func (*ZipArchive) Directory

func (a *ZipArchive) Directory(name string) error

func (*ZipArchive) Header

func (a *ZipArchive) Header(fi os.FileInfo) (io.Writer, error)