Docker Desktop Kubernetes性能优化及kubectl TLS握手超时问题排查

针对你执行kubectl scale时偶尔出现的Unable to connect to the server: net/http: TLS handshake timeout问题，结合Docker Desktop内置K8s的特性，可从以下几个方向优化：

1. 批量执行kubectl命令，减少重复连接开销 #

不要逐个对Deployment执行scale操作，用批量命令一次性完成，减少多次与apiserver建立TLS连接的次数：

• 对所有Deployment执行相同scale操作：

  kubectl scale deployment --all --current-replicas=2 --replicas=2
  

• 针对特定标签的Deployment操作：

  kubectl scale deployment -l app=shopping --current-replicas=2 --replicas=2
  

• 用管道批量处理所有Deployment：

  kubectl get deployments -o name | xargs kubectl scale --current-replicas=2 --replicas=2
  

2. 提升Docker Desktop的资源分配 #

Docker Desktop内置的K8s是单节点集群，36个Pod加上K8s核心组件（apiserver、etcd、控制器等）会占用大量资源，资源不足直接导致apiserver响应缓慢：

• 打开Docker Desktop设置 → Resources → Advanced，将CPU配额调高到4核以上，内存调整到8GB以上，磁盘分配也适当增加。
• 关闭本地其他无关的Docker容器、虚拟机或后台服务，释放资源给K8s集群。

3. 优化kubectl的连接配置 #

开启kubectl的HTTP持久连接，减少重复TLS握手的次数：

• 编辑~/.kube/config文件，在对应集群的配置中添加keep-alive参数：

  clusters:
  - cluster:
      server: https://localhost:6443
      # 添加以下连接配置
      timeout: 30s
      keep-alive: 30s
    name: docker-desktop
  

• 也可通过环境变量临时设置：

  export KUBECTL_CLIENT_TIMEOUT=30s
  export HTTP_PROXY="" # 若有代理干扰，清空代理配置
  

4. 给Pod设置资源请求与限制 #

避免单个Pod无限制占用节点资源，导致apiserver和其他K8s组件资源不足：
在每个Deployment的容器配置中添加资源限制，示例：

spec:
  template:
    spec:
      containers:
      - name: my-gateway
        image: rafaelribeirosouza86/shopping:api-gateway
        # 新增资源限制配置
        resources:
          requests:
            cpu: "100m"
            memory: "256Mi"
          limits:
            cpu: "500m"
            memory: "512Mi"

这样K8s能更合理地调度资源，避免节点资源耗尽。

5. 排查网络干扰问题 #

• 关闭本地VPN、代理软件，这类工具可能拦截kubectl与apiserver之间的TLS连接，导致握手超时。
• 检查本地防火墙规则，确保允许本地访问K8s apiserver的默认端口6443。

内容的提问来源于stack exchange，提问作者Rafael Souza