Kubernetes用户指南（一）--快速开始、使用k8s配置文件

一、快速开始

1、启动一个简单的容器。

一旦在container中打包好应用并将其commit为image之后，你就可以将其部署在k8s集群上。

一个简单的nginx服务器例子：

先决条件：你需要拥有的是一个部署完毕并可以正常运行的k8s集群。

在Master节点上使用kubectl命令来启动一个运行着nginx服务器的容器：

$ kubectl run my-nginx --image=nginx --replicas=2 --port=80

CONTROLLER   CONTAINER(S)   IMAGE(S)   SELECTOR       REPLICAS

my-nginx     my-nginx       nginx      run=my-nginx   2

以上命令会让节点上的Docker从nginx这个image上启动一个容器监听80端口，此为一个pod。

而replicas=2则表示会起两个一模一样的pod。

使用以下命令来查看创建的pod：

$ kubectl get po

NAME             READY     STATUS    RESTARTS   AGE

my-nginx-l8n3i   1/1       Running   0          29m

my-nginx-q7jo3   1/1       Running   0          29m

k8s会确保你的应用是一直运行的，当容器运行失败时，k8s会自动重启容器，当整个节点失败时，会在另外一个健康的节点启动这个容器。

2、通过端口将应用连接到Internet上。

先决条件：拥有公网IP，或者在云服务器上，如：阿里云，亚马逊云等。

以下命令将上一步骤中的nginx容器连接到公网中：

$ kubectl expose rc my-nginx --port=80 --type=LoadBalancer

NAME       LABELS         SELECTOR       IP(S)     PORT(S)

my-nginx   run=my-nginx   run=my-nginx             80/TCP

rc即Replication Controller，上一步骤中的命令其实会自动创建一个名为my-nginx的rc来确保pod的数量维持在2个。

可以使用以下命令来查看rc：

$ kubectl get rc

CONTROLLER   CONTAINER(S)  IMAGE(S)   SELECTOR      REPLICAS 

my-nginx     my-nginx      nginx      run=my-nginx     2
   

expose命令将会创建一个service，将本地（某个节点上）的一个随机端口关联到容器中的80端口。

可以使用以下命令来查service：

$ kubectl get svc my-nginx

NAME         LABELS          SELECTOR     IP(S)              PORT(S)         

my-nginx     run=my-nginx    run=nginx    10.254.110.117     80/TCP     

type指明这个svc将会起到一个负载均衡的作用，会将流量导入两个pod中。

svc会分配一个虚拟IP用来访问容器，如上步骤中分配的IP为10.254.110.117，则可以在任意节点上通过curl 10.254.110.117得到nginx的欢迎界面。

在分配虚拟IP的过程中，你可能需要等待一些时间。

在任一节点上使用netstat -tunpl命令可以看到，kube-proxy监听的端口多了一个，端口号是随机的，可以在浏览器中输入该节点的公网IP:端口访问放nginx的欢迎界面。

3、删除容器。

删除rc，即删除该rc控制的所有容器。

删除svc，即删除分配的虚拟IP。

$ kubectl delete rc my-nginx

replicationcontrollers/my-nginx

$ kubectl delete svc my-nginx

services/my-nginx

注意，如果使用delete pod ${podName}来删除是没有效果的，因为rc会马上启动另外一个pod来维持总数量为2。

二、通过配置文件来创建资源。

除了某些强制性的命令，如：kubectl run或者expose等，会隐式创建rc或者svc，k8s还允许通过配置文件的方式来创建这些操作对象。

通常，使用配置文件的方式会比直接使用命令行更可取，因为这些文件可以进行版本控制，而且文件的变化和内容也可以进行审核，当使用及其复杂的配置来提供一个稳健、可靠和易维护的系统时，这些点就显得非常重要。

在声明定义配置文件的时候，所有的配置文件都存储在YAML或者JSON格式的文件中并且遵循k8s的资源配置方式。

kubectl可以创建、更新、删除和获得API操作对象，当前apiVersion、kind和name会组成一个API Path以供kubectl来调用。

1、通过一个配置文件来启动容器。

k8s的pod中运行容器，一个包含简单的Hello World容器的pod可以通过YAML文件这样来定义：

apiVersion: v1

kind: Pod

metadata:

  name: hello-world

spec: 
# 当前pod内容的声明

restartPolicy: Never

  containers:

  - name: hello

    image: "ubuntu:14.04"

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

创建的pod名为metadata.name的值：hello-world，该名称必须是唯一的。

spec的内容为该pod中，各个容器的声明：

restartPolicy：Never表示启动后运行一次就终止这个pod。

containers[0].name为容器1的名字。

containers[0].image为该启动该容器的镜像。

containers[0].command相当于Dockerfile中定义的Entrypoint，可以通过下面的方式来声明cmd的参数：

command: ["/bin/echo"]

args: ["hello","world"]

使用以下命令来通过这个YAML文件创建pod：

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

pods/hello-world

2、检验配置文件的正确性。

当你不确定声明的配置文件是否书写正确时，可以使用以下命令要验证：

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

使用--validate只是会告诉你它发现的问题，仍然会按照配置文件的声明来创建资源，除非有严重的错误使创建过程无法继续，如必要的字段缺失或者字段值不合法，不在规定列表内的字段会被忽略。

点此查看完成的字段列表：

Pod
API object

3、环境变量和变量扩展。

因为并不是所有的image都包含有shell，所以k8s并不会自动执行shell命令，如果你想在容器的shell中执行一些命令，例如扩展环境变量，你可以这么定义配置文件：

apiVersion: v1

kind: Pod

metadata:

  name: hello-world

spec:  

restartPolicy: Never

  containers:

  - name: hello

    image: "ubuntu:14.04"

    env:

    - name: MESSAGE

      value: "hello world"

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

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

但是，如果只是扩展一些环境变量就使用shell是不必要的，所以上面的声明并不会让k8s在启动pod的时候执行，如果你真的想要达到这种效果请使用以下声明代替：

command: ["/bin/echo"]

args: ["$(MESSAGE)"]

更多的设置环境变量的语法：

$(ENVVAR) syntax

4、查看pod状态。

你可以通过get命令来查看被创建的pod。

如果执行完创建pod的命令之后，你的速度足够快，那么使用get命令你将会看到以下的状态：

$ kubectl get pods

NAME          READY     STATUS    RESTARTS   AGE

hello-world   0/1       Pending   0          0s

一个pod刚被创建的时候是不会被调度的，因为没有任何节点被选择用来运行这个pod。

调度的过程发生在创建完成之后，但是这个过程一般很快，所以你通常看不到pod是出于unscheduler状态的除非创建的过程遇到了问题。

pod被调度之后，分配到指定的节点上运行，这时候，如果该节点没有所需要的image，那么将会自动从默认的Docker Hub上pull指定的image，一切就绪之后，你就可以看到pod是处于running状态了：

$ kubectl get pods

NAME          READY     STATUS    RESTARTS   AGE

hello-world   1/1       Running   0          5s

其中READY字段表示该pod中 正在运行的容器数量/总容器数量。

由于我们创建的pod是只运行一次就终止，所以在它运行起来之后，它就会马上终止了，再次查看pod状态结果如下：

$ kubectl get pods

NAME          READY     STATUS       RESTARTS   AGE

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

5、查看pod输出。

你可能会有想了解在pod中执行命令的输出是什么，和Docker logs命令一样，kubectl logs将会显示这些输出：

$ kubectl logs hello-world

hello world

6、删除pod。

当你查看完输出之后，就可以将这个pod删除了：

$ kubectl delete pod hello-world

pods/hello-world

和create一样，delete成功之后会打印出被删除的资源类型/资源名。

也可以使用资源类型/资源名的格式删除：

$ kubectl delete pods/hello-world

pods/hello-world

被终止的pod不会马上自动删除，所以你可以通过观察pod的最终状态是什么，来确认是否需要清理删除你的那些挂掉的pod。

另外，为了释放节点上的磁盘空间，删除pod时容器和它们的日志信息会被一起自动删除。