Add missing scrape annotations to provider pods

[turkenh]

Description of your changes

All crossplane providers expose metrics by default, the ones inherited from controller runtime at minimum. In provider pods, the package manager adds the metrics port already but don't add the Prometheus scrape annotations, which would be convenient for observing providers without additional configuration.

This PR adds the following annotations to all provider pods by default:

"prometheus.io/scrape": "true"
"prometheus.io/port":   "8080"
"prometheus.io/path":   "/metrics"

It is possible to disable this behavior with a DeploymentRuntimeConfig as below:

apiVersion: pkg.crossplane.io/v1beta1
kind: DeploymentRuntimeConfig
metadata:
  name: no-scrape
spec:
  deploymentTemplate:
    spec:
      selector: {}
      template:
        metadata:
          annotations:
            prometheus.io/scrape: "false"

We are already adding these annotations to Crossplane and RBAC manager pods.

I have:

• Read and followed Crossplane's contribution process.
• Run make reviewable to ensure this PR is ready for review.
• Added or updated unit tests.
• Added or updated e2e tests.
• Linked a PR or a docs tracking issue to document this change.
• Added backport release-x.y labels to auto-backport this PR.

Need help with this checklist? See the cheat sheet.

[github-actions]

Backport failed for release-1.14, because it was unable to cherry-pick the commit(s).

Please cherry-pick the changes locally and resolve any conflicts.

git fetch origin release-1.14
git worktree add -d .worktree/backport-5529-to-release-1.14 origin/release-1.14
cd .worktree/backport-5529-to-release-1.14
git switch --create backport-5529-to-release-1.14
git cherry-pick -x 6365d26beb3a68b2e4058ec97626339da7e11346

[github-actions]

Successfully created backport PR for release-1.15:

• [Backport release-1.15] Add missing scrape annotations to provider pods #5530