Preserve external controller annotations for deployment and daemonSet

[salonichf5]

Proposed changes

Write a clear and concise description that helps reviewers understand the purpose and impact of your changes. Use the
following format:

Problem: Users want that deployments and daemonSet preserve external annotations like how we do for services

Solution: Adds a solution to track internal annotations and preserver external annotations.

Testing: I verified the behavior by manually adding an annotation to both to deployment and waiting if controller overwrites it and watching the generation

kubectl annotate deploy gateway-nginx \
  field.cattle.io/publicEndpoints='[{"addresses":["x"],"port":80}]' --overwrite
deployment.apps/gateway-nginx annotated


 kubectl describe deploy gateway-nginx | sed -n '/Annotations:/,/Selector:/p'

Annotations:            deployment.kubernetes.io/revision: 1
                        field.cattle.io/publicEndpoints: [{"addresses":["x"],"port":80}]
Selector:               app.kubernetes.io/instance=nginx-gateway,app.kubernetes.io/managed-by=nginx-gateway-nginx,app.kubernetes.io/name=gateway-nginx,gateway.networking.k8s.io/gateway-name=gateway
  Annotations:      prometheus.io/port: 9113
                    prometheus.io/scrape: true

kubectl get deploy gateway-nginx -o jsonpath="{.metadata.generation}  {.metadata.resourceVersion}  {.metadata.annotations.field\.cattle\.io/publicEndpoints}{\"\n\"}" --watch
2  2046  [{"addresses":["x"],"port":80}]

Daemonset

 kubectl annotate daemonsets.apps gateway-nginx \ 
  field.cattle.io/publicEndpoints='[{"addresses":["x"],"port":80}]' --overwrite
daemonset.apps/gateway-nginx annotated

kubectl describe daemonsets.apps gateway-nginx | sed -n '/Annotations:/,/Selector:/p' 
Annotations:    deprecated.daemonset.template.generation: 1
                field.cattle.io/publicEndpoints: [{"addresses":["x"],"port":80}]
Desired Number of Nodes Scheduled: 1
Current Number of Nodes Scheduled: 1

controller  Created pod: gateway-nginx-gdvd7
sa.choudhary@N9939CQ4P0 nginx-gateway-fabric % kubectl get daemonsets.apps gateway-nginx -o jsonpath="{.metadata.generation}  {.metadata.resourceVersion}  {.metadata.annotations.field\.cattle\.io/publicEndpoints}{\"\n\"}" --watch 
1  26427  [{"addresses":["x"],"port":80}]

Please focus on (optional): If you any specific areas where you would like reviewers to focus their attention or provide
specific feedback, add them here.

Closes #4447

Checklist

Before creating a PR, run through this checklist and mark each as complete.

• I have read the CONTRIBUTING doc
• I have added tests that prove my fix is effective or that my feature works
• I have checked that all unit tests pass after adding my changes
• I have updated necessary documentation
• I have rebased my branch onto main
• I will ensure my PR is targeting the main branch and pulling from my branch from my own fork

Release notes

If this PR introduces a change that affects users and needs to be mentioned in the release notes,
please add a brief note that summarizes the change.

Fixes a bug to preserve external controller annotations for Deployment and DaemonSets to avoid constant updates. 

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 86.20%. Comparing base (3424d94) to head (a26f7d6).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #4468      +/-   ##
==========================================
- Coverage   86.23%   86.20%   -0.04%     
==========================================
  Files         132      132              
  Lines       14557    14560       +3     
  Branches       35       35              
==========================================
- Hits        12553    12551       -2     
- Misses       1792     1794       +2     
- Partials      212      215       +3     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[sjberman]

At this point, we could cherrypick this into 2.3 since we haven't released yet.

[bjee19]

nice job