[KEP-4006] Docs for Transitioning from SPDY to WebSockets (Beta)

[seans3]

• Updates control plane feature flag: TranslateStreamCloseWebsocketRequests to Beta
• Adds new control plane feature flag: PortForwardWebsockets as Alpha
• Adds new kubectl feature flag: KUBECTL_PORT_FORWARD_WEBSOCKETS

kubernetes/enhancements#4006

[netlify]

✅ Pull request preview available for checking

Built without sensitive environment variables

Name	Link
🔨 Latest commit	2c8bbd2
🔍 Latest deploy log	https://app.netlify.com/sites/kubernetes-io-main-staging/deploys/65d6dc1a4c4469000878b6e6
😎 Deploy Preview	https://deploy-preview-45270--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.

[seans3]

/cc @fsmunoz

[dipesh-rawat]

@seans3 We should consider setting the dev-1.30 branch as the target branch rather than the main branch for this pull request. Since the change is related to the feature in v1.30.

[seans3]

Sean Sullivan We should consider setting the dev-1.30 branch as the target branch rather than the main branch for this pull request. Since the change is related to the feature in v1.30.

@dipesh-rawat

Fixed. Please let me know if this does it. Thanks.

[fsmunoz]

Thank you @seans3, looks good, I've updated the tracking sheet.

[katcosgrove]

Hey @seans3! Just a reminder that this needs to be reviewed and ready to merge by Docs Freeze on March 26, including a technical review. An exception request will be required if you cannot meet that deadline. Thank you!

cc: @aojea @soltysh @deads2k @liggitt

[aojea]

/lgtm

[k8s-ci-robot]

LGTM label has been added.

Git tree hash: f56d8fd401b9c8ad4031fea77a7187d0d732126d

[drewhagen]

@kubernetes/sig-docs-en-reviews Can we get a review of the content from docs on this one? The deadline is March 26th 2024 18:00 PT to get this into the release. Thanks!

[sftim]

/lgtm

[sftim]

How about:

Suggested change

	<td></td><td style="line-height: 130%; word-wrap: break-word;">When set to true, the kubectl port-forward command will attempt to stream using the websockets protocol. If the upgrade to websockets fails, the commands will fallback to use the current SPDY protocol.
	<td></td><td style="line-height: 130%; word-wrap: break-word;">When set to true, the <tt>kubectl port-forward</tt> command attempts to stream using a <a href="https://www.w3.org/TR/websockets/">WebSocket</a>. If the upgrade to using a WebSocket fails, the kubectl tool falls back to using the <a href="https://www.chromium.org/spdy/">SPDY</a> protocol.

The suggested text avoids implying that SPDY is “current”. However, if this is different from the text already in k/k code, we should use that text from upstream as-is.

(it'd be great to get good docs into kubectl itself, where relevant)

[sftim]

/approve

[k8s-ci-robot]

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: sftim

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 [sftim]

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

[drewhagen]

/milestone 1.30