Document CSI node ID annotations

[carlory]

Summary

• Documents csi.alpha.kubernetes.io/node-id annotation used on VolumeAttachments for finding node identifiers when CSINode object is unavailable
• Documents csi.volume.kubernetes.io/nodeid deprecated annotation previously used on Nodes

related to kubernetes/kubernetes#135676

🤖 Generated with Claude Code

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign salaxander for approval. For more information see the Code Review Process.

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

Details

Needs approval from an approver in each of these files:

• content/en/docs/OWNERS

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

[carlory]

/cc @lmktfy @jsafrane

[carlory]

/hold
util kubernetes/kubernetes#135676 is merged

[netlify]

✅ Pull request preview available for checking

Built without sensitive environment variables

Name	Link
🔨 Latest commit	da7a70a
🔍 Latest deploy log	https://app.netlify.com/projects/kubernetes-io-main-staging/deploys/69a1045e4c176c0008c8b4e0
😎 Deploy Preview	https://deploy-preview-54035--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 project configuration.

[lmktfy]

It's actually OK to mark both of these deprecated right away, because the paradigm of putting "alpha" or "beta" in the key is deprecated, and any label or annotation using the old way can be marked deprecated on those grounds.

Also we can mark things deprecated even if we don't have a plan to migrate to a different key.

---

The text should briefly explain the situation to readers though; they might wonder what persistent storage to use if non-CSI is deprecated and CSI depends on using a deprecated annotation.

I think this is fine though; various important subparts of Kubernetes were technically in alpha at the 1.0 release and were still alpha come (eg) v1.17, and the world Did Not End.

[carlory]

It's actually OK to mark both of these deprecated right away

@lmktfy we can not deprecated the csi.alpha.kubernetes.io/node-id annotation because the external attacher still uses it.
See kubernetes-csi/external-attacher#83 and https://github.com/kubernetes-csi/external-attacher/blob/master/pkg/controller/csi_handler.go#L755-L784

/cc @jsafrane
for double check.

[carlory]

The text should briefly explain the situation to readers though; they might wonder what persistent storage to use if non-CSI is deprecated and CSI depends on using a deprecated annotation.

updated.

[lmktfy]

It's actually OK to mark both of these deprecated right away

@lmktfy we can not deprecated the csi.alpha.kubernetes.io/node-id annotation because the external attacher still uses it. See kubernetes-csi/external-attacher#83 and https://github.com/kubernetes-csi/external-attacher/blob/master/pkg/controller/csi_handler.go#L755-L784

You really can; you can deprecate ("ask people not to do") a thing even when it still works.

[carlory]

You really can; you can deprecate ("ask people not to do") a thing even when it still works.

Added.

[jsafrane]

/lgtm
from sig-storage perspective. csi.volume.kubernetes.io/nodeid is not used anywhere, I think, but as @lmktfy wrote elsewhere, we should document even the unused ones.

[k8s-ci-robot]

LGTM label has been added.

Details

Git tree hash: 251ee83316a18e4e48e23ee547f07fdbf1a7cc3d

[k8s-ci-robot]

New changes are detected. LGTM label has been removed.

[carlory]

updated: v1.1.0 --> v2.2. See https://github.com/kubernetes-csi/external-attacher/blob/cc32e8cebcb4433b84c26aacc59e200aecd9f5be/CHANGELOG/CHANGELOG-2.2.md?plain=1#L11

/cc @jsafrane