30 配置Kubernetes

译者：李昂

除了像 kubectl run 和 kubectl expose 这些必要的命令，它们在各种地方都有介绍，kubernetes也支持可声明式的配置。配置文件也需要必要的命令，这样就可以在代码审查中

检查版本控制和文件改动，而代码审查对复杂的具有鲁棒性的可靠生产系统是非常重要的。在声明式风格中，所有的配置都保存在YAML或者JSON配置文件中，使用Kubernetes的API资源模式（schema）作为配置的模式（schema）。 kubectl 命令可以创建、更新、删除以及获取API资源。 kubectl 命令用 ApiVersion （目前是“v1”）， kind 资源， name 资源去创建合适的API路径来执行特殊的操作。

使用配置文件创建一个容器

Kubernetes是在Pod中来运行容器的。一个包含了一个简单的HellWorld容器的Pod可以被如下的YAML文件指定：

apiVersion : v1

kind : Pod

metadata :

name : hello - world

spec : # specification of the pod’s contents

restartPolicy : Never

containers : - name : hello

image : "ubuntu:14.04"

command : [ "/bin/echo" , "hello”,”world" ]

metadata.name的 值 hello-world ，将会成为创建成功后Pod的名称，这个名称必须在集群中唯一，而 container[0].name 只是容器在Pod中的昵称。 image 就是Docker image的名称且Kubernetes默认会从Docker Hub中拉取镜像。

restartPolicy : Never 指明了我们只是想运行容器一次然后就终止Pod。

Command 覆盖了docker容器的 Entrypoint 。命令的参数（相当于Docker的 Cmd ）可以指定 args 参数，如下所示：

command : [ "/bin/echo" ]

args : [ "hello" , "world" ]

创建这个pod就可以使用 create 命令了

$ kubectl create - f ./ hello - world . yaml

pods / hello - world

当成功创建时， kubectl 打印出资源类型和资源名称。

配置验证

如果你不确定指定的资源是否正确，你可以 kubectl 帮你验证。

$ kubectl create - f ./ hello - world . yaml -- validate

假设我们指定的是 entrypoint 而不是 command ，你会看到如下输出：

I0709 06 : 33 : 05.600829 14160 schema . go : 126 ] unknown field : entrypoint

I0709 06 : 33 : 05.600988 14160 schema . go : 129 ] this may be a false alarm ,

see https : //github.com/GoogleCloudPlatform/kubernetes/issues/6842

pods / hello - world

kubectl create –validate 会警告已经检测出问题，除非缺少必须的字段或者字段值不合法，最后kubectl还是会创建出资源。一定要小心，未知的API字段会被忽略。这个pod没有 command 字段而被创建，command字段是一个可选字段，因为image镜像可以指定 Entrypoint 。访问Pod API object来查看合法字段列表。

环境变量和增加变量

Kubernetes没有自动的在shell中的运行命令（不是所有镜像都有shell）。如果你想在shell中运行你的命令，例如增加环境便令（使用 env 字段），你可以按如下做法：

apiVersion : v1

kind : Pod

metadata :

name : hello - world

spec : # specification of the pod’s contents

restartPolicy : Never

containers : - name : hello

image : "ubuntu:14.04"

env : - name : MESSAGE

value : "hello world"

command : [ "/bin/sh" , "-c" ]

args : [ "/bin/echo \"${MESSAGE}\"" ]

然而，一个shell需要的不仅是增加环境变量。如果你使用 $(ENVVAR) 语法Kubernetes将会为你做这些事。

查看pod状态

使用get命令，你可以看到你已经创建的pod（事实上是集群中你的所有pod）。如果你在创建后用足够快的速度输入 get 命令，你会看到下面的内容：

$ kubectl get pods

NAME READY STATUS RESTARTS AGE

hello - world 0 / 1 Pending 0 0s

初始化的时候，新创建的pod还未被调度，也就是还没有节点被选中去运行它。pod创建后会进行调度但是它很快，所以你正常是不会看到pods处于未被调度的状态，除非有问题产生。

在pod被调度之后，如果节点中还没有镜像那么就会先通过docker拉取响应的镜像。一切就绪后，你会看到容器在运行：

$ kubectl get pods

NAME READY STATUS RESTARTS AGE

hello - world 1 / 1 Running 0 s

Ready 列指示正在运行在pod中的容器数量。

而开始运行后很快这个容器将会被终止。 kubectl 会显示容器已经不再运行以及推出状态：

$ kubectl get pods

NAME READY STATUS RESTARTS AGE

hello - world 0 / 1 ExitCode : 0 0 15s

查看pod输出

你会想要查看你运行命令的输出。像 docker logs 一样， kubectl logs 也会显示输出：

$ kubectl logs hello - world

hello world

删除pods

当你看完的输出，你应该删除pod：

$ kubectl delete pod hello - world

pods / hello - world

就像 create 一样，删除成功时 kubectl 也会打印出资源类型和资源名称。

你也可以使用 资源/名称格式指定一个pod：

$ kubectl delete pods / hello - world

pods / hello - world

终止pods不会自动的删除，你可以观察他们的最终状态，所以请确定清理了你的已经结束的pods。

在另一方面， 为了在节点中释放磁盘空间容器和他们的日志也会被自动删除 。