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

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

2. 如上图所示，ProtoClient提供了增删改查接口，我们可以用这些接口实现对K8S资源的操作；

3. 有了接口，接下来要搞清楚参数怎么准备，先看create方法的源码，看它需要什么样的参数：

4. 如上图所示，create方法的第一个参数就是K8S资源类，该类的特性是在泛型中约束的，必须实现com.google.protobuf.Message的子接口；

5. 这些入参Message的子类从哪里来呢？例如我们要创建一个NameSpace的时候，是自己写一个Message子类？还是说哪里有现成的？接下来要做的就是搞清楚K8S资源类来自哪里？毕竟所有K8S资源的操作都要用上这些java类；

6. 一起去java客户端的源码寻找线索，这是父子结构的maven工程，在名为client-java-proto的子工程中，它的README文件给出了线索，地址是：https://github.com/kubernetes-client/java/tree/master/proto ，如下图：

7. 上图红框中的操作向我们揭示了整个过程：先去下载另一个github仓库，然后此仓库里有脚本generate.sh，该脚本根据protobuf配置生成java类，这些java文件被放置在java/proto/src/main/java目录下；

8. 本文是学习K8S官方java客户端的文章，有关K8S的protobuf详情不在这里展开，只给出一段关键脚本供您参考，这是根据proto自动生成代码时执行的脚本，用于下载protobuf文件，地址：https://github.com/kubernetes-client/gen/blob/master/proto/dependencies.sh ，如下图：

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

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

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

小结

1. ProtoClient类提供的操作K8S资源的增删改查方法；

2. java客户端的client-java-proto子工程内，有通过K8S官方protobuf生成的对象类，这些类就是ProtoClient的增删查用到的参数；

3. 增删改查方法有了，涉及的对象也有了，接下来可以实战了；

实战前的准备

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

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

1. 打开API在线文档，我这里K8S版本是1.15，地址是：https://v1-15.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.15/

2. 如下图，红框1是pod列表的接口文档，红框2显示了该URL，有了这个URL我们可以编码了：

3. 在今后的操作中，所有资源都可以根据该文档找到对应的API信息，辅助我们编码；

4. 终于，可以开始实战了；

源码下载

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协议 |

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

开始编码

1. 打开《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

2. 新增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实例

• @return

• @throws Exception

*/

private ProtoClient buildProtoClient() 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();

// 创建操作类

return new ProtoClient(client);

}

@RequestMapping(value = “/createnamespace/{namespace}”, method = RequestMethod.GET)

最后

自我介绍一下，小编13年上海交大毕业，曾经在小公司待过，也去过华为、OPPO等大厂，18年进入阿里一直到现在。

深知大多数Java工程师，想要提升技能，往往是自己摸索成长，自己不成体系的自学效果低效漫长且无助。

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

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Java开发知识点，不论你是刚入门Java开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门！

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

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

[外链图片转存中…(img-rf30DqZf-1715793759703)]

[外链图片转存中…(img-Ko48PaCC-1715793759703)]

既有适合小白学习的零基础资料，也有适合3年以上经验的小伙伴深入学习提升的进阶课程，基本涵盖了95%以上Java开发知识点，不论你是刚入门Java开发的新手，还是希望在技术上不断提升的资深开发者，这些资料都将为你打开新的学习之门！

如果你觉得这些内容对你有帮助，需要这份全套学习资料的朋友可以戳我获取！！

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