基础命令

create

创建Deployment和Service资源

  1. kubectl create -f demo-deploment.yaml
  2. kubectl create -f demo-service.yaml

delete

#根据yaml文件删除对应资源
kubectl delete -f demo-deployment.yaml
kubectl delete -f demo-service.yaml

#通过资源名称进行删除,会同时删除deployment和service资源
kubectl delete 具体资源名称

#删除指定的pod
[root@k8smaster ~]# kubectl delete deploy nginx
deployment.apps "nginx" deleted

get

#查看所有的资源信息
[root@k8smaster ~]# kubectl get all
NAME                        READY   STATUS    RESTARTS   AGE
pod/nginx-f89759699-z8s7b   1/1     Running   0          5m22s

NAME                 TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)        AGE
service/kubernetes   ClusterIP   10.96.0.1        <none>        443/TCP        14m
service/nginx        NodePort    10.108.140.177   <none>        80:32175/TCP   3m48s

NAME                    READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/nginx   1/1     1            1           5m22s

NAME                              DESIRED   CURRENT   READY   AGE
replicaset.apps/nginx-f89759699   1         1         1       5m22s


#查看pod列表
[root@k8smaster ~]# kubectl get pod
NAME                    READY   STATUS    RESTARTS   AGE
nginx-f89759699-z8s7b   1/1     Running   0          7m7s

#查看某个pod的yaml文件
[root@k8smaster ~]# kubectl get pods
NAME                    READY   STATUS    RESTARTS   AGE
nginx-f89759699-z8s7b   1/1     Running   0          20m
[root@k8smaster ~]# kubectl get pods nginx-f89759699-z8s7b -o yaml
apiVersion: v1
kind: Pod
metadata:
  creationTimestamp: "2022-03-28T08:27:20Z"
  generateName: nginx-f89759699-
  labels:
    app: nginx
    pod-template-hash: f89759699

#显示pod节点的标签信息
[root@k8smaster ~]# kubectl get pod --show-labels
NAME                    READY   STATUS    RESTARTS   AGE     LABELS
nginx-f89759699-z8s7b   1/1     Running   0          7m28s   app=nginx,pod-template-hash=f89759699

#根据指定标签匹配到具体的pod
[root@k8smaster ~]# kubectl get pod -l app=nginx
NAME                    READY   STATUS    RESTARTS   AGE
nginx-f89759699-z8s7b   1/1     Running   0          22m

#查看node节点列表
[root@k8smaster ~]# kubectl get nodes

NAME        STATUS   ROLES    AGE   VERSION

k8smaster   Ready    master   13m   v1.18.0

k8snode1    Ready    <none>   12m   v1.18.0

k8snode2    Ready    <none>   12m   v1.18.0

#显示node节点的标签信息
kubectl get node --show-labels

#查看pod详细信息,也就是可以查看pod具体运行在哪个节点上(IP地址信息)
[root@k8smaster ~]# kubectl get pods -o wide
NAME                    READY   STATUS    RESTARTS   AGE   IP           NODE       NOMINATED NODE   READINESS GATES
nginx-f89759699-z8s7b   1/1     Running   0          15m   10.244.1.2   k8snode1   <none>           <none>

#查看服务详细信息,显示服务名称,类型,集群ip,端口,时间等信息
[root@k8smaster ~]# kubectl get svc
NAME         TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)        AGE
kubernetes   ClusterIP   10.96.0.1        <none>        443/TCP        28m
nginx        NodePort    10.108.140.177   <none>        80:32175/TCP   17m
[root@k8smaster ~]# kubectl get svc -n kube-system
NAME       TYPE        CLUSTER-IP   EXTERNAL-IP   PORT(S)                  AGE
kube-dns   ClusterIP   10.96.0.10   <none>        53/UDP,53/TCP,9153/TCP   27m

#查看有哪些namespace
[root@k8smaster ~]# kubectl get namespaces
NAME              STATUS   AGE
default           Active   56m
kube-node-lease   Active   56m
kube-public       Active   56m
kube-system       Active   56m

#查看所有pod所属的命名空间
[root@k8smaster ~]# kubectl get pod --all-namespaces
NAMESPACE     NAME                                READY   STATUS    RESTARTS   AGE
default       nginx-f89759699-z8s7b               1/1     Running   0          17m
kube-system   coredns-7ff77c879f-8qlkx            1/1     Running   0          26m
kube-system   coredns-7ff77c879f-m6bs8            1/1     Running   0          26m
kube-system   etcd-k8smaster                      1/1     Running   0          27m
kube-system   kube-apiserver-k8smaster            1/1     Running   0          27m
kube-system   kube-controller-manager-k8smaster   1/1     Running   0          27m
kube-system   kube-flannel-ds-dxt4r               1/1     Running   0          21m
kube-system   kube-flannel-ds-hx4pt               1/1     Running   0          21m
kube-system   kube-flannel-ds-w8cph               1/1     Running   0          21m
kube-system   kube-proxy-4wjkq                    1/1     Running   0          25m
kube-system   kube-proxy-wrdxk                    1/1     Running   0          26m
kube-system   kube-proxy-x5rg5                    1/1     Running   0          25m
kube-system   kube-scheduler-k8smaster            1/1     Running   0          27m

#查看所有pod所属的命名空间并且查看都在哪些节点上运行
[root@k8smaster ~]# kubectl get pod --all-namespaces -o wide
NAMESPACE     NAME                                READY   STATUS    RESTARTS   AGE   IP              NODE        NOMINATED NODE   READINESS GATES
default       nginx-f89759699-z8s7b               1/1     Running   0          23m   10.244.1.2      k8snode1    <none>           <none>
kube-system   coredns-7ff77c879f-8qlkx            1/1     Running   0          32m   10.244.2.2      k8snode2    <none>           <none>
kube-system   coredns-7ff77c879f-m6bs8            1/1     Running   0          32m   10.244.2.3      k8snode2    <none>           <none>
kube-system   etcd-k8smaster                      1/1     Running   0          32m   172.16.82.250   k8smaster   <none>           <none>
kube-system   kube-apiserver-k8smaster            1/1     Running   0          32m   172.16.82.250   k8smaster   <none>           <none>
kube-system   kube-controller-manager-k8smaster   1/1     Running   0          32m   172.16.82.250   k8smaster   <none>           <none>
kube-system   kube-flannel-ds-dxt4r               1/1     Running   0          27m   172.16.82.250   k8smaster   <none>           <none>
kube-system   kube-flannel-ds-hx4pt               1/1     Running   0          27m   172.16.82.248   k8snode2    <none>           <none>
kube-system   kube-flannel-ds-w8cph               1/1     Running   0          27m   172.16.82.249   k8snode1    <none>           <none>
kube-system   kube-proxy-4wjkq                    1/1     Running   0          31m   172.16.82.249   k8snode1    <none>           <none>
kube-system   kube-proxy-wrdxk                    1/1     Running   0          32m   172.16.82.250   k8smaster   <none>           <none>
kube-system   kube-proxy-x5rg5                    1/1     Running   0          31m   172.16.82.248   k8snode2    <none>           <none>
kube-system   kube-scheduler-k8smaster            1/1     Running   0          32m   172.16.82.250   k8smaster   <none>           <none>

#查看目前所有的replica set,显示了所有的pod副本数,以及他们的可用数量以及状态等信息
[root@k8smaster ~]# kubectl get rs
NAME              DESIRED   CURRENT   READY   AGE
nginx-f89759699   1         1         1       24m

#查看已经部署的所有应用,可以看到容器,以及容器所用的镜像,标签等信息
[root@k8smaster ~]# kubectl get deploy -o wide
NAME    READY   UP-TO-DATE   AVAILABLE   AGE   CONTAINERS   IMAGES   SELECTOR
nginx   1/1     1            1           24m   nginx        nginx    app=nginx
kubectl get deployments -o wide

run

#示例,运行一个名为nginx,副本数为3,标签为app=example,镜像为nginx:1.10,端口为80的容器实例
kubectl run nginx --replicas=3 --labels="app=example" --image=nginx:1.10 --port=80
#示例,运行一个名称为nginx,副本数为3,标签为app=example,镜像为nginx:1.10,端口为80的容器实例,并绑定到k8s-node1s上
kubectl run nginx --image=nginx:1.10 --replicas=3 --labels="app=example" --port=80 --overrides='{"apiVersion":"apps/v1","spec":{"template":{"spec":{"nodeSelector":{"kubernetes.io/hostname":"k8s-node1"}}}}}'

expose

#创建一个service服务,并且暴露端口给外部可以访问
kubectl expose deployment nginx --port=80 --type=NodePort --target-port=80 --name=nginx-service

set

kubectl set resources

#将deployment的nginx容器cpu限制为“200m”,将内存设置为“512Mi”
kubectl set resource deployment nginx -c=nginx --limits=cpu=200m,memory=512Mi

#设置所有nginx容器中Requests和Limits
kubectl set resource deployment nginx --limits=cpu=200m,memory=512Mi --requests=cpu=100m,memory=256Mi

#删除nginx中容器的计算资源值
kubectl set resource deployment nginx --limits=cpu=0 --requests=cpu=0,memory=0

kubectl set selector

#设置资源的selector,如果在调用“set selector”命令之前已经存在选择器,则新创建的选择器将覆盖原来的选择器。
#注意:目前selector命令只能用于Service对象

kubectl set image

#将deployment中的nginx容器镜像设置为“nginx:1.9.1”
kubectl set image deployment/nginx busybox=busybox nginx=nginx:1.9.1

#所有deployment和rc的nginx容器镜像更新为“nginx:1.9.1”
kubectl set image deployments,rc nginx=nginx:1.9.1 --all

#将daemonset abc的所有容器镜像更新为“nginx:1.9.1”
kubectl set image daemonset abc *=nginx:1.9.1

#从本地文件中更新nginx容器镜像
kubectl set image -f path/to/file.yaml nginx=nginx:1.9.1 --local -o yaml

explain

#用于显示资源文档信息
kubectl explain rs

edit

#编辑Deployment nginx的一些信息
kubectl edit deployment nginx

#编辑service类型的nginx的一些信息
kubectl edit service/nginx

设置命令

label

#用于更新(增加或删除)资源上的label(标签)

#给名为foo的Pod添加label unhealthy=true
kubectl label pods foo unhealthy=true

#给名为foo的Pod修改label为 'status'/value 'unhealthy',且覆盖现有的value
kubectl label --overwrite pods foo status=unhealthy

#给namespace 中的所有Pod添加label
kubectl label pods --all status=unhealthy

#仅当resource-version=1时才更新名foo的Pod上的label
kubectl label pods foo status=unhealthy --resource-version=1 

#删除名为"bar"的label。(使用“-”减号相连)
kubectl label pods foo bar-

annotate

# 更新Pod“foo”,设置annotation “description”的value “my frontend”,如果同一个annotation多次设置,则只使用最后设置的value值
kubectl annotate pods foo description='my frontend'

#根据“pod.json”中的type和name更新Pod的annotation
kubetcl annotate -f pod.json description='my frontend'

#更新Pod"foo",设置annotation"description"的value"my frontend running nginx",覆盖现有的值
kubectl annotate --overwrite pods foo description='my frontend running nginx'

#更新namespace中的所有Pod
kubectl annotate pods --all description='my frontend running nginx'

#只有当resource-version为1时,才更新Pod'foo'
kubectl annotate pods foo description='my frontend running nginx' --resourece-version=1

#通过删除名为“description”的annotations来更新Pod‘foo’
#不需要 -overwrite flag
kubectl annotate pods foo description-

completion

#在bash中设置当前shell的自动补全,要先安装bash-completion包
source <(kubectl completion bash)

#在你的bash shell中永久的添加自动补全
echo "source <(kubectl completion bash)" >> ~./bashrc
#在zsh中设置当前shell的自动补全
source <(kubectl completion zhs)

#在您的 zsh shell 中永久的添加自动补全
echo "if [ $commands[kubectl] ]; then source <(kubectl completion zsh); fi" >> ~/.zshrc

部署命令

rollout

#用于对资源进行管理,可用资源包括:deployment,daemonsets
#子命令:
history        (查看历史版本)
pause        (暂停资源)
resume    (恢复暂停资源)
status    (查看资源状态)
undo        (回滚版本)
#回滚到之前的deployment
kubectl rollout undo deployment/abc

#查看daemonset状态
kubectl rollout status daemons

rolling-update

# 使用frontend-v2.json中的新RC数据更新frontend-v1的pod
kubectl rolling-update frontend-v1 -f frontend-v2.json

# 使用JSON数据更新frontend-v1的pod
cat frontend-v2.json | kubectl rolling-update frontend-v1 -f -

# 其他的一些滚动更新
kubectl rolling-update frontend-v1 frontend-v2 --image=image:v2

kubectl rolling-update frontend --image=image:v2

kubectl rolling-update frontend-v1 frontend-v2 --rollback

scale

#扩容或缩容 Deployment、ReplicaSet、Replication Controller或 Job 中Pod数量
#scale也可以指定多个前提条件,如:当前副本数量或 --resource-version ,进行伸缩比例设置前,系统会先验证前提条件是否成立。这个就是弹性伸缩策略
# 将名为foo中的pod副本数设置为3。
kubectl scale --replicas=3 rs/foo
kubectl scale deploy/nginx --replicas=30

# 将由“foo.yaml”配置文件中指定的资源对象和名称标识的Pod资源副本设为3
kubectl scale --replicas=3 -f foo.yaml

# 如果当前副本数为2,则将其扩展至3。
kubectl scale --current-replicas=2 --replicas=3 deployment/mysql

# 设置多个RC中Pod副本数量
kubectl scale --replicas=5 rc/foo rc/bar rc/baz

autoscale

#这个比scale更加强大,也是弹性伸缩策略 ,它是根据流量的多少来自动进行扩展或者缩容。
#指定Deployment、ReplicaSet或ReplicationController,并创建已经定义好资源的自动伸缩器。使用自动伸缩器可以根据需要自动增加或减少系统中部署的pod数量。

# 使用 Deployment “foo”设定,使用默认的自动伸缩策略,指定目标CPU使用率,使其Pod数量在2到10之间
kubectl autoscale deployment foo --min=2 --max=10

# 使用RC“foo”设定,使其Pod的数量介于1和5之间,CPU使用率维持在80%
kubectl autoscale rc foo --max=5 --cpu-percent=80

集群管理命令

certificate

#用于证书资源管理,授权等

cluster-info

#显示集群信息
kubectl cluster-info

top

#用于查看资源的cpu,内存磁盘等资源的使用率
kubectl top pod --all-namespaces

cordon

用于标记某个节点不可调度

uncordon

用于标签节点可以调度

drain

用于在维护期间排除节点

taint

用于给某个Nod节点设置污点

集群故障排查和调试命令

describe

#显示特定资源的详细信息

#查看my-nginx pod的详细状态
kubectl describe pod my-nginx

root@kubeasz:~# kubectl describe pod tomcat-deployment-84ff9bf6b4-967kt
Name:         tomcat-deployment-84ff9bf6b4-967kt
Namespace:    default
Priority:     0
Node:         172.16.82.254/172.16.82.254
Start Time:   Wed, 30 Mar 2022 16:01:58 +0800
Labels:       app=tomcat
              pod-template-hash=84ff9bf6b4
Annotations:  <none>
Status:       Running
IP:           172.20.0.8
IPs:
  IP:           172.20.0.8
Controlled By:  ReplicaSet/tomcat-deployment-84ff9bf6b4
Containers:
  tomcat:
    Container ID:   docker://5d187cc5bc5caf75cb30a16f7d2a5ef2369a1e82413a917e044fbe8ff8ea282f
    Image:          tomcat:latest
    Image ID:       docker-pullable://tomcat@sha256:9dee185c3b161cdfede1f5e35e8b56ebc9de88ed3a79526939701f3537a52324
    Port:           8080/TCP
    Host Port:      0/TCP
    State:          Running
      Started:      Wed, 30 Mar 2022 16:03:21 +0800
    Ready:          True
    Restart Count:  0
    Environment:    <none>
    Mounts:
      /var/run/secrets/kubernetes.io/serviceaccount from kube-api-access-j2dm4 (ro)
Conditions:
  Type              Status
  Initialized       True 
  Ready             True 
  ContainersReady   True 
  PodScheduled      True 
Volumes:
  kube-api-access-j2dm4:
    Type:                    Projected (a volume that contains injected data from multiple sources)
    TokenExpirationSeconds:  3607
    ConfigMapName:           kube-root-ca.crt
    ConfigMapOptional:       <nil>
    DownwardAPI:             true
QoS Class:                   BestEffort
Node-Selectors:              <none>
Tolerations:                 node.kubernetes.io/not-ready:NoExecute op=Exists for 300s
                             node.kubernetes.io/unreachable:NoExecute op=Exists for 300s
Events:
  Type    Reason     Age    From               Message
  ----    ------     ----   ----               -------
  Normal  Scheduled  11m    default-scheduler  Successfully assigned default/tomcat-deployment-84ff9bf6b4-967kt to 172.16.82.254
  Normal  Pulling    11m    kubelet            Pulling image "tomcat:latest"
  Normal  Pulled     9m44s  kubelet            Successfully pulled image "tomcat:latest" in 1m21.913571377s
  Normal  Created    9m44s  kubelet            Created container tomcat
  Normal  Started    9m44s  kubelet            Started container tomcat
root@kubeasz:~#

logs

#用于在一个pod中打印一个容器的日志,如果pod中只有一个容器,可以省略容器名

# 返回仅包含一个容器的pod nginx的日志快照
kubectl logs nginx

# 返回pod ruby中已经停止的容器web-1的日志快照
kubectl logs -p -c ruby web-1

# 持续输出pod ruby中的容器web-1的日志
kubectl logs -f -c ruby web-1

# 仅输出pod nginx中最近的20条日志
kubectl logs --tail=20 nginx

# 输出pod nginx中最近一小时内产生的所有日志
kubectl logs --since=1h nginx

#参数选项:
-c, --container="": 容器名。
-f, --follow[=false]: 指定是否持续输出日志(实时日志)。
–interactive[=true]: 如果为true,当需要时提示用户进行输入。默认为true。
–limit-bytes=0: 输出日志的最大字节数。默认无限制。
-p, --previous[=false]: 如果为true,输出pod中曾经运行过,但目前已终止的容器的日志。
–since=0: 仅返回相对时间范围,如5s、2m或3h,之内的日志。默认返回所有日志。只能同时使用since和since-time中的一种。
–since-time="": 仅返回指定时间(RFC3339格式)之后的日志。默认返回所有日志。只能同时使用since和since-time中的一种。
–tail=-1: 要显示的最新的日志条数。默认为-1,显示所有的日志。
–timestamps[=false]: 在日志中包含时间戳。

exec

#进入容器进行交互,在容器中执行命令

# 进入nginx容器,执行一些命令操作
kubectl exec -it nginx-deployment-58d6d6ccb8-lc5fp bash


#参数选项:
-c, --container="": 容器名。如果未指定,使用pod中的一个容器。
-p, --pod="": Pod名。
-i, --stdin[=false]: 将控制台输入发送到容器。
-t, --tty[=false]: 将标准输入控制台作为容器的控制台输入

attach

#连接到一个正在运行的容器

# 获取正在运行中的pod 123456-7890的输出,默认连接到第一个容器
kubectl attach 123456-7890

# 获取pod 123456-7890中ruby-container的输出
kubectl attach 123456-7890 -c ruby-container

# 切换到终端模式,将控制台输入发送到pod 123456-7890的ruby-container的“bash”命令,并将其输出到控制台/
# 错误控制台的信息发送回客户端。
kubectl attach 123456-7890 -c ruby-container -i -t

#参数选项:
-c, --container="": 容器名。如果省略,则默认选择第一个 pod。
-i, --stdin[=false]: 将控制台输入发送到容器。
-t, --tty[=false]: 将标准输入控制台作为容器的控制台输入

cp

拷贝文件或者目录到pod容器中
用于pod和外部的文件交换,类似于docker 的cp,就是将容器中的内容和外部的内容进行交换。

高级命令

apply

#通过文件名或者标准输入对资源应用配置
#通过文件名或控制台输入,对资源进行配置。 如果资源不存在,将会新建一个。可以使用 JSON 或者 YAML 格式。
# 将pod.json中的配置应用到pod
kubectl apply -f ./pod.json

# 将控制台输入的JSON配置应用到Pod
cat pod.json | kubectl apply -f -

#参数选项:
-f, --filename=[]: 包含配置信息的文件名,目录名或者URL。
–include-extended-apis[=true]: If true, include definitions of new APIs via calls to the API server. [default true]
-o, --output="": 输出模式。"-o name"为快捷输出(资源/name).
–record[=false]: 在资源注释中记录当前 kubectl 命令。
-R, --recursive[=false]: Process the directory used in -f, --filename recursively. Useful when you want to manage related manifests organized within the same directory.
–schema-cache-dir="~/.kube/schema": 非空则将API schema缓存为指定文件,默认缓存到’$HOME/.kube/schema’
–validate[=true]: 如果为true,在发送到服务端前先使用schema来验证输入。

patch

#使用补丁修改,更新资源的字段,也就是修改资源的部分内容

# 使用策略合并补丁部分更新节点
kubectl patch node k8s-node-1 -p '{"spec":{"unschedulable":true}}'

# 更新容器镜像
kubectl patch pod valid-pod -p '{"spec":{"containers":[{"name":"kubernetes-serve-hostname","image":"new image"}]}}'

replace

#通过文件或者标准输入替换原有资源

# 使用pod.json中的数据替换pod
kubectl replace -f ./pod.json

# 根据传入的JSON替换pod
cat pod.json | kubectl replace -f -

# 更新镜像版本(tag)到v4
kubectl get pod mypod -o yaml | sed 's/\(image: myimage\):.*$/\1:v4/' | kubectl replace -f -

# 强制替换,删除原有资源,然后重新创建资源
kubectl replace --force -f ./pod.json

convert

#不同的版本之间转换配置文件

#将“pod.yaml”转换为最新版本并打印到stdout
kubectl convert -f pod.yaml

#将“pod.yaml”指定的资源的实时状态转换为最新版本#,并以json格式打印到stdout
kubectl convert -f pod.yaml --local -o json

#将当前目录下的所有文件转换为最新版本,并将其全部创建
kubectl convert -f . | kubectl create -f -

其他命令

api-servions

#打印当前集群支持的api版本
kubectl api-versions

help

#查看命令帮助
kubectl --help

#具体的子命令把帮助,例如
kubectl create --help

config

#用于修改kubeconfig配置文件(用于访问api,例如配置认证信息)
#设置 kubectl 与哪个 Kubernetes 集群进行通信并修改配置信息。查看 使用 kubeconfig 跨集群授权访问文档获取详情配置文件信息。

# 显示合并的 kubeconfig 配置
kubectl config view

# 同时使用多个 kubeconfig 文件并查看合并的配置
KUBECONFIG=~/.kube/config:~/.kube/kubconfig2 kubectl config view

# 获取 e2e 用户的密码
kubectl config view -o jsonpath='{.users[?(@.name == "e2e")].user.password}'

# 展示当前所处的上下文
kubectl config current-context

# 设置默认的上下文为 my-cluster-name
kubectl config use-context my-cluster-name

# 添加新的集群配置到 kubeconf 中,使用 basic auth 进行鉴权
kubectl config set-credentials kubeuser/foo.kubernetes.com --username=kubeuser --password=kubepassword

# 使用特定的用户名和命名空间设置上下文。
kubectl config set-context gce --user=cluster-admin --namespace=foo \
  && kubectl config use-context gce

version

#打印客户端和服务端版本信息
kubectl version

plugin

运行一个命令行插件