k8s 资源外部版本和内部版本

cbmljs

已于 2022-09-30 14:25:22 修改

阅读量1.3k

点赞数 1

分类专栏： kubernetes 文章标签： kubernetes docker 云原生 k8s

于 2022-09-30 11:57:33 首次发布

本文链接：https://blog.csdn.net/cbmljs/article/details/127121246

版权

kubernetes 专栏收录该内容

75 篇文章 16 订阅

订阅专栏

简介

kubernetes资源定义在pkg/apis目录下，在详解资源代码定义之前，先来了解一下资源的外部版本和内部版本。在Kubernetes系统中，同一资源对象对应着两个版本。

资源代码

// 外部版本所在位置

kubernetes/staging/src/k8s.io/api/

// 内部版本所在位置

kubernetes/pkg/apis/

外部版本代码

内部版本代码

为什么会有内外版本的概念

其实在 kubernetes 中对于 resource 之所以会有 version 的概念，是因为方便持续的渐进演化。

例如一个 deployment 在 v1 里有功能 A, 那么在 v1beta1 里就可能会对功能 A 来进行 enhancement 或者去增加新功能 B，然后在 v1beta2 中又会有更多的特性加入。

从设计角度上看 kubernetes 引入的 internal version 的概念，在同一个 group 之中的所有 version 的 resource 都会转化成 internal version, 然后来持久化在 etcd cluster 之中。反之从 etcd cluster 中读取数据的时候，就会从 internal version来转化成相应的对外 version，也就是如下所示：

引入 internal version 的概念就是希望其它所有的 version 在转化的过程中仅仅会和 internal version 产生关联依赖，不会相互关联依赖。而 internal version 并不会暴露给外面使用，完全交由 kuberbetes 研发团队来维护。如果没有 internal version 那么就需要如下图来提供所有 version 之间的相互转换，这样就极大的增加了演进的复杂度，所以并没有采用如下的设计。

资源代码的定义

内部版本的资源代码结构说明如下：

doc.go： GoDoc文件，定义了当前包的注释信息。在Kubernetes资源包中，它还当担了代码生成器的全局Tags描述文件；
register.go：定义了资源组、资源版本以及资源的注册信息；
type.go：定义了在当前资源组、资源版本下所支持的资源类型；
v1、v1beta1、v1beta2：定义了资源组下拥有的资源版本的资源
install：把当前资源之下的所有资源注册到资源注册表中；
validation：定义了资源的验证方法；
zz_generated.deepcopy.go：定义了资源的深复制操作，该文件由代码生成器自动生成；

将资源注册到资源注册表中(scheme)

每个kubernetes资源目录，都通过register.go代码文件定义所属的资源组和资源版本，内部版本资源对象通过runtime.APIVersionInternal标识。

代码路径：pkg/apis/apps/v1/register.go

在每个kubernetes资源组目录汇总，都拥有一个install/install.go代码文件，它负责将资源信息注册到资源注册表（Scheme）中。以core核心资源组为例，代码如下：

代码路径：pkg/apis/core/install/install.go

legacyscheme.Scheme是kube-apiserver组件的全局资源注册表，Kubernetes的所有资源信息都交给资源注册统一管理。core.AddToScheme函数注册core资源组内部版本的资源。v1.AddToScheme函数注册core资源组外部版本的资源。scheme.SetVersionPriority函数注册资源组的版本顺序，如有多个资源版本，排在最前面的为资源首选版本。

资源模型

我们可以用如下图例来表示 kubernetes 中 resource 的基本定义 model：

所有 resource 的基本定义 model，总结起来就是所有的 resource 都会通过继承的方式来继承 type meta 和 object meta 类型，通过组合成员变量的方式来组合了属于 resource 自己特定的 spec 和 status。这种模型的设计理念也比较常见，类似于在 java 的世界中，多数的设计模式也都是通过继承和组合的概念来完成变化的。
可以理解为，就是一个资源创建的基本框架
本节也就等同于之前的k8s类型定义介绍

在 kubernetes 世界之中所有 resource 的基本定义里(例如我们常用的 YAML 文件)，一定都有 type meta 和 object meta 这两个部分。在上一篇文章里我们以 deployment 资源为例，也看同时到了 type meta 和 object meta 在源文件中的对应。