Add workers.celery.annotations field

[Miretpl]

related: #28880

This PR introduces a new workers.celery.annotations section and deprecates the old workers.annotations section (as it was only applicable to Celery workers).

---

Was generative AI tooling used to co-author this PR?

• Yes (please specify the tool below)

---

• Read the Pull Request Guidelines for more information. Note: commit author/co-author name and email in commits become permanently public when merged.
• For fundamental code changes, an Airflow Improvement Proposal (AIP) is needed.
• When adding dependency, check compliance with the ASF 3rd Party License Policy.
• For significant user-facing changes create newsfragment: {pr_number}.significant.rst, in airflow-core/newsfragments. You can add this file in a follow-up commit after the PR is created so you know the PR number.

[Copilot]

Pull request overview

Introduces a new Helm values field workers.celery.annotations for Celery worker Deployment/StatefulSet annotations and deprecates the legacy workers.annotations field, aligning worker configuration with the existing workers.celery.* structure.

Changes:

• Add workers.celery.annotations to values.yaml and values.schema.json, and mark workers.annotations as deprecated.
• Add a Helm NOTES deprecation warning when workers.annotations is used.
• Update Helm chart tests to validate annotation precedence/overrides across workers.annotations, workers.celery.annotations, and worker sets.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
helm-tests/tests/helm_tests/airflow_core/test_worker.py	Updates annotation test coverage for new workers.celery.annotations path and precedence.
helm-tests/tests/helm_tests/airflow_core/test_worker_sets.py	Extends worker-set annotation overwrite tests to include workers.celery.annotations.
chart/values.yaml	Documents deprecation of workers.annotations and adds workers.celery.annotations.
chart/values.schema.json	Updates schema docs for deprecated field and adds schema entry for workers.celery.annotations.
chart/templates/NOTES.txt	Adds a deprecation warning for workers.annotations.
chart/newsfragments/64982.significant.rst	Adds release-note entry for the deprecation/rename.

[Miretpl]

One thing I think is still missing is a test around the deprecation warning in NOTES.txt.

I was thinking about adding something like that in the future, as it would require implementing custom rendering logic (helm template command, which we are using in the unit tests, is not rendering NOTES.txt file), or moving that test to the integration tests (which, because of its slow nature, I would say, is out of scope).

The chart tests cover the rendered annotation behavior, but this warning is part of the upgrade path too. It would be good to have one Helm test that checks the warning appears when workers.annotations is set, so that message does not quietly disappear later.

Also, when I have a little more time (probably soon, as the whole move from workers to workers.celery/workers.kubernetes is almost finished), I plan to start preparing some migration doc, which should make the future migration from 1.x to 2.x easier.

[github-actions]

Backport successfully created: chart/v1-2x-test

Note: As of Merging PRs targeted for Airflow 3.X
the committer who merges the PR is responsible for backporting the PRs that are bug fixes (generally speaking) to the maintenance branches.

In matter of doubt please ask in #release-management Slack channel.

Status	Branch	Result
✅	chart/v1-2x-test