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
    • Extend WebSocket Streaming Protocol to the Kubelet for Exec/Attach/PortForward kubernetes#136256
  • 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.