Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

preflight

package

Go to main page

Versions in this module

v3

v3.54.2

Aug 3, 2026

v3.54.1

Jul 23, 2026

v3.54.0

Jul 19, 2026

v3.53.1

Jul 19, 2026

v3.53.0

Jul 16, 2026

v3.52.1

Jul 16, 2026

v3.52.0

Jul 14, 2026

v3.51.1

Jul 7, 2026

v3.51.0

Jun 29, 2026

v3.50.0

Jun 24, 2026

Changes in this version

type EventType

+ const EventJobPromisedFailure

v3.49.2

Jun 18, 2026

v3.49.1

Jun 18, 2026

v3.49.0

Jun 18, 2026

v3.48.1

Jun 14, 2026

v3.48.0

Jun 10, 2026

v3.47.0

Jun 9, 2026

v3.46.0

Jun 4, 2026

v3.45.0

Jun 3, 2026

v3.44.1

Jun 1, 2026

Changes in this version

type Event

+ func (e Event) MarshalJSON() ([]byte, error)

v3.44.0

May 26, 2026

v3.43.0

May 26, 2026

v3.42.0

May 7, 2026

v3.41.1

May 5, 2026

v3.41.0

May 4, 2026

v3.40.0

Apr 30, 2026

v3.39.0

Apr 29, 2026

Changes in this version

+ func HelpText() string

v3.38.1

Apr 24, 2026

v3.38.0

Apr 23, 2026

Changes in this version

type Event

+ BuildCanceled *bool

+ Incomplete bool

+ StopReason string

+ func (e *Event) ApplyJobResults(finalBuild buildkite.Build, tracker *watch.JobTracker)

+ func (e *Event) ApplySummaryMeta(meta summaryMeta)

type RunCmd

+ ExitOn []internalpreflight.ExitPolicy

+ func (c *RunCmd) Validate() error

v3.37.1

Apr 22, 2026

v3.37.0

Apr 22, 2026

Changes in this version

type Event

+ Tests internalpreflight.SummaryTests

type EventType

+ const EventJobRetryPassed

type RunCmd

+ AwaitTestResults awaitTestResultsFlag

v3.36.0

Apr 17, 2026

v3.35.2

Apr 15, 2026

Changes in this version

+ type CleanupCmd struct

+ DryRun bool

+ JSON bool

+ Pipeline string

+ PreflightUUID string

+ Text bool

+ func (c *CleanupCmd) Help() string

+ func (c *CleanupCmd) Run(kongCtx *kong.Context, globals cli.GlobalFlags) error

+ type RunCmd struct

+ Interval float64

+ JSON bool

+ NoCleanup bool

+ Pipeline string

+ Text bool

+ Watch bool

+ func (c *RunCmd) Help() string

+ func (c *RunCmd) Run(kongCtx *kong.Context, globals cli.GlobalFlags) error

v3.35.1

Apr 13, 2026

v3.35.0

Apr 10, 2026

Changes in this version

+ type Event struct

+ BuildNumber int

+ BuildState string

+ BuildURL string

+ Detail string

+ Duration time.Duration

+ FailedJobs []buildkite.Job

+ Job *buildkite.Job

+ Jobs *watch.JobSummary

+ PassedJobs []buildkite.Job

+ Pipeline string

+ PreflightID string

+ TestFailures []buildkite.BuildTest

+ Time time.Time

+ Title string

+ Type EventType

+ type EventType string

+ const EventBuildStatus

+ const EventBuildSummary

+ const EventJobFailure

+ const EventOperation

+ const EventTestFailure

type PreflightCmd

+ JSON bool

+ Text bool

type Result

+ func (r Result) Passed() bool

v3.34.0

Mar 31, 2026

v3.33.1

Mar 31, 2026

Changes in this version

+ type Result struct

+ func NewResult(build buildkite.Build) Result

+ func (r Result) Error() error

v3.33.0

Mar 30, 2026

Changes in this version

+ type PreflightCmd struct

+ Interval float64

+ NoCleanup bool

+ Pipeline string

+ Watch bool

+ func (c *PreflightCmd) Help() string

+ func (c *PreflightCmd) Run(kongCtx *kong.Context, globals cli.GlobalFlags) error