Kubernetes中文文档

配置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。

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