k8s资源配置⽂件编写(yaml、json)
⽂章⽬录
1.yaml
1.1yaml编写规则
⼤⼩写敏感
使⽤缩进表⽰层级关系
缩进时不允许使⽤Tab键,只允许使⽤空格
缩进的空格数⽬不重要,只要相同层级的元素左侧对齐即可
”#” 表⽰注释,从这个字符⼀直到⾏尾,都会被解析器忽略
YAML只有两种结构类型需要知道: lists, maps
1.2 yaml maps
Maps的value既能够对应字符串也能够对应⼀个Maps
apiVersion: v1
kind: Pod
metadata:
name: test-site
labels:
app: web
上述的YAML⽂件中,metadata这个KEY对应的值为⼀个Maps,⽽嵌套的labels这个KEY的值⼜是⼀个Map。实际使⽤中可视情况进⾏多层嵌套。
YAML处理器根据⾏缩进来知道内容之间的关联
编写为json⽂件格式与之对⽐
{
"apiVersion":"v1",
"kind":"Pod",
"metadata":{
"name":"test-site",
"labels":{
"app":"web"
}
}
}
1.3 yaml lists
List即列表,也就是数组
args
- sleep
-"1000"
- message
-"Bring back Firefly!"
以json表⽰为
{
"args":["sleep","1000","message","Bring back Firefly!"]
}
list的⼦项也可以是maps,maps的⼦项也可以是list
apiVersion: v1
kind: Pod
metadata:
name: rss-site
labels:
app: web
spec:
containers:
- name: front-end
image: nginx
ports:
- containerPort:80
-
name: rss-reader
image: nickchase/rss-php-nginx:v1
ports:
- containerPort:88
以json表⽰为
{
"apiVersion":"v1",
"kind":"Pod",
"metadata":{
"name":"rss-site",
"labels":{
"app":"web"
}
},
"spec":{
"containers":[{
"name":"front-end",
"image":"nginx",
"ports":[{
"containerPort":"80"
}]
},
{
"name":"rss-reader",
"image":"nickchase/rss-php-nginx:v1",
"ports":[{
"containerPort":"88"
}]
}]
}
}
2.k8s资源配置⽂件中的yaml参数
以下以定义⼀个pod为例
2.1必写项
参数名字段类型说明
version String这⾥是指的是K8S API的版本,⽬前基本上是v1,可以⽤kubectl api-versions命令查询
参数名字段类型说明
kind String这⾥指的是yaml⽂件定义的资源类型和⾓⾊,⽐如:Pod metadata Object元数据对象,固定值就写metadata
metadata.name String元数据对象的名字,这⾥由我们编写,⽐如命名Pod的名字metadata.namespace String元数据对象的命名空间,由我们⾃⾝定义
Spec Object详细定义对象,固定值就写Spec
⽰例⼀
# yaml格式的pod定义⽂件完整内容:
apiVersion: v1      #必选,版本号,例如v1
kind: Pod      #必选,Pod
metadata:      #必选,元数据
name: string      #必选,Pod名称
namespace: string    #必选,Pod所属的命名空间
labels:      #⾃定义标签
- name: string    #⾃定义标签名字
annotations:      #⾃定义注释列表
-
name: string
spec:        #必选,Pod中容器的详细定义
containers:      #必选,Pod中容器列表
- name: string    #必选,容器名称
image: string    #必选,容器的镜像名称
imagePullPolicy:[Always | Never | IfNotPresent] #获取镜像的策略 Alawys表⽰下载镜像 IfnotPresent表⽰优先使⽤本地镜像,否则下载镜像,Nerver表⽰仅使⽤本地镜像
command:[string]    #容器的启动命令列表,如不指定,使⽤打包时使⽤的启动命令
args:[string]    #容器的启动命令参数列表
workingDir: string    #容器的⼯作⽬录
volumeMounts:    #挂载到容器内部的存储卷配置
- name: string    #引⽤pod定义的共享存储卷的名称,需⽤volumes[]部分定义的的卷名
mountPath: string    #存储卷在容器内mount的绝对路径,应少于512字符
readOnly: boolean    #是否为只读模式
ports:      #需要暴露的端⼝库号列表
- name: string    #端⼝号名称
containerPort: int  #容器需要监听的端⼝号
hostPort: int    #容器所在主机需要监听的端⼝号,默认与Container相同
protocol: string    #端⼝协议,⽀持TCP和UDP,默认TCP
env:      #容器运⾏前需设置的环境变量列表
- name: string    #环境变量名称
value: string    #环境变量的值
resources:      #资源限制和请求的设置
limits:      #资源限制的设置
cpu: string    #Cpu的限制,单位为core数,将⽤于docker run --cpu-shares参数
memory: string    #内存限制,单位可以为Mib/Gib,将⽤于docker run --memory参数
requests:      #资源请求的设置
cpu: string    #Cpu请求,容器启动的初始可⽤数量
memory: string    #内存清楚,容器启动的初始可⽤数量
livenessProbe:    #对Pod内个容器健康检查的设置,当探测⽆响应⼏次后将⾃动重启该容器,检查⽅法有exec、httpGet和tcpSocket,对⼀个容器只需设置其中⼀种⽅法即可
其中⼀种⽅法即可
exec:      #对Pod容器内检查⽅式设置为exec⽅式
command:[string]  #exec⽅式需要制定的命令或脚本
httpGet:      #对Pod内个容器健康检查⽅法设置为HttpGet,需要制定Path、port
path: string
port: number
host: string
scheme: string
HttpHeaders:
- name: string
value: string
tcpSocket:    #对Pod内个容器健康检查⽅式设置为tcpSocket⽅式
port: number
initialDelaySeconds:0  #容器启动完成后⾸次探测的时间,单位为秒
timeoutSeconds:0  #对容器健康检查探测等待响应的超时时间,单位秒,默认1秒
periodSeconds:0    #对容器监控检查的定期探测时间设置,单位秒,默认10秒⼀次
successThreshold:0
failureThreshold:0
securityContext:
privileged:false
restartPolicy:[Always | Never | OnFailure]#Pod的重启策略,Always表⽰⼀旦不管以何种⽅式终⽌运⾏,kubelet都将重启,OnFailure表⽰只有Pod以⾮0退出码退出才重启,Nerver表⽰不再重启该Pod
nodeSelector: obeject  #设置NodeSelector表⽰将该Pod调度到包含这个label的node上,以key:value的格式指定
imagePullSecrets:    #Pull镜像时使⽤的secret名称,以key:secretkey格式指定
- name: string
hostNetwork:false      #是否使⽤主机⽹络模式,默认为false,如果设置为true,表⽰使⽤宿主机⽹络
volumes:      #在该pod上定义共享存储卷列表
- name: string    #共享存储卷名称(volumes类型有很多种)
emptyDir:{}    #类型为emtyDir的存储卷,与Pod同⽣命周期的⼀个临时⽬录。为空值
hostPath: string    #类型为hostPath的存储卷,表⽰挂载Pod所在宿主机的⽬录
path: string    #Pod所在宿主机的⽬录,将被⽤于同期中mount的⽬录
secret:      #类型为secret的存储卷,挂载集与定义的secre对象到容器内部
scretname: string
items:
- key: string
path: string
configMap:    #类型为configMap的存储卷,挂载预定义的configMap对象到容器内部
name: string
items:
- key: string
path: string
⽰例⼆
apiVersion: v1            #指定api版本,此值必须在kubectl apiversion中
kind: Pod                  #指定创建资源的⾓⾊/类型
metadata:                  #资源的元数据/属性
name: django-pod        #资源的名字,在同⼀个namespace中必须唯⼀
labels:                  #设定资源的标签,使这个标签在service⽹络中备案,以便被获知
k8s-app: django
version: v1
kubernetes.io/cluster-service:"true"
annotations:            #设置⾃定义注解列表
- name: String        #设置⾃定义注解名字
spec:                      #设置该资源的内容
restartPolicy: Always    #表⽰⾃动重启,⼀直都会有这个容器运⾏
nodeSelector:            #选择node节点14    zone: node1
containers:
- name: django-pod        #容器的名字
image: django:v1.1      #容器使⽤的镜像地址
imagePullPolicy: Never #三个选择Always、Never、IfNotPresent,每次启动时检查和更新(从registery)images的策略,nodeselector
# Always,每次都检查
# Never,每次都不检查(不管本地是否有)
# IfNotPresent,如果本地有就不检查,如果没有就拉取
command:['sh']        #启动容器的运⾏命令,将覆盖容器中的Entrypoint,对应Dockefile中的ENTRYPOINT
command:['sh']        #启动容器的运⾏命令,将覆盖容器中的Entrypoint,对应Dockefile中的ENTRYPOINT
args:["$(str)"]      #启动容器的命令参数,对应Dockerfile中CMD参数
env:                  #指定容器中的环境变量
- name: str            #变量的名字
value:"/etc/run.sh" #变量的值
resources:            #资源管理
requests:            #容器运⾏时,最低资源需求,也就是说最少需要多少资源容器才能正常运⾏
cpu:0.1          #CPU资源(核数),两种⽅式,浮点数或者是整数+m,0.1=100m,最少值为0.001核(1m)        memory:32Mi      #内存使⽤量
limits:              #资源限制
cpu:0.5
memory:32Mi
ports:
- containerPort:8080    #容器开发对外的端⼝
name: uwsgi          #名称
protocol:TCP
livenessProbe:        #pod内容器健康检查的设置
httpGet:            #通过httpget检查健康,返回200-399之间,则认为容器正常
path:/            #URI地址
port:8080
#host:127.0.0.1  #主机地址
scheme:HTTP
initialDelaySeconds:180 #表明第⼀次检测在容器启动后多长时间后开始
timeoutSeconds:5    #检测的超时时间
periodSeconds:15    #检查间隔时间
#也可以⽤这种⽅法
#exec:执⾏命令的⽅法进⾏监测,如果其退出码不为0,则认为容器正常
#  command:
#    - cat
#    -/tmp/health
#也可以⽤这种⽅法
#tcpSocket://通过tcpSocket检查健康
#  port: number
lifecycle:            #⽣命周期管理(钩⼦)
postStart:          #容器运⾏之前运⾏的任务
exec:
command:
-'sh'
-'yum upgrade -y'
preStop:            #容器关闭之前运⾏的任务
exec:
command:['service httpd stop']
volumeMounts:          #挂载设置
- name: volume        #挂载设备的名字,与volumes[*].name 需要对应
mountPath:/data    #挂载到容器的某个路径下
readOnly: True
volumes:                #定义⼀组挂载设备
- name: volume          #定义⼀个挂载设备的名字
#meptyDir:{}
hostPath:
path:/opt          #挂载设备类型为hostPath,路径为宿主机下的/opt

版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。