写在前面
在前⾯的课程中,我们在安装 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文件的资料请关注代码网其它相关文章!
发表评论