跳到主要内容

k8s常用命令速查

虚拟机​

说明

pd虚拟机安装的k8s集群，因为mac电脑休眠或关机会导致pod创建失败、pvc绑定失败等问题，因此需要重启一下相关服务

alias k8sfix='systemctl restart containerd kubelet && \
	kubectl -n calico-system rollout restart ds/calico-node && \
	kubectl -n kube-system rollout restart ds/kube-proxy'

网络​

网络调试工具​

nicolaka/netshoot

kubectl run net-test --rm -it --image=registry.cn-beijing.aliyuncs.com/pptfzo/netshoot:v0.14-amd64 -- bash

kubectl​

设置当前 context 的默认 namespace​

export CONTEXT=production
export NS=production
kubectl config set-context $CONTEXT --namespace=$NS

pod​

强制删除pod​

kubectl delete pod <pod-name> --grace-period=0 --force

查看pod包含的容器​

说明

一般情况下，一个pod可能包含多个容器

通过自定义列

$ export POD_NAME='xxx'
$ kubectl get pod ${POD_NAME} -o 'custom-columns=NAME:.metadata.name,CONTAINERS:.spec.containers[*].name'
NAME                                            CONTAINERS
prometheus-prometheus-server-75c956b9cc-w8l4p   prometheus-prometheus-server-configmap-reload,prometheus-prometheus-server

通过 jq 命令

$ export POD_NAME='xxx'
$ kubectl get pod ${POD_NAME} -o json | jq '.spec.containers[].name'
"prometheus-prometheus-server-configmap-reload"
"prometheus-prometheus-server"

重启重启过的pod​

kubectl get pod -A \
| awk 'NR>1 && $5>0 {print $1, $2}' \
| xargs -n2 kubectl delete pod -n

node​

查看node节点拥有的镜像​

kubectl get nodes -o json | jq -r '.items[] | "\(.metadata.name): \(.status.images[].names[])"'

查看node节点上调度的pod​

export NODE_NAME=''
kubectl get pods --field-selector spec.nodeName=$NODE_NAME

查看某个node节点上被 oom kill 的pod​

export NODE_NAME=''
(
  echo -e "NODE_NAME\tPOD_NAME\tCONTAINER_NAME\tREASON\tFINISHED_AT"
  kubectl get pods --field-selector spec.nodeName=$NODE_NAME -o json | \
    jq -r '.items[] |
      .metadata.name as $pod_name |
      .spec.nodeName as $node_name |
      .status.containerStatuses[]? |
      select(.lastState.terminated.reason == "OOMKilled") |
      "\($node_name)\t\($pod_name)\t\(.name)\tOOMKilled\t\(.lastState.terminated.finishedAt)"'
) | column -t

查看某个node节点上运行的pod的资源分配情况​

export NODE_NAME=''
(
  echo -e "POD\tREQUEST_CPU\tREQUEST_MEM\tLIMIT_CPU\tLIMIT_MEM"
  kubectl get pods --field-selector spec.nodeName=$NODE_NAME -o json | \
    jq -r '.items[] | 
      [.metadata.name, 
       (.spec.containers[] | 
          .resources.requests.cpu // "none", 
          .resources.requests.memory // "none", 
          .resources.limits.cpu // "none", 
          .resources.limits.memory // "none")] | @tsv'
) | column -t

存储类​

设置默认存储类​

export SC_NAME=openebs-hostpath
kubectl patch storageclass ${SC_NAME} -p '{"metadata": {"annotations":{"storageclass.kubernetes.io/is-default-class":"true"}}}'

查看证书过期时间​

说明

组件证书：

  • 例如 admin.conf、apiserver、apiserver-kubelet-client 等证书，有效期为 1 年。这些证书在 2025 年 11 月 8 日到期，目前还剩 298 天

证书颁发机构 (CA)：

  • 根 CA (ca)、ETCD CA (etcd-ca)、以及前端代理 CA (front-proxy-ca) 的有效期为 10 年，到期时间是 2034 年 11 月 6 日
$ kubeadm certs check-expiration
[check-expiration] Reading configuration from the cluster...
[check-expiration] FYI: You can look at this config file with 'kubectl -n kube-system get cm kubeadm-config -o yaml'

CERTIFICATE                EXPIRES                  RESIDUAL TIME   CERTIFICATE AUTHORITY   EXTERNALLY MANAGED
admin.conf                 Nov 08, 2025 09:40 UTC   298d            ca                      no      
apiserver                  Nov 08, 2025 09:40 UTC   298d            ca                      no      
apiserver-etcd-client      Nov 08, 2025 09:40 UTC   298d            etcd-ca                 no      
apiserver-kubelet-client   Nov 08, 2025 09:40 UTC   298d            ca                      no      
controller-manager.conf    Nov 08, 2025 09:40 UTC   298d            ca                      no      
etcd-healthcheck-client    Nov 08, 2025 09:40 UTC   298d            etcd-ca                 no      
etcd-peer                  Nov 08, 2025 09:40 UTC   298d            etcd-ca                 no      
etcd-server                Nov 08, 2025 09:40 UTC   298d            etcd-ca                 no      
front-proxy-client         Nov 08, 2025 09:40 UTC   298d            front-proxy-ca          no      
scheduler.conf             Nov 08, 2025 09:40 UTC   298d            ca                      no      
super-admin.conf           Nov 08, 2025 09:40 UTC   298d            ca                      no      

CERTIFICATE AUTHORITY   EXPIRES                  RESIDUAL TIME   EXTERNALLY MANAGED
ca                      Nov 06, 2034 09:40 UTC   9y              no      
etcd-ca                 Nov 06, 2034 09:40 UTC   9y              no      
front-proxy-ca          Nov 06, 2034 09:40 UTC   9y              no

查看未达到期望副本数的资源​

kubectl get deploy --all-namespaces -o custom-columns=NAMESPACE:.metadata.namespace,NAME:.metadata.name,READY:.status.readyReplicas,DESIRED:.spec.replicas --no-headers=true | awk '$3 != $4 && $NF != 0'

手动设置资源的副本数​

kubectl scale deployment <deployment-name> --replicas=<desired-replica-count> -n <namespace>

污点​

污点官方文档

查看所有节点的污点​

kubectl get nodes -o custom-columns=NAME:.metadata.name,TAINTS:.spec.taints

查看某个节点的污点​

kubectl describe node <node-name> | grep Taints

给某个节点添加污点​

命令
kubectl taint nodes <node-name> key=value:effect

示例

这将在 node-1 节点上设置一个名为 key1、值为 value1 的污点，效果为 NoSchedule，即不允许在具有此污点的节点上调度 Pod。

kubectl taint nodes node-1 key1=value1:NoSchedule

取消某个节点的污点​

命令
kubectl taint nodes <node-name> key:value-

示例

这将从 node-1 节点上移除名为 key1 的污点

kubectl taint nodes node-1 key1:value-

标签​

标签官方文档

查看所有节点标签​

kubectl get nodes --show-labels

查看某个节点的标签​

命令
kubectl get nodes <node-name> --show-labels

示例

$ kubectl get nodes ops-ingress-worker3 --show-labels
NAME                  STATUS   ROLES    AGE   VERSION   LABELS
ops-ingress-worker3   Ready    <none>   57d   v1.27.3   beta.kubernetes.io/arch=amd64,beta.kubernetes.io/os=linux,ingress-ready=true,kubernetes.io/arch=amd64,kubernetes.io/hostname=ops-ingress-worker3,kubernetes.io/os=linux

给某个节点添加标签​

命令
kubectl label nodes <your-node-name> key=value

示例

给 ops-ingress-worker3 节点添加一个键为 disktype 值为 ssd 的标签

kubectl label nodes ops-ingress-worker3 disktype=ssd

查看

$ kubectl get nodes ops-ingress-worker3 --show-labels
NAME                  STATUS   ROLES    AGE   VERSION   LABELS
ops-ingress-worker3   Ready    <none>   57d   v1.27.3   beta.kubernetes.io/arch=amd64,beta.kubernetes.io/os=linux,disktype=ssd,ingress-ready=true,kubernetes.io/arch=amd64,kubernetes.io/hostname=ops-ingress-worker3,kubernetes.io/os=linux

取消某个节点的标签​

命令

取消标签只需要指定键，不需要指定值

kubectl label nodes <your-node-name> key-

示例

取消 ops-ingress-worker3 节点添键为 disktype 的标签

kubectl label nodes ops-ingress-worker3 disktype-

查看

$ kubectl get nodes ops-ingress-worker3 --show-labels
NAME                  STATUS   ROLES    AGE   VERSION   LABELS
ops-ingress-worker3   Ready    <none>   57d   v1.27.3   beta.kubernetes.io/arch=amd64,beta.kubernetes.io/os=linux,ingress-ready=true,kubernetes.io/arch=amd64,kubernetes.io/hostname=ops-ingress-worker3,kubernetes.io/os=linux

调度​

设置节点为不可调度​

kubectl cordon $NODENAME

恢复节点为可调度​

kubectl uncordon $NODENAME

清空节点​

清空节点官方文档

说明

如果存在 DaemonSet 管理的 Pod，你将需要为 kubectl 设置 --ignore-daemonsets 以成功地清空节点。 kubectl drain 子命令自身实际上不清空节点上的 DaemonSet Pod 集合： DaemonSet 控制器（作为控制平面的一部分）会立即用新的等效 Pod 替换缺少的 Pod。 DaemonSet 控制器还会创建忽略不可调度污点的 Pod，这种污点允许在你正在清空的节点上启动新的 Pod。

注意

如果有一些 Pod 使用了 emptyDir 卷或本地存储，这些 Pod 默认情况下不会被删除。要强制删除这些 Pod，可以使用 --delete-emptydir-data 参数

$ kubectl drain --ignore-daemonsets 10.246.140.15
node/10.246.140.15 already cordoned
error: unable to drain node "10.246.140.15", aborting command...

There are pending nodes to be drained:
 10.246.140.15
error: cannot delete Pods with local storage (use --delete-emptydir-data to override): istio-system/istio-ingressgateway-6867ddc5fd-ldvfq, redis/drc-ecc-redis-0-0, redis/drc-ecc-redis-1-1, redis/drc-ecc-redis-2-0, redis/drc-local-test-1-1, redis/drc-local-test-2-1, redis/drc-local-test-7-0-1, redis/drc-test1-zone-stage-ten-2-0, redis/drc-uuap-redis-0-0
kubectl drain --ignore-daemonsets $NODENAME

执行成功后最后提示如下

pod/xxx evicted
pod/xxx evicted
node/10.246.140.15 evicted

集群​

查看当前集群的容器运行时​

kubectl get nodes -o wide
export NODE_NAME='ops-ingress-worker'
kubectl describe no $NODE_NAME | grep 'Container Runtime'
kubectl get nodes -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.status.nodeInfo.containerRuntimeVersion}{"\n"}{end}'
Bottom GIF
Top GIF