k8s客户端fabric8基本使用-CFANZ编程社区

介绍

参考下文

开源微服务管理平台 fabric8 简介 · Jimmy Song本文介绍了开源的微服务管理平台 Fabric8。https://jimmysong.io/blog/fabric8-introduction/

官网

https://github.com/fabric8io/kubernetes-clienthttps://github.com/fabric8io/kubernetes-client

Usage

Creating a client
Configuring the client
Loading resources from external sources
Passing a reference of a resource to the client
Adapting a client

Adapting and close

Generating CRD from Java
Generating Java from CRD
Mocking Kubernetes
Who Uses Fabric8 Kubernetes Client?
Kubernetes Operators in Java Written using Fabric8 Kubernetes Client
Kubernetes and Red Hat OpenShift Compatibility Matrix
Kubernetes Client CHEAT SHEET
Kubectl Java Equivalents
FAQs

Usage

Creating a client

The easiest way to create a client is:

KubernetesClient client = new KubernetesClientBuilder().build();

DefaultOpenShiftClient implements both the KubernetesClient & OpenShiftClient interface so if you need the OpenShift extensions, such as Builds, etc then simply do:

OpenShiftClient osClient = new KubernetesClientBuilder().build().adapt(OpenShiftClient.class);

Configuring the client

This will use settings from different sources in the following order of priority:

System properties
Environment variables
Kube config file
Service account token & mounted CA certificate

System properties are preferred over environment variables. The following system properties & environment variables can be used for configuration:

Property / Environment Variable	Description	Default value
`kubernetes.disable.autoConfig` / `KUBERNETES_DISABLE_AUTOCONFIG`	Disable automatic configuration	`false`
`kubernetes.master` / `KUBERNETES_MASTER`	Kubernetes master URL	`https://kubernetes.default.svc`
`kubernetes.api.version` / `KUBERNETES_API_VERSION`	API version	`v1`
`openshift.url` / `OPENSHIFT_URL`	OpenShift master URL	Kubernetes master URL value
`kubernetes.oapi.version` / `KUBERNETES_OAPI_VERSION`	OpenShift API version	`v1`
`kubernetes.trust.certificates` / `KUBERNETES_TRUST_CERTIFICATES`	Trust all certificates	`false`
`kubernetes.disable.hostname.verification` / `KUBERNETES_DISABLE_HOSTNAME_VERIFICATION`		`false`
`kubernetes.certs.ca.file` / `KUBERNETES_CERTS_CA_FILE`
`kubernetes.certs.ca.data` / `KUBERNETES_CERTS_CA_DATA`
`kubernetes.certs.client.file` / `KUBERNETES_CERTS_CLIENT_FILE`
`kubernetes.certs.client.data` / `KUBERNETES_CERTS_CLIENT_DATA`
`kubernetes.certs.client.key.file` / `KUBERNETES_CERTS_CLIENT_KEY_FILE`
`kubernetes.certs.client.key.data` / `KUBERNETES_CERTS_CLIENT_KEY_DATA`
`kubernetes.certs.client.key.algo` / `KUBERNETES_CERTS_CLIENT_KEY_ALGO`	Client key encryption algorithm	`RSA`
`kubernetes.certs.client.key.passphrase` / `KUBERNETES_CERTS_CLIENT_KEY_PASSPHRASE`
`kubernetes.auth.basic.username` / `KUBERNETES_AUTH_BASIC_USERNAME`
`kubernetes.auth.basic.password` / `KUBERNETES_AUTH_BASIC_PASSWORD`
`kubernetes.auth.serviceAccount.token` / `KUBERNETES_AUTH_SERVICEACCOUNT_TOKEN`	Name of the service account token file	`/var/run/secrets/kubernetes.io/serviceaccount/token`
`kubernetes.auth.tryKubeConfig` / `KUBERNETES_AUTH_TRYKUBECONFIG`	Configure client using Kubernetes config	`true`
`kubeconfig` / `KUBECONFIG`	Name of the kubernetes config file to read	`~/.kube/config`
`kubernetes.auth.tryServiceAccount` / `KUBERNETES_AUTH_TRYSERVICEACCOUNT`	Configure client from Service account	`true`
`kubernetes.tryNamespacePath` / `KUBERNETES_TRYNAMESPACEPATH`	Configure client namespace from Kubernetes service account namespace path	`true`
`kubernetes.auth.token` / `KUBERNETES_AUTH_TOKEN`
`kubernetes.watch.reconnectInterval` / `KUBERNETES_WATCH_RECONNECTINTERVAL`	Watch reconnect interval in ms	`1000`
`kubernetes.watch.reconnectLimit` / `KUBERNETES_WATCH_RECONNECTLIMIT`	Number of reconnect attempts (-1 for infinite)	`-1`
`kubernetes.connection.timeout` / `KUBERNETES_CONNECTION_TIMEOUT`	Connection timeout in ms (0 for no timeout)	`10000`
`kubernetes.request.timeout` / `KUBERNETES_REQUEST_TIMEOUT`	Read timeout in ms	`10000`
`kubernetes.upload.connection.timeout` / `KUBERNETES_UPLOAD_CONNECTION_TIMEOUT`	Pod upload connection timeout in ms	`10000`
`kubernetes.upload.request.timeout` / `KUBERNETES_UPLOAD_REQUEST_TIMEOUT`	Pod upload request timeout in ms	`120000`
`kubernetes.request.retry.backoffLimit` / `KUBERNETES_REQUEST_RETRY_BACKOFFLIMIT`	Number of retry attempts	`0`
`kubernetes.request.retry.backoffInterval` / `KUBERNETES_REQUEST_RETRY_BACKOFFINTERVAL`	Retry initial backoff interval in ms	`1000`
`kubernetes.rolling.timeout` / `KUBERNETES_ROLLING_TIMEOUT`	Rolling timeout in ms	`900000`
`kubernetes.logging.interval` / `KUBERNETES_LOGGING_INTERVAL`	Logging interval in ms	`20000`
`kubernetes.scale.timeout` / `KUBERNETES_SCALE_TIMEOUT`	Scale timeout in ms	`600000`
`kubernetes.websocket.timeout` / `KUBERNETES_WEBSOCKET_TIMEOUT`	Websocket timeout in ms	`5000`
`kubernetes.websocket.ping.interval` / `KUBERNETES_WEBSOCKET_PING_INTERVAL`	Websocket ping interval in ms	`30000`
`kubernetes.max.concurrent.requests` / `KUBERNETES_MAX_CONCURRENT_REQUESTS`		`64`
`kubernetes.max.concurrent.requests.per.host` / `KUBERNETES_MAX_CONCURRENT_REQUESTS_PER_HOST`		`5`
`kubernetes.impersonate.username` / `KUBERNETES_IMPERSONATE_USERNAME`	`Impersonate-User` HTTP header value
`kubernetes.impersonate.group` / `KUBERNETES_IMPERSONATE_GROUP`	`Impersonate-Group` HTTP header value
`kubernetes.tls.versions` / `KUBERNETES_TLS_VERSIONS`	TLS versions separated by `,`	`TLSv1.2`
`kubernetes.truststore.file` / `KUBERNETES_TRUSTSTORE_FILE`
`kubernetes.truststore.passphrase` / `KUBERNETES_TRUSTSTORE_PASSPHRASE`
`kubernetes.keystore.file` / `KUBERNETES_KEYSTORE_FILE`
`kubernetes.keystore.passphrase` / `KUBERNETES_KEYSTORE_PASSPHRASE`
`kubernetes.backwardsCompatibilityInterceptor.disable` / `KUBERNETES_BACKWARDSCOMPATIBILITYINTERCEPTOR_DISABLE`	Disable the `BackwardsCompatibilityInterceptor`	`true`
`no.proxy` / `NO_PROXY`	comma-separated list of domain extensions proxy should not be used for

Alternatively you can use the ConfigBuilder to create a config object for the Kubernetes client:

Config config = new ConfigBuilder().withMasterUrl("https://mymaster.com").build(); KubernetesClient client = new KubernetesClientBuilder().withConfig(config).build();

Using the DSL is the same for all resources.

List resources:

NamespaceList myNs = client.namespaces().list(); ServiceList myServices = client.services().list(); ServiceList myNsServices = client.services().inNamespace("default").list();

Get a resource:

Namespace myns = client.namespaces().withName("myns").get(); Service myservice = client.services().inNamespace("default").withName("myservice").get();

Delete:

Namespace myns = client.namespaces().withName("myns").delete(); Service myservice = client.services().inNamespace("default").withName("myservice").delete();

Editing resources uses the inline builders from the Kubernetes Model:

Namespace myns = client.namespaces().withName("myns").edit(n -> new NamespaceBuilder(n) .editMetadata() .addToLabels("a", "label") .endMetadata() .build()); Service myservice = client.services().inNamespace("default").withName("myservice").edit(s -> new ServiceBuilder(s) .editMetadata() .addToLabels("another", "label") .endMetadata() .build());

In the same spirit you can inline builders to create:

Namespace myns = client.namespaces().create(new NamespaceBuilder() .withNewMetadata() .withName("myns") .addToLabels("a", "label") .endMetadata() .build()); Service myservice = client.services().inNamespace("default").create(new ServiceBuilder() .withNewMetadata() .withName("myservice") .addToLabels("another", "label") .endMetadata() .build());

You can also set the apiVersion of the resource like in the case of SecurityContextConstraints :

SecurityContextConstraints scc = new SecurityContextConstraintsBuilder() .withApiVersion("v1") .withNewMetadata().withName("scc").endMetadata() .withAllowPrivilegedContainer(true) .withNewRunAsUser() .withType("RunAsAny") .endRunAsUser() .build();

Following events

Use io.fabric8.kubernetes.api.model.Event as T for Watcher:

client.events().inAnyNamespace().watch(new Watcher<Event>() { @Override public void eventReceived(Action action, Event resource) { System.out.println("event " + action.name() + " " + resource.toString()); } @Override public void onClose(KubernetesClientException cause) { System.out.println("Watcher close due to " + cause); } });

Working with extensions

The kubernetes API defines a bunch of extensions like daemonSets, jobs, ingresses and so forth which are all usable in the extensions() DSL:

e.g. to list the jobs...

jobs = client.batch().jobs().list();

Loading resources from external sources

There are cases where you want to read a resource from an external source, rather than defining it using the clients DSL. For those cases the client allows you to load the resource from:

A file(Supports both java.io.File and java.lang.String)
A url
An input stream

Once the resource is loaded, you can treat it as you would, had you created it yourself.

For example lets read a pod, from a yml file and work with it:

Pod refreshed = client.load('/path/to/a/pod.yml').fromServer().get();
client.load('/workspace/pod.yml').delete();
LogWatch handle = client.load('/workspace/pod.yml').watchLog(System.out);

Passing a reference of a resource to the client

In the same spirit you can use an object created externally (either a reference or using its string representation).

For example:

Pod pod = someThirdPartyCodeThatCreatesAPod();
client.resource(pod).delete();

Adapting the client

The client supports plug-able adapters. An example adapter is the OpenShift Adapter which allows adapting an existing KubernetesClient instance to an OpenShiftClient one.

For example:

KubernetesClient client = new KubernetesClientBuilder().build(); OpenShiftClient oClient = client.adapt(OpenShiftClient.class);

The client also support the isAdaptable() method which checks if the adaptation is possible and returns true if it does.

KubernetesClient client = new KubernetesClientBuilder().build(); if (client.isAdaptable(OpenShiftClient.class)) { OpenShiftClient oClient = client.adapt(OpenShiftClient.class); } else { throw new Exception("Adapting to OpenShiftClient not support. Check if adapter is present, and that env provides /oapi root path."); }

Adapting and close

Note that when using adapt() both the adaptee and the target will share the same resources (underlying http client, thread pools etc). This means that close() is not required to be used on every single instance created via adapt. Calling close() on any of the adapt() managed instances or the original instance, will properly clean up all the resources and thus none of the instances will be usable any longer.

Mocking Kubernetes

Along with the client this project also provides a kubernetes mock server that you can use for testing purposes. The mock server is based on https://github.com/square/okhttp/tree/master/mockwebserver but is empowered by the DSL and features provided by https://github.com/fabric8io/mockwebserver.

The Mock Web Server has two modes of operation:

Expectations mode
CRUD mode

Expectations mode

It's the typical mode where you first set which are the expected http requests and which should be the responses for each request. More details on usage can be found at: GitHub - fabric8io/mockwebserver: An extension of okhttp's mockwebserver, that provides a DSL and is easier to use

This mode has been extensively used for testing the client itself. Make sure you check kubernetes-test.

To add a Kubernetes server to your test:

@Rule public KubernetesServer server = new KubernetesServer();

CRUD mode

Defining every single request and response can become tiresome. Given that in most cases the mock webserver is used to perform simple crud based operations, a crud mode has been added. When using the crud mode, the mock web server will store, read, update and delete kubernetes resources using an in memory map and will appear as a real api server.

To add a Kubernetes Server in crud mode to your test:

@Rule public KubernetesServer server = new KubernetesServer(true, true);

Then you can use the server like:

@Test public void testInCrudMode() { KubernetesClient client = server.getClient(); final CountDownLatch deleteLatch = new CountDownLatch(1); final CountDownLatch closeLatch = new CountDownLatch(1); //CREATE client.pods().inNamespace("ns1").create(new PodBuilder().withNewMetadata().withName("pod1").endMetadata().build()); //READ podList = client.pods().inNamespace("ns1").list(); assertNotNull(podList); assertEquals(1, podList.getItems().size()); //WATCH Watch watch = client.pods().inNamespace("ns1").withName("pod1").watch(new Watcher<Pod>() { @Override public void eventReceived(Action action, Pod resource) { switch (action) { case DELETED: deleteLatch.countDown(); break; default: throw new AssertionFailedError(action.toString().concat(" isn't recognised.")); } } @Override public void onClose(KubernetesClientException cause) { closeLatch.countDown(); } }); //DELETE client.pods().inNamespace("ns1").withName("pod1").delete(); //READ AGAIN podList = client.pods().inNamespace("ns1").list(); assertNotNull(podList); assertEquals(0, podList.getItems().size()); assertTrue(deleteLatch.await(1, TimeUnit.MINUTES)); watch.close(); assertTrue(closeLatch.await(1, TimeUnit.MINUTES)); }

JUnit5 support through extension

You can use KubernetesClient mocking mechanism with JUnit5. Since it doesn't support @Rule and @ClassRule there is dedicated annotation @EnableKubernetesMockClient. If you would like to create instance of mocked KubernetesClient for each test (JUnit4 @Rule) you need to declare instance of KubernetesClient as shown below.

@EnableKubernetesMockClient class ExampleTest { KubernetesClient client; @Test public void testInStandardMode() { ... } }

In case you would like to define static instance of mocked server per all the test (JUnit4 @ClassRule) you need to declare instance of KubernetesClient as shown below. You can also enable crudMode by using annotation field crud.

@EnableKubernetesMockClient(crud = true) class ExampleTest { static KubernetesClient client; @Test public void testInCrudMode() { ... } }

Compatibility Matrix

Kubernetes Compatibility Matrix:

	K8s 1.24.0	K8s 1.23.3	K8s 1.22.1	K8s 1.21.1	K8s 1.20.2	K8s 1.19.1	K8s 1.18.0	K8s 1.17.0	K8s 1.16.0	K8s 1.15.3	K8s 1.14.2	K8s 1.12.0	K8s 1.11.0	K8s 1.10.0	K8s 1.9.0	K8s 1.7.0	K8s 1.6.0
kubernetes-client 6.1.1	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-	-
kubernetes-client 6.0.0	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-	-
kubernetes-client 5.12.3		✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-	-
kubernetes-client 5.12.2		✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-	-
kubernetes-client 5.12.1		✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-	-
kubernetes-client 5.12.0		✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-	-
kubernetes-client 5.11.2			✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-	-
kubernetes-client 5.11.1			✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-	-
kubernetes-client 5.11.0			✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-	-
kubernetes-client 5.10.2			✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-	-
kubernetes-client 5.10.1			✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-	-
kubernetes-client 5.10.0			✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-	-
kubernetes-client 5.9.0			✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-	-
kubernetes-client 5.8.1			✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-	-
kubernetes-client 5.8.0			✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-	-
kubernetes-client 5.7.4			-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.7.3			-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.7.2			-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.7.1			-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.7.0			-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.6.0			-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.5.0			-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.4.2			-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.4.1			-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.4.0			-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.3.2			-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.3.1			-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.3.0			-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.2.1			-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.2.0			-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.1.2			-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.1.1			-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.1.0			-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.0.3			-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.0.2			-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.0.1			-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 5.0.0			-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.13.3			-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.13.2			-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.13.1			-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.13.0			-	-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.12.0			-	-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.11.2			-	-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.11.1			-	-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.11.0			-	-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.10.3			-	-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.10.2			-	-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.10.1			-	-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.10.0			-	-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.9.2			-	-	-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.9.1			-	-	-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.9.0			-	-	-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.8.0			-	-	-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.7.2			-	-	-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.7.1			-	-	-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.7.0			-	-	-	-	-	✓	✓	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.6.4			-	-	-	-	-	-	-	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.6.3			-	-	-	-	-	-	-	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.6.2			-	-	-	-	-	-	-	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.6.1			-	-	-	-	-	-	-	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.6.0			-	-	-	-	-	-	-	✓	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.5.2			-	-	-	-	-	-	-	-	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.5.1			-	-	-	-	-	-	-	-	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.5.0			-	-	-	-	-	-	-	-	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.4.2			-	-	-	-	-	-	-	-	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.4.1			-	-	-	-	-	-	-	-	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.4.0			-	-	-	-	-	-	-	-	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.3.1			-	-	-	-	-	-	-	-	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.3.0			-	-	-	-	-	-	-	-	✓	✓	✓	✓	✓	-	-
kubernetes-client 4.2.2			-	-	-	-	-	-	-	-	-	✓	✓	✓	✓	-	-
kubernetes-client 4.2.1			-	-	-	-	-	-	-	-	-	✓	✓	✓	✓	-	-
kubernetes-client 4.2.0			-	-	-	-	-	-	-	-	-	✓	✓	✓	✓	-	-
kubernetes-client 4.1.3			-	-	-	-	-	-	-	-	-	✓	✓	✓	✓	-	-
kubernetes-client 4.1.2			-	-	-	-	-	-	-	-	-	✓	✓	✓	✓	-	-
kubernetes-client 4.1.1			-	-	-	-	-	-	-	-	-	✓	✓	✓	✓	-	-
kubernetes-client 4.1.0			-	-	-	-	-	-	-	-	-	-	-	-	✓	✓	✓
kubernetes-client 4.0.0			-	-	-	-	-	-	-	-	-	-	-	-	✓	✓	✓
kubernetes-client 3.2.0			-	-	-	-	-	-	-	-	-	-	-	-	✓	✓	✓
kubernetes-client 3.1.12			-	-	-	-	-	-	-	-	-	-	-	-	✓	✓	✓
kubernetes-client 3.0.11			-	-	-	-	-	-	-	-	-	-	-	-	✓	✓	✓
kubernetes-client 3.0.10			-	-	-	-	-	-	-	-	-	-	-	-	✓	✓	✓
kubernetes-client 3.0.3			-	-	-	-	-	-	-	-	-	-	-	-	-	✓	-
kubernetes-client 1.3.92			-	-	-	-	-	-	-	-	-	-	-	-	-	-	+

OpenShift Compatibility Matrix:

Note: This matrix is prepared by running our integration tests on different versions of OpenShift.

	OCP 4.9.8	OCP 4.5.14	OCP 4.2.0	OCP 4.1.0	OCP 3.11.0	OCP 3.10.0	OCP 3.9.0	OCP 3.7.0	OCP 3.6.0
openshift-client 6.1.1	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 6.0.0	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.12.3	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.12.1	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.12.0	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.11.2	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.11.1	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.11.0	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.10.2	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.10.1	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.10.0	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.9.0	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.8.1	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.8.0	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.7.4	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.7.3	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.7.2	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.7.1	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.7.0	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.6.0	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.5.0	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.4.2	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.4.1	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.4.0	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.3.2	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.3.1	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.3.0	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.2.1	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.2.0	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.1.2	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.1.1	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.1.0	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.0.3	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.0.2	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.0.1	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 5.0.0	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 4.13.3	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 4.13.2	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 4.13.1	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 4.13.0	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 4.12.0	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 4.11.2	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 4.11.1	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 4.11.0	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 4.10.3	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 4.10.2	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 4.10.1	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 4.10.0	✓	✓	✓	✓	✓	✓	✓	-	-
openshift-client 4.9.2	-	-	✓	✓	✓	✓	✓	-	-
openshift-client 4.9.1	-	-	✓	✓	✓	✓	✓	-	-
openshift-client 4.9.0	-	-	✓	✓	✓	✓	✓	-	-
openshift-client 4.8.0	-	-	✓	✓	✓	✓	✓	-	-
openshift-client 4.7.2	-	-	✓	✓	✓	✓	✓	-	-
openshift-client 4.7.1	-	-	✓	✓	✓	✓	✓	-	-
openshift-client 4.7.0	-	-	✓	✓	✓	✓	✓	-	-
openshift-client 4.6.4	-	-	-	✓	✓	✓	✓	-	-
openshift-client 4.6.3	-	-	-	✓	✓	✓	✓	-	-
openshift-client 4.6.2	-	-	-	✓	✓	✓	✓	-	-
openshift-client 4.6.1	-	-	-	✓	✓	✓	✓	-	-
openshift-client 4.6.0	-	-	-	✓	✓	✓	✓	-	-
openshift-client 4.5.2	-	-	-	✓	✓	✓	✓	-	-
openshift-client 4.5.1	-	-	-	✓	✓	✓	✓	-	-
openshift-client 4.5.0	-	-	-	✓	✓	✓	✓	-	-
openshift-client 4.4.2	-	-	-	✓	✓	✓	✓	-	-
openshift-client 4.4.1	-	-	-	✓	✓	✓	✓	-	-
openshift-client 4.4.0	-	-	-	✓	✓	✓	✓	-	-
openshift-client 4.3.1	-	-	-	-	✓	✓	✓	-	-
openshift-client 4.3.0	-	-	-	-	✓	✓	✓	-	-
openshift-client 4.2.2	-	-	-	-	✓	✓	✓	-	-
openshift-client 4.2.1	-	-	-	-	✓	✓	✓	-	-
openshift-client 4.2.0	-	-	-	-	✓	✓	✓	-	-
openshift-client 4.1.3	-	-	-	-	✓	✓	✓	-	-
openshift-client 4.1.2	-	-	-	-	✓	✓	✓	-	-
openshift-client 4.1.1	-	-	-	-	✓	✓	✓	-	-
openshift-client 4.1.0	-	-	-	-	-	✓	✓	✓	-
openshift-client 4.0.0	-	-	-	-	-	-	✓	✓	✓
openshift-client 3.2.0	-	-	-	-	-	-	✓	✓	✓
openshift-client 3.1.12	-	-	-	-	-	-	✓	✓	✓
openshift-client 3.0.11	-	-	-	-	-	-	✓	✓	✓
openshift-client 3.0.10	-	-	-	-	-	-	✓	✓	✓
openshift-client 3.0.3	-	-	-	-	-	-	-	✓	-
openshift-client 1.3.92	-	-	-	-	-	-	-	-	+

Major Changes in Kubernetes Client 4.0.0

All the resource objects used here will be according to OpenShift 3.9.0 and Kubernetes 1.9.0. All the resource objects will give all the fields according to OpenShift 3.9.0 and Kubernetes 1.9.0

SecurityContextConstraints has been moved to OpenShift client from Kubernetes Client
Job dsl is in bothbatch andextensions(Extensions is deprecated)
DaemonSet dsl is in bothapps andextensions(Extensions is deprecated)
Deployment dsl is in bothapps andextensions(Extensions is deprecated)
ReplicaSet dsl is in bothapps andextensions(Extensions is deprecated)
NetworkPolicy dsl is in bothnetwork andextensions(Extensions is deprecated)
Storage Class moved fromclient base DSL tostorage DSL
PodSecurityPolicies moved fromclient base DSL andextensions to onlyextensions
ThirdPartyResource has been removed.

Who uses Kubernetes & OpenShift Java client?

Extensions:

Service Catalog API
Knative
Tekton
Volcano
Istio
Open Cluster Management

Frameworks/Libraries/Tools:

Arquillian Cube
Apache Camel
Apache Flink
Apache Spark
Jaeger Kubernetes
Loom
Microsoft Azure Libraries for Java
Spinnaker Halyard
Spring Cloud Connectors for Kubernetes
Spring Cloud Kubernetes

CI Plugins:

Deployment Pipeline Plugin (Jenkins)
Kubernetes Elastic Agent (GoCD)
Kubernetes Plugin (Jenkins)
Kubernetes Pipeline Plugin (Jenkins)
OpenShift Sync Plugin (Jenkins)
Kubernetes Plugin (Teamcity from Jetbrains)
Kubernetes Agents for Bamboo (WindTunnel Technologies)

Build Tools:

Fabric8 Maven Plugin
Eclipse JKube
Gradle Kubernetes Plugin

Platforms:

Apache Openwhisk
Eclipse che
EnMasse
Openshift.io (Launcher service)
Spotify Styx
Strimzi
Syndesis
StackGres
Boomerang Flow

Proprietary Platforms:

vCommander

As our community grows, we would like to track keep track of our users. Please send a PR with your organization/community name.

Tests we run for every new Pull Request

There are the links of the Github Actions and Jenkins for the tests which run for every new Pull Request. You can view all the recent builds also.

Regression Tests
Unit Tests

To get the updates about the releases, you can join https://groups.google.com/forum/embed/?place=forum/fabric8-devclients

Kubectl Java Equivalents

This table provides kubectl to Kubernetes Java Client mappings. Most of the mappings are quite straightforward and are one liner operations. However, some might require slightly more code to achieve same result:

kubectl	Fabric8 Kubernetes Client
`kubectl config view`	ConfigViewEquivalent.java
`kubectl config get-contexts`	ConfigGetContextsEquivalent.java
`kubectl config current-context`	ConfigGetCurrentContextEquivalent.java
`kubectl config use-context minikube`	ConfigUseContext.java
`kubectl config view -o jsonpath='{.users[*].name}'`	ConfigGetCurrentContextEquivalent.java
`kubectl get pods --all-namespaces`	PodListGlobalEquivalent.java
`kubectl get pods`	PodListEquivalent.java
`kubectl get pods -w`	PodWatchEquivalent.java
`kubectl get pods --sort-by='.metadata.creationTimestamp'`	PodListGlobalEquivalent.java
`kubectl run`	PodRunEquivalent.java
`kubectl create -f test-pod.yaml`	PodCreateYamlEquivalent.java
`kubectl exec my-pod -- ls /`	PodExecEquivalent.java
`kubectl attach my-pod`	PodAttachEquivalent.java
`kubectl delete pod my-pod`	PodDelete.java
`kubectl delete -f test-pod.yaml`	PodDeleteViaYaml.java
`kubectl cp /foo_dir my-pod:/bar_dir`	UploadDirectoryToPod.java
`kubectl cp my-pod:/tmp/foo /tmp/bar`	DownloadFileFromPod.java
`kubectl cp my-pod:/tmp/foo -c c1 /tmp/bar`	DownloadFileFromMultiContainerPod.java
`kubectl cp /foo_dir my-pod:/tmp/bar_dir`	UploadFileToPod.java
`kubectl logs pod/my-pod`	PodLogsEquivalent.java
`kubectl logs pod/my-pod -f`	PodLogsFollowEquivalent.java
`kubectl logs pod/my-pod -c c1`	PodLogsMultiContainerEquivalent.java
`kubectl port-forward my-pod 8080:80`	PortForwardEquivalent.java
`kubectl get pods --selector=version=v1 -o jsonpath='{.items[*].metadata.name}'`	PodListFilterByLabel.java
`kubectl get pods --field-selector=status.phase=Running`	PodListFilterFieldSelector.java
`kubectl get pods --show-labels`	PodShowLabels.java
`kubectl label pods my-pod new-label=awesome`	PodAddLabel.java
`kubectl annotate pods my-pod icon-url=http://goo.gl/XXBTWq`	PodAddAnnotation.java
`kubectl get configmap cm1 -o jsonpath='{.data.database}'`	ConfigMapJsonPathEquivalent.java
`kubectl create -f test-svc.yaml`	LoadAndCreateService.java
`kubectl create -f test-deploy.yaml`	LoadAndCreateDeployment.java
`kubectl set image deploy/d1 nginx=nginx:v2`	RolloutSetImageEquivalent.java
`kubectl scale --replicas=4 deploy/nginx-deployment`	ScaleEquivalent.java
`kubectl scale statefulset --selector=app=my-database --replicas=4`	ScaleWithLabelsEquivalent.java
`kubectl rollout restart deploy/d1`	RolloutRestartEquivalent.java
`kubectl rollout pause deploy/d1`	RolloutPauseEquivalent.java
`kubectl rollout resume deploy/d1`	RolloutResumeEquivalent.java
`kubectl rollout undo deploy/d1`	RolloutUndoEquivalent.java
`kubectl create -f test-crd.yaml`	LoadAndCreateCustomResourceDefinition.java
`kubectl create -f customresource.yaml`	CustomResourceCreateDemo.java
`kubectl create -f customresource.yaml`	CustomResourceCreateDemoTypeless.java
`kubectl get ns`	NamespaceListEquivalent.java
`kubectl apply -f test-resource-list.yml`	CreateOrReplaceResourceList.java
`kubectl get events`	EventsGetEquivalent.java
`kubectl top nodes`	TopEquivalent.java
`kubectl auth can-i create deployment.apps`	CanIEquivalent.java
`kubectl create -f test-csr-v1.yml`	CertificateSigningRequestCreateYamlEquivalent.java
`kubectl certificate approve my-cert`	CertificateSigningRequestApproveYamlEquivalent.java
`kubectl certificate deny my-cert`	CertificateSigningRequestDenyYamlEquivalent.java