v0.33.0

v0.33.0 (2025-10-15)

Full Changelog

In this release, we've redesigned the way the agent-stack-k8s interacts with Buildkite's by backend updating it to use the new Stacks API. The user-facing impact to this is that you'll get more feedback in the Buildkite web UI as to what agent-stack-k8s is doing with your jobs, its progress in running them. The stack will also give better feedback in the Buildkite UI when the stack can't run your jobs.

The stacks API is public — if you're interested in designing your own custom scheduler for Buildkite jobs, check out the docs and please let us know how you get on!

Additional updates this version:

Added

• Allow specifying pod templates in job definitions (docs) #722 (@DrJosh9000)
• Add buildkite.com/build-repo and buildkite.com/pipeline-slug annotations #718 (@adnowakodbx1)
• Expose termination grace period as environment variable #719 (@scadu)

Updated

• Update agent to v3.109.1 #709 #710 #724 #747 (@DrJosh9000 + @dependabot[bot])

Changed

• Don't deploy monitoring resources by default #707 (@DrJosh9000)

Fixed

• Set TerminationGracePeriodSeconds correctly, add config #721 (@DrJosh9000)
• Fix an issue where hugepages resource claims wouldn't be parsed correctly #738 #732 (@moskyb)
• Detect command containter using BUILDKITE_COMMAND EnvVar #741 (@zhming0)

v0.32.4

v0.32.4 (2025-10-10)

Full Changelog

Fixed

• Ensure that hugepages resource claims in podSpecPatch are applied correctly #740 (@moskyb)

Images

Helm chart

Image: public.ecr.aws/buildkite/helm/agent-stack-k8s:0.32.4
Image: ghcr.io/buildkite/helm/agent-stack-k8s:0.32.4
Digest: sha256:267e6155aa0d9ec6380aa356ea38553cc0bfb0e28ff061d1921660667c97cc39

Controller

Image: public.ecr.aws/buildkite/agent-stack-k8s/controller:0.32.4
Image: ghcr.io/buildkite/agent-stack-k8s/controller:0.32.4
Digest: sha256:646523e9407c48937e5203c8a8d2ff02d3dca7d18c45208a644e11ec92b524c0

Agent

Image: ghcr.io/buildkite/agent:3.109.0
Digest: sha256:9e6e34f508013e95ba51ceae0be8656afa2108cc04f1aadd05e28a8e0ee6ccc8

v0.32.3

v0.32.3 (2025-10-09)

Full Changelog

Fixed

• Fix an issue where hugepages resource claims in the resource-classes attribute wouldn't be respected #732 (@moskyb)

Changed

• Update buildkite-agent to 3.109.0 #737 (@moskyb)

Images

Helm chart

Image: public.ecr.aws/buildkite/helm/agent-stack-k8s:0.32.3
Image: ghcr.io/buildkite/helm/agent-stack-k8s:0.32.3
Digest: sha256:3f6a19770df3a691f5a83d35ca29cbfde6f2dd9b3264ca4be566586a4074ec61

Controller

Image: public.ecr.aws/buildkite/agent-stack-k8s/controller:0.32.3
Image: ghcr.io/buildkite/agent-stack-k8s/controller:0.32.3
Digest: sha256:6e375ba1f24d5213d6d589a921b5d74460eba6f5bc1dc2faf75166e04b5e9cac

Agent

Image: ghcr.io/buildkite/agent:3.109.0
Digest: sha256:9e6e34f508013e95ba51ceae0be8656afa2108cc04f1aadd05e28a8e0ee6ccc8

v0.32.2

v0.32.2 (2025-10-07)

Full Changelog

Added

• Make DefaultTerminationGracePeriodSeconds configurable #730 (@DrJosh9000)
• Add podTemplate to plugin config #726 (@DrJosh9000)
• Add buildkite.com/build-repo and buildkite.com/pipeline-slug annotations #727 (@DrJosh9000)

Fixed

• Fix log collection grace period on termination #728 (@DrJosh9000)

Update

• chore(deps): Bump github.com/buildkite/agent/v3 from 3.107.2 to 3.108.0 #729 (@DrJosh9000)

Images

Helm chart

Image: public.ecr.aws/buildkite/helm/agent-stack-k8s:0.32.2
Image: ghcr.io/buildkite/helm/agent-stack-k8s:0.32.2
Digest: sha256:159d00a4491601c33942821fda6b5a80a9dea66f96228b9fd6bb39328fc6539e

Controller

Image: public.ecr.aws/buildkite/agent-stack-k8s/controller:0.32.2
Image: ghcr.io/buildkite/agent-stack-k8s/controller:0.32.2
Digest: sha256:fc9ee6262268ca1a8b0577e6ac6e29d929b2833ed910cc9cf3eb0fcfeec89cd0

Agent

Image: ghcr.io/buildkite/agent:3.108.0
Digest: sha256:bebbe8b8b53fd8bdad4efbdb19c10ec96075ecd5d373217c4e6d1ab9963b16a5

v0.32.1

v0.32.1 (2025-09-24)

Full Changelog

Fixed

Monitoring resources (PodMonitor, Grafana dashboard) were deployed by default in 0.32.0. This breaks the deployment if Prometheus Operator CRDs are not already installed. They are no longer deployed by default. To deploy them set the relevant values in values.yaml, or pass the relevant flags to Helm:

helm install (...other options omitted for brevity...) \
  --set monitoring.podMonitor.deploy=true \
  --set monitoring.deployGrafanaDashboard=true

• Don't deploy monitoring resources by default #715 (@DrJosh9000)

A bug preventing local hooks from executing in the command container(s) was fixed in the agent.

• Update agent to v3.107.2 #714 (@DrJosh9000)

Images

Helm chart

Image: public.ecr.aws/buildkite/helm/agent-stack-k8s:0.32.1
Image: ghcr.io/buildkite/helm/agent-stack-k8s:0.32.1
Digest: sha256:0273a2ba9254815cd1d8ca19311b0f9b555551dd0bcbba9b8e19525ce8750994

Controller

Image: public.ecr.aws/buildkite/agent-stack-k8s/controller:0.32.1
Image: ghcr.io/buildkite/agent-stack-k8s/controller:0.32.1
Digest: sha256:4eb2dbe426da4e1a4411600142f2535d03b598738e60df286f2c69e29cfe0e26

Agent

Image: ghcr.io/buildkite/agent:3.107.2
Digest: sha256:2606a2418082bc130951c0f78baf3ed85838820eb80098c2c45f0f324b086918

v0.32.0

v0.32.0 (2025-09-23)

Full Changelog

New

• chore(deps): Bump github.com/buildkite/agent/v3 from 3.103.1 to 3.107.0 #704 (@dependabot[bot])
• Add PodMonitor to deployment #688 (@DrJosh9000)
• Dashboard: Make data source a variable #702 (@DrJosh9000)
• Monitoring tweaks #696 (@DrJosh9000)
• Fix the Grafana dashboard installation #673 (@DrJosh9000)
• Add Grafana dashboard (based on Prometheus metrics) #669 (@DrJosh9000)
• PS-1049 add branch-build annotation to pods #672 (@SorchaAbel)

Internal

• PB-631 part 1: fail job API as part of stacks client #692 (@zhming0)
• PB-681: fix reservation support and pod_watcher ignoring reserved state #695 (@zhming0)
• Register/deregister stacks #687 (@moskyb)
• Deregister endpoint #682 (@moskyb)
• Stacks API client #678 (@moskyb)
• chore(deps): Bump github.com/stretchr/testify from 1.11.0 to 1.11.1 #679 (@dependabot[bot])
• chore(deps): Bump the k8s group with 3 updates #676 (@dependabot[bot])
• chore(deps): Bump github.com/stretchr/testify from 1.10.0 to 1.11.0 #677 (@dependabot[bot])

Images

Helm chart

Image: public.ecr.aws/buildkite/helm/agent-stack-k8s:0.32.0
Image: ghcr.io/buildkite/helm/agent-stack-k8s:0.32.0
Digest: sha256:85d7cc88048d3076c414ce25ae49bf3ff46af4ef434fae43084095bf35d0df7a

Controller

Image: public.ecr.aws/buildkite/agent-stack-k8s/controller:0.32.0
Image: ghcr.io/buildkite/agent-stack-k8s/controller:0.32.0
Digest: sha256:a54f90f0f72ac22f38affad2c291c4bd015053c38e58917abd4bf440915a9dfd

Agent

Image: ghcr.io/buildkite/agent:3.107.0
Digest: sha256:4c5c8b822cf6a5f1135a6998235b78a752b1b86e2520694e8bc648a7a9cd0ec3

v0.31.0

v0.31.0 (2025-08-13)

Full Changelog

Added

• Introduce resource_class #668 (@zhming0)

Fixed

• Fix monitor jobs handled metric #670 (@DrJosh9000)

Internal

• chore(deps): Bump github.com/prometheus/client_golang from 1.22.0 to 1.23.0 #666 (@dependabot[bot])

Images

Helm chart

Image: public.ecr.aws/buildkite/helm/agent-stack-k8s:0.31.0
Image: ghcr.io/buildkite/helm/agent-stack-k8s:0.31.0
Digest: sha256:55b91e388889e684fbd612dbb6b4570db230d1f2b9ae64c524494460b1f12434

Controller

Image: public.ecr.aws/buildkite/agent-stack-k8s/controller:0.31.0
Image: ghcr.io/buildkite/agent-stack-k8s/controller:0.31.0
Digest: sha256:2d48f595f78cb08210c737fd221382224fd64fe45983191a5c039d2ee5a24ffe

Agent

Image: ghcr.io/buildkite/agent:3.103.1
Digest: sha256:3b4336137a9684c896841607aee7084f62f5ccca88ea779666bd388f9ff25bdc

v0.30.2

v0.30.2 (2025-08-07)

Full Changelog

FIXED

• Return token on context cancellation in worker #663 (@JoeColeman95)

Changed

• Upgrade agent to v3.103.1 #667 (@zhming0)
• Update CODEOWNERS #664 (@DrJosh9000)
• chore(deps): Bump sigs.k8s.io/yaml from 1.5.0 to 1.6.0 in the k8s group #661 (@dependabot[bot])
• chore(deps): Bump github.com/jedib0t/go-pretty/v6 from 6.6.7 to 6.6.8 #662 (@dependabot[bot])

Images

Helm chart

Image: public.ecr.aws/buildkite/helm/agent-stack-k8s:0.30.2
Image: ghcr.io/buildkite/helm/agent-stack-k8s:0.30.2
Digest: sha256:6e0fe9f0d8c2acd0b1b240571c21caeb57c87684dc148249ec5999685a7de448

Controller

Image: public.ecr.aws/buildkite/agent-stack-k8s/controller:0.30.2
Image: ghcr.io/buildkite/agent-stack-k8s/controller:0.30.2
Digest: sha256:17395131b4d495a88148427164d5cb16514f9ff2127f76cfab5b1d1cd5d187a3

Agent

Image: ghcr.io/buildkite/agent:3.103.1
Digest: sha256:3b4336137a9684c896841607aee7084f62f5ccca88ea779666bd388f9ff25bdc

v0.28.3

v0.28.3 (2025-08-04)

Full Changelog

Changed

• Return token on context cancellation in worker #665 (@JoeColeman95)

Images

Helm chart

Image: public.ecr.aws/buildkite/helm/agent-stack-k8s:0.28.3
Image: ghcr.io/buildkite/helm/agent-stack-k8s:0.28.3
Digest: sha256:dbf33ba8f4563606d52076c8c0bacc2d9340c859cf680163cb7b4de21b68e77c

Controller

Image: public.ecr.aws/buildkite/agent-stack-k8s/controller:0.28.3
Image: ghcr.io/buildkite/agent-stack-k8s/controller:0.28.3
Digest: sha256:b7a508d17704fbc61034a240efb165d87ed652e648a70706d17dd1c0d5b02378

Agent

Image: ghcr.io/buildkite/agent:3.98.1
Digest: sha256:e57c0c8a003895bfe3bb0a10d15ee892349a3c31b4606ebea17fe92af662fae0

v0.30.1

v0.30.1 (2025-07-29)

Full Changelog

Fixed

• PIPE-1664: job level image attribute take precedence over controller podSpecPatch #659 (@zhming0)

Images

Helm chart

Image: public.ecr.aws/buildkite/helm/agent-stack-k8s:0.30.1
Image: ghcr.io/buildkite/helm/agent-stack-k8s:0.30.1
Digest: sha256:a7c815f3746f7d79d66edd93a914dc69e448577726fdbeec3f30f517e690fae4

Controller

Image: public.ecr.aws/buildkite/agent-stack-k8s/controller:0.30.1
Image: ghcr.io/buildkite/agent-stack-k8s/controller:0.30.1
Digest: sha256:353870aa4273e69bd73c382ce1ad129e7cf9356b7be2d0421a1da7995ba2ca55

Agent

Image: ghcr.io/buildkite/agent:3.103.0
Digest: sha256:79589467fb78221155c79b8f2b687b79b605ef314a3139ec48fcbb0df0370656