k8s笔记5--k8s常见命令

kubectl 具备丰富的命令，其使用方法如下:
kubectl [flags] [options]
通过 "kubectl --help"来查找指定命令的更多信息；
通过 “kubectl options” 来查找所用命令行选项 (适用于所有命令).

此处根据 kubectl --help 将各类命令加以分类，后续将按照分类补充各命令的使用案例。

1 Basic Commands (Beginner)

  1. create
    Create a resource from a file or from stdin.
    create 直接创建一个资源，若资源已经存在，继续创建的时候会报错；
    apply -f resource.yaml 会创建并更新该资源，若该资源存在则更新对应资源；
    1) 通过dry-run 的方式创建一个deployment 基本信息
kubectl create deployment my-web --image=nginx --dry-run=client -o yaml >my-web.yaml
通过 apply -f 创建实际的deployment
kubectl apply -f my-web.yaml 
2）创建ns
kubectl create namespace test-online2 --dry-run=client -o yaml
等价于yaml： 
cat << EOF >test-online2.yaml
apiVersion: v1
kind: Namespace
metadata:
  name: test-online2
EOF
kubectl apply -f test-online2.yaml
3) 创建一个 pod
$ cat pod.yaml 
apiVersion: v1
kind: Pod
metadata:
  name: web-pod
  namespace: test-online
spec: 
  containers:
  - image: nginx:latest
    name: web-pod
    ports:
    - name: web-port
      containerPort: 80
      protocol: TCP
 kubectl apply -f pod.yaml
  2. expose
    使用 replication controller, service, deployment 或者 pod 并暴露它作为一个新的 Kubernetes Service
    $ kubectl expose deployment my-web --port=5000 --target-port=5000 --type=NodePort

$ kubectl get svc
NAME     TYPE       CLUSTER-IP    EXTERNAL-IP   PORT(S)          AGE
my-web   NodePort   10.1.175.63   <none>        5000:32020/TCP   4m5s
    此时通过nodeIP:NodePort可以正常访问my-web 中的5000端口： 在这里插入图片描述
  3. run
    在集群中运行一个指定的镜像
    在当前命名空间中创建一个pod，容器端口为80
kubectl run nginx2  --image=nginx:latest --port=80
等价：
apiVersion: v1
kind: Pod
metadata:
 creationTimestamp: null
 labels:
   run: nginx2
 name: nginx2
spec:
 containers:
 - image: nginx:latest
   name: nginx2
   ports:
   - containerPort: 80
   resources: {}
 dnsPolicy: ClusterFirst
 restartPolicy: Always
status: {}
  4. set
    为 objects 设置一个指定的特征
    1) 设置 my-web 中的容器nginx的镜像为nginx:latest
kubectl set image deployment/my-web nginx=nginx:latest
2) 设置 my-web 中的环境变量 env_dir为/local
kubectl set env deployment/my-web env_dir=/local
3) 查看所有pod的环境变量
kubectl set env  pods --all --list

2 Basic Commands (Intermediate)

  1. explain
    查看资源的文档
    1）查看pod 的所有子字段的文档
kubectl explain pods
2）查看pod的spec.containers 的所有子字段文档
kubectl explain pods.spec.containers
  2. get
    显示一个或更多 resource
     -o wide 可以查看扩展信息
1) 获取 pod 信息
$ kubectl get pods  -n=test-online 等价 kubectl get pods  --namespace=test-online
NAME                  READY   STATUS    RESTARTS   AGE
web-96d5df5c8-4q4vx   1/1     Running   0          62m
$ kubectl get pods  --namespace=test-online  -o wide
NAME                  READY   STATUS    RESTARTS   AGE   IP            NODE                              NOMINATED NODE   READINESS GATES
web-96d5df5c8-4q4vx   1/1     Running   0          63m   10.244.1.15   test02.i.xxx.net   <none>           <none> 

jsonpath 可以查看pod信息指定key的数据，若直接为"{}", 则返回一个未格式化的大json字符串
$ kubectl get pod  web-96d5df5c8-4q4vx -o jsonpath="{.metadata.labels}"
{"app":"web","pod-template-hash":"96d5df5c8"}

2) 查看 configmap 信息
$ kubectl get configmap  -n=kube-public
NAME           DATA   AGE
cluster-info   1      3d23h

3）查看node信息，并显示label
kubectl get node -A --show-labels
4）查看ns信息
kubectl get ns(或者 namespaces)
  3. edit
    在服务器上编辑一个资源
    1) 编辑 deployment my-web
kubectl edit deployment/my-web
2) 编辑 pod nginx2
kubectl edit pod nginx2 [-o json 以json格式编辑]
  4. delete
    Delete resources by filenames, stdin, resources and names, or by resources and label selector
    1) 删除pod nginx2
kubectl delete pod nginx2
2) 删除ns test-online2
kubectl delete namespace test-online2
或者 
kubectl delete -f test-online2.yaml(1.1 创建ns中的yaml)

3 Deploy Commands

  1. rollout
    Manage the rollout of a resource
    1) 回滚到前一个版本
kubectl rollout undo deployment/my-web 
2）查看回滚历史记录
kubectl rollout history deployment/my-web
  2. scale
    Set a new size for a Deployment, ReplicaSet or Replication Controller
    kubectl scale --replicas=2 deployment/my-web
  3. autoscale
    自动调整一个 Deployment, ReplicaSet, 或者 ReplicationController 的副本数量
    kubectl autoscale deployment my-web --min=2 --max=3
此时可以通过hpa 查看pod数量，若再次scale为1，则过一会儿会自动伸缩为2
$ kubectl get hpa
NAME     REFERENCE           TARGETS         MINPODS   MAXPODS   REPLICAS   AGE
my-web   Deployment/my-web   <unknown>/80%   2         3         2          111s
若想取消自动伸缩，则直接delete hpa 即可 ：
kubectl delete hpa my-we
    使用autoscale后发现报错：failed to get cpu utilization: missing request for cpu，对应上述TARGETS中的unknown；
    错误原因：创建deployment时候没有设置cpu request信息；
    此时设置 spec.containers.resources 为如下内容即可：
      resources: 
        requests:
          cpu: "50m"
          memory: "50Mi"
注意：cpu 带单位的时候必须带双引号，内存有单位必须带双引号；
    设置cpu 和 memory 后，再配置hpa： kubectl autoscale deployment my-web --cpu-percent=15 --min=2 --max=3
    $ kubectl  get hpa
NAME     REFERENCE           TARGETS   MINPODS   MAXPODS   REPLICAS   AGE
my-web   Deployment/my-web   1%/15%    2         3         2          88s
此时在另外一个pod里面持续访问ubuntu-flask服务，就会发现cpu使用率在逐渐增加，当大于15%的时候就会开始扩容了；当请求访问完成后cpu降低了，过一段时间又缩容为2(约5min后缩容为2，cpu降低后不会立马缩容回来，主要为了防止流量又立刻突增)；
for i in {1..1000};do wget http://10.1.175.63:5000/hello ;sleep 0.1;done
    Kubernetes：HPA 详解-基于 CPU、内存和自定义指标自动扩缩容

4 Cluster Management Commands

  1. certificate
    修改 certificate 资源.
  2. cluster-info
    显示集群信息
    1) 查看集群基础信息，包括master 和kubedns
$ kubectl cluster-info 
Kubernetes master is running at https://10.120.75.102:6443
KubeDNS is running at https://10.120.75.102:6443/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy
2） 诊断集群
kubectl cluster-info dump
输出很多集群诊断信息
  3. top
    Display Resource (CPU/Memory/Storage) usage.
    kubectl top node [node-name 查看指定node的cpu mem信息] # (不指定node-name)显示所有节点cpu 内存使用情况
kubectl top pod -A # 显示所有pod 的cpu 和 内存使用情况
  4. cordon
    标记 node 为 unschedulable
    kubectl cordon node-name 
标记不可调度后，get nodes 发现 status 变为 Ready,SchedulingDisabled
  5. uncordon
    标记 node 为 schedulable
    kubectl uncordon node-name
  6. drain
    Drain node in preparation for maintenance
    该操作为驱逐或者删除node上的pod，常见常见为磁盘爆了会出现pod被驱逐现象
$ kubectl drain node-name
  7. taint
    更新一个或者多个 node 上的 taints
    1) 将node01 设置污点，使其不可调度(若已有disktype标签，则会更新value为ssd，没有则添加标签)
kubectl taint node node01 disktype=ssd:NoSchedule
默认情况下，kubeadm 中的master就被设置为 node-role.kubernetes.io/master:NoSchedule ，因此一般的实例 master 是无法被调度到master上的；
若通过tant ndoe master-name node-role.kubernetes.io/master:NoSchedule- 去掉污点，则master也可以被调度
2）去掉taints，恢复node01位可调度
kubectl taint node node01 disktype:NoSchedule-

5 Troubleshooting and Debugging Commands

  1. describe
    显示一个指定 resource 或者 group 的 resources 详情

    1) 查看指定ns下的pod详细信息，当pod无法正常拉起的时候可以通过这种方式排错
kubectl -n test-online describe po my-web-7d99c588c5-tp5z5
2) 查看 node详细信息
kubectl describe nodes node_name
该命令会返回 Name，Roles，Labels，Annotations，Conditions，Capacity(cpu,内存,存储)、Events（可以用于排错）等重要信息；

  2. logs
    输出容器在 pod 中的日志

    1) 输出指定pod 的日志
kubectl logs web-96d5df5c8-mj4r6
2）输出指定pod的最后2行日志
kubectl --tail=2 logs web-96d5df5c8-mj4r6
3）输出最近10小时的日志
kubectl --since=10h logs web-96d5df5c8-mj4r6

  3. attach
    Attach 到一个运行中的 container

  4. exec
    在一个 container 中执行一个命令；
    当前同时支持 pod cmd 和 pod -- cmd模式，后续会抛弃pod cmd 模式；

    1) 单个容器
$ kubectl exec web-96d5df5c8-4q4vx  -- hostname
web-96d5df5c8-4q4vx
2）多个容器， 通过  -c container_name 来选择接入哪个容器
kubectl -n test-online exec my-web-698c8ccc85-qxh9l  -c flask-app -- bash

  5. port-forward
    Forward one or more local ports to a pod

  6. proxy
    运行一个 proxy 到 Kubernetes API server

  7. cp
    复制 files 和 directories 到 containers 和从容器中复制 files 和 directories.

    1) 拷贝文件a.txt 到指定ns的 pod web-96d5df5c8-mj4r6 中 
$ kubectl cp a.txt -n test-online web-96d5df5c8-mj4r6:/
$ kubectl exec -n test-online web-96d5df5c8-mj4r6 -- cat /a.txt
This is a.txt
2）从指定 ns 的 pod web-96d5df5c8-mj4r6 中拷贝文件到本地
拷贝文件到本地 a.txt， 注意此处 :a.txt 不能写为 :/a.txt, 因为当前不支持绝对路径，后面本地不可以写为 具体路径，只需要写一个名称即可
kubectl cp test-online/web-96d5df5c8-mj4r6:a.txt a.txt
拷贝pod 中文件加 dir为本地文件夹dir：
kubectl cp test-online/web-96d5df5c8-mj4r6:dir dir
3) 通过-c指定pod中某个容器
$ kubectl -n xxx-iserving cp videomocap-service-5f8864d648-rgpj6:output/logs logs -c videomocap-service
将命令将该服务videomocap-service容器workdir的output/logs 拷贝到当前logs目录。

    注意：
    k8s 中的cp 暂时不支持绝对路径(pod_name:/a.txt 会报错)，默认路径为work dir的路径；
    若没有通过-c container_name 来指定容器，则默认将 文件拷贝到第一个容器中；

  8. auth
    Inspect authorization

6 Advanced Commands

  1. diff
    Diff live version against would-be applied version
  2. apply
    通过文件名或标准输入流(stdin)对资源进行配置
    1) 创建deployment｜pod｜service 等资源
 将资源配置详信息写到 yaml中，通过 -f 指定文件即可创建相关资源；
 kubectl apply -f dployment-my-web.yaml
  3. patch
    使用 strategic merge patch 更新一个资源的 field(s)
  4. replace
    通过 filename 或者 stdin替换一个资源
  5. wait
    Experimental: Wait for a specific condition on one or many
    resources.
  6. convert
    在不同的 API versions 转换配置文件
  7. kustomize
    Build a kustomization target from a directory or a remote url.

7 Settings Commands

  1. label
    更新在这个资源上的 labels
    默认情况下，master节点角色为master，其它节点角色为none，可以通过如下方式将其它节点标记为node1角色
$ kubectl label nodes node_name node-role.kubernetes.io/node1=
删除标（将最后的=改为-即可）
$ kubectl label nodes node_name node-role.kubernetes.io/node1-
  2. annotate
    更新一个资源的注解
  3. completion
    Output shell completion code for the specified shell (bash or zsh)
    linux:
source <(kubectl completion bash)
mac:
source <(kubectl completion zsh)

8 Other Commands

  1. alpha
    Commands for features in alpha
  2. api-resources
    Print the supported API resources on the server
  3. api-versions
    Print the supported API versions on the server, in the form of “group/version”
  4. config
    修改 kubeconfig 文件
    修改默认 ns 为test-online(k8s 默认的为default ns)
kubectl config set-context $(kubectl config current-context) --namespace=test-online
  5. plugin
    Provides utilities for interacting with plugins.
  6. version
    输出 client 和 server 的版本信息
  7. 设置kubectl 自动补全
    apt-get install bash-completion
source /usr/share/bash-completion/bash_completion
source <(kubectl completion bash)
注意：<( 之间不能有空格，否则会报错

9 说明

docs/reference/kubectl/overview/
kubectl/kubectl-commands

# kubernetes
Logo
K8S/Kubernetes

K8S/Kubernetes社区为您提供最前沿的新闻资讯和知识内容

更多推荐

【深度】阿里巴巴万级规模 K8s 集群全局高可用体系之美

作者 |  韩堂、柘远、沉醉来源 | 阿里巴巴云原生公众号​前言台湾作家林清玄在接受记者采访的时候，如此评价自己 30 多年写作生涯：“第一个十年我才华横溢，‘贼光闪现’，令周边黯然失色；第二个十年，我终于‘宝光现形’，不再去抢风头，反而与身边的美丽相得益彰；进入第三个十年，繁华落尽见真醇，我进入了‘醇光初现’的阶段，真正体味到了境界之美”。​长夜有穷，真水无香。领略过了 K8s“身在江

avatar K8S/Kubernetes

如何基于 K8s 构建下一代 DevOps 平台？

作者 | 孙健波（天元）导读：当前云原生 DevOps 体系现状如何？面临哪些挑战？如何通过 OAM 解决云原生 DevOps 场景下的诸多问题？云原生开发应用模型 OAM(Open Application Model) 社区核心成员孙健波将为大家一一解答，并分享如何基于 OAM 和 Kubernetes 打造无限能力的下一代 DevOps 平台。什么是 DevOps？为什么基于 Kub

avatar K8S/Kubernetes

k8s 火了！

2020，上云之年，产品云端化成为一种趋势。在一线城市，很多公司都已经构建了自己的私有云环境，比如阿里云、网易云、华为云等。而Kubernetes 作为基于容器编排领域的王者，具备扩展...

avatar K8S/Kubernetes