Skip to content

Support checkout skipping in agent#3672

Merged
mcncl merged 6 commits intomainfrom
feat/skip_checkout
Jan 28, 2026
Merged

Support checkout skipping in agent#3672
mcncl merged 6 commits intomainfrom
feat/skip_checkout

Conversation

@mcncl
Copy link
Contributor

@mcncl mcncl commented Jan 17, 2026

Description

The kubernetes stack allows checkout: skip: true to be set in the step config, but using non-k8s doesn't support this without the use of a plugin. By adding this flag/env var reading we allow for a future where skip_checkout: true can be set in the step (BUILDKITE_SKIP_CHECKOUT)

This also allows agents to run with --skip-checkout, which means folks can ensure that they can have a fleet of agents in a certain queue which won't checkout.

Context

A lot of folks use third party plugins to achieve this, and the k8s supports it as a first class citizen.

Changes

  • adds SkipCheckout as an agent configuration option
  • sets the job checkout to determine if skipping checkout has been set (this is for a future skip_checkout config option
  • enabled users to set a flag, --skip-checkout in start and bootstrap
  • adds a test to checkout_test.go and checkout_integration_test.go

Testing

  • Tests have run locally (with go test ./...). Buildkite employees may check this if the pipeline has run automatically.
  • Code is formatted (with go tool gofumpt -extra -w .)

Disclosures / Credits

All me babyyyyyyy.

mcncl added 6 commits January 14, 2026 22:41
Signed-off-by: Ben McNicholl <git@benmcnicholl.com>
Signed-off-by: Ben McNicholl <git@benmcnicholl.com>
Signed-off-by: Ben McNicholl <git@benmcnicholl.com>
Signed-off-by: Ben McNicholl <git@benmcnicholl.com>
Signed-off-by: Ben McNicholl <git@benmcnicholl.com>
@mcncl
Copy link
Contributor Author

mcncl commented Jan 17, 2026

Keen on knowing, too, if we already have plans to support the existing pattern;

steps:
  - label: "Alpaca"
    checkout:
      skip: true

If so I'll happily adjust this PR so it doesn't look for a future config state.

@zhming0 zhming0 requested a review from a team January 27, 2026 00:15
Copy link
Contributor

@zhming0 zhming0 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks good to me! 💚

@mcncl mcncl merged commit 8872ea8 into main Jan 28, 2026
2 checks passed
@mcncl mcncl deleted the feat/skip_checkout branch January 28, 2026 00:43
@zhming0 zhming0 mentioned this pull request Jan 28, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants