在 K8S 中为自定义资源定义添加“解释”信息

Question

我已经在 K8S 中注册了自定义资源定义：

apiVersion: apiextensions.k8s.io/v1beta1
kind: CustomResourceDefinition
metadata:
  name: resources.example.com
  labels:
    service: "my-resource"
spec:
  group: example.com
  version: v1alpha1
  scope: Namespaced
  names:
    plural: resources
    singular: resource
    kind: MYRESOURCE
    shortNames:
    - res

现在尝试为我的自定义资源获取“解释”：

kubectl explain resource

我收到以下错误：

group example.com has not been registered

如何将explain 信息添加到我的自定义资源定义中，或者 CRD 不支持此操作？

Answer 1

explain 使用服务器发布的 openapi 模式信息来工作。在 v1.15 之前，CRD 无法发布该信息。

在 1.15+ 中，指定 structural schemas 和 enable pruning 的 CRD 发布 OpenAPI 并使用说明。