前言
在 Fabric8操作Kubernetes(一) 一文中我们介绍了初始化 KubernetesClient
的方法。今天我们一起来学习一下如果通过 KubernetesClient 创建各种资源对象
。
Pods
通过 client.pods()
可以实现对 Pods 的操作。下面是一些常用方法:
- 从yaml文件创建 Pod:
Pod myPod = client.pods().load(new FileInputStream("some-pod.yml")).get();
- 列出指定 Namespace 下的所有
Pod
对象:
PodList podList = client.pods().inNamespace("default").list();
- 列出所有 Namespace 下的所有
Pod
对象:
PodList podList = client.pods().inAnyNamespace().list();
- 列出所有包含指定标签的
Pod
对象:
PodList podList = client.pods().inNamespace("default").withLabel("foo", "bar").list();
- 根据名称获取
Pod
对象:
Pod myPod = client.pods().inNamespace("default").withName("nginx-pod").get();
- 创建一个
Pod
:
Pod aPod = new PodBuilder().withNewMetadata().withName("demo-pod1").endMetadata()
.withNewSpec()
.addNewContainer()
.withName("nginx")
.withImage("nginx:1.7.9")
.addNewPort().withContainerPort(80).endPort()
.endContainer()
.endSpec()
.build();
Pod createdPod = client.pods().inNamespace("default").create(aPod);
- 创建或替换已存在的
Pod
对象:
client.pods().inNamespace("default").createOrReplace(aPod);
- Create or Replace some
Pod
on the fly withBuilder
:
client.pods().inNamespace("default").createOrReplaceWithNew()
.withNewMetadata().withName("demo-pod1").endMetadata()
.withNewSpec()
.addNewContainer()
.withName("nginx")
.withImage("nginx:1.7.9")
.addNewPort().withContainerPort(80).endPort()
.endContainer()
.endSpec()
.done();
- 编辑一个
Pod
对象:
client.pods().inNamespace("default").withName("nginx").edit()
.editOrNewMetadata().addToLabels("new","label").endMetadata().done()
- 获取
Pod
对象的日志输出:
String log = client.pods().inNamespace("default").withName("test-pod").getLog();
- 监听
Pod
日志输出:
LogWatch watch = client.pods().inNamespace(namespace).withName(podName).tailingLines(10).watchLog(System.out);
- 删除一个
Pod
:
Boolean isDeleted = client.pods().inNamespace("default").withName("nginx").delete();
- 删除多个
Pod
对象:
Boolean isDeleted = client.pods().inNamespace("default").delete(pod1, pod2);
- 等待
Pod
ready:
Pod pod = client.pods().inNamespace("default").withName("nginx").waitUntilReady(5, TimeUnit.MINUTES);
- 等待
Pod
达成某些条件:
Pod pod = client.pods().inNamespace("default").withName("nginx").waitUntilCondition(pod -> pod.getStatus().getPhase().equals("Succeeded"), 1, TimeUnit.MINUTES)
- 代理
Pod
的端口:
int containerPort = client.pods().inNamespace("default").withName("testpod").get().getSpec().getContainers().get(0).getPorts().get(0).getContainerPort();
LocalPortForward portForward = client.pods().inNamespace("default").withName("testpod").portForward(containerPort, 8080);
- 监听
Pod
:
final CountDownLatch deleteLatch = new CountDownLatch(1);
Watch watch = client.pods().withName("pod1").watch(new Watcher<Pod>() {
@Override
public void eventReceived(Action action, Pod resource) {
switch (action) {
case DELETED:
deleteLatch.countDown();
}
}
@Override
public void onClose(KubernetesClientException cause) { }
});
deleteLatch.await(10, TimeUnit.MINUTES)
- 上传一个文件到
Pod
中:
client.pods().inNamespace(currentNamespace).withName(pod1.getMetadata().getName())
.file("/tmp/toBeUploaded").upload(tmpFile.toPath());
- 读取
Pod
中指定的文件:
try (InputStream is = client.pods().inNamespace(currentNamespace).withName(pod1.getMetadata().getName()).file("/msg").read()) {
String result = new BufferedReader(new InputStreamReader(is)).lines().collect(Collectors.joining("\n"));
}
Service
通过 client.services()
可以实现对 Service 的操作。下面是一些常用方法:
- 从yaml文件中加载一个
Service
:
Service aService = client.services().load(new FileInputStream("service.yml")).get();
- 根据名称获取
Service
:
Service service = client.services().inNamespace("default").withName("some-service").get();
- 创建一个
Service
:
Service createdSvc = client.services().inNamespace("default").create(svc);
- 创建或替换一个已存在的
Service
:
Service createdSvc = client.services().inNamespace("default").createOrReplace(svc);
- 通过 Builders 创建或替换一个已存在的
Service
:
Service createdSvc = client.services().inNamespace("default").createOrReplaceWithNew()
.withNewMetadata().withName("svc2").endMetadata()
.withNewSpec().withType("ExternalName").withExternalName("my.database.example.com")
.addNewPort().withName("80").withProtocol("TCP").withPort(80).endPort()
.endSpec()
.withNewStatus()
.withNewLoadBalancer()
.addNewIngress()
.withIp("146.148.47.155")
.endIngress()
.endLoadBalancer()
.endStatus()
.done();
- 列出指定 namespace 下的所有
Service
对象:
ServiceList svcList = client.services().inNamespace("default").list();
- 列出所有 namespace 下的所有
Service
对象:
ServiceList svcList = client.services().inAnyNamespace().list();
- 列出包含指定标签的所有
Service
对象:
ServiceList svcList = client.services().inNamespace("default").withLabel("foo", "bar").list();
- 删除一个
Service
:
Boolean isDeleted = client.services().inNamespace("default").withName("some-svc").delete();
- 监听
Service
:
client.services().inNamespace("default").watch(new Watcher<Service>() {
@Override
public void eventReceived(Action action, Service resource) {
// Perform something depending upon action
}
@Override
public void onClose(KubernetesClientException cause) {
}
});
Deployment
通过 client.apps().deployment()
可以实现对 Deployment 的操作。下面是一些常用方法:
- 通过yaml文件生成
Deployment
对象:
Deployment aDeployment = client.apps().deployments().load(new FileInputStream("test-deployments.yml")).get();
- 通过名称获取
Deployment
对象:
Deployment deploy = client.apps().deployments().inNamespace("default").withName("deploy-1").get();
- 创建一个
Deployment
:
Deployment deployment1 = new DeploymentBuilder()
.withNewMetadata()
.withName("deployment1")
.addToLabels("test", "deployment")
.endMetadata()
.withNewSpec()
.withReplicas(1)
.withNewTemplate()
.withNewMetadata()
.addToLabels("app", "httpd")
.endMetadata()
.withNewSpec()
.addNewContainer()
.withName("busybox")
.withImage("busybox")
.withCommand("sleep","36000")
.endContainer()
.endSpec()
.endTemplate()
.withNewSelector()
.addToMatchLabels("app","httpd")
.endSelector()
.endSpec()
.build();
client.apps().deployments().inNamespace("default").create(deployment1);
- 创建或替换一个已存在的
Deployment
:
Deployment createdDeployment = client.apps().deployments().inNamespace("default").createOrReplace(deployObj);
- 通过 builders 创建或更新一个已存在的
Deployment
:
client.apps().deployments().inNamespace("default").createOrReplaceWithNew()
.withNewMetadata()
.withName("deployment1")
.addToLabels("test", "deployment")
.endMetadata()
.withNewSpec()
.withReplicas(1)
.withNewTemplate()
.withNewMetadata()
.addToLabels("app", "httpd")
.endMetadata()
.withNewSpec()
.addNewContainer()
.withName("busybox")
.withImage("busybox")
.withCommand("sleep","36000")
.endContainer()
.endSpec()
.endTemplate()
.withNewSelector()
.addToMatchLabels("app","httpd")
.endSelector()
.endSpec()
.done();
- 列出指定 Namespace 下的所有
Deployment
对象:
DeploymentList aDeploymentList = client.apps().deployments().inNamespace("default").list();
- 列出所有 Namespace 下的所有
Deployment
对象:
DeploymentList aDeploymentList = client.apps().deployments().inAnyNamespace().list();
- 列出包含指定标签的所有
Deployment
对象:
DeploymentList aDeployList = client.apps().deployments().inNamespace("default").withLabel("foo", "bar").list();
- 编辑
Deployment
:
// Scales Deployment to 2 replicas
Deployment updatedDeploy = client.apps().deployments().inNamespace("default")
.withName("deployment1").edit()
.editSpec().withReplicas(2).endSpec().done();
- 更新
Deployment
中一个容器的镜像:
Deployment updatedDeployment = client.apps().deployments().inNamespace("default").withName("ngix-controller")
.rolling().updateImage("docker.io/nginx:latest");
- 更新
Deployment
中多个容器的镜像:
Map<String, String> containerToImageMap = new HashMap<>();
containerToImageMap.put("nginx", "nginx:perl");
containerToImageMap.put("sidecar", "someImage:someVersion");
Deployment updatedDeployment = client.apps().deployments()
.inNamespace("default")
.withName("nginx-deployment")
.rolling()
.updateImage(containerToImageMap);
- 滚动更新
Deployment
:
Deployment deployment = client.apps().deployments()
.inNamespace("default")
.withName("nginx-deployment")
.rolling()
.restart();
- 暂停滚动更新
Deployment
:
Deployment deployment = client.apps().deployments()
.inNamespace("default")
.withName("nginx-deployment")
.rolling()
.pause();
- 恢复滚动更新
Deployment
:
Deployment deployment = client.apps().deployments()
.inNamespace("default")
.withName("nginx-deployment")
.rolling()
.resume();
- 回滚
Deployment
:
Deployment deployment = client.apps().deployments()
.inNamespace("default")
.withName("nginx-deployment")
.rolling()
.undo();
- 删除
Deployment
:
Boolean isDeleted = client.apps().deployments().inNamespace("default").withName("foo").delete();
- 监听
Deployment
:
client.apps().deployments().inNamespace("default").watch(new Watcher<Deployment>() {
@Override
public void eventReceived(Action action, Deployment resource) {
// Do stuff depending upon action
}
@Override
public void onClose(KubernetesClientException cause) {
}
});
- 扩容或缩容
Deployment
:
client.apps().deployments().inNamespace("default").withName("nginx-deployment").scale(1);
- 查看
Deployment
日志输出:
client.apps().deployments().inNamespace("default").withName("nginx").watchLog(System.out);
ReplicaSet
通过 client.apps().replicaSets()
可以实现对 ReplicaSet 的操作。下面是一些常用方法:
- 通过yaml文件生成
ReplicaSet
对象:
ReplicaSet replicaSet = client.apps().replicaSets().inNamespace("default")
.load(new FileInputStream("test-replicaset.yml")).get();
- 根据名称获取
ReplicaSet
:
ReplicaSet rs = client.apps().replicaSets().inNamespace("default").withName("rs1").get();
- 创建一个
ReplicaSet
对象:
ReplicaSet replicaset1 = new ReplicaSetBuilder()
.withNewMetadata()
.withName("replicaset1")
.addToLabels("app", "guestbook")
.addToLabels("tier", "frontend")
.endMetadata()
.withNewSpec()
.withReplicas(1)
.withNewSelector()
.withMatchLabels(Collections.singletonMap("tier", "frontend"))
.endSelector()
.withNewTemplate()
.withNewMetadata()
.addToLabels("app", "guestbook")
.addToLabels("tier", "frontend")
.endMetadata()
.withNewSpec()
.addNewContainer()
.withName("busybox")
.withImage("busybox")
.withCommand("sleep","36000")
.withNewResources()
.withRequests(requests)
.endResources()
.withEnv(envVarList)
.endContainer()
.endSpec()
.endTemplate()
.endSpec()
.build();
client.apps().replicaSets().inNamespace("default").create(replicaset1);
- 创建或替换一个已存在的
ReplicaSet
对象:
ReplicaSet rs = client.apps().replicaSets().inNamespace("default").createOrReplace(replicaSet);
- 通过 builders 创建或替换一个已存在的
ReplicaSet
对象:
ReplicaSet rs = client.apps().replicaSets().inNamespace("default").createOrReplaceWithNew()
.withNewMetadata()
.withName("replicaset1")
.addToLabels("app", "guestbook")
.addToLabels("tier", "frontend")
.endMetadata()
.withNewSpec()
.withReplicas(1)
.withNewSelector()
.withMatchLabels(Collections.singletonMap("tier", "frontend"))
.endSelector()
.withNewTemplate()
.withNewMetadata()
.addToLabels("app", "guestbook")
.addToLabels("tier", "frontend")
.endMetadata()
.withNewSpec()
.addNewContainer()
.withName("busybox")
.withImage("busybox")
.withCommand("sleep","36000")
.withNewResources()
.withRequests(requests)
.endResources()
.withEnv(envVarList)
.endContainer()
.endSpec()
.endTemplate()
.endSpec()
.done();
- 列出指定 Namespace 下的所有
ReplicaSet
对象:
ReplicaSetList rsList = client.apps().replicaSets().inNamespace("default").list();
- 列出所有 Namespace 下的所有
ReplicaSet
对象:
ReplicaSetList rsList = client.apps().replicaSets().inAnyNamespace().list();
- 列出包含指定标签的
ReplicaSet
对象:
ReplicaSetList rsList = client.apps().replicaSets().inNamespace("default").withLabel("foo", "bar").list();
- 删除
ReplicaSet
:
Boolean isDeleted = client.apps().replicaSets().inNamespace("default").withName("rs1").delete();
- 监听
ReplicaSet
:
client.apps().replicaSets().inNamespace("default").watch(new Watcher<ReplicaSet>() {
@Override
public void eventReceived(Action action, ReplicaSet resource) {
// Do some stuff depending upon action type
}
@Override
public void onClose(KubernetesClientException cause) {
}
});
- 扩容或缩容
ReplicaSet
:
// Scale to 3 replicas
client.apps().replicaSets().inNamespace("default").withName("nginx-rs").scale(3);
- 更新
ReplicaSet
的镜像:
ReplicaSet replicaSet = client.apps().replicaSets()
.inNamespace("default")
.withName("soaktestrs")
.rolling()
.updateImage("nickchase/soaktest");
- 更新
ReplicaSet
中多个容器的镜像:
Map<String, String> containerToImageMap = new HashMap<>();
containerToImageMap.put("c1", "image1");
containerToImageMap.put("c2", "image2");
ReplicaSet replicaSet = client.apps().replicaSets()
.inNamespace("default")
.withName("soaktestrs")
.rolling()
.updateImage(containerToImageMap);
ReplicationController
通过 client.replicationControllers()
可以实现对 ReplicationController 的操作。下面是一些常用方法:
- 通过yaml文件生成
ReplicationController
对象:
ReplicationController aReplicationController = client.replicationControllers().inNamespace("default")
.load(new FileInputStream("/test-replicationcontroller.yml")).get();
- 根据名称获取
ReplicationController
对象:
ReplicationController rc = client.replicationControllers().inNamespace("default").withName("nginx-controller").get();
- 创建
ReplicationController
对象:
ReplicationController rc1 = new ReplicationControllerBuilder()
.withNewMetadata().withName("nginx-controller").addToLabels("server", "nginx").endMetadata()
.withNewSpec().withReplicas(3)
.withNewTemplate()
.withNewMetadata().addToLabels("server", "nginx").endMetadata()
.withNewSpec()
.addNewContainer().withName("nginx").withImage("nginx")
.addNewPort().withContainerPort(80).endPort()
.endContainer()
.endSpec()
.endTemplate()
.endSpec().build();
ReplicationController rc = client.replicationControllers().inNamespace("default").create(rc1);
- 创建或替换一个已存在的
ReplicationController
对象:
ReplicationController rc = client.replicationControllers().inNamespace("default").createOrReplace(rc1);
- 通过 builders 创建或替换一个已存在的
ReplicationController
对象:
ReplicationController rc = client.replicationControllers().inNamespace("default").createOrReplaceWithNew()
.withNewMetadata().withName("nginx-controller").addToLabels("server", "nginx").endMetadata()
.withNewSpec().withReplicas(3)
.withNewTemplate()
.withNewMetadata().addToLabels("server", "nginx").endMetadata()
.withNewSpec()
.addNewContainer().withName("nginx").withImage("nginx")
.addNewPort().withContainerPort(80).endPort()
.endContainer()
.endSpec()
.endTemplate()
.endSpec().done();
- 列出指定命名空间下的所有
ReplicationController
对象:
ReplicationControllerList rcList = client.replicationControllers().inNamespace("default").list();
- 列出所有命名空间下的所有
ReplicationController
对象:
ReplicationControllerList rcList = client.replicationControllers().inAnyNamespace("default").list();
- 列出包含指定标签的
ReplicationController
对象:
ReplicationControllerList rcList = client.replicationControllers().inNamespace("default").withLabel("foo", "bar").list();
- 删除
ReplicationController
:
Boolean isDeleted = client.replicationControlers().inNamespace("default").withName("nginx-controller").delete();
- 监听
ReplicationController
:
client.replicationControllers().inNamespace(currentNamespace).watch(new Watcher<ReplicationController>() {
@Override
public void eventReceived(Action action, ReplicationController resource) {
// Do something depending upon action type
}
@Override
public void onClose(KubernetesClientException cause) {
}
});
- 扩容或缩容
ReplicationController
:
ReplicationController rc = client.replicationControllers().inNamespace("default").withName("nginx-controller").scale(2);
- 更新
ReplicationController
的镜像:
ReplicationController rc = client.replicationControllers()
.inNamespace("default")
.withName("nginx")
.rolling()
.updateImage("nginx:latest");
- 更新
ReplicationController
多个容器的镜像:
Map<String, String> containerToImageMap = new HashMap<>();
containerToImageMap.put("c1", "image1");
containerToImageMap.put("c2", "image2");
ReplicationController rc = client.replicationControllers()
.inNamespace("default")
.withName("nginx")
.rolling()
.updateImage(controllerToImageMap);
ConfigMap
ConfigMap
resource is available in Kubernetes Client api via the client.configMaps()
. Here are some examples of common usage:
- Load
ConfigMap
object from yaml:
ConfigMap configMap = client.configMaps().load(new FileInputStream("configmap1.yml")).get();
- Get
ConfigMap
from API server:
ConfigMap configMap = client.configMaps().inNamespace("default").withName("configmap1").get();
- Create
ConfigMap
:
ConfigMap configMap1 = new ConfigMapBuilder()
.withNewMetadata().withName("configmap1").endMetadata()
.addToData("1", "one")
.addToData("2", "two")
.addToData("3", "three")
.build();
ConfigMap configMap = client.configMaps().inNamespace("default").create(configMap1);
- Create or Replace some existing
ConfigMap
:
ConfigMap configMap = client.configMaps().inNamespace("default").createOrReplace(configMap1);
- Create or Replace some
ConfigMap
with builders:
ConfigMap configMap = client.configMaps().inNamespace("default").createOrReplaceWithNew()
.withNewMetadata().withName("configmap1").endMetadata()
.addToData("1", "one")
.addToData("2", "two")
.addToData("3", "three")
.done();
- List
ConfigMap
objects in some namespace:
ConfigMapList configMapList = client.configMaps().inNamespace("default").list();
- List
ConfigMap
objects in any namespace:
ConfigMapList configMapList = client.configMaps().inAnyNamespace().list();
- List
ConfigMap
objects in some namespace with some labels:
ConfigMapList configMapList = client.configMaps().inNamespace("default").withLabel("foo", "bar").list();
- Delete
ConfigMap
:
Boolean isDeleted = client.configMaps().inNamespace("default").withName("configmap1").delete();
- Watch
ConfigMap
:
client.configMaps().inNamespace("default").watch(new Watcher<ConfigMap>() {
@Override
public void eventReceived(Action action, ConfigMap resource) {
// Do something depending upon action type
}
@Override
public void onClose(KubernetesClientException cause) {
}
});
- Update
ConfigMap
:
ConfigMap configMap1 = client.configMaps().inNamespace(currentNamespace).withName("configmap1").edit()
.addToData("4", "four").done();
Secret
Secret
resource is available in Kubernetes Client api via client.secrets()
. Here are some of the examples of it's common usages:
- Load
Secret
from yaml:
Secret aSecret = client.secrets().inNamespace("default").load(new FileInputStream("test-secret.yml")).get();
- Get a
Secret
from API server:
Secret secret = client.secrets().inNamespace("default").withName("secret1").get()
- Create a
Secret
:
Secret secret1 = new SecretBuilder()
.withNewMetadata().withName("secret1").endMetadata()
.addToData("username", "guccifer")
.addToData("password", "shadowgovernment")
.build();
Secret secretCreated = client.secrets().inNamespace("default").create(secret1);
- Create or Replace an existing
Secret
:
Secret createdSecret = client.secrets().inNamespace("default").createOrReplace(secret1);
- Create or Replace
Secret
with builder:
Secret createdSecret = client.secrets().inNamespace("default").createOrReplaceWithNew()
.withNewMetadata().withName("secret1").endMetadata()
.addToData("username", "guccifer")
.addToData("password", "shadowgovernment")
.done();
- List
Secret
resources in some namespace:
SecretList secretList = client.secrets().inNamespace("default").list();
- List
Secret
resources in any namespace:
SecretList secretList = client.secrets().inAnyNamespace().list();
- List
Secret
resources in some namespace with some label:
SecretList secretList = client.secrets().inNamespace("default").withLabel("foo", "bar").list();
- Edit
Secret
:
Secret secret1 = client.secrets().inNamespace(currentNamespace).withName("secret1").edit()
.withType("Opaque")
.done();
- Delete
Secret
:
Boolean isDeleted = client.secrets().inNamespace("default").withName("secret1").delete();
- Watch
Secret
:
client.secrets().inNamespace("default").watch(new Watcher<Secret>() {
@Override
public void eventReceived(Action action, Secret resource) {
// Do something depending upon action type
}
@Override
public void onClose(KubernetesClientException cause) {
}
});
Job
Job
resource is available in Kubernetes Client API via client.batch().jobs()
. Here are some of the examples of common usage:
- Loading a
Job
from yaml:
Job job = client.batch().jobs().load(new FileInputStream("sample-job.yml")).get();
- Get a
Job
resource with some name from API server:
Job job = client.batch().jobs().inNamespace("default").withName("pi").get();
- Create
Job
:
final Job job = new JobBuilder()
.withApiVersion("batch/v1")
.withNewMetadata()
.withName("pi")
.withLabels(Collections.singletonMap("label1", "maximum-length-of-63-characters"))
.withAnnotations(Collections.singletonMap("annotation1", "some-very-long-annotation"))
.endMetadata()
.withNewSpec()
.withNewTemplate()
.withNewSpec()
.addNewContainer()
.withName("pi")
.withImage("perl")
.withArgs("perl", "-Mbignum=bpi", "-wle", "print bpi(2000)")
.endContainer()
.withRestartPolicy("Never")
.endSpec()
.endTemplate()
.endSpec()
.build();
client.batch().jobs().inNamespace("default").create(job);
- Create or Replace an existing
Job
:
Job job = client.batch().jobs().inNamespace("default").createOrReplace(job);
- Create or Replace an existing
Job
with builder:
Job job = client.batch().jobs().inNamespace("default").createOrReplaceWithNew()
.withApiVersion("batch/v1")
.withNewMetadata()
.withName("pi")
.withLabels(Collections.singletonMap("label1", "maximum-length-of-63-characters"))
.withAnnotations(Collections.singletonMap("annotation1", "some-very-long-annotation"))
.endMetadata()
.withNewSpec()
.withNewTemplate()
.withNewSpec()
.addNewContainer()
.withName("pi")
.withImage("perl")
.withArgs("perl", "-Mbignum=bpi", "-wle", "print bpi(2000)")
.endContainer()
.withRestartPolicy("Never")
.endSpec()
.endTemplate()
.endSpec()
.done();
- List
Job
in some namespace:
JobList jobList = client.batch().jobs().inNamespace("default").list();
- List
Job
in any namespace:
JobList jobList = client.batch().jobs().inAnyNamespace().list();
- List
Job
resources in some namespace with some labels:
JobList jobList = client.batch().jobs().inNamespace("default").withLabel("foo", "bar").list();
- Delete
Job
:
Boolean isDeleted = client.batch().jobs().inNamespace("default").withName("pi").delete();
- Watch
Job
:
client.batch().jobs().inNamespace("default").watch(new Watcher<Job>() {
@Override
public void eventReceived(Action action, Job resource) {
// Do something depending upon action
}
@Override
public void onClose(KubernetesClientException cause) {
}
})
CronJob
CronJob
resource is available in Kubernetes Client api via client.batch().cronjobs()
. Here are some of the examples of its usages:
- Load
CronJob
from yaml:
CronJob cronJob = client.batch().cronjobs().load(new FileInputStream("cronjob.yml")).get();
- Get a
CronJob
from Kubernetes API server:
CronJob aCronJob = client.batch().cronjobs().inNamespace("default").withName("some-cj").get();
- Create
CronJob
:
CronJob cronJob1 = new CronJobBuilder()
.withApiVersion("batch/v1beta1")
.withNewMetadata()
.withName("hello")
.withLabels(Collections.singletonMap("foo", "bar"))
.endMetadata()
.withNewSpec()
.withSchedule("*/1 * * * *")
.withNewJobTemplate()
.withNewSpec()
.withNewTemplate()
.withNewSpec()
.addNewContainer()
.withName("hello")
.withImage("busybox")
.withArgs("/bin/sh", "-c", "date; echo Hello from Kubernetes")
.endContainer()
.withRestartPolicy("OnFailure")
.endSpec()
.endTemplate()
.endSpec()
.endJobTemplate()
.endSpec()
.build();
cronJob1 = client.batch().cronjobs().inNamespace("default").create(cronJob1);
- Create or Replace an existing
CronJob
:
CronJob cronJob = client.batch().cronjobs().inNamespace("default").createOrReplace(cronJob1);
- Create or Replace
CronJob
with builders:
CronJob cronJob = client.batch().cronjobs().inNamespace("default").createOrReplaceWithNew()
.withApiVersion("batch/v1beta1")
.withNewMetadata()
.withName("hello")
.withLabels(Collections.singletonMap("foo", "bar"))
.endMetadata()
.withNewSpec()
.withSchedule("*/1 * * * *")
.withNewJobTemplate()
.withNewSpec()
.withNewTemplate()
.withNewSpec()
.addNewContainer()
.withName("hello")
.withImage("busybox")
.withArgs("/bin/sh", "-c", "date; echo Hello from Kubernetes")
.endContainer()
.withRestartPolicy("OnFailure")
.endSpec()
.endTemplate()
.endSpec()
.endJobTemplate()
.endSpec()
.done();
- List some
CronJob
objects in some namespace:
CronJobList cronJobList = client.batch().cronjobs().inNamespace("default").list()
- List some
CronJob
objects in any namespace:
CronJobList cronJobList = client.batch().cronjobs().inAnyNamespace().list();
- List some
CronJob
objects in some namespace with some label:
CronJobList cronJobList = client.batch().cronjobs().inNamespace("default").withLabel("foo", "bar").list();
- Edit/Update
CronJob
:
CronJob cronJob1 = client.batch().cronjobs().inNamespace("default").withName(cronJob1.getMetadata().getName())
.edit()
.editSpec()
.withSchedule("*/1 * * * *")
.endSpec()
.done();
- Delete
CronJob
:
Boolean isDeleted = client.batch().cronjobs().inNamespace("default").withName("pi").delete();
Namespace
Namespace
is available in Kubernetes Client API via client.namespaces()
. Here are some of the common usages:
- Load
Namespace
from yaml:
Namespace namespace = client.namespaces().load(new FileInputStream("namespace-test.yml")).get();
- Get
Namespace
from Kubernetes API server:
Namespace namespace = client.namespaces().withName("namespace1").get();
- List
Namespace
objects:
NamespaceList namespaceList = client.namespaces().list();
- List
Namespace
objects with some labels:
NamespaceList namespaceList = client.namespaces().withLabel("key1", "value1").list();
- Delete
Namespace
objects:
Boolean isDeleted = client.namespaces().withName("ns1").delete();
ServiceAccount
ServiceAccount
resource is available in Kubernetes Client API via client.serviceAccounts()
. Here are some examples of it's usage:
- Load
ServiceAccount
from yaml:
ServiceAccount svcAccount = client.serviceAccounts().inNamespace("default")
.load(new FileInputStream("sa.yml")).get();
- Get
ServiceAccount
from Kubernetes API server:
ServiceAccount sa = client.serviceAccounts().inNamespace("default").withName("sa-ribbon").get();
- Create
ServiceAccount
:
ServiceAccount serviceAccount1 = new ServiceAccountBuilder()
.withNewMetadata().withName("serviceaccount1").endMetadata()
.withAutomountServiceAccountToken(false)
.build();
client.serviceAccounts().inNamespace("default").create(serviceAccount1);
- Create or Replace
ServiceAccount
:
ServiceAccount serviceAccount = client.serviceAccounts().inNamespace("default").createOrReplace(serviceAccount1);
- Create or Replace
ServiceAccount
with builders:
ServiceAccount serviceAccount = client.serviceAccounts().inNamespace("default").createOrReplaceWithNew()
.withNewMetadata().withName("serviceaccount1").endMetadata()
.withAutomountServiceAccountToken(false)
.done();
- List
ServiceAccount
in some specific namespace:
ServiceAccountList svcAccountList = client.serviceAccounts().inNamespace("default").list();
- List
ServiceAccount
in some namespace with labels:
ServiceAccountList saList = client.serviceAccounts().inNamespace("default").withLabel("foo", "bar").list();
- Update/Edit
ServiceAccount
:
ServiceAccount serviceAccount1 = client.serviceAccounts().inNamespace("default").withName("serviceaccount1").edit()
.addNewSecret().withName("default-token-uudp").endSecret()
.addNewImagePullSecret().withName("myregistrykey").endImagePullSecret()
.done();
- Delete
ServiceAccount
:
Boolean bDeleted = client.serviceAccounts().inNamespace("default").withName("serviceaccount1").delete();
Ingress
Ingress
resource is available in Kubernetes Client API via client.network().ingress()
. Here are some examples regarding its usage:
- Load
Ingress
from yaml:
Ingress ingress = client.network().ingress().load(new FileInputStream("ingress.yml")).get();
- Get
Ingress
from Kubernetes API server:
Ingress ingress = client.network().ingress().inNamespace("default").withName("ingress1").get();
- Create
Ingress
:
Ingress ingress = new IngressBuilder()
.withNewMetadata().withName("test-ingress").addToAnnotations("nginx.ingress.kubernetes.io/rewrite-target", "/").endMetadata()
.withNewSpec()
.addNewRule()
.withNewHttp()
.addNewPath()
.withPath("/testPath").withNewBackend().withServiceName("test").withServicePort(new IntOrString(80)).endBackend()
.endPath()
.endHttp()
.endRule()
.endSpec()
.build();
client.network().ingress().inNamespace("default").create(ingress);
- Create or Replace
Ingress
:
Ingress igx = client.network().ingress().inNamespace("default").createOrReplace(ingress);
- Create or Replace
Ingress
with Builders:
Ingress igx = client.network().ingress().inNamespace("default").createOrReplaceWithNew()
.withNewMetadata().withName("test-ingress").addToAnnotations("nginx.ingress.kubernetes.io/rewrite-target", "/").endMetadata()
.withNewSpec()
.addNewRule()
.withNewHttp()
.addNewPath()
.withPath("/testPath").withNewBackend().withServiceName("test").withServicePort(new IntOrString(80)).endBackend()
.endPath()
.endHttp()
.endRule()
.endSpec()
.done();
- List
Ingress
in some namespace:
IngressList ingressList = client.network().ingress().inNamespace("default").list();
- List
Ingress
in any namespace:
IngressList ingressList = client.network().ingress().inAnyNamespace().list();
- List
Ingress
with some label in any namespace:
IngressList ingressList = client.network().ingress().inNamespace("default").withLabel("foo", "bar").list();
- Delete
Ingress
:
Boolean isDeleted = client.network().ingress().inNamespace("default").withName("ingress1").delete();
StatefulSet
StatefulSet
resource is available in Kubernetes API via client.apps().statefulsets()
. Here are some examples of its common usages:
- Load
StatefulSet
from yaml:
StatefulSet aStatefulSet = client.apps().statefulSets()
.load(new FileInputStream("test-statefulset.yml")).get();
- Get a
StatefulSet
from Kubernetes API server:
StatefulSet ss1 = client.apps().statefulSets().inNamespace("default").withName("ss1").get();
- Create a
StatefulSet
:
StatefulSet ss1 = new StatefulSetBuilder()
.withNewMetadata().withName("ss1").endMetadata()
.withNewSpec()
.withReplicas(2)
.withNewSelector().withMatchLabels(Collections.singletonMap("app", "nginx")).endSelector()
.withNewTemplate()
.withNewMetadata()
.addToLabels("app", "nginx")
.endMetadata()
.withNewSpec()
.addNewContainer()
.withName("nginx")
.withImage("nginx")
.addNewPort()
.withContainerPort(80)
.withName("web")
.endPort()
.addNewVolumeMount()
.withName("www")
.withMountPath("/usr/share/nginx/html")
.endVolumeMount()
.endContainer()
.endSpec()
.endTemplate()
.addNewVolumeClaimTemplate()
.withNewMetadata()
.withName("www")
.endMetadata()
.withNewSpec()
.addToAccessModes("ReadWriteOnce")
.withNewResources()
.withRequests(Collections.singletonMap("storage", new Quantity("1Gi")))
.endResources()
.endSpec()
.endVolumeClaimTemplate()
.endSpec()
.build();
StatefulSet ss = client.apps().statefulSets().inNamespace("default").create(ss1);
- Create or Replace an existing
StatefulSet
:
StatefulSet ss = client.apps().statefulSets().inNamespace("default").createOrReplace(ss1);
- List
StatefulSet
in some particular namespace:
StatefulSetList statefulSetList = client.apps().statefulSets().inNamespace("default").list();
- List
StatefulSet
in any namespace:
StatefulSetList statefulSetList = client.apps().statefulSets().inAnyNamespace().list();
- List
StatefulSet
in some namespace with label:
StatefulSetList statefulSetList = client.apps().statefulSets().inNamespace("default").withLabel("foo", "bar").list();
- Delete
StatefulSet
:
Boolean bDeleted = client.apps().statefulSets().inNamespace("default").withName("ss1").delete();
- Scale
StatefulSet
:
client.apps().statefulSets().inNamespace("default").withName("ss1").scale(2);
- Watch
StatefulSet
:
client.apps().statefulSets().inNamespace("default").withName("ss1").watch(new Watcher<StatefulSet>() {
@Override
public void eventReceived(Action action, StatefulSet resource) {
// Do something on action type
}
@Override
public void onClose(KubernetesClientException cause) {
}
})
- Update Image in
StatefulSet
:
StatefulSet statefulSet = client.apps().statefulSets()
.inNamespace("default")
.withName("web")
.rolling()
.updateImage("nginx:1.19");
- Updated multiple containers in
StatefulSet
:
Map<String, String> containerToImageMap = new HashMap<>();
containerToImageMap("container1", "nginx:1.9");
containerToImageMap("container2", "busybox:latest");
Statefulset statefulSet = client.apps().statefulSets()
.inNamespace("default")
.withName("web")
.rolling()
.updateImage(params);
- Restart Rollout for
StatefulSet
:
StatefulSet ss = client.apps().statefulSets()
.inNamespace("default")
.withName("web")
.rolling()
.restart();
- Pause Rollout for
StatefulSet
:
StatefulSet ss = client.apps().statefulSets()
.inNamespace("default")
.withName("web")
.rolling()
.pause();
- Resume Rollout for
StatefulSet
:
StatefulSet ss = client.apps().statefulSets()
.inNamespace("default")
.withName("web")
.rolling()
.resume();
- Undo Rollout for
StatefulSet
:
StatefulSet ss = client.apps().statefulSets()
.inNamespace("default")
.withName("web")
.rolling()
.undo();
DaemonSet
DaemonSet
resource is available in Kubernetes Client API via client.apps().daemonSets()
. Here are some examples of its common usage:
- Load
DaemonSet
from yaml:
DaemonSet ds = client.apps().daemonSets().load(new FileInputStream("daemonset.yaml")).get();
- Get
DaemonSet
from Kubernetes API server:
DaemonSet ds = client.apps().daemonSets().inNamespace("default").withName("ds1").get();
- Create
DaemonSet
:
DaemonSet ds = new DaemonSetBuilder()
.withNewMetadata().withName("fluentd-elasticsearch").addToLabels("k8s-app", "fluentd-logging").endMetadata()
.withNewSpec()
.withNewSelector()
.addToMatchLabels("name", "fluentd-elasticsearch")
.endSelector()
.withNewTemplate()
.withNewSpec()
.addNewToleration().withKey("node-role.kubernetes.io/master").withEffect("NoSchedule").endToleration()
.addNewContainer()
.withName("fluentd-elasticsearch").withImage("quay.io/fluentd_elasticsearch/fluentd:v2.5.2")
.withNewResources()
.addToLimits(Collections.singletonMap("memory", new Quantity("200Mi")))
.addToRequests(Collections.singletonMap("cpu", new Quantity("100m")))
.endResources()
.addNewVolumeMount().withName("varlog").withMountPath("/var/log").endVolumeMount()
.endContainer()
.withTerminationGracePeriodSeconds(30l)
.addNewVolume()
.withName("varlog").withNewHostPath().withPath("/var/log").endHostPath()
.endVolume()
.endSpec()
.endTemplate()
.endSpec()
.build();
ds = client.apps().daemonSets().inNamespace("default").create(ds);
- Create or Replace existing
DaemonSet
:
DaemonSet ds = client.apps().daemonSets().inNamespace("default").createOrReplace(ds);
- List
DaemonSet
in some namespace:
DaemonSetList dsList = client.apps().daemonSets().inNamespace("default").list();
- List
DaemonSet
in any namespace:
DaemonSetList dsList = client.apps().daemonSets().inAnyNamespace().list();
- List
DaemonSet
with some label:
DaemonSetList dsList = client.apps().daemonSets().inNamespace("default").withLabel("foo", "bar").list();
- Delete
DaemonSet
:
Boolean isDeleted = client.apps().daemonSets().inNamespace("default").withName("ds1").delete();
- Watch
DaemonSet
:
client.apps().daemonSets().inNamespace("default").watch(new Watcher<DaemonSet>() {
@Override
public void eventReceived(Action action, DaemonSet resource) {
// Do something depending upon action type
}
@Override
public void onClose(KubernetesClientException cause) {
}
});
PersistentVolumeClaim
PersistentVolumeClaim
is available in Kubernetes Client API via client.persistentVolumeClaims()
. Here are some examples of it's common usage:
- Load a
PersistentVolumeClaim
from yaml:
PersistentVolumeClaim pvc = client.persistentVolumeClaims().load(new FileInputStream("pvc.yaml")).get();
- Get a
PersistentVolumeClaim
object from Kubernetes API server:
PersistentVolumeClaim pvc = client.persistentVolumeClaims().inNamespace("default").withName("test-pv-claim").get();
- Create
PersistentVolumeClaim
:
PersistentVolumeClaim persistentVolumeClaim = new PersistentVolumeClaimBuilder()
.withNewMetadata().withName("test-pv-claim").endMetadata()
.withNewSpec()
.withStorageClassName("my-local-storage")
.withAccessModes("ReadWriteOnce")
.withNewResources()
.addToRequests("storage", new Quantity("500Gi"))
.endResources()
.endSpec()
.build();
client.persistentVolumeClaims().inNamespace("default").create(persistentVolumeClaim);
- Create or Replace an existing
PersistentVolumeClaim
:
PersistentVolumeClaim pvc = client.persistentVolumeClaims().inNamespace("default").createOrReplace(pvcToCreate);
- Create or Replace an existing
PersistentVolumeClaim
with builders:
PersistentVolumeClaim pvc = client.persistentVolumeClaims().inNamespace("default").createOrReplaceWithNew()
.withNewMetadata().withName("test-pv-claim").endMetadata()
.withNewSpec()
.withStorageClassName("my-local-storage")
.withAccessModes("ReadWriteOnce")
.withNewResources()
.addToRequests("storage", new Quantity("500Gi"))
.endResources()
.endSpec()
.done();
- List
PersistentVolumeClaim
objects in a particular namespace:
PersistentVolumeClaimList pvcList = client.persistentVolumeClaims().inNamespace("default").list();
- List
PersistentVolumeClaim
objects in any namespace:
PersistentVolumeClaimList pvcList = client.persistentVolumeClaims().inAnyNamespace().list();
- List
PersistentVolumeClaim
objects in some namespace with some labels:
PersistentVolumeClaimList pvcList = client.persistentVolumeClaims().inNamespace("default").withLabel("foo", "bar").list();
- Delete
PersistentVolumeClaim
:
Boolean isDeleted = client.persistentVolumeClaims().inNamespace("default").withName("test-pv-claim").delete();
PersistentVolume
PersistentVolume
resource is available in Kubernetes Client API via client.persistentVolumes()
. Here are some of the examples of it's common usage:
- Load a
PersistentVolume
from yaml:
PersistentVolume pv = client.persistentVolumes().load(new FileInputStream("pv.yaml")).get();
- Get a
PersistentVolume
from Kubernetes API server:
PersistentVolume pv = client.persistentVolumes().withName("test-local-pv").get();
- Create
PersistentVolume
:
PersistentVolume pv = new PersistentVolumeBuilder()
.withNewMetadata().withName("test-local-pv").endMetadata()
.withNewSpec()
.addToCapacity(Collections.singletonMap("storage", new Quantity("500Gi")))
.withAccessModes("ReadWriteOnce")
.withPersistentVolumeReclaimPolicy("Retain")
.withStorageClassName("my-local-storage")
.withNewLocal()
.withPath("/mnt/disks/vol1")
.endLocal()
.withNewNodeAffinity()
.withNewRequired()
.addNewNodeSelectorTerm()
.withMatchExpressions(Arrays.asList(new NodeSelectorRequirementBuilder()
.withKey("kubernetes.io/hostname")
.withOperator("In")
.withValues("my-node")
.build()
))
.endNodeSelectorTerm()
.endRequired()
.endNodeAffinity()
.endSpec()
.build();
PersistentVolume pvCreated = client.persistentVolumes().create(pv)
- Create or Replace
PersistentVolume
:
PersistentVolume pv = client.persistentVolumes().createOrReplace(pvToCreate);
- List
PersistentVolume
:
PersistentVolumeList pvList = client.persistentVolumes().list();
- List
PersistentVolume
with some labels:
PersistentVolumeList pvList = client.persistentVolumes().withLabel("foo", "bar").list();
- Delete
PersistentVolume
:
Boolean isDeleted = client.persistentVolumes().withName("test-local-pv").delete();
NetworkPolicy
NetworkPolicy
is available in Kubernetes Client API via client.network().networkPolicies()
. Here are some examples of it's common usages:
- Load a
NetworkPolicy
from yaml:
NetworkPolicy loadedNetworkPolicy = client.network().networkPolicies()
.load(new FileInputStream("/test-networkpolicy.yml")).get();
- Get
NetworkPolicy
from Kubernetes API server:
NetworkPolicy getNetworkPolicy = client.network().networkPolicies()
.withName("networkpolicy").get();
- Create
NetworkPolicy
:
NetworkPolicy networkPolicy = new NetworkPolicyBuilder()
.withNewMetadata()
.withName("networkpolicy")
.addToLabels("foo","bar")
.endMetadata()
.withNewSpec()
.withNewPodSelector()
.addToMatchLabels("role","db")
.endPodSelector()
.addToIngress(0,
new NetworkPolicyIngressRuleBuilder()
.addToFrom(0, new NetworkPolicyPeerBuilder().withNewPodSelector()
.addToMatchLabels("role","frontend").endPodSelector()
.build()
).addToFrom(1, new NetworkPolicyPeerBuilder().withNewNamespaceSelector()
.addToMatchLabels("project","myproject").endNamespaceSelector()
.build()
)
.addToPorts(0,new NetworkPolicyPortBuilder().withPort(new IntOrString(6379))
.withProtocol("TCP").build())
.build()
)
.endSpec()
.build();
NetworkPolicy npCreated = client.network().networkPolicies().create(networkPolicy);
- Create or Replace some existing
NetworkPolicy
:
NetworkPolicy npCreated = client.network().networkPolicies().createOrReplace(networkPolicy);
- List
NetworkPolicy
:
NetworkPolicyList networkPolicyList = client.network().networkPolicies().list();
- List with labels
NetworkPolicy
:
NetworkPolicyList networkPolicyList = client.network().networkPolicies()
.withLabels(Collections.singletonMap("foo","bar")).list();
- Delete
NetworkPolicy
:
Boolean deleted = client.network().networkPolicies().withName("np-test").delete();
PodDisruptionBudget
PodDisruptionBudget
is available in Kubernetes Client API via client.policy().podDisruptionBudget()
. Here are some of the examples of its usage:
- Load
PodDisruptionBudget
from yaml:
PodDisruptionBudget pdb = client.policy().podDisruptionBudget().load(new FileInputStream("/test-pdb.yml")).get();
- Get
PodDisruptionBudget
from Kubernetes API server:
PodDisruptionBudget podDisruptionBudget = client.policy().podDisruptionBudget().inNamespace("default").withName("poddisruptionbudget1").get();
- Create
PodDisruptionBudget
:
PodDisruptionBudget podDisruptionBudget = new PodDisruptionBudgetBuilder()
.withNewMetadata().withName("zk-pkb").endMetadata()
.withNewSpec()
.withMaxUnavailable(new IntOrString("1%"))
.withNewSelector()
.withMatchLabels(Collections.singletonMap("app", "zookeeper"))
.endSelector()
.endSpec()
.build();
client.policy().podDisruptionBudget().inNamespace("default").create(podDisruptionBudget);
- Create or Replace
PodDisruptionBudget
:
PodDisruptionBudget pdb = client.policy().podDisruptionBudget().inNamespace("default").createOrReplace(podDisruptionBudgetObj);
- List
PodDisruptionBudget
in some namespace:
PodDisruptionBudgetList podDisruptionBudgetList = client.policy().podDisruptionBudget().inNamespace("default").list();
- List
PodDisruptionBudget
in any namespace:
PodDisruptionBudgetList pdbList = client.policy().podDisruptionBudget().inAnyNamespace().list();
- List
PodDisruptionBudget
with labels:
PodDisruptionBudgetList pdbList = client.policy().podDisruptionBudget().inNamespace("default").withLabel("foo", "bar").list();
- Delete
PodDisruptionBudget
:
Boolean deleted = client.policy().podDisruptionBudget().inNamespace("default").withName("poddisruptionbudget1").delete();
SelfSubjectAccessReview
- Create
SelfSubjectAccessReview
(equivalent ofkubectl auth can-i create deployments --namespace dev
):
try (KubernetesClient client = new DefaultKubernetesClient()) {
SelfSubjectAccessReview ssar = new SelfSubjectAccessReviewBuilder()
.withNewSpec()
.withNewResourceAttributes()
.withGroup("apps")
.withResource("deployments")
.withVerb("create")
.withNamespace("dev")
.endResourceAttributes()
.endSpec()
.build();
ssar = client.authorization().v1().selfSubjectAccessReview().create(ssar);
System.out.println("Allowed: "+ ssar.getStatus().getAllowed());
}
SubjectAccessReview
- Create
SubjectAccessReview
:
try (KubernetesClient client = new DefaultKubernetesClient()) {
SubjectAccessReview sar = new SubjectAccessReviewBuilder()
.withNewSpec()
.withNewResourceAttributes()
.withGroup("apps")
.withResource("deployments")
.withVerb("create")
.withNamespace("default")
.endResourceAttributes()
.withUser("kubeadmin")
.endSpec()
.build();
sar = client.authorization().v1().subjectAccessReview().create(sar);
System.out.println("Allowed: "+ sar.getStatus().getAllowed());
}
LocalSubjectAccessReview
- Create
LocalSubjectAccessReview
:
try (KubernetesClient client = new DefaultKubernetesClient()) {
LocalSubjectAccessReview lsar = new LocalSubjectAccessReviewBuilder()
.withNewMetadata().withNamespace("default").endMetadata()
.withNewSpec()
.withUser("foo")
.withNewResourceAttributes()
.withNamespace("default")
.withVerb("get")
.withGroup("apps")
.withResource("pods")
.endResourceAttributes()
.endSpec()
.build();
lsar = client.authorization().v1().localSubjectAccessReview().inNamespace("default").create(lsar);
System.out.println(lsar.getStatus().getAllowed());
}
SelfSubjectRulesReview
- Create
SelfSubjectRulesReview
:
try (KubernetesClient client = new DefaultKubernetesClient()) {
SelfSubjectRulesReview selfSubjectRulesReview = new SelfSubjectRulesReviewBuilder()
.withNewMetadata().withName("foo").endMetadata()
.withNewSpec()
.withNamespace("default")
.endSpec()
.build();
selfSubjectRulesReview = client.authorization().v1().selfSubjectRulesReview().create(selfSubjectRulesReview);
System.out.println(selfSubjectRulesReview.getStatus().getIncomplete());
System.out.println("non resource rules: " + selfSubjectRulesReview.getStatus().getNonResourceRules().size());
System.out.println("resource rules: " + selfSubjectRulesReview.getStatus().getResourceRules().size());
}
网友评论