# Kubernetes Java Client

[![build](https://github.com/kubernetes-client/java/workflows/build/badge.svg)](https://github.com/kubernetes-client/java/actions/workflows/maven.yml)
[![Client Capabilities](https://img.shields.io/badge/Kubernetes%20client-Silver-blue.svg?style=flat&colorB=C0C0C0&colorA=306CE8)](https://bit.ly/kubernetes-client-capabilities-badge)
[![Client Support Level](https://img.shields.io/badge/kubernetes%20client-beta-green.svg?style=flat&colorA=306CE8)](https://bit.ly/kubernetes-client-support-badge)
[![Maven Central](https://img.shields.io/maven-central/v/io.kubernetes/client-java.svg?label=Maven%20Central)](https://search.maven.org/search?q=g:%22io.kubernetes%22%20AND%20a:%22client-java%22)
![Sonatype Nexus (Snapshots)](https://img.shields.io/nexus/s/io.kubernetes/client-java?label=Maven%20Snapshot&server=https%3A%2F%2Foss.sonatype.org)

Java client for the [kubernetes](https://kubernetes.io/) API.

## To start using Kubernetes Java Client

See the wiki page and documentation [here](https://github.com/kubernetes-client/java/wiki).

- [Installation](https://github.com/kubernetes-client/java/wiki/1.-Installation)
- [Client Versioning and Compatibility](https://github.com/kubernetes-client/java/wiki/2.-Versioning-and-Compatibility)
- [Code Examples](https://github.com/kubernetes-client/java/wiki/3.-Code-Examples)

## Release

Starting from `20.0.0` (Kubernetes 1.28), `client-java-api` was introduced non-backward-compatible changes. Optional 
parameters are now consolidated into a single object, and Java8 support has been removed. For Java8 users or those 
preferring the old SDK interface, a legacy SDK module version is available with a "-legacy" suffix, like `20.0.0-legacy`.

## Development

- [Development and Contributing](https://github.com/kubernetes-client/java/wiki/4.-Development-and-Contributing)
- [Generate Java CRD Models](https://github.com/kubernetes-client/java/wiki/5.-Generate-Java-CRD-Model)
- [Known Issues](https://github.com/kubernetes-client/java/wiki/6.-Known-Issues)
- [Troubleshooting/FAQ](https://github.com/kubernetes-client/java/wiki/7.-FAQ)

## Support

If you need support, start with checking whether you're hitting known issues. If that doesn't work, please [open an issue](https://github.com/kubernetes-client/java/issues/new)
to describe the cases. Additionally, before you file an issue, please search [existing issues](https://github.com/kubernetes-client/java/issues)
to see if your issue is 
already covered.

You can also reach out to us via [#kubernetes-client](https://kubernetes.slack.com/messages/kubernetes-clients/) slack 
channel.

