Clusterpedia 0.2.0 发布

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

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

使用 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 种：

Unix 时间戳格式： 为了方便使用会根据时间戳的长度来区分单位为 s 还是 ms 。10 位时间戳单位为秒，13 位时间戳单位为毫秒。
RFC3339： 2006-01-02T15:04:05Z or 2006-01-02T15:04:05+08:00
UTC Date： 2006-01-02
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

邮件： info@daocloud.io

电话：400 002 6898

Clusterpedia 0.2.0 发布

使用 Helm 来部署

02

使用 Kube config 来接入集群

03

新增的 检索功能