2021年1月14日星期四

Kubernetes官方java客户端之八:fluent style

欢迎访问我的GitHub

https://github.com/zq2599/blog_demos

内容:所有原创文章分类汇总及配套源码,涉及Java、Docker、Kubernetes、DevOPS等;

概览

  1. 本文是《Kubernetes官方java客户端》系列的第八篇,以下提到的java客户端都是指client-jar.jar;
  2. 前文《Kubernetes官方java客户端之七:patch操作》涉及的知识点、代码、操作都太多了,对作者和读者都是莫大的折磨,到了本篇咱们轻松一下,写几段简单流畅的代码,了解java客户端对fluent style编程的支持,并且编码完成后的验证操作也很简单;

关于fluent styel

  1. 也称为fluid coding, fluent programming,是一种增强代码可读性的风格,使得阅读代码时更加自然流畅,特点是函数返回有关类型,使得多个函数的调用前后链接起来。
  2. 关于fluent style可以参考Martin Flowler于2005年发表的文章,地址是:https://martinfowler.com/bliki/FluentInterface.html ,使用fluent style前后的代码对比如下图所示:

3.

源码下载

  1. 如果您不想编码,可以在GitHub下载所有源码,地址和链接信息如下表所示(https://github.com/zq2599/blog_demos):
名称链接备注
项目主页https://github.com/zq2599/blog_demos该项目在GitHub上的主页
git仓库地址(https)https://github.com/zq2599/blog_demos.git该项目源码的仓库地址,https协议
git仓库地址(ssh)git@github.com:zq2599/blog_demos.git该项目源码的仓库地址,ssh协议
  1. 这个git项目中有多个文件夹,本章的应用在kubernetesclient文件夹下,如下图红框所示:
    在这里插入图片描述

实战步骤概述

  1. 在父工程kubernetesclient下面新建名为fluent的子工程;
  2. fluent工程中只有一个类FluentStyleApplication,启动的main方法以及fluent style的代码都在此类中;
  3. FluentStyleApplication.java提供四个web接口,功能分别是:新建namespace、新建deployment、新建service、删除前面三个接口新建的所有资源;
  4. fluent工程编码完成后,不需要做成镜像部署在kubernetes环境内部,而是作为一个普通SpringBoot应用找个java环境启动即可,与《Kubernetes官方java客户端之三:外部应用 》一文的部署和启动一致;
  5. 依次调用每个接口,验证功能是否符合预期;

编码

  1. 在父工程kubernetesclient下面新建名为fluent的maven子工程,pom.
<?
  1. 新建FluentStyleApplication.java,首先,该类作为启动类,要有main方法:
public static void main(String[] args) { SpringApplication.run(FluentStyleApplication.class, args);}
  1. 定义常量NAMESPACE作为本次实战的namespace:
private final static String NAMESPACE = "fluent";
  1. 用@PostConstruct注解修饰setDefaultApiClient方法,令其在实例化时执行一次,里面做了一些全局性的初始化设置,注意kubeConfigPath变量对应的config文件路径要正确:
/**  * 默认的全局设置  * @return  * @throws Exception  */ @PostConstruct private void setDefaultApiClient() throws Exception {  // 存放K8S的config文件的全路径  String kubeConfigPath = "/Users/zhaoqin/temp/202007/05/config";  // 以config作为入参创建的client对象,可以访问到K8S的API Server  ApiClient client = ClientBuilder    .kubeconfig(KubeConfig.loadKubeConfig(new FileReader(kubeConfigPath)))    .build();  // 会打印和API Server之间请求响应的详细内容,生产环境慎用  client.setDebugging(true);  // 创建操作类  Configuration.setDefaultApiClient(client); }
  1. 接下来是创建namespace的web服务,如下所示,由于namespace在kubernetes的apiVersion是v1,因此创建的是V1Namespace实例:
 @RequestMapping(value = "/fluent/createnamespace") public V1Namespace createnamespace() throws Exception {  V1Namespace v1Namespace = new V1NamespaceBuilder()    .withNewMetadata()    .withName(NAMESPACE)    .addToLabels("label1", "aaa")    .addToLabels("label2", "bbb")    .endMetadata()    .build();  return new CoreV1Api().createNamespace(v1Namespace, null, null, null); }
  1. 为了更清晰的展现fluent style效果,将上述代码与创建namespace的yaml文件内容放在一起对比,如下图所示,可见对照着yaml文件就能将代码写出来:
    在这里插入图片描述

  2. 接下来是创建service的代码,为了便于和yaml对应起来,代码中特意加了缩进:

 @RequestMapping(value = "/fluent/createservice") public V1Service createservice() throws Exception {  V1Service v1Service = new V1ServiceBuilder()    // meta设置    .withNewMetadata()     .withName("nginx")    .endMetadata()    // spec设置    .withNewSpec()     .withType("NodePort")     .addToPorts(new V1ServicePort().port(80).nodePort(30103))     .addToSelector("name", "nginx")    .endSpec()    .build();  return new CoreV1Api().createNamespacedService(NAMESPACE, v1Service, null, null, null); }
  1. 创建deployment的代码如下,因为内容较多所以相对复杂一些,请注意,由于deployment在kubernetes的apiVersion是extensions/v1beta1,因此创建的是ExtensionsV1beta1Deployment实例:
 @RequestMapping(value = "/fluent/createdeployment") public ExtensionsV1beta1Deployment createdeployment() throws Exception {  ExtensionsV1beta1Deployment v1Deployment = new ExtensionsV1beta1DeploymentBuilder()    // meta设置    .withNewMetadata()     .withName("nginx")    .endMetadata()    // spec设置    .withNewSpec()     .withReplicas(1)     // spec的templat     .withNewTemplate()      // template的meta      .withNewMetadata()       .addToLabels("name", "nginx")      .endMetadata()      // template的spec      .withNewSpec()       .addNewContainer()        .withName("nginx")        .withImage("nginx:1.18.0")        .addToPorts(new V1ContainerPort().containerPort(80))       .endContainer()      .endSpec()     .endTemplate()    .endSpec()    .build();  return new ExtensionsV1beta1Api().createNamespacedDeployment(NAMESPACE, v1Deployment, null, null, null); } 
  1. 从上述代码可见,withXXX和endXXX是成对出现的,请在编程的时候注意不要遗漏了endXXX,建议在写withXXX的同时就把endXXX写上;
  2. 最后一个方法是清理所有资源的,前面创建的deployment、service、namespace都在此一次性清理掉,实际操作中发现了一个尴尬的情况:删除deployment和namespace时,发送到API Server的删除请求都收到的操作成功的响应,但kubernetes客户端在反序列化响应内容时抛出异常(日志中显示了详细情况),鄙人能力有限暂未找到解决之道,因此只能用try catch来避免整个方法抛出异常,好在kubernetes实际上已经删除成功了,影响不大:
 @RequestMapping(value = "/fluent/clear") public String clear() throws Exception {  // 删除deployment  try {   new ExtensionsV1beta1Api().deleteNamespacedDeployment("nginx", NAMESPACE, null, null, null, null, null, null);  } catch (Exception e)  {   log.error("delete deployment error", e);  }  CoreV1Api coreV1Api = new CoreV1Api();  // 删除service  coreV1Api.deleteNamespacedService("nginx", NAMESPACE, null, null, null, null, null, null);  // 删除namespace  try {   coreV1Api.deleteNamespace(NAMESPACE, null, null, null, null, null, null);  } catch (Exception e)  {   log.error("delete namespace error", e);  }  return "clear finish, " + new Date(); }
  1. 编码已完成,启动fluent工程,接下来开始验证功能是否正常;

验证

  1. 将fluent工程直接在IEDA环境启动;

  2. 浏览器访问 ,页面会展示API Server返回的完整namespace信息:
    在这里插入图片描述

  3. 浏览器访问 ,页面会展示API Server返回的完整service信息:
    在这里插入图片描述

  4. 浏览器访问 ,页面会展示API Server返回的完整deployment信息:
    在这里插入图片描述

  5. 验证前面几个接口创建的服务是否可用,我这里kubernetes的IP地址是192.168.50.135,因此访问 ,可以正常显示nginx首页:

在这里插入图片描述

  1. SSH登录kubernetes服务器查看,通过kubernetes的java客户端创建的资源都正常:
    在这里插入图片描述

  2. 验证完成后,浏览器访问 ,即可清理掉前面三个接口创建的资源;

  • 至此,基于fluent style调用java客户端的实战就完成了,希望您能熟练使用此风格的API调用,使得编码变得更加轻松流畅,顺便预告一下,下一篇继续做一些简单轻松的操作,目标是熟悉java客户端的常用操作;

你不孤单,欣宸原创一路相伴

  1. Java系列
  2. Spring系列
  3. Docker系列
  4. kubernetes系列
  5. 数据库+中间件系列
  6. DevOps系列

欢迎关注公众号:程序员欣宸

微信搜索「程序员欣宸」,我是欣宸,期待与您一同畅游Java世界...
https://github.com/zq2599/blog_demos









原文转载:http://www.shaoqun.com/a/508753.html

跨境电商:https://www.ikjzd.com/

华翰物流:https://www.ikjzd.com/w/1799

picitup:https://www.ikjzd.com/w/446


欢迎访问我的GitHubhttps://github.com/zq2599/blog_demos内容:所有原创文章分类汇总及配套源码,涉及Java、Docker、Kubernetes、DevOPS等;概览本文是《Kubernetes官方java客户端》系列的第八篇,以下提到的java客户端都是指client-jar.jar;前文《Kubernetes官方java客户端之七:patch操作》涉及的知
heap:heap
zappos.com:zappos.com
亚马逊黄金日购物意愿降低?电子商务整体搜索量下降84%:亚马逊黄金日购物意愿降低?电子商务整体搜索量下降84%
盛夏去惠州南昆山温泉大观园该注意什么事项和须知什么?:盛夏去惠州南昆山温泉大观园该注意什么事项和须知什么?
惠州海滨温泉好玩吗?:惠州海滨温泉好玩吗?

没有评论:

发表评论