Kubernetes JavaScript客户端1.0.0版本迁移指南

Kubernetes JavaScript客户端库在1.0.0版本中进行了重大架构调整，将底层HTTP请求库从已弃用的request迁移到了node-fetch。这一变更带来了许多API层面的不兼容变化，开发者需要特别注意以下关键变更点。

错误处理机制变更

在0.x版本中，开发者可以通过HttpError类来处理HTTP错误：

import * as k8s from '@kubernetes/client-node';

try {
  // 执行Kubernetes操作
} catch (e) {
  if (e instanceof k8s.HttpError) {
    console.error(e.body);
  }
}

1.0.0版本中，错误处理机制完全重构。现在需要使用ApiException类，并通过状态码来判断错误类型：

const k8sApi = kc.makeApiClient(k8s.CoreV1Api);

try {
  const pod = await k8sApi.readNamespacedPod({ 
    name: 'pod-name', 
    namespace: 'default' 
  });
} catch (err) {
  if (err instanceof k8s.ApiException) {
    // 判断是否为404错误
    const isNotFound = err.code === 404;
    // 错误详情需要手动解析
    const errorDetails = JSON.parse(err.body);
    console.log(errorDetails);
  }
}

响应体处理变化

新版本中，响应体的处理方式也有所不同：

1. 成功响应现在直接返回解析后的对象，不再需要通过response.body访问
2. 错误响应中的body字段是JSON字符串而非对象，需要手动解析

实用工具推荐

对于需要处理多种错误类型的场景，可以考虑使用第三方工具库来简化代码：

import { apimachinery } from '@kubenode/controller-runtime';

try {
  // Kubernetes操作
} catch (err) {
  console.log(apimachinery.errors.isNotFound(err)); // 专门检查404错误
}

注意事项

1. 目前官方示例尚未完全更新，部分示例代码可能不适用于1.0.0版本
2. PATCH操作接口有特殊处理方式，与常规CRUD操作不同
3. 从集群加载配置时(kc.loadFromCluster())可能需要注意额外配置

建议开发者在升级前充分测试核心功能，特别是错误处理逻辑。对于复杂的迁移场景，可以考虑逐步替换组件而非一次性升级。