Move AWS Service annotation details to reference page

[sftim]

https://kubernetes.io/docs/concepts/services-networking/service/ has a bunch of specific details for one cloud provider, AWS.

These belong elsewhere; there are already good homes at https://cloud-provider-aws.sigs.k8s.io/service_controller/ and https://kubernetes-sigs.github.io/aws-load-balancer-controller/latest/, so we can omit them from the Service page.

I updated https://kubernetes.io/docs/reference/labels-annotations-taints/ to list all the AWS annotations for Services, and I marked all of those as deprecated because they include .beta. in the subdomain part of the label key (which is a generally deprecated practice).

Preview of the revised Service page.

Open question, though: should we link from https://kubernetes.io/docs/concepts/services-networking/service/ to https://cloud-provider-aws.sigs.k8s.io/service_controller/ and to https://kubernetes-sigs.github.io/aws-load-balancer-controller/latest/?

• If we do, does it make sense also to link to https://cloud-provider-azure.sigs.k8s.io/topics/loadbalancer/
  • and to list the deprecated annotations for Azure LB in https://kubernetes.io/docs/reference/labels-annotations-taints/?
• We can do that. It shouldn't be part of this PR though, whatever we decide.

marking as Draft because of the open question

[netlify]

✅ Pull request preview available for checking

Built without sensitive environment variables

Name	Link
🔨 Latest commit	5a98033
🔍 Latest deploy log	https://app.netlify.com/sites/kubernetes-io-main-staging/deploys/6499f7a9826842000867c266
😎 Deploy Preview	https://deploy-preview-38551--kubernetes-io-main-staging.netlify.app
📱 Preview on mobile	Toggle QR Code... Use your smartphone camera to open QR code link.

---

To edit notification comments on pull requests, go to your Netlify site configuration.

[tengqm]

This is NICE.
/lgtm
I'm not sure the beta in the annotations means that they are deprecated though.

[k8s-ci-robot]

LGTM label has been added.

Git tree hash: f037617245669dd1c40ddd33483da17a3ae40c36

[sftim]

I understood that all annotations with alpha or beta in their name were deprecated and that SIGs should look to move away.

Since I opened this PR, I found https://cloud-provider-aws.sigs.k8s.io/service_controller/ and also https://cloud-provider-azure.sigs.k8s.io/topics/loadbalancer/

1. We can hyperlink to these
2. I can file enhancement issues against the AWS and Azure cloud provider code to recommend using a non-beta annotation, ideally one that doesn't use a kubernetes.io domain.

[tengqm]

My take is that most of the providers of those APIs are cautious about the "maturity level" of their technologies.
"Alpha", "Beta" are an indication of technology maturity. An "Alpha" version of something may be widely used, and a "Beta" release might be deprecated a long time ago. Similarly, a "v1" release might become EOL several years ago.
I cannot tell if a "Beta" thing is deprecated or not. If it is deprecated, we must already have a more mature thing as a replacement. That's the reason I think we may need double confirm at this.

[sftim]

I'll ask SIG Architecture how we should mark 'em.
Also, I'll hyperlink to the provider docs.

The thing that makes them deprecated isn't the beta status, it's putting the status in the annotation key. The modern way is to use the same key, without an alpha or beta substring, all the way to GA.

[sftim]

Ok, I think this is ready for review.

[sftim]

I just went with marking all but one actually-deprecated annotation as beta.

[sftim]

Changes since last LGTM

[sftim]

All changes since #38551 (comment) are just rebases.

[tengqm]

/approve

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: tengqm

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Needs approval from an approver in each of these files:

• content/en/OWNERS [tengqm]

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

[windsonsea]

wow, half a year passed.
/lgtm

[k8s-ci-robot]

LGTM label has been added.

Git tree hash: c548d94c05dbb2cc1c90d4996bb32e7468aa2602