build

Documentation

Index

• Variables
• func AddFile(a Archive, file string) error
• func DownloadGo(csdb *ChecksumDB, version string) string
• func ExtractArchive(archive string, dest string) error
• func FindMainPackages(dir string) []string
• func MustRun(cmd *exec.Cmd)
• func MustRunCommand(cmd string, args ...string)
• func PGPKeyID(pgpkey string) (string, error)
• func PGPSignFile(input string, output string, pgpkey string) error
• 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 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 ChecksumDB
  • func MustLoadChecksums(file string) *ChecksumDB
  • func (db *ChecksumDB) DownloadFile(url, dstPath string) error
  • func (db *ChecksumDB) Verify(path string) error
• type Environment
  • func Env() Environment
  • func LocalEnv() Environment
  • func (env Environment) String() string
• type GoToolchain
  • func (g *GoToolchain) Go(command string, args ...string) *exec.Cmd
  • func (g *GoToolchain) Install(gobin string, args ...string) *exec.Cmd
• 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 DownloadGo

func DownloadGo(csdb *ChecksumDB, version string) string

DownloadGo downloads the Go binary distribution and unpacks it into a temporary directory. It returns the GOROOT of the unpacked toolchain.

func ExtractArchive

func ExtractArchive(archive string, dest string) error

ExtractArchive unpacks a .zip or .tar.gz archive to the destination directory.

func FindMainPackages

func FindMainPackages(dir string) []string

FindMainPackages finds all 'main' packages in the given directory and returns their package paths.

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 PGPKeyID

func PGPKeyID(pgpkey string) (string, error)

PGPKeyID parses an armored key and returns the key ID.

func PGPSignFile

func PGPSignFile(input string, output string, pgpkey string) error

PGPSignFile parses a PGP private key from the specified string and creates a signature file into the output parameter of the input file.

Note, this method assumes a single key will be container in the pgpkey arg, furthermore that it is in armored format.

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 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 ChecksumDB

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

ChecksumDB keeps file checksums.

func MustLoadChecksums

func MustLoadChecksums(file string) *ChecksumDB

MustLoadChecksums loads a file containing checksums.

func (*ChecksumDB) DownloadFile

func (db *ChecksumDB) DownloadFile(url, dstPath string) error

DownloadFile downloads a file and verifies its checksum.

func (*ChecksumDB) Verify

func (db *ChecksumDB) Verify(path string) error

Verify checks whether the given file is valid according to the checksum database.

type Environment

type Environment struct {
	CI                        bool
	Name                      string // name of the environment
	Repo                      string // name of GitHub repo
	Commit, Date, 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 GoToolchain

type GoToolchain struct {
	Root string // GOROOT

	// Cross-compilation variables. These are set when running the go tool.
	GOARCH string
	GOOS   string
	CC     string
}

func (*GoToolchain) Go

func (g *GoToolchain) Go(command string, args ...string) *exec.Cmd

Go creates an invocation of the go command.

func (*GoToolchain) Install

func (g *GoToolchain) Install(gobin string, args ...string) *exec.Cmd

Install creates an invocation of 'go install'. The command is configured to output executables to the given 'gobin' directory.

This can be used to install auxiliary build tools without modifying the local go.mod and go.sum files. To install tools which are not required by go.mod, ensure that all module paths in 'args' contain a module version suffix (e.g. "...@latest").

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)