feat: support annotations on Deployment/StatefulSet in Helm chart

[wyattwalter]

Summary

• Adds a new top-level annotations value in the Helm chart that gets applied to the Deployment/StatefulSet metadata
• Also wires up the existing commonAnnotations value to the Deployment/StatefulSet, which was previously missing from this resource
• Enables use cases like Stakater Reloader (reloader.stakater.com/auto: "true") and other annotations that need to live on the workload resource

Example usage

annotations:
  reloader.stakater.com/auto: "true"

Test plan

• Deploy chart with annotations set and verify annotations appear on the StatefulSet metadata
• Deploy chart with workload.kind: Deployment and verify annotations appear on the Deployment metadata
• Deploy chart with commonAnnotations set and verify they also appear on the Deployment/StatefulSet
• Deploy chart with both annotations and commonAnnotations to verify they merge correctly
• Deploy chart with neither set and verify no annotations block is rendered

🤖 Generated with Claude Code

Summary by CodeRabbit

• New Features

  • Added support for custom deployment annotations via a new annotations setting
  • Added support for custom pod-level annotations via a new podAnnotations setting
  • Annotations are now conditionally rendered and merged from common and resource-specific sources

• Tests

  • Added tests covering annotation presence, merging, and propagation for Deployments and StatefulSets

• Chores

  • Chart version bumped to 3.6.9

Warning

Tests have not run on the HEAD a877940 yet

---

Wed, 11 Feb 2026 20:46:53 UTC

[coderabbitai]

Walkthrough

Adds conditional annotations rendering to the Helm deployment template, introduces top-level annotations and podAnnotations keys in values.yaml, bumps the chart version, and adds Helm tests validating annotation presence and merging for Deployment and StatefulSet resources.

Changes

Cohort / File(s)	Summary
Helm template deploy/helm/templates/deployment.yaml	Introduces a conditional metadata.annotations block that renders .Values.annotations and .Values.commonAnnotations via tplvalues.render when provided.
Values & Chart deploy/helm/values.yaml, deploy/helm/Chart.yaml	Adds top-level annotations and podAnnotations keys to values; bumps chart version from 3.6.8 to 3.6.9.
Tests deploy/helm/tests/annotations_test.yaml	New Helm tests covering absence, single-source, and merged annotations across StatefulSet and Deployment manifests; assertions check kind and metadata.annotations subsets.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Poem

A tiny key in YAML's seam,
Whispers metadata into the stream.
Charts inch forward, tests applaud,
Annotations hum — the cluster's awed. ✨

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly and specifically describes the main change: adding support for annotations on Deployment/StatefulSet resources in the Helm chart.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description check	✅ Passed	The PR description adequately covers the feature summary, use cases, and includes a test plan with checkboxes, though some test items are unchecked.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing touches

• 📝 Generate docstrings

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch claude/sharp-shirley

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[sebastianiv21]

LGTM