CR
定制资源(Custom Resource) 是对 Kubernetes API 的扩展.
资源(Resource) 是 Kubernetes API 中的一个端点, 其中存储的是某个类别的 API 对象 的一个集合。 例如内置的 pods 资源包含一组 Pod 对象
定制资源(Custom Resource) 是对 Kubernetes API 的扩展,不一定在默认的 Kubernetes 安装中就可用。定制资源所代表的是对特定 Kubernetes 安装的一种定制。 不过,很多 Kubernetes 核心功能现在都用定制资源来实现,这使得 Kubernetes 更加模块化
定制资源可以通过动态注册的方式在运行中的集群内或出现或消失,集群管理员可以独立于集群 更新定制资源。一旦某定制资源被安装,用户可以使用 kubectl 来创建和访问其中的对象,就像他们为 pods 这种内置资源所做的一样
CRD
CustomResourceDefinition API 资源允许你定义定制资源。 定义 CRD 对象的操作会使用你所设定的名字和模式定义(Schema)创建一个新的定制资源, Kubernetes API 负责为你的定制资源提供存储和访问服务。 CRD 对象的名称必须是合法的 DNS 子域名
创建CRD
例如,下面是一个crd.yaml的例子
# mybooks-crd.yaml
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
# 名字必需与下面的 spec 字段匹配,并且格式为 '<名称的复数形式>.<组名>'
name: mybooks.cloud.lilq.cn
spec:
# 组名称,用于 REST API: /apis/<组>/<版本>
group: cloud.lilq.cn
# 列举此 CustomResourceDefinition 所支持的版本
versions:
# 版本名称,比如 v1、v2beta1 等等
- name: v1
# 每个版本都可以通过 served 标志来独立启用或禁止
served: true
# 其中一个且只有一个版本必需被标记为存储版本
storage: true
# 定义自定义对象的声明规范
schema:
openAPIV3Schema:
description: Define MyBook YAML Spec
type: object
properties:
# 自定义CRD的字段类型
spec:
type: object
properties:
uuid:
type: string
name:
type: string
price:
type: integer
# 定义作用范围:Namespaced(命名空间级别)或者 Cluster(整个集群)
scope: Namespaced
names:
# kind 通常是单数形式的帕斯卡编码(PascalCased)形式。你的资源清单会使用这一形式
kind: MyBook
# plural 名字用于 REST API 中的定义:/apis/<group>/<version>/<plural>
plural: mybooks
# singular 名称用于 CLI 操作或显示的一个别名
singular: mybook
# shortNames 允许你在命令行使用较短的字符串来匹配资源
shortNames:
- mb
- 创建
kubectl apply -f mybooks-crd.yaml
- 查看创建的RESTful API
kubectl get --raw /apis/cloud.lilq.cn/v1 | python -m json.tool
- 查看创建的CRD
kubectl get crd
创建定制对象
针对上面创建MyBook对象进行添加,删除,更新等操作了,先添加一条记录
# mybook.yaml
apiVersion: cloud.lilq.cn/v1
kind: MyBook
metadata:
name: my-new-mybook-object
spec:
uuid: "2c4789b2-30f2-4d31-ab71-ca115ea8c100"
name: "mybook"
price: 500
- 创建
kubectl apply -f mybook.yaml
- 查看
kubectl get mb
kubectl get mybook
kubectl get mb -o yaml
- 删除
kubectl delete -f mybook.yaml