(四)Kubernetes 资源清单定义

(四)Kubernetes 资源清单定义

Kubernetes常用资源对象

依据资源的主要功能作为分类标准，​​Kubernetes​​​的​​API​​对象大体可分为五个类别，如下：

对象资源格式

​​Kubernetes API​​​ 仅接受及响应​​JSON​​​格式的数据（​​JSON​​​对象），同时，为了便于使用，它也允许用户提供​​YAML​​​格式的​​POST​​​对象，但​​API Server​​​需要实现自行将其转换为​​JSON​​​格式后方能提交。​​API Server​​​接受和返回的所有​​JSON​​​对象都遵循同一个模式，它们都具有​​kind​​​和​​apiVersion​​​字段，用于标识对象所属的资源类型、​​API​​群组及相关的版本。大多数的对象或列表类型的资源提供元数据信息，如名称、隶属的名称空间和标签等；​​spec​​​则用于定义用户期望的状态，不同的资源类型，其状态的意义也各有不同，例如​​Pod​​​资源最为核心的功能在于运行容器；而​​status​​​则记录着活动对象的当前状态信息，它由​​Kubernetes​​系统自行维护，对用户来说为只读字段。

获取对象的​​JSON​​​格式的配置清单可以通过"​​kubectl get TYPE/NAME -o yaml​​"命令来获取。

[root@k8s-master ~]# kubectl get pod nginx-67685f79b5-8rjk7 -o yaml #获取该pod的配置清单apiVersion: v1kind: Podmetadata: creationTimestamp: "2019-08-30T07:00:30Z" generateName: nginx-67685f79b5- labels: pod-template-hash: 67685f79b5 run: nginx name: nginx-67685f79b5-8rjk7 namespace: default ownerReferences: - apiVersion: apps/v1 blockOwnerDeletion: true controller: true kind: ReplicaSet name: nginx-67685f79b5 uid: 6de479a9-52f6-4581-8e06-884a84dab593 resourceVersion: "244953" selfLink: /api/v1/namespaces/default/pods/nginx-67685f79b5-8rjk7 uid: 0b6f5a87-4129-4b61-897a-6020270a846espec: containers: - image: nginx:1.12 imagePullPolicy: IfNotPresent name: nginx resources: {} terminationMessagePath: /dev/termination-log terminationMessagePolicy: File volumeMounts: - mountPath: /var/run/secrets/kubernetes.io/serviceaccount name: default-token-s8mbf readOnly: true dnsPolicy: ClusterFirst enableServiceLinks: true nodeName: k8s-node1 priority: 0 restartPolicy: Always schedulerName: default-scheduler securityContext: {} serviceAccount: default serviceAccountName: default terminationGracePeriodSeconds: 30 tolerations: - effect: NoExecute key: node.kubernetes.io/not-ready operator: Exists tolerationSeconds: 300 - effect: NoExecute key: node.kubernetes.io/unreachable operator: Exists tolerationSeconds: 300 volumes: - name: default-token-s8mbf secret: defaultMode: 420 secretName: default-token-s8mbfstatus: conditions: - lastProbeTime: null lastTransitionTime: "2019-08-30T07:00:30Z"

创建资源的方法

​​apiserver​​仅接受​​JSON​​格式的资源定义​​yaml​​格式提供资源配置清单，​​apiserver​​可自动将其转为​​json​​格式，而后再提交

大部分资源的配置清单由以下5个字段组成

apiVersion: 指明api资源属于哪个群组和版本，同一个组可以有多个版本 group/version # kubectl api-versions 命令可以获取kind: 资源类别，标记创建的资源类型，k8s主要支持以下资源类别 Pod、ReplicaSet、Deployment、StatefulSet、DaemonSet、Job、Cronjobmetadata: 用于描述对象的属性信息，主要提供以下字段： name: 指定当前对象的名称，其所属的名称空间的同一类型中必须唯一 namespace: 指定当前对象隶属的名称空间，默认值为default labels: 设定用于标识当前对象的标签，键值数据，常被用作挑选条件 annotations: 非标识型键值数据，用来作为挑选条件，用于labels的补充spec: 用于描述所期望的对象应该具有的状态（disired state），资源对象中最重要的字段。status: 用于记录对象在系统上的当前状态（current state），本字段由kubernetes自行维护

​​kubernetes​​​存在内嵌的格式说明，定义资源配置清单时，可以使用​​kubectl explain​​​命令进行查看，如查看​​Pod​​这个资源的定义：

[root@k8s-master ~]# kubectl explain podsKIND: PodVERSION: v1DESCRIPTION: Pod is a collection of containers that can run on a host. This resource is created by clients and scheduled onto hosts.FIELDS: apiVersion APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: kind Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: metadata