docker用户过渡到kubectl命令行指南

对于没有使用过 kubernetes 的 docker 用户，如何快速掌握 kubectl 命令？

在本文中，我们将向 docker-cli 用户介绍 Kubernetes 命令行如何与 api 进行交互。该命令行工具——kubectl，被设计成 docker-cli 用户所熟悉的样子，但是它们之间又存在一些必要的差异。该文档将向您展示每个 docker 子命令和 kubectl 与其等效的命令。

在使用 kubernetes 集群的时候，docker 命令通常情况是不需要用到的，只有在调试程序或者容器的时候用到，我们基本上使用 kubectl 命令即可，所以在操作 kubernetes 的时候我们抛弃原先使用 docker 时的一些观念。

docker run

如何运行一个 nginx Deployment 并将其暴露出来？ 查看 kubectl run 。

使用 docker 命令：

  1. $ docker run -d --restart=always -e DOMAIN=cluster --name nginx-app -p 80:80 nginx
  2. a9ec34d9878748d2f33dc20cb25c714ff21da8d40558b45bfaec9955859075d0
  3. $ docker ps
  4. CONTAINER ID        IMAGE               COMMAND                CREATED             STATUS              PORTS                         NAMES
  5. a9ec34d98787        nginx               "nginx -g 'daemon of   2 seconds ago       Up 2 seconds        0.0.0.0:80->80/tcp, 443/tcp   nginx-app

使用 kubectl 命令：

  1. # start the pod running nginx
  2. $ kubectl run --image=nginx nginx-app --port=80 --env="DOMAIN=cluster"
  3. deployment "nginx-app" created

在大于等于 1.2 版本 Kubernetes 集群中，使用kubectl run 命令将创建一个名为 “nginx-app” 的 Deployment。如果您运行的是老版本，将会创建一个 replication controller。 如果您想沿用旧的行为，使用 --generation=run/v1 参数，这样就会创建 replication controller。查看 kubectl run 获取更多详细信息。

  1. # expose a port through with a service
  2. $ kubectl expose deployment nginx-app --port=80 --name=nginx-http
  3. service "nginx-http" exposed

在 kubectl 命令中，我们创建了一个 Deployment，这将保证有 N 个运行 nginx 的 pod（N 代表 spec 中声明的 replica 数，默认为 1）。我们还创建了一个 service，使用 selector 匹配具有相应的 selector 的 Deployment。查看 快速开始 获取更多信息。

默认情况下镜像会在后台运行，与docker run -d ... 类似，如果您想在前台运行，使用：

  1. kubectl run [-i] [--tty] --attach <name> --image=<image>

与 docker run ... 不同的是，如果指定了 --attach ，我们将连接到 stdin，stdout 和 stderr，而不能控制具体连接到哪个输出流（docker -a ...）。

因为我们使用 Deployment 启动了容器，如果您终止了连接到的进程（例如 ctrl-c），容器将会重启，这跟 docker run -it不同。 如果想销毁该 Deployment（和它的 pod），您需要运行 kubeclt delete deployment <name>。

docker ps

如何列出哪些正在运行？查看 kubectl get。

使用 docker 命令：

  1. $ docker ps
  2. CONTAINER ID        IMAGE               COMMAND                CREATED             STATUS              PORTS                         NAMES
  3. a9ec34d98787        nginx               "nginx -g 'daemon of   About an hour ago   Up About an hour    0.0.0.0:80->80/tcp, 443/tcp   nginx-app

使用 kubectl 命令：

  1. $ kubectl get po
  2. NAME              READY     STATUS    RESTARTS   AGE
  3. nginx-app-5jyvm   1/1       Running   0          1h

docker attach

如何连接到已经运行在容器中的进程？查看 kubectl attach。

使用 docker 命令：

  1. $ docker ps
  2. CONTAINER ID        IMAGE               COMMAND                CREATED             STATUS              PORTS                         NAMES
  3. a9ec34d98787        nginx               "nginx -g 'daemon of   8 minutes ago       Up 8 minutes        0.0.0.0:80->80/tcp, 443/tcp   nginx-app
  4. $ docker attach a9ec34d98787
  5. ...

使用 kubectl 命令：

  1. $ kubectl get pods
  2. NAME              READY     STATUS    RESTARTS   AGE
  3. nginx-app-5jyvm   1/1       Running   0          10m
  4. $ kubectl attach -it nginx-app-5jyvm
  5. ...

docker exec

如何在容器中执行命令？查看 kubectl exec。

使用 docker 命令：

  1. $ docker ps
  2. CONTAINER ID        IMAGE               COMMAND                CREATED             STATUS              PORTS                         NAMES
  3. a9ec34d98787        nginx               "nginx -g 'daemon of   8 minutes ago       Up 8 minutes        0.0.0.0:80->80/tcp, 443/tcp   nginx-app
  4. $ docker exec a9ec34d98787 cat /etc/hostname
  5. a9ec34d98787

使用 kubectl 命令：

  1. $ kubectl get po
  2. NAME              READY     STATUS    RESTARTS   AGE
  3. nginx-app-5jyvm   1/1       Running   0          10m
  4. $ kubectl exec nginx-app-5jyvm -- cat /etc/hostname
  5. nginx-app-5jyvm

执行交互式命令怎么办？

使用 docker 命令：

  1. $ docker exec -ti a9ec34d98787 /bin/sh
  2. # exit

使用 kubectl 命令：

  1. $ kubectl exec -ti nginx-app-5jyvm -- /bin/sh      
  2. # exit

更多信息请查看 获取运行中容器的 Shell 环境。

docker logs

如何查看运行中进程的 stdout/stderr？查看 kubectl logs。

使用 docker 命令：

  1. $ docker logs -f a9e
  2. 192.168.9.1 - - [14/Jul/2015:01:04:02 +0000] "GET / HTTP/1.1" 200 612 "-" "curl/7.35.0" "-"
  3. 192.168.9.1 - - [14/Jul/2015:01:04:03 +0000] "GET / HTTP/1.1" 200 612 "-" "curl/7.35.0" "-"

使用 kubectl 命令：

  1. $ kubectl logs -f nginx-app-zibvs
  2. 10.240.63.110 - - [14/Jul/2015:01:09:01 +0000] "GET / HTTP/1.1" 200 612 "-" "curl/7.26.0" "-"
  3. 10.240.63.110 - - [14/Jul/2015:01:09:02 +0000] "GET / HTTP/1.1" 200 612 "-" "curl/7.26.0" "-"

现在是时候提一下 pod 和容器之间的细微差别了；默认情况下如果 pod 中的进程退出 pod 也不会终止，相反它将会重启该进程。这类似于 docker run 时的 --restart=always 选项， 这是主要差别。在 docker 中，进程的每个调用的输出都是被连接起来的，但是对于 kubernetes，每个调用都是分开的。要查看以前在 kubernetes 中执行的输出，请执行以下操作：

  1. $ kubectl logs --previous nginx-app-zibvs
  2. 10.240.63.110 - - [14/Jul/2015:01:09:01 +0000] "GET / HTTP/1.1" 200 612 "-" "curl/7.26.0" "-"
  3. 10.240.63.110 - - [14/Jul/2015:01:09:02 +0000] "GET / HTTP/1.1" 200 612 "-" "curl/7.26.0" "-"

查看 记录和监控集群活动 获取更多信息。

docker stop 和 docker rm

如何停止和删除运行中的进程？查看 kubectl delete。

使用 docker 命令：

  1. $ docker ps
  2. CONTAINER ID        IMAGE               COMMAND                CREATED             STATUS              PORTS                         NAMES
  3. a9ec34d98787        nginx               "nginx -g 'daemon of   22 hours ago        Up 22 hours         0.0.0.0:80->80/tcp, 443/tcp   nginx-app
  4. $ docker stop a9ec34d98787
  5. a9ec34d98787
  6. $ docker rm a9ec34d98787
  7. a9ec34d98787

使用 kubectl 命令：

  1. $ kubectl get deployment nginx-app
  2. NAME        DESIRED   CURRENT   UP-TO-DATE   AVAILABLE   AGE
  3. nginx-app   1         1         1            1           2m
  4. $ kubectl get po -l run=nginx-app
  5. NAME                         READY     STATUS    RESTARTS   AGE
  6. nginx-app-2883164633-aklf7   1/1       Running   0          2m
  7. $ kubectl delete deployment nginx-app
  8. deployment "nginx-app" deleted
  9. $ kubectl get po -l run=nginx-app
  10. # Return nothing

请注意，我们不直接删除 pod。使用 kubectl 命令，我们要删除拥有该 pod 的 Deployment。如果我们直接删除pod，Deployment 将会重新创建该 pod。

docker login

在 kubectl 中没有对 docker login 的直接模拟。如果您有兴趣在私有镜像仓库中使用 Kubernetes，请参阅 使用私有镜像仓库。

docker version

如何查看客户端和服务端的版本？查看 kubectl version。

使用 docker 命令：

  1. $ docker version
  2. Client version: 1.7.0
  3. Client API version: 1.19
  4. Go version (client): go1.4.2
  5. Git commit (client): 0baf609
  6. OS/Arch (client): linux/amd64
  7. Server version: 1.7.0
  8. Server API version: 1.19
  9. Go version (server): go1.4.2
  10. Git commit (server): 0baf609
  11. OS/Arch (server): linux/amd64

使用 kubectl 命令：

  1. $ kubectl version
  2. Client Version: version.Info{Major:"1", Minor:"6", GitVersion:"v1.6.9+a3d1dfa6f4335", GitCommit:"9b77fed11a9843ce3780f70dd251e92901c43072", GitTreeState:"dirty", BuildDate:"2017-08-29T20:32:58Z", OpenPaasKubernetesVersion:"v1.03.02", GoVersion:"go1.7.5", Compiler:"gc", Platform:"linux/amd64"}
  3. Server Version: version.Info{Major:"1", Minor:"6", GitVersion:"v1.6.9+a3d1dfa6f4335", GitCommit:"9b77fed11a9843ce3780f70dd251e92901c43072", GitTreeState:"dirty", BuildDate:"2017-08-29T20:32:58Z", OpenPaasKubernetesVersion:"v1.03.02", GoVersion:"go1.7.5", Compiler:"gc", Platform:"linux/amd64"}

docker info

如何获取有关环境和配置的各种信息？查看 kubectl cluster-info。

使用 docker 命令：

  1. $ docker info
  2. Containers: 40
  3. Images: 168
  4. Storage Driver: aufs
  5.  Root Dir: /usr/local/google/docker/aufs
  6.  Backing Filesystem: extfs
  7.  Dirs: 248
  8.  Dirperm1 Supported: false
  9. Execution Driver: native-0.2
  10. Logging Driver: json-file
  11. Kernel Version: 3.13.0-53-generic
  12. Operating System: Ubuntu 14.04.2 LTS
  13. CPUs: 12
  14. Total Memory: 31.32 GiB
  15. Name: k8s-is-fun.mtv.corp.google.com
  16. ID: ADUV:GCYR:B3VJ:HMPO:LNPQ:KD5S:YKFQ:76VN:IANZ:7TFV:ZBF4:BYJO
  17. WARNING: No swap limit support

使用 kubectl 命令：

  1. $ kubectl cluster-info
  2. Kubernetes master is running at https://108.59.85.141
  3. KubeDNS is running at https://108.59.85.141/api/v1/namespaces/kube-system/services/kube-dns/proxy
  4. KubeUI is running at https://108.59.85.141/api/v1/namespaces/kube-system/services/kube-ui/proxy
  5. Grafana is running at https://108.59.85.141/api/v1/namespaces/kube-system/services/monitoring-grafana/proxy
  6. Heapster is running at https://108.59.85.141/api/v1/namespaces/kube-system/services/monitoring-heapster/proxy
  7. InfluxDB is running at https://108.59.85.141/api/v1/namespaces/kube-system/services/monitoring-influxdb/proxy

原文地址：https://github.com/rootsongjc/kubernetes.github.io/blob/master/docs/user-guide/docker-cli-to-kubectl.md