当前位置:

首页 > 系统应用 > 加强Kubernetes能力:利用CRD定义多版本资源的实现方式

加强Kubernetes能力:利用CRD定义多版本资源的实现方式

姚灿武,Rancher 中国研发工程师,拥有 7 年云计算领域经验,热衷开源技术,在云原生相关技术领域拥有丰富的开发和实践经验。CRD,也就是自定义资源定义(Custom Resource Definition),堪称Kubernetes API里一个极为强大的扩展机制。凭借CRD,用户能够定义属于

本文目录

    姚灿武,Rancher 中国研发工程师,拥有 7 年云计算领域经验,热衷开源技术,在云原生相关技术领域拥有丰富的开发和实践经验。

    CRD,也就是自定义资源定义(Custom Resource Definition),堪称Kubernetes API里一个极为强大的扩展机制。凭借CRD,用户能够定义属于自己的资源类型,以此来拓展Kubernetes的API以及资源类型。值得一提的是,CRD定义能够用于创建多个版本的资源,这在Kubernetes集群的演变与升级过程中,有着不可小觑的作用。

    接下来,我们要聊聊Kubernetes CRD的版本概念及其用法,探讨如何在CRD中定义多版本资源,以及资源数据存储和转换的实现方式。最后,我们还会介绍如何开发CRD webhook,让Kubernetes实现CRD版本兼容。

    多版本 CRD

    多版本 CRD 是指在 CRD 中定义多个版本的 API,每个版本的 API 可以有自己的规则,这样就可以在不影响旧版本应用程序的情况下,对新版本应用程序进行更新和升级。

    要创建多版本 CRD,我们需要定义一个 Custom Resource Definition 对象,该对象包含多个 version 字段。每个 version 字段都有一个 schema,其中包含了自定义资源的属性和规则。

    通过一个例子来说明,以下是一个单版本 CRD 示例:

    apiVersion: apiextensions.k8s.io/v1
    kind: CustomResourceDefinition
    metadata:
    name: foos.sample.webhook.io
    spec:
    conversion:
    strategy: None
    group: sample.webhook.io
    names:
    kind: Foo
    listKind: FooList
    plural: foos
    shortNames:
    - foo
    - foos
    singular: foo
    scope: Namespaced
    versions:
    - name: v1
    schema:
    openAPIV3Schema:
    properties:
    apiVersion:
    type: string
    kind:
    type: string
    metadata:
    type: object
    type: object
    served: true
    storage: true

    文件中规定版本信息以及资源的名称、类型等信息。通过 kubectl apply 命令,可以将该 CRD 文件应用到 Kubernetes 集群中,从而在集群中创建一个新的资源类型 Foo,例如:

    apiVersion: sample.webhook.io/v1
    kind: Foo
    metadata:
    name: foo-sample

    上述自定义资源 Foo 只有一个 v1 版本,如果我们需要更新自定义资源中的某个字段,就需要更新 Foo 的版本,例如更新为 v2 版本,就要在 CRD 文件中添加 v2 版本的定义,例如:

    apiVersion: apiextensions.k8s.io/v1
    kind: CustomResourceDefinition
    metadata:
    name: foos.sample.webhook.io
    spec:
    versions:
    - name: v1
    schema:
    openAPIV3Schema:
    properties:
    apiVersion:
    type: string
    kind:
    type: string
    metadata:
    type: object
    type: object
    served: true
    storage: false
    - name: v2
    schema:
    openAPIV3Schema:
    properties:
    alias:
    type: string
    apiVersion:
    type: string
    kind:
    type: string
    metadata:
    type: object
    type: object
    served: true
    storage: true

    在上述 CRD 文件中,我们定义了两个版本,v1 和 v2。v2 相比 v1 新增了一个 alias 字段。

    资源数据存储

    为确保 Kubernetes 能够正确地将自定义资源持久化到存储中,并且能够正确地从存储中读取和还原自定义资源。CRD 中定义了 spec.versions.storage 字段,用于指示使用哪个版本的 CRD 持久化到存储中。在一个 CRD 定义中,只能有一个版本的 storage 字段的值为 true。

    上述例子中,我们定义了两个版本,v1 和 v2。v1 版本 storage 字段为 false,v2 版本 storage 字段为 true,这表明 Kubernetes etcd 中存储的是 v2 版本的资源数据。

    那么对于未被选定的版本的数据如何存储呢?以上面foo-sample为例,我们来看下 etcd 中是怎么存储的,结果如下:

    /registry/sample.webhook.io/foos/default/foo-sample
    {"apiVersion":"sample.webhook.io/v2","kind":"Foo","metadata":{"annotations":{"kubectl.kubernetes.io/last-applied-configuration":"{"apiVersion":"sample.webhook.io/v1","kind":"Foo","metadata":{"annotations":{},"name":"foo-sample","namespace":"default"}}n"},"creationTimestamp":"2023-05-22T09:49:03Z","generation":1,"managedFields":[{"apiVersion":"sample.webhook.io/v1","fieldsType":"FieldsV1","fieldsV1":{"f:metadata":{"f:annotations":{".":{},"f:kubectl.kubernetes.io/last-applied-configuration":{}}}},"manager":"kubectl-client-side-apply","operation":"Update","time":"2023-05-22T09:49:03Z"}],"name":"foo-sample","namespace":"default","uid":"3360f129-31f7-4a3f-8991-7694524d9a78"}}

    第一行是foo-sample的 key,第二行是foo-samplejson 格式表示的内容,其中apiVersion为sample.webhook.io/v2,这表明即便 v1 版本的资源也以 v2 版本的格式存储。

    数据转换

    当自定义资源支持多个版本时,因为只能以某一个版本的格式进行存储,所以需要在存储的版本和提供的版本之间进行转换,实现多版本兼容。

    • 如果转换涉及模式变更, 并且需要自定义逻辑,则应该使用 Webhook 来完成。在 CRD 中配置 webhook 示例如下:
    apiVersion: apiextensions.k8s.io/v1
    kind: CustomResourceDefinition
    ...
    spec:
    conversion:
    strategy: Webhook
    webhook:
    clientConfig:
    caBundle: LS0tLS1CRUdJTiBDRVJUSUZJQ0FURS0tLS0tCk1JSUJ2akNDQVdPZ0F3SUJBZ0lCQURBS0JnZ3Foa2pPUFFRREFqQkdNUnd3R2dZRFZRUUtFeE5rZVc1aGJXbGoKYkdsemRHVnVaWEl0YjNKbk1TWXdKQVlEVlFRRERCMWtlVzVoYldsamJHbHpkR1Z1WlhJdFkyRkFNVFk0TkRjegpPRGswTXpBZUZ3MHlNekExTWpJd056QXlNak5hRncwek16QTFNVGt3TnpBeU1qTmFNRVl4SERBYUJnTlZCQW9UCkUyUjVibUZ0YVdOc2FYTjBaVzVsY2kxdmNtY3hKakFrQmdOVkJBTU1IV1I1Ym1GdGFXTnNhWE4wWlc1bGNpMWoKWVVBeE5qZzBOek00T1RRek1Ga3dFd1lIS29aSXpqMENBUVlJS29aSXpqMERBUWNEUWdBRUZYWDQzaEZRdjRyOApKelR1UkJ0b3lqUmRtWjhIRkExbWZnOXJnTWVlNnVXZ20wMXBNR3lSRnFna3Z1RHF5RUlMTUtCRDduQ2IrVFp3CitBR3loVWhTV0tOQ01FQXdEZ1lEVlIwUEFRSC9CQVFEQWdLa01BOEdBMVVkRXdFQi93UUZNQU1CQWY4d0hRWUQKVlIwT0JCWUVGRzg2VnpCcW1wRUcrUWlrS0d1SGNIQlJwS2R3TUFvR0NDcUdTTTQ5QkFNQ0Ewa0FNRVlDSVFDaQp5SFFyeGNXN3dUM0dwRWhyNklQQWpXWDVJOSt4Y0dkUGQzQURKS0hwZ2dJaEFJQmhTc00xd1hxMU80VUlaWWZwCkNWVkxwaCtvUVMvMzI5OHMwS0VqWW9FTAotLS0tLUVORCBDRVJUSUZJQ0FURS0tLS0tCg==
    service:
    name: webhook-sample
    namespace: default
    path: /v1/webhook/conversion
    port: 443
    conversionReviewVersions:
    - v1
    • 如果没有模式变更,则可使用默认的None转换策略,为不同版本提供服务时只有apiVersion字段会被改变。
    apiVersion: apiextensions.k8s.io/v1
    kind: CustomResourceDefinition
    ...
    spec:
    ...
    conversion:
    strategy: None

    CRD webhook 开发

    与Admission Webhook一样,CRD webhook 也是一个 HTTP 回调,webhook service 就是一个 HTTP 服务。接口结构如下:

    // ConversionReview describes a conversion request/response.
    type ConversionReview struct {
    meta v1.TypeMeta `json:",inline"`
    // request describes the attributes for the conversion request.
    // +optional
    Request *ConversionRequest `json:"request,omitempty" protobuf:"bytes,1,opt,name=request"`
    // response describes the attributes for the conversion response.
    // +optional
    Response *ConversionResponse `json:"response,omitempty" protobuf:"bytes,2,opt,name=response"`
    }

    Harvester 项目组在harvester webhook框架中增加了 CRD webhook 的支持,开发者只需要实现Converter接口并把它注册到 webhook server 中,然后启动 webhook server 即可。

    // Converter is a interface to convert object to the desired version
    type Converter interface {
    GroupResource() schema.GroupResource
    Convert(Object *unstructured.Unstructured, desiredAPIVersion string) (*unstructured.Unstructured, error)
    }

    具体开发细节请参考示例webhook sample。

    总 结

    在实际产品进化演变过程中,多版本兼容一直是一个重要的问题。Kubernetes CRD 采用选定某一个版本进行持久化,并使用 webhook 实现多版本数据转换的策略来解决多版本兼容性问题。在 Kubernetes 外的其他项目中,这种策略也值得学习借鉴。

    参 考

    Versions in Custom Resource Definitions:https://kubernetes.io/zh-cn/docs/tasks/extend-kubernetes/custom-resources/custom-resource-definition-versioning

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    系统应用 云计算
    相关文章 更多
    打破x86长期垄断!Arm宣布超大规模云市场占比超50%
    打破x86长期垄断!Arm宣布超大规模云市场占比超50%

    Arm架构在全球超大规模云计算市场份额突破50%,十大云服务商均已部署自研Arm芯片。AWSGraviton年营收超200亿美元,谷歌、微软相继跟进。预计2026年Arm在数据中心CPU市场占比达23%,与AMD持平。同时推出首款服务器级AGICPU,锁定Meta、OpenAI等客户,目标2027年收入10亿美元。

    DebianSniffer在云计算环境中的作用
    DebianSniffer在云计算环境中的作用

    Debian Sniffer在云计算环境中的作用概念澄清“Debian Sniffer”并非单一、官方的工具名称,通常是指在Debian系统上运行的各类网络嗅探/抓包与分析工具(如 tcpdump、Wireshark、netsniff-ng 等)的泛称。其核心能力是对网络数据包进行捕获与分析,用于观

    性能竞赛优秀项目|分得干脆、合得高效,用Shuffle优化TiDB算子
    性能竞赛优秀项目|分得干脆、合得高效,用Shuffle优化TiDB算子

    作者介绍:黄建博,云计算领域技术开发工程师;金灵, Shopee 软件研发工程师。他们的队伍 huang-b 在性能竞赛中斩获一等奖,本文将介绍 Shuffle 优化 TiDB 算子项目的设计与实践过程。在我们往常的印象中,分与合是一对矛盾的概念,但是这次比赛留给我们队伍一个很深刻的印象是,分与合是

    【云原生】快速了解Kubernetes
    【云原生】快速了解Kubernetes

    在云原生技术发展的浪潮之中,Kubernetes伴随着容器技术的发展,成为了目前云时代的“操作系统”。Kubernetes作为容器集群管理系统和云原生领域的关键项目,已经是云原生时代最需要理解与实践的核心技术。但技术的发展从来都不是一蹴而就,Kubernetes的诞生也有其对

    Serverless躁动背后的5大落地之痛
    Serverless躁动背后的5大落地之痛

    Serverless从诞生起就被赋予了变革云计算的使命但是往往看上去越厉害的东西落地时遇到的困难就会越多Serverless也不例外**痛点一:厂家锁定无论是个人用户,还是企业客户大家都不希望自己被厂家锁定而是任由自己选择服务和产品但选择了 Serverless 的客户会面临更高的迁移成本因为Ser

    基于MinIO对象存储保障Rancher数据
    基于MinIO对象存储保障Rancher数据

    作者简介谢泽钦,身为SUSE Rancher技术支持工程师,主要负责订阅客户的维护与售后技术支持服务,为客户提供相关技术解决方案。他拥有CKA、CKS官方认证,在云计算领域摸爬滚打多年,历经从OpenStack到Kubernetes的技术变革,对底层操作系统、KVM虚拟化和Docker容器等相关云原

    低代码是开发的未来吗?浅谈低代码平台
    低代码是开发的未来吗?浅谈低代码平台

    低代码的热潮在几年前就火过,从阿里钉钉跨平台协作方式,再到飞书上的审批流程,以及目前我们接触到的表单审批、投票的模板,这些都是关于低代码的实现方式。随着企业数字化转型和云计算的不断发展,低代码平台又一次成为热门话题被越来越多的人讨论。今天分享的主题为浅谈低代码平台,主要从以下 4 个方面进行介绍:低

    基于信通院Serverless工具链模型的实践:ServerlessDevs
    基于信通院Serverless工具链模型的实践:ServerlessDevs

    前言嘿,你知道吗?2022年6月15日,信通院在中国信通院云原生产业大会上,发布了一个超重要的标准——《基于无服务器架构的工具链能力要求》,至此,全球首个云原生Serverless开放工具链模型正式诞生啦!Serverless Devs [1]作为一款开源开放的开发者工具,可是积极参与了工具链模型的

    Rancher2.6MonitoringGrafana对接LDAP
    Rancher2.6MonitoringGrafana对接LDAP

    作者简介 谢泽钦,SUSE Rancher 技术支持工程师,负责订阅客户的维护与售后技术支持服务,提供相关技术解决方案。拥有 CKA、CKS 官方认证,多年云计算领域经验,经历了从 OpenStack 到 Kubernetes 的技术变革,对底层操作系统、KVM 虚拟化和 Docker 容器等相关云

    ApacheDoris巨大飞跃:存算分离新架构
    ApacheDoris巨大飞跃:存算分离新架构

    历史上,数据分析需求的不断提升(更大的数据规模、更快的处理速度、更低的使用成本)和计算基础设施的不断进化(从专用的高端硬件、到低成本的商用硬件、到云计算服务),这两大因素推动数据仓库的架构大体经历了三个时代:软硬一体的一体机时代、存算一体的分布式时代以及存算分离的云原生时代。Apache Doris

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。