Transition from SPDY to WebSockets

[seans3]

Enhancement Description

• One-line enhancement description (can be used as a release note): Transition the bi-directional streaming protocol of Kubernetes clients from SPDY/3.1 to WebSockets.

• Kubernetes Enhancement Proposal: https://github.com/kubernetes/enhancements/tree/master/keps/sig-api-machinery/4006-transition-spdy-to-websockets

• Discussion Link:

  • SIG API Machinery Video
  • SIG API Machinery Notes

• Primary contact (assignee): @seans3

• Responsible SIGs: SIG API Machinery, SIG CLI

• Enhancement target (which target equals to which milestone):

  • Alpha release target (x.y): 1.29
  • Beta release target (x.y): 1.31
  • Stable release target (x.y): 1.37

• Alpha

  • KEP (k/enhancements) update PR(s):
    • KEP-4006: Initial iteration of provisional WebSockets KEP #4016
    • Update WebSocket KEP (4006) to reflect latest understanding #4169
  • Code (k/k) update PR(s):
    • WebSocket Client and V5 RemoteCommand Subprotocol kubernetes#119157
    • Stream Translator Proxy and FallbackExecutor for WebSockets kubernetes#119186
    • PortForward: Tunnel SPDY through WebSockets kubernetes#123413
  • Docs (k/website) update PR(s):
    • Document Kubernetes' use of WebSockets (replacement for SPDY / KEP 4006) website#43620

• Beta

  • KEP (k/enhancements) update PR(s):
    • KEP-4006: RemoteCommand as Beta, and initial PortForward over WebSockets as Alpha #4416
    • KEP-4006: PortForward Websockets graduates to Beta #4666
    • KEP-4006: Synthetic RBAC create check for WebSocket request upgrade -- 1.35 #5524
    • KEP-4006: Extend WebSockets to Kubelet - v1.36 #5792
  • Code (k/k) update PR(s):
    • RemoteCommand over WebSockets to Beta kubernetes#123281
    • PortForward over Websockets Graduates to Beta kubernetes#125528
    • Implements synthetic create authz permission check for exec, attach, and portforward kubernetes#134577
  • Docs (k/website) update(s):
    • [KEP-4006] Docs for Transitioning from SPDY to WebSockets (Beta) website#45270
    • [KEP-4006] - Docs for PortForward over WebSockets Feature Gates (Beta) website#46955

• Stable

  • KEP (k/enhancements) update PR(s):
  • Code (k/k) update PR(s):
    • Implements missing HTTPS proxy functionality gorilla/websocket#978
    • Deflake proxy unit tests gorilla/websocket#982
    • Update gorilla/websockets library from 1.5.0 to latest 1.5.3 kubernetes#130249
  • Docs (k/website) update(s):

Please keep this description up to date. This will help the Enhancement Team to track the evolution of the enhancement efficiently.

[seans3]

/sig api-machinery

[seans3]

/sig cli
/stage alpha

[deads2k]

/milestone v1.28
/label lead-opted-in

[salehsedghpour]

Hello @seans3 👋, Enhancements team here.

Just checking in as we approach enhancements freeze on 01:00 UTC Friday, 16th June 2023.

This enhancement is targeting for stage alpha for 1.28 (correct me, if otherwise)

Here's where this enhancement currently stands:

• KEP readme using the latest template has been merged into the k/enhancements repo.
• KEP status is marked as implementable for latest-milestone: 1.28
• KEP readme has a updated detailed test plan section filled out
• KEP readme has up to date graduation criteria
• KEP has a production readiness review that has been completed and merged into k/enhancements.

For this KEP, we would just need to update the following:

• Ensure that the PRs are merged.

The status of this enhancement is marked as at risk. Please keep the issue description up-to-date with appropriate stages as well. Thank you!