Kubernetes资源清单
1、k8s中的资源
集群资源分类:
- 名称空间级别:只在本名称空间下生效;kube-system
- 集群级别:role,在定义时未指定名称空间
- 元数据型:HPA--通过指标进行操作
什么是资源?
k8s中所有的内容都抽象为资源,资源实例化之后,叫做对象。
K8s中存在哪些资源
1.名称空间级别
工作负载型资源(workload):
Pod、ReplicaSet、Deployment、StatefulSet、DaemonSet、Job、CronJob(ReplicationController在v1.11版本被废弃)
- Statefulset--有状态服务建立的管理器
- DaemonSet--可以在每个节点运行一个pod的组件
- Job\Cronjob:批处理任务
服务发现及负载均衡型资源(ServiceDiscovery LoadBalance)
- Service、Ingress 将资源暴露出去
配置与存储型资源:
- Volume--存储卷
- CSI--容器存储接口,可以扩展符合k8s规则的第三方存储卷
特殊类型的存储卷:
- ConfigMap--通过它存储配置文件,达到热更新
- Secret--保存密码密钥
- DownwardAPI--下载文件的接口,调用数据
2.集群级资源:
NameSpace、Node、Role、ClusterRole、RoleBinding、ClusterRoleBinding
3.元数据型资源
通过指标进行操作
HPA、PodTemplate、LimitRange
2、资源清单
在k8s中,一般使用yaml
格式的文件来创建符合我们预期的pod,这样的yaml文件我们一般称为资源清单。
YAML语法
yaml是一个可读性高,用来表达数据序列的格式;yaml的意思其实是:仍是一种标记语言,但为了强调这种语言以数据为中心,而不是以标记语言为重点。
基本语法:
- 缩进时不允许使用Tab键,只允许使用空格
- 缩进的空格数量不重要,只要相同层级左侧对齐即可
- \# 标识注释,从这个字符一直到行尾,都会被解释器忽略
支持的数据结构:
- 对象:键值对的集合,又称映射(mapping)/哈希(hashes)/字典(dictionary)
- 数组:一组按次序排列的值,又称为序列(sequence)/列表(list)
- 纯量(scalars):单个的、不可再分的值
对象类型:对象的一组键值对,使用冒号结构表示
name: Steve
age: 18
# 键:<空格> 值
# yaml也允许另一种写法,将所有键值对写成一个行内对象
hash: { name: Steve, age: 18 }
数组类型:一组连词线开头的行,构成一个数组
animal:
- Cat
- Dog
# 数组也可以采用行内表示法,使用大括号
animal: [Cat, Dog]
复合结构:对象和数组可以结合使用,形成复合结构
languages:
- Ruby
- Perl
- Python
websites:
YAML: yaml.org
Ruby: ruby-lang.org
Python: python.org
纯量:纯量是最基本的、不可再分的值
# 字符串、布尔值、整数、浮点数、NULL
# 时间、日期
# 数值直接以字面量的形式表示
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
字符串
字符串默认不使用双引号表示
str: 这是一个字符串
如果字符串之中包含空格或特殊字符,需要放在引号之中
str: '内容: 字符串'
单引号和双引号都可以使用;但双引号不会对特殊字符转义
s1: '内容\n字符串'
s2: "内容\n字符串"
单引号之中如果还有单引号,必须连续使用两个单引号转义
str: 'labor''s day'
# 输出结果为labor's day(劳动的一天)
# 类似于转义符\'s
字符串可以写成多行,但从第二行开始,必须有一个单空格缩进;换行符会被转为空格
str: 这是一段
多行
字符串
多行字符串可以使用|保留换行符,也可以使用>折叠换行
this: |
Foo
Bar
that: >
Foo
Bar
+ 号表示保留文字块末尾的换行,- 号表示删除字符串末尾的换行
s1: |
Foo
s2: |+
Foo
s3: |-
Foo
3、
常用字段解释说明
必须存在的属性
参数名 | 字段类型 | 说明 |
---|---|---|
version | String | 这里指的是K8s API的版本,目前基本上是v1,可以用kubectl api-version命令查询 |
kind | String | 这里指的是yaml文件定义的资源类型和角色,比如:pod |
metadata | Object | 元数据对象,固定值就写 metadata |
metadata.name | String | 元数据对象的名字,这里由我们编写,比如命令Pod的名字 |
metadata.namespace | String | 元数据对象的命名空间,由我们自身定义 |
spec | Object | 详细定义对象,固定值就写 Spec |
spec.containers[] | list | 这里是Spec对象的容器列表定义,是个列表 |
spec.containers[].name | String | 这里定义容器的名字 |
spec.containers[].image | String | 这里定义要用到的镜像名称 |
主要对象:
参数名 | 字段类型 | 说明 |
---|---|---|
spec.containers[].name | String | 定义容器的名字 |
spec.containers[].image | String | 定义要用到的镜像名称 |
spec.containers[].imagePullRolicy | String | 定义镜像拉取策略,有Always、Never、IfNotPresent三个选项; Always:每次都尝试重新拉取镜像,默认Always Never:仅使用本地镜像 IfNotPresent:如果本地有镜像就使用本地就像,如果没有就拉取在线镜像; |
spec.containers[].command[] | List | 指定容器启动命令,因为是数组可以指定多个,不指定则使用镜像打包时使用的启动命令。 |
spec.containers[].args[] | List | 指定容器启动命令参数,因为是数组可以指定多个。 |
spec.containers[].workingDir | String | 指定容器的工作目录。 |
spec.containers[].volumeMounts[] | List | 指定容器内部的存储卷配置 |
spec.containers[].volumeMounts[].name | String | 指定可以被容器挂载的存储卷的名称 |
spec.containers[].volumeMounts[].mountPath | String | 指定可以被容器挂载的存储卷的路径 |
spec.containers[].volumeMounts[].readOnly | String | 设置存储卷路径的读写模式,true或者false,默认为读写模式 |
spec.containers[].ports[] | List | 指定容器需要用到的端口列表 |
spec.containers[].ports[].name | String | 指定端口名称 |
spec.containers[].containerPort | String | 指定容器需要监听的端口号 |
spec.containers[].ports[].hostPort | String | 指定容器所在主机需要监听的端口号,默认跟上面containerPort相同;注意设置了hostPort同一台主机无法启动该容器的相同副本(因为主机的端口号不能相同,这样会冲突) |
spec.containers[].ports[].protocol | String | 指定端口协议,支持TCP和UDP,默认为TCP |
spec.containers[].env[] | List | 指定容器运行前需设置的环境变量列表 |
额外的参数项
参数名 | 字段类型 | 说明 |
---|---|---|
spec.restartPolicy | String | 定义Pod的重启策略,可选值为Always、OnFailure,默认值为Always; 1.Always:pod一旦终止运行,则无论容器是如何终止的,kubelet服务都将重启它。 2.OnFailure:只有pod以非零退出码终止时,kubelet才会重启该容器;如果容器正常退出(退出码为0),则kubelet将不会重启它; 3.Never:pod终止后,kubelet将退出码报告给master,不会重启pod。 |
spec.nodeSelector | Object | 定义Node的Label过滤标签,以key: value格式指定 |
spec.imagePullSecrets | Object | 定义pull镜像时使用sercet名称,以name: secretkey格式指定 |
spec.hostNetwork | Boolean | 定义是否使用主机网络模式,默认值false;设置true表示使用宿主机网络,不使用docker网桥,同时设置了true将无法再同一台宿主机上启动第二个副本。 |
3、通过资源清单编写 Pod
查看运行的pod
kubectl get pods
查看pod详细信息
kubectl describe pod <podName>
查看容器日志
kubectl logs <podName> -c <指定容器名>
第一个ymal文件
apiVersion: v1 # k8s API 版本
kind: Pod # 资源角色:pod
metadata: # 元数据对象
name: myapp-pod # 对象名
namespace: # 命名空间
labels: # 标签
app: myapp
version: v1
spec: # 详细定义对象
containers: # 容器列表
- name: app # 容器名
image: docker.io/nginx # 镜像名
创建pod
kubectl create -f myapp.yaml