关于云计算:Kubernetes官方java客户端之六OpenAPI基本操作

欢送拜访我的GitHub

https://github.com/zq2599/blog_demos

内容：所有原创文章分类汇总及配套源码，波及Java、Docker、Kubernetes、DevOPS等；

概览

本文是《Kubernetes官网java客户端》系列的第六篇，以下提到的java客户端都是指client-jar.jar；
前文《Kubernetes官网java客户端之五：proto基本操作》曾经提到，java客户端的基本功能由两个次要脉络组成，第一个是proto，次要性能是应用ProtoClient类提供的增删改查接口，这些接口用到的入参和返回对象所波及到的java类，都是通过K8S的protobuf生成的；
除了应用ProtoClient对K8S资源进行增删改查，还提供了另一种更弱小的形式：OpenAPI，本章咱们就来一起学习OpenAPI相干的操作；

K8S的OpenAPI

先抛开java客户端不提，咱们来看看K8S自身的OpenAPI，地址是：https://kubernetes.io/zh/docs… ，要害信息如下图所示，可见K8S提供了OpenAPI标准：

如果您想查看以后K8S环境的OpenAPI标准，请关上K8S环境的/etc/kubernetes/manifests/kube-apiserver.yaml文件，减少下图红框中的内容：

批改结束后请稍候，零碎会依据文件的变动自动更新（千万不要执行kubectl apply -f kube-apiserver.yaml，这会导致新建api-server的pod，因为端口占用而启动失败）;
假如宿主机IP地址是192.168.50.135，那么在浏览器上拜访：http://192.168.50.135:8080/openapi/v2，就能失去所有OpenAPI信息如下图：

上图的原始数据没有可读性，复制到在线JSON格式化网站，失去的内容如下图，例如查问pod列表的API信息曾经十分具体了：

以上就是对K8S的OpenAPI简介，接下来回到java客户端自身，看看它提供了哪些OpenAPI相干的能力；

java客户端的OpenAPI

关上java客户端工程的源码如下图，红框1就是和OpenAPI相干的子工程，提供服务的性能类都在红框2的package中，也就是说，依附红框2中的API以及红框3中的数据结构，咱们能够实现大部分K8S资源管制相干的操作：

关上罕用的CoreV1Api.java，如下图红框，顶部的正文曾经阐明了所有：这些代码都是工具生成的(至于如何生成就不在本文中探讨了):

如果您下载了java客户端源码，能够在client-java-api这个子工程中看到残缺的OpenAPI接口文档：

前文《Kubernetes官网java客户端之五：proto基本操作》的代码中，咱们尝试过获取pod列表，然而ProtoClient的已有API不反对提交更具体的业务参数，此时抉择OpenAPI接口即可输出具体的业务参数，接口详细信息能够在文档中查到，还带有残缺的demo代码，如下图所示：

上图中的listNamespacedPod接口有两个重要参数：fieldSelector和labelSelector，这是过滤用的，具体的用法请参考K8S官网文档，地址是：https://kubernetes.io/docs/co… ，如下图红框：

弄清楚了K8S的OpenAPI标准，以及java客户端根据此标准生成的API服务，还有具体的接口文档在手，能够编码实战了；

源码下载

如果您不想编码，能够在GitHub下载所有源码，地址和链接信息如下表所示(https://github.com/zq2599/blo…：

名称	链接	备注
我的项目主页	https://github.com/zq2599/blo…	该我的项目在GitHub上的主页
git仓库地址(https)	https://github.com/zq2599/blo…	该我的项目源码的仓库地址，https协定
git仓库地址(ssh)	git@github.com:zq2599/blog_demos.git	该我的项目源码的仓库地址，ssh协定

这个git我的项目中有多个文件夹，本章的利用在kubernetesclient文件夹下，如下图红框所示：

开始编码

关上[《Kubernetes官网java客户端之一：筹备》]()中创立的kubernetesclient工程，在外面新建子工程openapi，其pom.xml内容如下，要留神的是spring-boot-starter-json曾经被排除，因而序列化工具会变为Gson(本来默认是jackson)：

<?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>openapi</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <name>openapi</name>
    <description>Demo project for openapi client</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>

新增OpenAPIDemoApplication.java，这是新工程的疏导类，也有两个web接口，一个创立namespace，另一个依照namespace查问pod列表，要害地位已增加了正文，就不多赘述了：

package com.bolingcavalry.openapi;

import com.google.gson.GsonBuilder;
import io.kubernetes.client.openapi.ApiClient;
import io.kubernetes.client.openapi.ApiException;
import io.kubernetes.client.openapi.Configuration;
import io.kubernetes.client.openapi.apis.CoreV1Api;
import io.kubernetes.client.openapi.models.V1Namespace;
import io.kubernetes.client.openapi.models.V1NamespaceBuilder;
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.PathVariable;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;

import javax.annotation.PostConstruct;
import java.io.FileReader;

@SpringBootApplication
@RestController
@Slf4j
public class OpenAPIDemoApplication {

    public static void main(String[] args) {
        SpringApplication.run(OpenAPIDemoApplication.class, args);
    }

    /**
     * 默认的全局设置
     * @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();

        // 创立操作类
        Configuration.setDefaultApiClient(client);
    }

    @RequestMapping(value = "/openapi/createnamespace/{namespace}", method = RequestMethod.GET)
    public V1Namespace createnamespace(@PathVariable("namespace") String namespace) throws Exception {

        CoreV1Api coreV1Api = new CoreV1Api();

        V1Namespace v1Namespace = new V1NamespaceBuilder()
                .withNewMetadata()
                .withName(namespace)
                .endMetadata()
                .build();

        V1Namespace ns = coreV1Api.createNamespace(v1Namespace, null, null, null);

        // 应用Gson将汇合对象序列化成JSON，在日志中打印进去
        log.info("ns info \n{}", new GsonBuilder().setPrettyPrinting().create().toJson(ns));

        return ns;
    }


    @RequestMapping(value = "/openapi/pods/{namespace}", method = RequestMethod.GET)
    public V1PodList pods(@PathVariable("namespace") String namespace) throws ApiException {

        CoreV1Api apiInstance = new CoreV1Api();

        // String | If 'true', then the output is pretty printed.
        String pretty = null;

        // 订阅事件相干的参数，这里用不上
        Boolean allowWatchBookmarks = false;

        // 间断查找的标记，相似于翻页
        String _continue = null;

        //  字段选择器
        String fieldSelector = "status.phase=Running";

        // 依据标签过滤
        // String labelSelector = "component=kube-apiserver";
        String labelSelector = null;

        Integer limit = null;
        String resourceVersion = null;
        Integer timeoutSeconds = null;
        Boolean watch = false;

        V1PodList v1PodList = apiInstance.listNamespacedPod(namespace,
                pretty,
                allowWatchBookmarks,
                _continue,
                fieldSelector,
                labelSelector,
                limit,
                resourceVersion,
                timeoutSeconds,
                watch);

        // 应用Gson将汇合对象序列化成JSON，在日志中打印进去
        log.info("pod info \n{}", new GsonBuilder().setPrettyPrinting().create().toJson(v1PodList));

        return v1PodList;
    }

}

将OpenAPIDemoApplication运行起来，先测试创立namespace的服务，在浏览器拜访：http://localhost:8080/openapi/createnamespace/dddeeefff ，浏览器返回信息如下图：

SSH登录K8S主机，执行命令查看namespace，如下图红框，曾经创立胜利：

再试试Pod列表，地址是：http://localhost:8080/openapi/pods/kube-system ，如下图：

至此，OpenAPI接口的实际就实现了，当初已将java客户端的最根本的性能都实际过了，接下来的文章咱们将开始学习精彩的高级性能；

你不孤独，欣宸原创一路相伴

Java系列
Spring系列
Docker系列
kubernetes系列
数据库+中间件系列
DevOps系列

欢送关注公众号：程序员欣宸

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

关于云计算:Kubernetes官方java客户端之六OpenAPI基本操作

欢送拜访我的GitHub

概览

K8S的OpenAPI

java客户端的OpenAPI

源码下载

开始编码

你不孤独，欣宸原创一路相伴

欢送关注公众号：程序员欣宸

评论

发表回复取消回复

更多文章

苹果iOS打包的ipa应用无法安装？一篇文章带你了解可能的原因及排查方法

图解Golang：从零开始实现简易版过期LRU缓存

深入解析：基于Delta的线性数据结构模型，打造高效富文本编辑器

轻松管理社交媒体：使用Automa插件实现一键拉黑功能

关于云计算:Kubernetes官方java客户端之六OpenAPI基本操作

欢送拜访我的GitHub

概览

K8S的OpenAPI

java客户端的OpenAPI

源码下载

开始编码

你不孤独，欣宸原创一路相伴

欢送关注公众号：程序员欣宸

评论

发表回复 取消回复

更多文章

苹果iOS打包的ipa应用无法安装？一篇文章带你了解可能的原因及排查方法

图解Golang：从零开始实现简易版过期LRU缓存

深入解析：基于Delta的线性数据结构模型，打造高效富文本编辑器

轻松管理社交媒体：使用Automa插件实现一键拉黑功能

发表回复取消回复