Repository navigation
Releases
v0.8.2
For the full migration guide see MIGRATION.md.
Highlights
- Security fix: The kubelet client CSR approver now binds approval to an authenticated requester and a Karpenter-managed NodeClaim, requires matching node and GCE instance identity for renewal, limits bootstrap approval to launched and unregistered claims, and removes unnecessary CSR permissions. This closes the unrestricted approval path; it does not eliminate the shared GKE bootstrap registration race. See GHSA-54c4-fghw-84cc for scope and residual risk.
- GHCR and OCI distribution: release images and charts now use
ghcr.io/karpenter-gcp/karpenter-provider-gcpand itscharts/karpenterandcharts/karpenter-crdOCI repositories. Update any pinned image or chart references; see the migration guide. - v0.8.1 was not released: the v0.8.1 tag and controller image exist, and the
karpenterchart was partially published, butkarpenter-crdwas not. Do not use v0.8.1; v0.8.2 is the complete release with the image and both charts.
What's Changed
Bug Fixes
- fix(csr): harden kubelet client CSR authorization by @dm3ch in #785
- fix: add Dependabot cooldowns for zizmor by @dm3ch in #761
Documentation
- docs: verify release artifacts before GitHub release creation by @dm3ch in #757
- docs: add ZAST.AI to ADOPTERS.md by @rainsun in #759
- docs: document maintainers, governance, and security reporting by @dm3ch in #753
- docs: link production adopters from README by @jwcesign in #771
Maintenance
- ci: run CodeQL for release pull requests by @dm3ch in #784
- ci: consolidate workflows and rebuild security scanning by @dm3ch in #754
Full Changelog: v0.8.0...v0.8.2
v0.8.0
For the full migration guide see MIGRATION.md.
Release highlights
- Release artifacts are now signed. Controller images use keyless Cosign signatures; both Helm charts (
karpenterandkarpenter-crd) include OpenPGP provenance signatures. The image and both charts also have GitHub build-provenance attestations. See Verify release artifacts to verify them before installation. Signatures and attestations for this release were checked against the release tag and workflow; they do not establish absence of vulnerabilities. - Karpenter core upgraded to v1.15.0. Review the migration guide for node-repair behavior, disruption metrics, and CRD/RBAC upgrade considerations.
What's Changed
New Features
- Add Terraform-managed persistent e2e environment by @dm3ch in #656
- feat: support resource manager tags on GCENodeClass by @taltsafrirpx in #670
- feat: add bare-metal instance selection by @joemiller in #672
- feat: add z4d support by @joemiller in #674
- chore: migrate to karpenter-core v1.15.0 by @dm3ch in #677
- feat: sign images and Helm charts and attest builds by @dm3ch in #691
- feat: support GPU time-sharing via GCENodeClass gpuSharingConfig by @taltsafrirpx in #700
- feat: add nodepool, nodeclass and cluster info to node disk labels by @afrancis101 in #703
- feat: add threadsPerCore to GCENodeClass by @djeebus in #718
- feat(instance): back off instance types that hit GCE quota by @taltsafrirpx in #721
- feat: add GKE-compatible minCpuPlatform and gVNIC configuration by @djeebus (original implementation) and @dm3ch (integration) in #727
- feat: add failSwapOn and memorySwap to kubeletConfiguration by @djeebus in #728
- feat: add deviceName to GCENodeClass data disks by @djeebus in #736
- feat: make telemetry opt-in via TELEMETRY by @djeebus in #743
- feat: make launch failure backoffs configurable by @djeebus (original implementation) and @dm3ch (integration) in #744
- feat: configure node shutdown with deterministic defaults by @djeebus (original implementation) and @dm3ch (integration) in #746
- feat: add GKE-style boot-disk swap by @djeebus (original implementation) and @dm3ch (integration) in #752
Bug Fixes
- fix(e2e): validate published release image alignment by @dm3ch in #669
- fix: remove unsupported PD capabilities from C4A and N4 by @joemiller in #676
- fix(chart): avoid managed NPD ports for Spot detector by @dm3ch in #684
- fix: derive GPU count from accelerator quantities by @dm3ch in #685
- fix: set target pod network labels for multi-networking by @dm3ch in #689
- fix: fail startup when default service account lookup fails by @dm3ch in #692
- fix: avoid GitHub schema downloads during CRD validation by @dm3ch in #695
- fix: configure dual-stack networking for GKE nodes by @jwcesign in #701
- fix(interruption): skip nodes without matching NodeClaims by @dm3ch in #705
- fix: preserve usable COS images during staggered rollouts by @dm3ch in #706
- fix(imagefamily): allow Ubuntu version pins with a release letter by @ryan-macdonald-nb in #715
- fix(instance): fall back to on-demand within Create after a spot stockout by @ryan-macdonald-nb in #716
- fix: size the image streaming cache for the launched machine type by @djeebus in #734
- fix(deps): resolve dependency security scanning alerts by @dm3ch in #740
Documentation
- docs: align pod range examples and troubleshooting with subnetRangeNames by @promptless-for-oss in #668
- docs: add binarly to ADOPTERS.md by @guitmz in #671
- docs: document Z4D local SSD support by @promptless-for-oss in #675
- docs: note custom role update needed for resourceManagerTags by @promptless-for-oss in #678
- feat: add cortea to adopters by @tbCortea in #680
- docs: note deploy/terraform Dataplane V2, system pool and release channel changes by @promptless-for-oss in #687
- docs: Add joemiller as approver and reviewer by @joemiller in #688
- docs: document startup default service account lookup by @promptless-for-oss in #693
- docs: Document GPU count semantics for instance-gpu-count by @promptless-for-oss in #696
- docs: document dual-stack GKE node networking by @promptless-for-oss in #702
- docs: migration note for Karpenter ownership labels on persistent disks by @promptless-for-oss in #704
- docs: describe Spot to on-demand fallback within a launch after a stockout by @promptless-for-oss in #717
- docs: note threadsPerCore halves the podsPerCore pod cap by @promptless-for-oss in #725
- docs: document GCE quota backoff in migration guide and troubleshooting by @promptless-for-oss (original documentation) and @dm3ch (integration) in #726
- Original contribution: #722.
- docs: list swap among settings not inherited from the bootstrap pool by @promptless-for-oss in #733
- docs: note image streaming cache sizing in bootstrap pool metadata sources by @promptless-for-oss in #735
- docs: point insufficient capacity troubleshooting to configurable backoffs by @promptless-for-oss in #742
- docs: add E2B to adopters by @djeebus in #748
- docs: note shutdown grace periods are not inherited from the bootstrap pool by @promptless-for-oss in #749
- docs: add post-release signature check to RELEASE.md by @promptless-for-oss in #751
Maintenance
- chore(pricing): scheduled pricing data refresh by @github-actions in #679
- chore(pricing): scheduled pricing data refresh by @github-actions in #698
- chore(pricing): scheduled pricing data refresh by @github-actions in #714
- chore(pricing): scheduled pricing data refresh by @github-actions in #720
- chore: check GCENodeClass ergonomics against GKE in Greptile by @dm3ch in #729
- chore(security): add CVE checks and Go/base-image updates by @dm3ch in #730
- ci: reuse upstream Go caching on main by @jwcesign in #737
- chore(ci): lock actions, harden automation, and scan images with Grype by @dm3ch in #739
- chore(pricing): scheduled pricing data refresh by @github-actions in #747
- chore(security): bump Go to 1.27.4 by @djeebus in #7...
v0.7.0
For the full migration guide see MIGRATION.md.
Highlights
- Multiple GKE pod CIDR ranges, free-IP capacity reporting, and range-aware allocation (#573).
- GCE local SSD provisioning (#628), static hugepages (#645), and nested virtualization (#654).
- NodeClass labels on newly provisioned persistent disks (#661) and improved custom machine-type discovery (#601).
- Kubernetes compatibility ceiling raised to 1.36 (#667).
- Spot VM early preemption support via optional NPD component (disabled by default) #563
Before upgrading: update the controller IAM role and review the pod-range default behavior and local-SSD migration steps in the migration guide.
What's Changed
New Features
- Support kubelet serializeImagePulls/maxParallelImagePulls on GCENodeClass by @ryan-macdonald-nb in #554
- test(interruption): cover Spot preemption condition by @dm3ch in #627
- Add PR size labeling workflow by @dm3ch in #629
- Add bounded local e2e runner and reports by @dm3ch in #642
Bug Fixes
- fix: Select non-stale node pool templates when provisioning nodes by @sthomson-wyn in #578
- docs: recommend default disk selection by @dm3ch in #614
- fix(instance): handle unsupported machine types by @dm3ch in #622
- fix: grant CapacityBuffer controller RBAC by @dm3ch in #631
- fix: avoid selecting GCE images before they are ready by @dm3ch in #639
- fix(imagefamily): avoid filtered image catalog quota by @dm3ch in #644
Documentation
- Correct CapacityBuffer CRD installation guidance in settings reference by @promptless-for-oss in #559
- Document kubelet serializeImagePulls/maxParallelImagePulls on GCENodeClass by @promptless-for-oss in #555
- docs: align e2e proposal delivery order by @dm3ch in #625
Maintenance
- chore(pricing): scheduled pricing data refresh by @github-actions[bot] in #575
- chore(pricing): scheduled pricing data refresh by @github-actions[bot] in #582
- chore: check proposal number uniqueness by @dm3ch in #617
- chore: review E2E coverage opportunities by @dm3ch in #618
- test: exclude local SSD from standard e2e selection by @dm3ch in #657
New Contributors
- @ryan-macdonald-nb made their first contribution in #554
- @afrancis101 made their first contribution in #606
- @mdlayher made their first contribution in #643
- @dominicbinarly made their first contribution in #654
- @geekette86 made their first contribution in #601
- @guyeisenbach made their first contribution in #573
Full Changelog: v0.6.1...v0.7.0
v0.6.1
Fixes
- #604 — Addresses controller memory growth and OOMKills caused by duplicate regional machine-type entries.
- #620 — Prevents permanent
MACHINE_TYPE_UNSUPPORTEDerrors from repeatedly retrying and stranding pending Pods.
For the full migration guide see MIGRATION.md.
Full Changelog: v0.6.0...v0.6.1
v0.6.0
For the full migration guide see MIGRATION.md
What's Changed
Documentation
- docs: clarify empty-node disruption behavior by @dm3ch in #509
- Document Ubuntu per-architecture image resolution and arm64 discovery by @promptless-for-oss in #537
- docs: Document Balanced consolidation policy and CapacityBuffer feature gate (karpenter core v1.14) by @promptless-for-oss in #525
Maintenance
- chore(pricing): scheduled pricing data refresh by @github-actions[bot] in #543
- Remove unsupported instance labels by @dm3ch in #527
- chore: modernize Go code per gopls modernize analyzer by @hakman in #541
New Contributors
- @hakman made their first contribution in #541
- @gregswift made their first contribution in #536
Full Changelog: v0.5.0...v0.6.0
v0.5.0
For the full migration guide see MIGRATION.md.
What's Changed
Breaking Changes
New Features
- feat(helm): add pod and container security contexts with secure defaults by @guitmz in #464
- feat(chart): support PDB maxUnavailable by @kellen-miller in #477
- feat(proposal): local-ssd by @joemiller in #387
Bug Fixes
- Fix bootstrap label and taint inheritance by @dm3ch in #436
- fix: honor configured GKE cluster locations by @dm3ch in #439
- fix: reuse kube-env zone regex by @dm3ch in #445
- fix: restore GKE readiness labels by @dm3ch in #448
- Split instance type cache from offerings by @dm3ch in #463
- fix(metadata): inherit GKE readiness labels from the source template by @sleterrier in #485
- fix(disruption): use upstream empty-node handling by @dm3ch in #492
- fix: avoid duplicate GKE kube-proxy on Karpenter nodes by @dm3ch in #481
Documentation
- docs: fix ECR public release verification by @dm3ch in #432
- docs: define provider package boundaries by @dm3ch in #443
- Document Helm pod and container security contexts by @promptless-for-oss in #465
- Expand Dynamic Resource Allocation (DRA) settings guidance by @promptless-for-oss in #469
- docs(readme): add Sponsors section crediting PlanetScale testing infra by @joemiller in #471
- Document controller PodDisruptionBudget Helm values (minAvailable/maxUnavailable) by @promptless-for-oss in #478
- Add on-demand e2e CI proposal by @dm3ch in #495
- doc: remove unnecessary files by @jwcesign in #498
- docs: add ADOPTERS.md with BEAT81 as first adopter by @cacarico in #499
- doc: add cloudpilot ai adopters by @jwcesign in #503
Maintenance
- chore: fix presubmit formatter drift by @dm3ch in #441
- chore(pricing): scheduled pricing data refresh by @github-actions[bot] in #434
- chore: tighten dead-code linting by @dm3ch in #442
- chore(pricing): scheduled pricing data refresh by @github-actions[bot] in #472
- Refactor metadata assembly by @dm3ch in #430
New Contributors
- @guitmz made their first contribution in #464
- @francis-jjk made their first contribution in #480
- @kellen-miller made their first contribution in #477
Full Changelog: v0.4.1...v0.5.0
v0.4.1
For the full migration guide see MIGRATION.md.
Bug Fixes
- Fixed bootstrap label and taint inheritance from GKE template node pools.
- Karpenter-created nodes no longer inherit source GKE node pool identity labels and taints.
- Karpenter now rebuilds kubelet labels and register-with-taints from the target NodeClaim/NodePool metadata.
- Fixed zone selection for configured GKE cluster locations.
- Zonal and multi-zonal clusters now honor the cluster's configured locations instead of scheduling across all zones in the region.
- Restored GKE readiness labels required by GKE-managed DaemonSets.
- Restores labels used by kube-proxy and NVIDIA GPU device plugin selection.
- Fixes GPU node initialization where
nvidia.com/gpucould fail to register.
Full Changelog: v0.4.0...v0.4.1
v0.4.0
For the full migration guide see MIGRATION.md.
What's Changed
Breaking Changes
- fix(networking): inject cluster-id-bearing GCE tag so GKE auto-firewall rules cover karpenter nodes by @sleterrier in #314
- feat(gpu): add autoGPUTaint field to GCENodeClass by @dm3ch in #290
- feat(api): make imageSelectorTerms alias version pinning production-ready by @dm3ch in #327
- feat(gpu): add gpuDriverVersion field and gke-accelerator label injection by @dm3ch in #320
- feat(imagefamily): implement GKE release channel awareness by @dm3ch in #342
New Features
- feat(chart): add ServiceMonitor for Prometheus Operator scraping by @sleterrier in #317
- feat(instance): derive scheduling and SA from capacity type and GCENodeClass, not NodePool template by @dm3ch in #283
- feat: replace karpenter-managed bootstrap pools with pool discovery by @dm3ch in #263
- feat(iam): replace broad roles with minimal custom IAM role by @dm3ch in #358
- Add Confidential VM to index page feature lists by @promptless-for-oss in #422
- feat: set GKE disk type labels on Karpenter nodes by @dm3ch in #404
Bug Fixes
- fix(cloudprovider): handle empty providerID in Delete by @sleterrier in #335
- fix: replace deprecated swag.String/StringValue with lo.ToPtr/FromPtr by @dm3ch in #344
- fix(ci): add --devel to helm search/pull to preserve pre-release chart versions by @dm3ch in #339
- fix(helm): allow global key in values schema for subchart usage by @cacarico in #359
- fix(iam): drop non-existent container.clusters.getServerConfig permission by @dm3ch in #403
- fix(metadata): override base-template metadata instead of concatenating by @sleterrier in #394
- fix(kubeletConfiguration): honour systemReserved, kubeReserved, eviction* and other fields by @dm3ch in #400
- fix: reject empty eviction thresholds by @jwcesign in #410
- Fix GCENodeClass CRD CEL validation by @dm3ch in #411
Documentation
- docs: Document ServiceMonitor for Prometheus Operator integration by @promptless-for-oss in #318
- docs: Initial documentation improvements from Promptless by @promptless-for-oss in #302
- docs: Document subnetRangeName field by @promptless-for-oss in #305
- chore: document release process and automate release notes by @dm3ch in #311
- docs: Add DEFAULT_NODEPOOL_SERVICE_ACCOUNT to settings reference by @promptless-for-oss in #326
- Update PR template to remove user-facing change question by @dm3ch in #328
- docs: introduce proposal template and contributor process by @dm3ch in #333
- docs: Fix CONTRIBUTING.md heading hierarchy by @promptless-for-oss in #353
- docs: Document bootstrap pool discovery feature by @promptless-for-oss in #329
- Fix incorrect failure threshold references in bootstrap-pool.md by @promptless-for-oss in #363
- docs: Enhance troubleshooting with ImageResolutionFailed condition by @promptless-for-oss in #376
- docs: Document gpuDriverVersion field and automatic GPU label injection by @promptless-for-oss in #381
- docs(api): expand ShieldedInstanceConfig field comment by @sleterrier in #392
- doc: update readme by @jwcesign in #405
- doc: Add the content that was accidentally deleted by @jwcesign in #406
- Expand kubeletConfiguration documentation by @promptless-for-oss in #409
Maintenance
- chore(lint): add deadcode linter and remove unreachable functions by @dm3ch in #340
- chore(pricing): scheduled pricing data refresh by @github-actions[bot] in #357
- chore(pricing): scheduled pricing data refresh by @github-actions[bot] in #362
- chore: migrate dev toolchain to go.mod, drop golangci-lint-action args by @dm3ch in #341
- ci: add explicit CodeQL workflow covering fork PRs and scheduled scans by @dm3ch in #356
- chore(pricing): scheduled pricing data refresh by @github-actions[bot] in #386
- chore(ci): pin third-party GitHub Actions to commit SHAs by @dm3ch in #401
- chore(pricing): scheduled pricing data refresh by @github-actions[bot] in #396
- test(e2e): make Karpenter namespace and deployment name configurable by @sleterrier in #407
New Contributors
- @promptless-for-oss made their first contribution in #318
- @github-actions[bot] made their first contribution in #357
Full Changelog: v0.3.0...v0.4.0
v0.3.3
v0.3.2
For the full migration guide see MIGRATION.md.
Bug Fixes
- fix(networking): inject cluster-id-bearing GCE tag so GKE auto-firewall rules cover Karpenter nodes (#316) @sleterrier
What's Changed
Full Changelog: v0.3.0...v0.3.2