Fabric8 Kubernetes Client 是一个强大的 Java 客户端库，用于与 Kubernetes 集群交互。以下是快速上手指南：
1. 添加依赖
Maven 依赖：
<dependency><groupId>io.fabric8</groupId><artifactId>kubernetes-client</artifactId><version>6.10.0</version>
</dependency>
2. 基础操作
创建客户端
try (KubernetesClient client = new KubernetesClientBuilder().build()) {// 操作集群
}
列出所有 Pod
client.pods().inNamespace("default").list().getItems().forEach(pod -> System.out.println(pod.getMetadata().getName()));
创建 Deployment
Deployment deployment = client.apps().deployments().load(getClass().getResourceAsStream("/deployment.yaml")).item();
client.apps().deployments().create(deployment);
监控事件
client.v1().events().inNamespace("default").watch(new Watcher<Event>() {@Overridepublic void eventReceived(Action action, Event event) {System.out.println("Event: " + event.getMessage());}
});
3. 进阶用法
动态资源操作
GenericKubernetesResource resource = client.genericKubernetesResources("apiextensions.k8s.io/v1", "CustomResourceDefinition").load(getClass().getResourceAsStream("/crd.yaml")).item();
执行 Pod 命令
String output = client.pods().inNamespace("default").withName("my-pod").writingOutput(System.out) // 实时输出.exec("sh", "-c", "ls -l /tmp");
处理 YAML 资源
List<HasMetadata> resources = client.load(new FileInputStream("k8s-resources.yaml")).items();
resources.forEach(res -> {client.resource(res).createOrReplace();
});
4. 配置技巧
认证方式
• Kubeconfig 自动检测（默认）
• 显式指定配置：
Config config = new ConfigBuilder().withMasterUrl("https://api.cluster.local").withOauthToken("my-token").build();
调试日志
Logger logger = LoggerFactory.getLogger(Loggers.CLIENT);
logger.debug("HTTP request: {}", request);
5. 最佳实践
- 使用 try-with-resources 管理客户端生命周期
- 优先使用命名空间限定操作
- 处理 Kubernetes API 的兼容性（设置
client.getKubernetesVersion()） - 批量操作使用
withGracePeriodSeconds()设置优雅删除时间 - 使用
client.suppress(...)处理 API 版本不匹配问题
6. 常见问题处理
连接失败：
• 检查 ~/.kube/config 文件权限（应为 600）
• 验证集群证书是否有效
权限不足：
if (e.getCode() == 403) {System.err.println("需要添加 ClusterRole 权限");
}
资源版本冲突：
try {client.resource(deployment).update();
} catch (KubernetesClientException e) {// 重试逻辑
}
7. 实用资源
• 官方文档: https://github.com/fabric8io/kubernetes-client
• API 参考: client.getApiVersion() 查看支持的 API
• 调试工具: client.getConfiguration().setLoggingInterval(500)
建议从简单操作入手，逐步尝试复杂场景。Fabric8 的流畅 API 设计能让大部分 Kubernetes 操作变得直观，同时注意处理 Kubernetes API 的异步特性。