ghcr.io/kubernetes-client/java/crd-model-gen

ghcr.io/kubernetes-client/java/crd-model-gen:v1.0.0

ghcr.iolinux/amd64v1.0.0大小: 89.35 MB更新于 2026年11月8日

Kubernetes Java Client

面向 https://kubernetes.io/ API 的 Java 客户端。

开始使用 Kubernetes Java Client

相关说明与文档请参见https://github.com/kubernetes-client/java/wiki的 Wiki 页面。

  • https://github.com/kubernetes-client/java/wiki/1.-Installation
  • https://github.com/kubernetes-client/java/wiki/2.-Versioning-and-Compatibility
  • https://github.com/kubernetes-client/java/wiki/3.-Code-Examples

Exec 凭证插件策略

Kubeconfig 的 exec 凭证插件会启动本地进程。在默认的 AllowAll 策略下,仅可加载受信任的 kubeconfig 文件。应用程序可通过 ExecCredentialPluginPolicy 限制允许运行的插件,该策略遵循 https://kubernetes.io/docs/reference/kubectl/kuberc/ 的 credentialPluginPolicy / credentialPluginAllowlist 语义:

// 拒绝所有 exec 插件
ApiClient client = ClientBuilder.standard(ExecCredentialPluginPolicy.DENY_ALL).build();

// 仅允许指定插件(通过 PATH 解析的基础名,或完整路径)
ApiClient client = ClientBuilder.standard(
ExecCredentialPluginPolicy.allowlist("kubelogin", "/usr/local/bin/my-trusted-plugin")).build();

// 使用与 kubectl 一致的策略(从 $KUBERC 或 ~/.kube/kuberc 读取)
ApiClient client = ClientBuilder.standard(ExecCredentialPluginPolicy.fromDefaultKubeRc()).build();

// 或对手动加载的 KubeConfig 设置策略
kubeConfig.setExecCredentialPluginPolicy(ExecCredentialPluginPolicy.DENY_ALL);

当白名单条目与插件命令完全相等,或二者通过 PATH 解析得到同一个可执行文件时(不会解析符号链接与通配符),视为匹配。被拒绝的插件永远不会启动,同时会抛出 ExecCredentialPluginDeniedException 异常。该策略同时适用于初始凭证获取和令牌刷新流程。它不会限制插件的参数或环境变量,属于纵深防御措施,而非沙箱机制。

版本发布

从 20.0.0(对应 Kubernetes 1.28)版本开始,client-java-api 引入了不向后兼容的变更:可选参数现已整合为单个对象,同时移除了对 Java 8 的支持。对于使用 Java 8 或偏好旧版 SDK 接口的用户,可使用带 -legacy 后缀的旧版 SDK 模块版本,例如 20.0.0-legacy。

开发相关

  • https://github.com/kubernetes-client/java/wiki/4.-Development-and-Contributing
  • https://github.com/kubernetes-client/java/wiki/5.-Generate-Java-CRD-Model
  • https://github.com/kubernetes-client/java/wiki/6.-Known-Issues
  • https://github.com/kubernetes-client/java/wiki/7.-FAQ

如需更新所有 pom.xml 文件中的 Maven 项目版本(包括可选的 fluent-gen 模块),执行以下命令:

./scripts/update-version.sh 28.0.0-SNAPSHOT

该辅助脚本实际调用 Maven Versions 插件,对应的等效 Maven 命令为:

./mvnw -Pfluent-gen versions:set -DnewVersion=28.0.0-SNAPSHOT -DprocessAllModules=true -DgenerateBackupPoms=false

技术支持

如需获取支持,请先检查你遇到的问题是否属于已知问题。若无法解决,请https://github.com/kubernetes-client/java/issues/new 描述你的场景。此外,在提交 Issue 前,请先搜索https://github.com/kubernetes-client/java/issues,确认你遇到的问题尚未被记录。

你也可以通过 Slack 的 #kubernetes-client 频道联系项目团队。

专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告