Clusterpedia 0.2.0 发布

Clusterpedia 0.2.0 发布，当前，用户可以使用 Helm 快速部署 Clusterpedia ，直接使用 kube config 来接入集群，并新增三个检索功能，以及一些其他功能，为大家提供更优质的多集群资源复杂检索能力。

接下来详细介绍一下Clusterpedia0.2.0的内容，欢迎大家使用和提出建议。

01

使用 Helm 来部署

用户已经可以使用 Helm 来部署 Clusterpedia ，我们在上一篇已经为大家详细介绍过了，可以参考：使用 Helm 快速部署 Clusterpedia。

02

使用 Kube config 来接入集群

v0.1.0 时，用户需要分别填写被接入集群的 apiserver 地址，以及访问集群时的认证信息。

apiVersion: cluster.clusterpedia.io/v1alpha2 kind: PediaCluster metadata: name: cluster-example spec: apiserver: "https://10.30.43.43:6443" caData: tokenData: certData: keyData: syncResources: [] 

图注，非必选。选本句、回车空行。

在 v0.2.0 中 PediaCluster 增加了 spec.kubeconfig 字段，用户可以直接使用 kube config 来接入集群。

首先 base64 集群的kube config:

$ base64 ./kubeconfig.yaml 

然后填充到 PediaCluster 的 spec.kubeconfig 字段中。

apiVersion: cluster.clusterpedia.io/v1alpha2 kind: PediaCluster metadata: name: cluster-example spec: kubeconfig: **base64 kubeconfig** syncResources: [] 

在使用 kube config 时，不需要填写 spec.apiserver 以及其他认证字段。

需要注意，使用 kubectl get pediacluster 查看接入的集群列表时，APISERVER 不会显示集群地址。

$ kubectl get pediacluster NAME APISERVER VERSION STATUS cluster-example v1.22.2 Healthy 

如果需要显示，那么需要额外手动设置 spec.kubeconfig ，未来会添加 Mutating Admission Webhook 来解析 kubeconfig 并自动填充 spec.apiserver 字段。

03

新增的 检索功能

通过资源的创建时间来过滤资源

## 通过资源的创建时间来过滤资源

创建时间的区间采用左闭右开的规则，since <= creation time < before。

时间格式支持 4 种：

1. Unix 时间戳格式： 为了方便使用会根据时间戳的长度来区分单位为 s 还是 ms 。10 位时间戳单位为秒，13 位时间戳单位为毫秒。
2. RFC3339： 2006-01-02T15:04:05Z or 2006-01-02T15:04:05+08:00
3. UTC Date： 2006-01-02
4. UTC Datetime： 2006-01-02 15:04:05

由于 Kube Label Selector 的限制，Search Label 只支持使用 Unix 时间戳和 UTC Data 的格式

URL Query可以使用四种格式

首先查看一下当前都有哪些资源。

$ kubectl --cluster clusterpedia get pods CLUSTER NAME READY STATUS RESTARTS AGE cluster-example quickstart-ingress-nginx-admission-create--1-kxlnn 0/1 Completed 0 171d cluster-example fake-pod-698dfbbd5b-wvtvw 1/1 Running 0 8d cluster-example fake-pod-698dfbbd5b-74cjx 1/1 Running 0 21d cluster-example fake-pod-698dfbbd5b-tmcw7 1/1 Running 0 8d 

我们使用创建时间来过滤资源。

$ kubectl --cluster clusterpedia get pods -l "search.clusterpedia.io/since=2022-03-20"CLUSTER NAME READY STATUS RESTARTS AGEcluster-example fake-pod-698dfbbd5b-wvtvw 1/1 Running 0 8dcluster-example fake-pod-698dfbbd5b-tmcw7 1/1 Running 0 8d $ kubectl --cluster clusterpedia get pods -l "search.clusterpedia.io/before=2022-03-20"CLUSTER NAME READY STATUS RESTARTS AGEcluster-example quickstart-ingress-nginx-admission-create--1-kxlnn 0/1 Completed 0 171d cluster-example fake-pod-698dfbbd5b-74cjx 1/1 Running 0 21d 

使用 Owner Name 检索

在 v0.1.0 时，我们可以指定祖辈或者父辈 Owner UID 来查询资源，不过 Owner UID 使用起来并不方便，毕竟还需要提前得知 Owner 资源的 UID 。 在 v0.2.0 版本中，支持直接使用Owner Name来查询，并且 Owner 查询由实验性功能进入到正式功能，Search Label 的前缀也由internalstorage.clusterpedia.io升级为search.clusterpedia.io ，并且提供了 URL Query 。

如果用户同时指定了 Owner UID 和 Owner Name ，那么 Owner Name 会被忽略。

$ kubectl --cluster cluster-example get pods -l \ "search.clusterpedia.io/owner-name=fake-pod, \ search.clusterpedia.io/owner-seniority=1"CLUSTER NAME READY STATUS RESTARTS AGEcluster-example fake-pod-698dfbbd5b-wvtvw 1/1 Running 0 8dcluster-example fake-pod-698dfbbd5b-74cjx 1/1 Running 0 21dcluster-example fake-pod-698dfbbd5b-tmcw7 1/1 Running 0 8d 

另外为了避免某些情况下，owner 资源存在多种类型，我们可以使用 Owner Group Resource 来限制 Owner 的类型。

$ kubectl --cluster cluster-example get pods -l \ "search.clusterpedia.io/owner-name=fake-pod,\ search.clusterpedia.io/owner-gr=deployments.apps,\ search.clusterpedia.io/owner-seniority=1"... some output 

根据资源名称的模糊搜索

模糊搜索是一个非常常用的功能，当前暂时只提供了资源名称上的模糊搜索，由于还需要更多功能上的讨论，暂时作为试验性功能。

$ kubectl --cluster clusterpedia get deployments -l "internalstorage.clusterpedia.io/fuzzy-name=fake"CLUSTER NAME READY UP-TO-DATE AVAILABLE AGEcluster-example fake-pod 3/3 3 3 113d 

可以使用 in 操作符来指定多个参数，这样可以过滤出名字包含所有模糊字符串的资源。

04

其他功能

在 v0.1.0 中，查询资源列表时，允许返回的剩余的资源数量，这样用户可以通过计算就能得知当前检索添加下的资源总量。

在 v0.2.0 中对该功能进行了强化， 当分页查询的Offset参数过大时，ReaminingItemCount可以为负数，
这样可以保证通过 offset + len(list.items) + list.metadata.remainingItemCount 总是可以计算出正确的资源总量。

05

更新总览

• 支持使用 Helm 部署 (#53,#125, @calvin0327, @wzshiming)
• PediaCluster 支持使用 kube config 来接入集群 (#115, @wzshiming)

APIServer

• 支持通过创建时间的区间来过滤资源 (#113, @cleverhu)
• 支持根据 Owner 的名字来检索资源，并且 Owner 查询成为 clusterpedia 的正式功能，同时支持 Search Label 和 URL Query (#91, @Iceber)

Default Storage Layer

• 支持根据资源名称的模糊搜索 (#117, @cleverhu)
• RemainingItemCount 可以为负数，在 Offset 过大时依然可以使用 offset + len(items) + remainingItemCount 来计算资源总量。(#123, @cleverhu)

Bug Fixes

• 修复由于不必要的反序列化导致的 cpu 损耗，提升了查询时的性能 (#89,#92, @Iceber)

Deprecation

• Owner 查询已移动到正式功能，用于 Owner 查询的试验性 Search Label internalstorage.clusterpedia.io/owner-name和internalstorage.clusterpedia.io/owner-seniority会在下一个版本被移除 (#91, @Iceber)

欢迎大家下载使用和参与讨论，并在 issue 提出自己的意见和想法。 项目地址： https://github.com/clusterpedia-io/clusterpedia

微信社群：

添加微信备注 [ clusterpedia ]

加入技术讨论群

本文作者

蔡威

「 DaoCloud 道客」高级云原生研发工程师

DaoCloud 公司简介

「 DaoCloud 道客」云原生领域的创新领导者，成立于 2014 年底，拥有自主知识产权的核心技术，致力于打造开放的云操作系统为企业数字化转型赋能。产品能力覆盖云原生应用的开发、交付、运维全生命周期，并提供公有云、私有云和混合云等多种交付方式。成立迄今，公司已在金融科技、先进制造、智能汽车、零售网点、城市大脑等多个领域深耕，标杆客户包括交通银行、浦发银行、上汽集团、东风汽车、海尔集团、屈臣氏、金拱门（麦当劳）等。目前，公司已完成了 D 轮超亿元融资，被誉为科技领域准独角兽企业。公司在北京、武汉、深圳、成都设立多家分公司及合资公司，总员工人数超过 400 人，是上海市高新技术企业、上海市“科技小巨人”企业和上海市“专精特新”企业，并入选了科创板培育企业名单。

网址：www.daocloud.io

邮件： [email protected]

电话：400 002 6898