当前位置: 代码网 > 服务器>服务器>云虚拟主机 > 云原生系列Kubernetes深度解析YAML文件使用

云原生系列Kubernetes深度解析YAML文件使用

2024年05月21日 云虚拟主机 我要评论
写在前面在前⾯的课程中,我们在安装 kubernetes 集群的时候使⽤了⼀些 yaml ⽂件来创建相关的资源,但大家对 yaml ⽂件还是⾮常陌⽣。所以我们先来简单看⼀看 yaml ⽂件是如何⼯作的

写在前面

在前⾯的课程中,我们在安装 kubernetes 集群的时候使⽤了⼀些 yaml ⽂件来创建相关的资源,但大家对 yaml ⽂件还是⾮常陌⽣。所以我们先来简单看⼀看 yaml ⽂件是如何⼯作的,并使⽤ yaml ⽂件来定义⼀个 k8s pod,然后再定义⼀个 k8s deployment吧。

yaml基础

它的基本语法规则如下:

  • ⼤⼩写敏感
  • 使⽤缩进表示层级关系
  • 缩进时不允许使⽤tab键,只允许使⽤空格。
  • 缩进的空格数⽬不重要,只要相同层级的元素左侧对⻬即可
  • #表示注释,从这个字符⼀直到⾏尾,都会被解析器忽略。

在我们的 kubernetes 中,你只需要两种结构类型就⾏了:

  • lists
  • maps

也就是说,你可能会遇到 lists 的 maps 和 maps 的 lists,等等。不过不⽤担⼼,你只要掌握了这两 种结构也就可以了,其他更加复杂的我们暂不讨论。

maps

⾸先我们来看看 maps,我们都知道 map 是字典,就是⼀个 key:value 的键值对,maps 可以让我们 更加⽅便的去书写配置信息,例如:

--- 
apiversion: v1 
kind: pod

第⼀⾏的 - - - 是分隔符,是可选的,在单⼀⽂件中,可⽤连续三个连字号 --- 区分多个⽂件。这⾥我 们可以看到,我们有两个键: kind 和 apiversion ,他们对应的值分别是:v1 和pod。上⾯的 yaml ⽂件转换成 json 格式的话,你肯定就容易明⽩了:

{ 
"apiversion": "v1",
 "kind": "pod" 
 }

我们在创建⼀个相对复杂⼀点的 yaml ⽂件,创建⼀个 key 对应的值不是字符串⽽是⼀个 maps:

--- 
apiversion: v1
kind: pod 
metadata: 
name: kube100-site 
labels: 
app: web 

上⾯的 yaml ⽂件,metadata 这个 key 对应的值就是⼀个 maps 了,⽽且嵌套的 labels 这个 key 的值⼜是⼀个 map,你可以根据你⾃⼰的情况进⾏多层嵌套。

上⾯我们也提到了 yaml ⽂件的语法规则,yaml 处理器是根据⾏缩进来知道内容之间的嗯关联性 的。⽐如我们上⾯的 yaml ⽂件,我⽤了两个空格作为缩进,空格的数量并不重要,但是你得保持⼀ 致,并且⾄少要求⼀个空格(什么意思?就是你别⼀会缩进两个空格,⼀会缩进4个空格)。

我们可以看到 name 和 labels 是相同级别的缩进,所以 yaml 处理器就知道了他们属于同⼀个 map,⽽ app 是 labels 的值是因为 app 的缩进更⼤。

注意:在 yaml ⽂件中绝对不要使⽤ tab 键。

同样的,我们可以将上⾯的 yaml ⽂件转换成 json ⽂件:

{ 
"apiversion": "v1", 
"kind": "pod", 
"metadata": { 
"name": "kube100-site", 
"labels": { 
"app": "web" 
} 
} 
} 

或许你对上⾯的 json ⽂件更熟悉,但是你不得不承认 yaml ⽂件的语义化程度更⾼吧?

lists

lists 就是列表,说⽩了就是数组,在 yaml ⽂件中我们可以这样定义:

args
- cat 
- dog 
- fish

你可以有任何数量的项在列表中,每个项的定义以破折号(-)开头的,与⽗元素直接可以缩进⼀个空 格。对应的 json 格式如下:

{ 
"args": [ 'cat', 'dog', 'fish' ] 
}

当然,list 的⼦项也可以是 maps,maps 的⼦项也可以是list如下所示:

--- 
apiversion: v1 
kind: pod 
metadata: 
name: kube100-site 
labels: 
app: web 
spec: 
containers: 
- name: front-end 
image: nginx 
ports: 
- containerport: 80 
- name: flaskapp-demo 
image: jcdemo/flaskapp 
ports: 
- containerport: 5000 

⽐如这个 yaml ⽂件,我们定义了⼀个叫 containers 的 list 对象,每个⼦项都由 name、image、 ports 组成,每个 ports 都有⼀个 key 为 containerport 的 map 组成,同样的,我们可以转成如下 json 格式⽂件:

{ 
"apiversion": "v1", 
"kind": "pod", 
"metadata": { 
"name": "kube100-site", 
"labels": { 
"app": web" 
} 
},
"spec": { 
"containers": [{ 
"name": "front-end", 
"image": "nginx", 
"ports": [{ 
"containerport": "80" 
}] 
}, {
"name": "flaskapp-demo", 
"image": "jcdemo/flaskapp", 
"ports": [{ 
"containerport": "5000" 
}] 
}] 
} 
} 

是不是觉得⽤ json 格式的话⽂件明显⽐ yaml ⽂件更复杂了呢?

使⽤ yaml 创建 pod

现在我们已经对 yaml ⽂件有了⼤概的了解了,我相信你应该没有之前那么懵逼了吧?我们还是来使⽤ yaml ⽂件来创建⼀个 deployment 吧。

api 说明:https://kubernetes.io/docs/reference/generated/kubernetes−api/v1.10/\color{#00c5cd}{https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.10/ }https://kubernetes.io/docs/reference/generated/kubernetes−api/v1.10/

创建 pod

--- 
apiversion: v1 
kind: pod 
metadata: 
name: kube100-site 
labels: 
app: web 
spec: 
containers: 
- name: front-end 
image: nginx 
ports: 
- containerport: 80 
- name: flaskapp-demo 
image: jcdemo/flaskapp 
ports: 
- containerport: 5000 

这是我们上⾯定义的⼀个普通的 pod ⽂件,我们先来简单分析下⽂件内容:

  • apiversion,这⾥它的值是 v1,这个版本号需要根据我们安装的 kubernetes 版本和资源类型进⾏ 变化的,记住不是写死的
  • kind,这⾥我们创建的是⼀个 pod,当然根据你的实际情况,这⾥资源类型可以是 deployment、 job、ingress、service 等待。
  • metadata:包含了我们定义的 pod 的⼀些 meta 信息,⽐如名称、namespace、标签等等信息。
  • spec:包括⼀些 containers,storage,volumes,或者其他 kubernetes 需要知道的参数,以及诸 如是否在容器失败时重新启动容器的属性。你可以在特定 kubernetes api 找到完整的 kubernetes pod 的属性。

让我们来看⼀个典型的容器的定义:

…spec: 
containers: 
- name: front-end 
image: nginx 
ports: 
- containerport: 80 
… 

在这个例⼦中,这是⼀个简单的最⼩定义:⼀个名字(front-end),基于 nginx 的镜像,以及容器将会监听的⼀个端⼝(80)。在这些当中,只有名字是⾮常需要的,你也可以指定⼀个更加复杂的属性,例如在容器启动时运⾏的命令,应使⽤的参数,⼯作⽬录,或每次实例化时是否拉取映像的新副本。以下是⼀些容器可选的设置属性:

  • name

  • image
  • command
  • args
  • workingdir
  • ports
  • env
  • resources
  • volumemounts
  • livenessprobe
  • readinessprobe
  • livecycle
  • terminationmessagepath
  • imagepullpolicy
  • securitycontext
  • stdin
  • stdinonce
  • tty

明⽩了 pod 的定义后,我们将上⾯创建 pod 的 yaml ⽂件保存成 pod.yaml,然后使⽤ kubectl 创建 pod:

$ kubectl create -f pod.yaml 
pod "kube100-site" created 

然后我们就可以使⽤我们前⾯⽐较熟悉的 kubectl 命令来查看 pod 的状态了:

$ kubectl get pods 
name ready status restarts age 
kube100-site 2/2 running 0 1m 

到这⾥我们的 pod 就创建成功了,如果你在创建过程中有任何问题,我们同样可以使⽤前⾯的 kubectl describe 进⾏排查。我们先删除上⾯创建的pod:

$ kubectl delete -f pod.yaml 
pod "kube100-site" deleted

创建 deployment

现在我们可以来创建⼀个真正的 deployment。在上⾯的例⼦中,我们只是单纯的创建了⼀个 pod 实 例,但是如果这个 pod 出现了故障的话,我们的服务也就挂掉了,所以 k8s 提供了⼀ 个 deployment 的概念,可以让 kubernetes 去管理⼀组 pod 的副本,也就是副本集,这样就可以保 证⼀定数量的副本⼀直可⽤的,不会因为⼀个 pod 挂掉导致整个服务挂掉。我们可以这样定义⼀个 deployment:

--- 
apiversion: extensions/v1beta1 
kind: deployment 
metadata: 
name: kube100-site
spec: 
replicas: 2 

注意这⾥ apiversion 对应的值是 extensions/v1beta1 ,当然 kind 要指定为 deployment,因为这 就是我们需要的,然后我们可以指定⼀些 meta 信息,⽐如名字,或者标签之类的。最后,最重要的 是 spec 配置选项,这⾥我们定义需要两个副本,当然还有很多可以设置的属性,⽐如⼀个 pod 在没 有任何错误变成准备的情况下必须达到的最⼩秒数。 我们可以在kubernetes v1beta1 api参考中找到 ⼀个完整的 depolyment 可指定的参数列表。 现在我们来定义⼀个完整的 deployment 的 yaml ⽂件:

--- 
apiversion: extensions/v1beta1 
kind: deployment 
metadata: 
name: kube100-site 
spec: 
replicas: 2 
template: 
metadata: 
labels: 
app: web 
spec: 
containers: 
- name: front-end 
image: nginx 
ports: 
- containerport: 80 
- name: flaskapp-demo 
image: jcdemo/flaskapp 
ports: 
- containerport: 5000 

看起来是不是和我们上⾯的 pod.yaml 很类似啊,注意其中的 template,其实就是对 pod 对象的定义。将上⾯的 yaml ⽂件保存为 deployment.yaml,然后创建 deployment:

$ kubectl create -f deployment.yaml 
deployment "kube100-site" created 
```同样的,想要查看它的状态,我们可以检查 deployment的列表:
```go
$ kubectl get deployments 
name desired current up-to-date available age 
kube100-site 2 2 2 2 2m 

我们可以看到所有的 pods 都已经正常运⾏了。 到这⾥我们就完成了使⽤ yaml ⽂件创建 kubernetes deployment 的过程,在了解了 yaml ⽂件的基础后,定义 yaml ⽂件其实已经很简单了,最主要的是要根据实际情况去定义 yaml ⽂件,所以查阅 kubernetes ⽂档很重要。

可以使⽤http://www.yamllint.com/去检验 yaml ⽂件的合法性

以上就是云原生系列kubernetes深度解析yaml文件使用的详细内容,更多关于kubernetes解析yaml文件的资料请关注代码网其它相关文章!

(0)

相关文章:

版权声明:本文内容由互联网用户贡献,该文观点仅代表作者本人。本站仅提供信息存储服务,不拥有所有权,不承担相关法律责任。 如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 2386932994@qq.com 举报,一经查实将立刻删除。

发表评论

验证码:
Copyright © 2017-2025  代码网 保留所有权利. 粤ICP备2024248653号
站长QQ:2386932994 | 联系邮箱:2386932994@qq.com