Kubernetes的资源清单

一、k8s中的资源

1、什么是资源

• k8s中所有的内容都抽象为资源，资源实例化之后，叫做对象

2、名称空间级别

• 工作负载型资源(workload)：Pod、ReplicaSet、Deployment、StatefulSet、DaemonSet、Job、CronJob

• 服务发现及负载均衡型资源(ServiceDiscovery LoadBlance)：Service、Ingress、…

• 配置与存储型资源：Volume(存储卷)、CSI(容器存储接口，可以扩展各种各样的第三方存储卷)

• 特殊类型的存储卷：ConfigMap(当配置中心来使用的资源类型)、Secret(保存敏感数据)、DownwardAPI(把外部环境中的信息输出容器)

• 集群级资源：Namespace、Node、Role、ClusterRole、RoleBinding、ClusterRoleBinding

• 元数据型资源：HPA、PodTemplate、LimitRange

二、资源清单

1、什么是资源清单

在k8s中，一般使用yaml格式的文件来创建符合我们预期期望的pod，这样的yaml文件我们一般称为资源清单

2、资源清单格式

apiVersion: group/apiversion  # 如果没有给定 group 名称，那么默认为 core，可以使用 kubectl api-
versions # 获取当前 k8s 版本上所有的 apiVersion 版本信息( 每个版本可能不同 )
kind:       #资源类别
metadata：  #资源元数据   
   name   
   namespace   
   lables   
   annotations   # 主要目的是方便用户阅读查找
spec: # 期望的状态（disired state）
status：# 当前状态，本字段有 Kubernetes 自身维护，用户不能去定义

3、资源清单上的常用命令

获取apiVersion版本信息

[root@k8s-master01 ~]# kubectl api-versions
admissionregistration.k8s.io/v1beta1
apiextensions.k8s.io/v1beta1
apiregistration.k8s.io/v1
apiregistration.k8s.io/v1beta1
apps/v1
......(以下省略)

获取资源的apiVersion版本信息

[root@k8s-master01 ~]# kubectl explain pod
KIND:     Pod
VERSION:  v1
.....(以下省略)
[root@k8s-master01 ~]# kubectl explain Ingress
KIND:     Ingress
VERSION:  extensions/v1beta1

获取字段设置帮助文档

[root@k8s-master01 ~]# kubectl explain pod
KIND:     Pod
VERSION:  v1

DESCRIPTION:     
     Pod is a collection of containers that can run on a host. This resource is created by clients and scheduled onto hosts.
FIELDS:   
   apiVersion    <string>     
   ........     
   ........

字段配置格式

apiVersion <string>          #表示字符串类型
metadata <Object>            #表示需要嵌套多层字段
labels <map[string]string>   #表示由k:v组成的映射
finalizers <[]string>        #表示字串列表
ownerReferences <[]Object>   #表示对象列表
hostPID <boolean>            #布尔类型
priority <integer>           #整型
name <string> -required-     #如果类型后面接 -required-，表示为必填字段

4、通过定义清单文件创建Pod

apiVersion: v1
kind: Pod
metadata:  
  name: pod-demo  
  namespace: default  
  labels:    
    app: myapp
spec:  
  containers:  
  - name: myapp-1    
    image: daocloud.io/library/nginx:1.13.0-alpine
  - name: busybox-1    
    image: busybox:latest    
    command:    
     "/bin/sh"    
     - "-c"    
     - "sleep 3600"

kubectl get pod xx.xx.xx -o yaml  
<!--使用 -o 参数加 yaml，可以将资源的配置以 yaml的格式输出出来，也可以使用json，输出为json格式-->

三、Yaml语法

1、简单说明

是一个可读性高，用来表达数据序列的格式。Yaml的意思仍是一种标记语言，但为了强调这种语言以数据作为中心，而不是以标记语言为重点

2、基本语法

• 缩进时不允许使用Tab键，只允许使用空格
• 缩进的空格数目不重要，只要相同层级的元素左侧对齐即可

• 标识注释，从这个字符一直到行尾，都会被解释器忽略

3、Yaml支持的数据结构

• 对象：键值对的集合，又称为映射(mapping)/哈希(hashes)/字典(dictionary)
• 数组：一组按次序排列的值，又称为序列(sequence)/列表(list)
• 纯量(scalars)：单个的、不可再分的值

4、对象类型：对象的一组键值对，使用冒号结构表示

name： jake
age: 17

5、yaml也允许另一种写法，将所有键值对写成一个行内对象

hash: {name: jake, age: 17}

6、数组类型：一组连词线开头的行，构成一个数组

animal
- cat
- dog

数组也可以采用行内表示法

animal: [cat, dog]

7、复合结构：对象和数组可以结合使用，形成复合结构

1 languages:
2 - Ruby
3 - Perl
4 - Python
5 websites:
6 YAML: yaml.org
7 Ruby: ruby-lang.org
8 Python: python.org
9 Perl: use.perl.org

8、纯量：纯量是最基本的、不可再分的值。以下数据类型都属于纯量

1 字符串布尔值整数浮点数 Null
2 时间日期
数值直接以字面量的形式表示
number: 12.30
布尔值用true和false表示
isSet: true
null用 ~ 表示
parent: ~
时间采用 ISO8601 格式
iso8601: 2001-12-14t21:59:43.10-05:00
日期采用复合 iso8601 格式的年、月、日表示
date: 1976-07-31
YAML 允许使用两个感叹号，强制转换数据类型
e: !!str 123
f: !!str true

9、字符串

str: 这是一行字符串

如果字符串之中包含空格或特殊字符，需要放在引号之中

str: '内容： 字符串'

单引号和双引号都可以使用，双引号不会对特殊字符转义

s1: '内容\n字符串'
s2: "内容\n字符串"

单引号之中如果还有单引号，必须连续使用两个单引号转义

str: 'labor''s day'

字符串可以写成多行，从第二行开始，必须有一个单空格缩进。换行符会被转为空格

str: 这是一段
  多行
  字符串

多行字符串可以使用|保留换行符，也可以使用>折叠换行

this: |
Foo
Bar
that: >
Foo
Bar

+表示保留文字块末尾的换行，-表示删除字符串末尾的换行

s1: |
  Foo

s2: |+
  Foo

s3: |-
  Foo

10、Yaml常用字段说明

• 必须存在的属性

• 主要对象

• 额外参数项