Kubernetes官方java客户端之三：外部应用

雨点打透心脏的1/2处 2023-03-01 08:46 114阅读 0赞

### 欢迎访问我的GitHub ###

[https://github.com/zq2599/blog\_demos][https_github.com_zq2599_blog_demos]

### 概览 ###

1.  以下提到的java客户端都是指client-jar.jar；
2.  本文是《Kubernetes官方java客户端》系列的第三篇，[《Kubernetes官方java客户端：准备》][Kubernetes_java]一文中咱们为实战做好了准备工作，从本文开始进入实战阶段；
3.  本文的目标是开发名为OutsideclusterApplication的SpringBoot应用，该应用没有部署在K8S环境，使用的config文件是手动从K8S环境复制过来的，java客户端通过此config文件，能够远程访问到K8S上的API Server，实现所有客户端功能，整体部署情况如下图：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70]

*  介绍完毕，开始编码；

### 源码下载 ###

1.  如果您不想编码，可以在GitHub下载所有源码，地址和链接信息如下表所示(https://github.com/zq2599/blog\_demos)：

<table> 
 <thead> 
  <tr> 
   <th align="left">名称</th> 
   <th align="left">链接</th> 
   <th align="left">备注</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td align="left">项目主页</td> 
   <td align="left">https://github.com/zq2599/blog_demos</td> 
   <td align="left">该项目在GitHub上的主页</td> 
  </tr> 
  <tr> 
   <td align="left">git仓库地址(https)</td> 
   <td align="left">https://github.com/zq2599/blog_demos.git</td> 
   <td align="left">该项目源码的仓库地址，https协议</td> 
  </tr> 
  <tr> 
   <td align="left">git仓库地址(ssh)</td> 
   <td align="left">git@github.com:zq2599/blog_demos.git</td> 
   <td align="left">该项目源码的仓库地址，ssh协议</td> 
  </tr> 
 </tbody> 
</table>

1.  这个git项目中有多个文件夹，本章的应用在kubernetesclient文件夹下，如下图红框所示：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 1]

### 部署在K8S之外的应用：OutsideclusterApplication ###

名为OutsideclusterApplication的应用并未部署在K8S环境，该应用能够访问到K8S环境的关键，就是将K8S环境的config文件复制一份，然后放在OutsideclusterApplication能够访问到的位置：

1.  登录K8S环境，在~/.kube目录下找到config文件，复制此文件到OutsideclusterApplication运行的机器上(我这里存放的路径是/Users/zhaoqin/temp/202007/05/，和后面的代码中一致)；
2.  打开[《Kubernetes官方java客户端：准备》][Kubernetes_java]中创建的的kubernetesclient工程，在里面创建子工程，名为OutsideclusterApplication，这是个SpringBoot工程，pom.xml内容如下：

<?xml version="1.0" encoding="UTF-8"?>
    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
        <modelVersion>4.0.0</modelVersion>
    
        <parent>
            <groupId>com.bolingcavalry</groupId>
            <artifactId>kubernetesclient</artifactId>
            <version>1.0-SNAPSHOT</version>
            <relativePath>../pom.xml</relativePath>
        </parent>
    
        <groupId>com.bolingcavalry</groupId>
        <artifactId>outsidecluster</artifactId>
        <version>0.0.1-SNAPSHOT</version>
        <name>outsidecluster</name>
        <description>Demo project for Spring Boot</description>
        <packaging>jar</packaging>
    
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-starter-web</artifactId>
                <exclusions>
                    <exclusion>
                        <groupId>org.springframework.boot</groupId>
                        <artifactId>spring-boot-starter-json</artifactId>
                    </exclusion>
                </exclusions>
            </dependency>
            <dependency>
                <groupId>org.projectlombok</groupId>
                <artifactId>lombok</artifactId>
                <optional>true</optional>
            </dependency>
            <dependency>
                <groupId>io.kubernetes</groupId>
                <artifactId>client-java</artifactId>
            </dependency>
        </dependencies>
    
        <build>
            <plugins>
                <plugin>
                    <groupId>org.springframework.boot</groupId>
                    <artifactId>spring-boot-maven-plugin</artifactId>
                    <version>2.3.0.RELEASE</version>
                </plugin>
            </plugins>
        </build>
    
    </project>

1.  上述pom.xml中，需要注意的是在依赖spring-boot-starter-web的时候，使用exclusion语法排除了spring-boot-starter-json的依赖，这样做是为了将jackson的依赖全部去掉(spring-boot-starter-json依赖了jackson)，如此一来整个classpath下面就没有了jackson库，此时SpringBoot框架就会使用gson作为序列化和反序列化工具(client-java.jar依赖了gson库)；(这个问题在[《Kubernetes官方java客户端之二：序列化和反序列化问题》][Kubernetes_java 1]一文有详细介绍)
2.  新增OutsideclusterApplication.java，简单起见，该类即是引导类又是Controller：

package com.bolingcavalry.outsidecluster;
    
    import com.google.gson.GsonBuilder;
    import io.kubernetes.client.openapi.ApiClient;
    import io.kubernetes.client.openapi.Configuration;
    import io.kubernetes.client.openapi.apis.CoreV1Api;
    import io.kubernetes.client.openapi.models.V1PodList;
    import io.kubernetes.client.util.ClientBuilder;
    import io.kubernetes.client.util.KubeConfig;
    import lombok.extern.slf4j.Slf4j;
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RestController;
    
    import java.io.FileReader;
    
    @SpringBootApplication
    @RestController
    @Slf4j
    public class OutsideclusterApplication { 
    
        public static void main(String[] args) { 
            SpringApplication.run(OutsideclusterApplication.class, args);
        }
    
        @RequestMapping(value = "/hello")
        public V1PodList hello() 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();
    
            Configuration.setDefaultApiClient(client);
    
            CoreV1Api api = new CoreV1Api();
    
            // 调用客户端API取得所有pod信息
            V1PodList v1PodList = api.listPodForAllNamespaces(null, null, null, null, null, null, null, null, null);
    
            // 使用jackson将集合对象序列化成JSON，在日志中打印出来
            log.info("pod info \n{}", new GsonBuilder().setPrettyPrinting().create().toJson(v1PodList));
    
            return v1PodList;
        }
    
    }

1.  运行上述代码，在浏览器访问http://localhost:8080/hello ，即可取得K8S所有pod的详情，如下所示(为了让返回数据更加整齐美观，我用的是Firefox浏览器)：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 2]
2.  查看控制台，可见日志也将详情打印出来：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 3]

*  至此，咱们的第一个使用K8S官方java客户端的应用就完成了，接下来的实战会尝试将应用部署在K8S环境内，在K8S内部进行各项操作；

[https_github.com_zq2599_blog_demos]: https://github.com/zq2599/blog_demos
[Kubernetes_java]: https://xinchen.blog.csdn.net/article/details/107480015
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70]: /images/20230209/1f208eb7166444ebbf0609e9fdd0ad39.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 1]: https://img-blog.csdnimg.cn/20200721083316287.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5,size_16,color_FFFFFF,t_70
[Kubernetes_java 1]: https://xinchen.blog.csdn.net/article/details/107503695
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 2]: https://img-blog.csdnimg.cn/20200723083303115.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5,size_16,color_FFFFFF,t_70
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5_size_16_color_FFFFFF_t_70 3]: https://img-blog.csdnimg.cn/20200723083311799.png?x-oss-process=image/watermark,type_ZmFuZ3poZW5naGVpdGk,shadow_10,text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2JvbGluZ19jYXZhbHJ5,size_16,color_FFFFFF,t_70