Kubernetes官方java客户端之五：proto基本操作

2401_84413032

于 2024-04-19 01:20:17 发布

阅读量824

点赞数 16

分类专栏：程序员文章标签： kubernetes java 容器

本文链接：https://blog.csdn.net/2401_84413032/article/details/137943646

版权

程序员专栏收录该内容

309 篇文章 0 订阅

订阅专栏

概览

本文是《Kubernetes官方java客户端》系列的第五篇，以下提到的java客户端都是指client-jar.jar；
经过前面四篇文章的准备和尝试，我们对java客户端有了初步了解，也成功运行了hello world，接下来要做的是继续深入学习和实践，掌握这门利器；

两个主要脉络

java客户端的基本功能并不复杂，就是以何种手段发起对K8S资源的增删改查请求，把握以下两个主脉络即可：

proto主线：用K8S官方的protobuf定义将各种资源生成java类，用少量API处理这些对象(特点，API极少，每个API都通用，处理所有类型的资源对象)；
openapi主线：使用openapi工具，将所有资源都自动生成增删改查的API(特点：API极多，每个资源都有自身的API)；

今天的文章咱们来学习和了解proto主线；

proto主线的核心类ProtoClient

前面曾提到proto主线的特点是API极少，咱们来看看这些少量的API的源头：ProtoClient类

在这里插入图片描述

如上图所示，ProtoClient提供了增删改查接口，我们可以用这些接口实现对K8S资源的操作；
有了接口，接下来要搞清楚参数怎么准备，先看create方法的源码，看它需要什么样的参数：

在这里插入图片描述

如上图所示，create方法的第一个参数就是K8S资源类，该类的特性是在泛型中约束的，必须实现com.google.protobuf.Message的子接口；
这些入参Message的子类从哪里来呢？例如我们要创建一个NameSpace的时候，是自己写一个Message子类？还是说哪里有现成的？接下来要做的就是搞清楚K8S资源类来自哪里？毕竟所有K8S资源的操作都要用上这些java类；
一起去java客户端的源码寻找线索，这是父子结构的maven工程，在名为client-java-proto的子工程中，它的README文件给出了线索，地址是：https://github.com/kubernetes-client/java/tree/master/proto ，如下图：

在这里插入图片描述

上图红框中的操作向我们揭示了整个过程：先去下载另一个github仓库，然后此仓库里有脚本generate.sh，该脚本根据protobuf配置生成java类，这些java文件被放置在java/proto/src/main/java目录下；
本文是学习K8S官方java客户端的文章，有关K8S的protobuf详情不在这里展开，只给出一段关键脚本供您参考，这是根据proto自动生成代码时执行的脚本，用于下载protobuf文件，地址：https://github.com/kubernetes-client/gen/blob/master/proto/dependencies.sh ，如下图：

在这里插入图片描述

上图红框中的地址是：https://raw.githubusercontent.com/kubernetes//api/master/rbac/v1alpha1/generated.proto ，内容如下，java客户端中的java代码就是根据这些内容生成的：

在这里插入图片描述

结合前面的分析，再回到java客户端源码的子工程client-java-proto，可以找到generate.sh脚本生成的V1.java，这个java文件里面有V1版本的所有protobuf对象，如下图：

在这里插入图片描述

上图红框中Namespace类是GeneratedMessageV3的子类，来看下GeneratedMessageV3的继承关系，如下图，该类实现了Message接口，满足ProtoClient.create方法对入参的泛型约束：

在这里插入图片描述

小结

ProtoClient类提供的操作K8S资源的增删改查方法；
java客户端的client-java-proto子工程内，有通过K8S官方protobuf生成的对象类，这些类就是ProtoClient的增删查用到的参数；
增删改查方法有了，涉及的对象也有了，接下来可以实战了；

实战前的准备

现在还不能马上写代码，还差最后一个准备步骤：确认API参数；

假设实战的内容是查询kube-system这个namespace下面的所有pod列表，那么API相关信息在哪获取：

打开API在线文档，我这里K8S版本是1.15，地址是：https://v1-15.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.15/
如下图，红框1是pod列表的接口文档，红框2显示了该URL，有了这个URL我们可以编码了：

在这里插入图片描述

在今后的操作中，所有资源都可以根据该文档找到对应的API信息，辅助我们编码；
终于，可以开始实战了；

源码下载

如果您不想编码，可以在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协议 |

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

在这里插入图片描述

开始编码

打开《Kubernetes官方java客户端之一：准备》中创建的kubernetesclient工程，在里面新建子工程protobufclient，其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”>

4.0.0

com.bolingcavalry

kubernetesclient

1.0-SNAPSHOT

…/pom.xml

com.bolingcavalry

protobufclient

0.0.1-SNAPSHOT

protobufclient

Demo project for protobuf client

jar

org.springframework.boot

spring-boot-starter-web

org.springframework.boot

spring-boot-starter-json

org.projectlombok

lombok

true

io.kubernetes

client-java

org.springframework.boot

spring-boot-maven-plugin

2.3.0.RELEASE

新增ProtobufApplication.java，这是新工程的引导类，也有通过ProtoClient查询pod列表的代码：

package com.bolingcavalry.protobufclient;

import com.google.gson.GsonBuilder;

import io.kubernetes.client.ProtoClient;

import io.kubernetes.client.ProtoClient.ObjectOrStatus;

import io.kubernetes.client.openapi.ApiClient;

import io.kubernetes.client.proto.Meta;

import io.kubernetes.client.proto.V1.Namespace;

import io.kubernetes.client.proto.V1.PodList;

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 java.io.FileReader;

@SpringBootApplication

@RestController

@Slf4j

public class ProtobufApplication {

public static void main(String[] args) {

SpringApplication.run(ProtobufApplication.class, args);

}

/**

根据配置文件创建ProtoClient实例
自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数Java工程师，想要提升技能，往往是自己摸索成长或者是报班学习，但对于培训机构动则几千的学费，着实压力不小。自己不成体系的自学效果低效又漫长，而且极易碰到天花板技术停滞不前！

因此收集整理了一份《2024年Java开发全套学习资料》，初衷也很简单，就是希望能够帮助到想自学提升又不知道该从何学起的朋友，同时减轻大家的负担。

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Java开发知识点，真正体系化！

由于文件比较大，这里只是将部分目录截图出来，每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频，并且会持续更新！

如果你觉得这些内容对你有帮助，可以扫码获取！！（备注Java获取）