最新Fabric8 Kubernetes Client自定义资源交互方法及迁移指南

在Fabric8 Kubernetes Client 6.x及以上版本中，原有的无参client.customResources()方法已被废弃，推荐使用以下两种更规范的方式与自定义资源交互：

1. 强类型交互（推荐，适用于有Java模型类的场景） #

如果你的自定义资源已经有对应的Java模型类（比如示例中的IgniteClusterK8s和IgniteList），优先使用强类型API。

方式1：注解驱动（最简洁） #

确保你的IgniteClusterK8s类上添加Fabric8的CR元数据注解：

import io.fabric8.kubernetes.client.CustomResource;
import io.fabric8.kubernetes.model.annotation.Group;
import io.fabric8.kubernetes.model.annotation.Version;
import io.fabric8.kubernetes.model.annotation.Kind;
import io.fabric8.kubernetes.model.annotation.Plural;

@Group("ignite.apache.org") // 替换为你的CRD Group
@Version("v1") // 替换为你的CRD Version
@Kind("IgniteClusterK8s")
@Plural("igniteclusters")
public class IgniteClusterK8s extends CustomResource {
    // 自定义资源字段定义
}

改造后的代码无需手动定义上下文，直接通过resources()方法获取操作接口：

private MixedOperation<IgniteClusterK8s, IgniteList, Resource<IgniteClusterK8s>> createIgniteClient(String namespace) {
    try (final KubernetesClient client = getDefaultKubernetesClient()) {
        return client.resources(IgniteClusterK8s.class, IgniteList.class)
                .inNamespace(namespace);
        // 后续可直接调用create()、get()、update()、delete()等标准操作
    }
}

方式2：手动定义CR上下文 #

如果无法给模型类添加注解，可以手动构建CustomResourceDefinitionContext指定CRD元数据：

import io.fabric8.kubernetes.client.CustomResourceDefinitionContext;

private MixedOperation<IgniteClusterK8s, IgniteList, Resource<IgniteClusterK8s>> createIgniteClient(String namespace) {
    try (final KubernetesClient client = getDefaultKubernetesClient()) {
        CustomResourceDefinitionContext crdContext = new CustomResourceDefinitionContext.Builder()
                .withGroup("ignite.apache.org") // CRD的Group
                .withVersion("v1") // CRD的Version
                .withPlural("igniteclusters") // CRD的Plural名称
                .withKind("IgniteClusterK8s")
                .build();
        
        return client.customResources(crdContext, IgniteClusterK8s.class, IgniteList.class)
                .inNamespace(namespace);
    }
}

2. 动态类型交互（适用于无Java模型类的场景） #

如果不需要强类型模型，可以使用GenericKubernetesResource动态操作自定义资源，无需提前定义Java类：

private MixedOperation<GenericKubernetesResource, GenericKubernetesResourceList, Resource<GenericKubernetesResource>> createDynamicIgniteClient(String namespace) {
    try (final KubernetesClient client = getDefaultKubernetesClient()) {
        CustomResourceDefinitionContext crdContext = new CustomResourceDefinitionContext.Builder()
                .withGroup("ignite.apache.org")
                .withVersion("v1")
                .withPlural("igniteclusters")
                .build();
        
        return client.customResources(crdContext, GenericKubernetesResource.class, GenericKubernetesResourceList.class)
                .inNamespace(namespace);
    }
}

迁移核心要点 #

• 移除无参client.customResources()调用，替换为带模型类或CR上下文的重载方法
• 避免强制类型转换，新版本API会直接返回正确类型的MixedOperation
• 若使用注解驱动，确保CR模型类继承CustomResource并添加正确的元数据注解
• 对于批量操作，IgniteList需继承CustomResourceList并添加对应注解

内容的提问来源于stack exchange，提问作者sudhan sudh