Known Issues and Limitations

• Session recording is not supported when either the client or the Kubernetes cluster is using the now-deprecated SPDY protocol.

  • If your kubectl client and Kubernetes cluster are v1.31 and above, you shouldn’t have this issue unless you explicitly disable the following kubectl feature control environment variables: KUBECTL_REMOTE_COMMAND_WEBSOCKETS and KUBECTL_PORT_FORWARD_WEBSOCKETS.
  • If you are connecting to an older cluster with the latest client, you need to enable both feature gates TranslateStreamCloseWebsocketRequests (added in Kubernetes v1.29) and PortForwardWebsockets (added in Kubernetes v1.30) to enable the newer WebSocket protocol. Otherwise, the streaming protocol will fall back to SPDY.
  • If your kubectl client or Kubernetes cluster is v1.28 and below, the streaming protocol will always fall back to SPDY.
  • For more detailed information, see this Kubernetes blog post.

• kubectl cp might experience failures on large files (see Kubernetes issue #60140). Use kubectl cp --retries option to mitigate the issue.