Kubernetes的Group、Version、Resource学习小记，Java开发学习视频

最新推荐文章于 2024-05-30 17:31:59 发布

2401_84003115

最新推荐文章于 2024-05-30 17:31:59 发布

阅读量940

点赞数 12

分类专栏： 2024年程序员学习文章标签： kubernetes 学习 java

本文链接：https://blog.csdn.net/2401_84003115/article/details/137216261

版权

2024年程序员学习专栏收录该内容

198 篇文章 0 订阅

订阅专栏

这里分类和汇总了欣宸的全部原创(含配套源码)：https://github.com/zq2599/blog_demos

关于Group、Version、Resource

开篇先提重点：Group、Version、Resource十分重要，它们会贯穿《client-go实战》、《kubebuilder实战》、《Kubernetes官方java客户端》等系列文章的始终；
Kubernetes是以资源为中心的系统，在学习client-go时，Group、Version、Resource等资源相关的数据结构就显得格外重要了，下图来自郑老师《Kubernetes源码剖析》一文，将三者关系做了简洁清晰的介绍：

在这里插入图片描述

环境信息

开始学习前先交待一下我这边的环境信息，以避免因为版本引起的误会：

kubernetes源码：1.20.3-rc.0
实战环境的操作系统：CentOS Linux release 7.9.2009
实战环境的kubernetes：1.20.0

接下来开始学习Group、Version、Resource吧

Group

Group即资源组，在kubernetes对资源进行分组时，对应的数据结构就是Group，源码路径：k8s.io/apimachinery/pkg/apis/meta/v1/types.go ，如下，可见Group有自己的名称和版本：

type APIGroup struct {

TypeMeta json:",inline"

Name string json:"name" protobuf:"bytes,1,opt,name=name"

Versions []GroupVersionForDiscovery json:"versions" protobuf:"bytes,2,rep,name=versions"

PreferredVersion GroupVersionForDiscovery json:"preferredVersion,omitempty" protobuf:"bytes,3,opt,name=preferredVersion"

ServerAddressByClientCIDRs []ServerAddressByClientCIDR json:"serverAddressByClientCIDRs,omitempty" protobuf:"bytes,4,rep,name=serverAddressByClientCIDRs"

}

在kubernetes中有两种资源组：有组名资源组和无组名资源组(也叫核心资源组Core Groups)，它们都很常见；
deployment有组名，pod没有组名，咱们把它俩的OpenAPI放在一起对比就一目了然了：

在这里插入图片描述

Version

Version即版本，这个好理解，kubernetes的版本分为三种：

Alpha：内部测试版本，如v1alpha1
Beta：经历了官方和社区测试的相对稳定版，如v1beta1
Stable：正式发布版，如v1、v2

如下图红框，资源组batch之下有v1和v2alpha1两个版本，每个版本下都有多个资源：

在这里插入图片描述

数据结构源码还是在types.go文件中，如下：

type APIVersions struct {

TypeMeta json:",inline"

Versions []string json:"versions" protobuf:"bytes,1,rep,name=versions"

ServerAddressByClientCIDRs []ServerAddressByClientCIDR json:"serverAddressByClientCIDRs" protobuf:"bytes,2,rep,name=serverAddressByClientCIDRs"

}

Resource

Resource资源在kubernetes中的重要性是不言而喻的，常见的pod、service、deployment这些都是资源，下面是关于资源的一些小结：

在kubernetes环境被实例化的资源即资源对象(ResourceObject)；
资源被分为持久性（Persistent Entity）和非持久性（Ephemeral Entity），持久性如deployment，创建后会在etcd保存，非持久性如pod；

资源的源码：

type APIResource struct {

Name string json:"name" protobuf:"bytes,1,opt,name=name"

SingularName string json:"singularName" protobuf:"bytes,6,opt,name=singularName"

Namespaced bool json:"namespaced" protobuf:"varint,2,opt,name=namespaced"

Group string json:"group,omitempty" protobuf:"bytes,8,opt,name=group"

Version string json:"version,omitempty" protobuf:"bytes,9,opt,name=version"

Kind string json:"kind" protobuf:"bytes,3,opt,name=kind"

Verbs Verbs json:"verbs" protobuf:"bytes,4,opt,name=verbs"

ShortNames []string json:"shortNames,omitempty" protobuf:"bytes,5,rep,name=shortNames"

Categories []string json:"categories,omitempty" protobuf:"bytes,7,rep,name=categories"

StorageVersionHash string json:"storageVersionHash,omitempty" protobuf:"bytes,10,opt,name=storageVersionHash"

}

kubernetes为资源准备了8种操作：create、delete、deletecollection、get、list、patch、update、watch，每一种资源都支持其中的一部分，这在每个资源的API文档中可以看到；
资源支持以命名空间（namespace）进行隔离；
资源对象描述文件在日常操作中频繁用到，一共由五部分组成：apiVersion、kind、metadata、spec、status，下图是官方的deployment描述文件，用于创建3个nginx pod，对着红框和文字就了解每个部分的作用了：

在这里插入图片描述

上图并没有status，该部分是用来反应当前资源对象状态的，体现在资源的数据结构中，如下所示：

type Deployment struct {

metav1.TypeMeta json:",inline"

metav1.ObjectMeta json:"metadata,omitempty" protobuf:"bytes,1,opt,name=metadata"

Spec DeploymentSpec json:"spec,omitempty" protobuf:"bytes,2,opt,name=spec"

Status DeploymentStatus json:"status,omitempty" protobuf:"bytes,3,opt,name=status"

}

官方文档速查

在实际学习和开发中，对指定资源做增删改查操作时，官方文档是我们最可靠的依赖，地址：https://kubernetes.io/docs/reference/kubernetes-api/
打开deployment的文档，如下图：

在这里插入图片描述

另外还有API文档也是必不可少的，遗憾的是目前没有找到1.20的API在线文档，最新的是1.19版本，地址：https://v1-19.docs.kubernetes.io/docs/reference/generated/kubernetes-api/v1.19/
下图是deployment的api接口文档，可见示例、path、请求响应参数都有详细的说明，对咱们的学习和开发提供了强有力的支持：

在这里插入图片描述