kubernetes系列文章第二篇-kubectl

末蓝、 2023-03-14 08:24 30阅读 0赞

往期精彩文章

[kubernetes系列文章第一篇-k8s基本介绍][kubernetes_-k8s]

[kubernetes简介-这是一篇学习k8s必看的文章][kubernetes_-_k8s]

[kubernetes概述-介绍、组件、架构][kubernetes_-]

[了解pod和pod的生命周期-这一篇文章就够了][pod_pod_-]

[kubernetes service][]

[kubernetes1.17.3安装-超详细的安装步骤][kubernetes1.17.3_-]

[安装kubernetes1.17.3多master节点的高可用集群][kubernetes1.17.3_master]

[k8s1.18高可用集群安装-超详细中文官方文档][k8s1.18_-]

[k8s1.18多master节点高可用集群安装-超详细中文官方文档][k8s1.18_master_-]

[kubernetes HPA-超详细中文官方文档][kubernetes HPA-]

[kubernetes集群中部署EFK日志管理系统][kubernetes_EFK]

[kubernetes dashboard 2.0版本安装及RBAC授权][kubernetes dashboard 2.0_RBAC]

[kubernetes calico的两种网络模式BGP和IP-IP性能分析][kubernetes calico_BGP_IP-IP]

[k8s中蓝绿部署、金丝雀发布、滚动更新汇总][k8s]

[kubernetes Statefulset控制器][kubernetes Statefulset]

[Statefulset+storageclass+ceph最佳实践][Statefulset_storageclass_ceph]

[jenkins+kubernetes+harbor+gitlab构建企业级devops平台  
][jenkins_kubernetes_harbor_gitlab_devops_]

[kubeadm初始化k8s集群延长证书过期时间][kubeadm_k8s]

kubectl简介

kubectl是操作k8s集群的命令行工具，安装在k8s的master节点上，kubectl在$HOME/.kube目录中查找一个名为config的文件, 你可以通过设置Kubeconfig环境变量或设置--kubeconfig来指定其他的kubeconfig文件。kubectl通过与apiserver交互可以实现对k8s集群中各种资源的增删改查。接下来将会介绍kubectl语法，命令行的操作，并介绍常见的示例。命令的详细信息、参数和子命令可在kubectl参考文档中查看。

kubectl语法

kubectl语法格式如下，可在k8s集群的master节点执行：

kubectl [command] [TYPE] [NAME] [flags]

**上述语法解释说明：**

**command****：**指定要对一个或多个资源执行的操作，例如create、get、describe、delete等。

**type****：**指定资源类型。资源类型不区分大小写，可以指定单数、复数或缩写形式。例如，以下命令输出相同的结果:

kubectl get pod pod1

kubectl get pods pod1

kubectl get po pod1

**NAME****：**指定资源的名称。名称区分大小写。如果省略名称，则显示所有资源的详细信息：kubectlget pods。

**flags:** 指定可选的参数。例如，可以使用-s或-server参数指定 Kubernetes API服务器的地址和端口。

**注意事项说明:**

从命令行指定的参数会覆盖默认值和任何相应的环境变量。

**1.****在对多个资源执行操作时，可以按类型、名称、一个或者多个文件指定每个资源：**

**1****）按类型和名称指定资源：**

要对所有类型相同的资源进行分组，请执行以下操作：

TYPE1 name1 name2 name<\#>。  
例子：kubectl get pod example-pod1 example-pod2

分别指定多个资源类型：

TYPE1/name1 TYPE1/name2 TYPE2/name3TYPE<\#>/name<\#>。

例：kubectl get pod/example-pod1 deployment/example-rc1

**2****）用一个或多个文件指定资源：-f file1 -f file2 -f file<\#>**

使用YAML而不是JSON，因为YAML更容易使用，特别是用于配置文件时。  
例子：kubectl get pod -f ./pod.yaml

**2.kubectl –-help**

可查看kubectl的帮助命令

操作

下面讲解和kubectl操作相关的命令和语法：

**1. annotate**

1）语法：  
kubectlannotate (-f FILENAME | TYPE NAME | TYPE/NAME) KEY\_1=VAL\_1 … KEY\_N=VAL\_N\[--overwrite\] \[--all\] \[--resource-version=version\] \[flags\]

2）描述：

添加或更新一个或多个资源的注释。

**\*\*2. api-versions**

1）语法：

kubectl api-versions\[flags\]

2）描述：

列出可用的api版本

**\*\*3.apply**

1）语法：

kubectl apply -f FILENAME \[flags\]

从文件或stdin对资源的应用配置进行更改。

**4.attach-****不用**

1）语法：

kubectl attach POD-name -c CONTAINER-name  \[-i\] \[-t\] \[flags\]

附加到正在运行的容器，查看输出流或与容器交互。

**\*\*5.autoscale**

1）语法：

kubectl autoscale (-f FILENAME | TYPE NAME| TYPE/NAME) \[--min=MINPODS\] --max=MAXPODS \[--cpu-percent=CPU\] \[flags\]

自动扩缩容由副本控制器管理的一组 pod。

**6.cluster-info**

1）语法：

kubectl cluster-info \[flags\]

显示有关集群中的主服务器和服务的端点信息。

**7.config**

1）语法：

kubectl config SUBCOMMAND \[flags\]

修改kubeconfig文件

**8.create-****一般不用，用apply替代这个**

1）语法：

kubectl create -f FILENAME \[flags\]

从文件或标准输入创建一个或多个资源。** **

**\*\*9.delete**

1）语法：  
kubectl delete (-fFILENAME | TYPE \[NAME | /NAME | -l label | --all\]) \[flags\]

从文件、标准输入或指定标签选择器、名称、资源选择器或资源中删除资源。

**\*\*10.describe**

1）语法：

kubectl describe (-f FILENAME | TYPE\[NAME\_PREFIX | /NAME | -l label\]) \[flags\]

显示一个或多个资源的详细状态。

**11.diff**

1）语法：

kubectl diff -f FILENAME \[flags\]

将 live 配置和文件或标准输入做对比 (**BETA****版**)

**\*\*12.edit**

1）语法：  
kubectl edit (-fFILENAME | TYPE NAME | TYPE/NAME) \[flags\]

使用默认编辑器编辑和更新服务器上一个或多个资源的定义。** **

**\*\*13.exec-****常用的**

1）语法：

kubectl exec POD-name \[-c CONTAINER-name\]\[-i\] \[-t\] \[flags\] \[-- COMMAND \[args...\]\]

对 pod 中的容器执行命令。

**下面的命令就是登录到pod中的容器的命令**

kubectl exec calico-node-cblk2 -nkube-system -i -t -- /bin/sh

**\*\*14.explain-****常用的**

1）语法：

kubectl explain \[--recursive=false\]\[flags\]

获取多种资源的文档。例如 pod, node,service 等，相当于帮助命令，可以告诉我们怎么创建资源

**\*\*15.expose**

1）语法：

kubectl expose (-f FILENAME | TYPE NAME |TYPE/NAME) \[--port=port\] \[--protocol=TCP|UDP\] \[--target-port=number-or-name\]\[--name=name\] \[--external-ip=external-ip-of-service\] \[--type=type\] \[flags\]

将副本控制器、服务或pod作为新的Kubernetes服务进行暴露。

**\*\*16.get**

1）语法：

kubectl get (-f FILENAME | TYPE \[NAME |/NAME | -l label\]) \[--watch\] \[--sort-by=FIELD\] \[\[-o | --output\]=OUTPUT\_FORMAT\]\[flags\]

列出一个或多个资源。** **

**17.label**

1）语法：

kubectl label (-f FILENAME | TYPE NAME |TYPE/NAME) KEY\_1=VAL\_1 … KEY\_N=VAL\_N \[--overwrite\] \[--all\]\[--resource-version=version\] \[flags\]

添加或更新一个或多个资源的标签。

**\*\*18.logs**

1）语法：  
kubectl logs POD \[-cCONTAINER\] \[--follow\] \[flags\]

在 pod 中打印容器的日志。

**19.patch**

1）语法：  
kubectl patch (-fFILENAME | TYPE NAME | TYPE/NAME) --patch PATCH \[flags\]

更新资源的一个或多个字段

**20.port-forward**

1）语法：

kubectl port-forward POD\[LOCAL\_PORT:\]REMOTE\_PORT \[...\[LOCAL\_PORT\_N:\]REMOTE\_PORT\_N\] \[flags\]

将一个或多个本地端口转发到Pod。** **

**21.proxy**

1）语法：

kubectl proxy \[--port=PORT\]\[--www=static-dir\] \[--www-prefix=prefix\] \[--api-prefix=prefix\] \[flags\]

运行Kubernetes API服务器的代理。

**22.replace**

1）语法：  
kubectl replace -fFILENAM

从文件或标准输入中替换资源。** **

**\*\*23.run**

1）语法：

kubectl run NAME --image=image\[--env=“key=value”\] \[--port=port\] \[--dry-run=server | client | none\]\[--overrides=inline-json\] \[flags\]

在集群上运行指定的镜像

**24.scale**

1）语法：

kubectl scale (-f FILENAME | TYPE NAME |TYPE/NAME) --replicas=COUNT \[--resource-version=version\]\[--current-replicas=count\] \[flags\]

更新指定副本控制器的大小。

**25.version**

1）语法：

kubectl version \[--client\] \[flags\]

显示运行在客户端和服务器上的 Kubernetes 版本

**举例说明：**

kubectl run nginx --image=nginx 可以创建一个nginx应用

实际创建pod应用都是通过编写资源清单文件进行创建

**注：**

上面标注\*\*是常用命令，需要重点记一下，有关kubectl更详细的操作命令，可参考https://kubernetes.io/docs/reference/kubectl/kubectl/

资源类型

下表列出所有受支持的资源类型及其缩写别名:

(以下输出可以通过kubectl api-resources获取，内容以 Kubernetes 1.13.3 版本为准。)

![format_png][]

**输出选项**

下面给大家介绍怎么对输出的命令进行格式化或者排序

**1.****格式输出**

kubectl命令的默认输出格式是人类可读的明文格式，若要以特定格式向终端窗口输出详细信息，可以将-o或—out参数添加到受支持的kubectl命令中。

**2.语法**

kubectl \[command\] \[TYPE\] \[NAME\]-o=<output\_format>

根据 kubectl 操作，支持以下输出格式：

![format_png 1][]

**\*\*****示例：****在此示例中，以下命令将单个 pod 的详细信息输出为 YAML 格式的对象：**

kubectl get pod web-pod-13je7 -o yaml

**注：**

有关每个命令支持哪种输出格式的详细信息，可参考：

https://kubernetes.io/docs/user-guide/kubectl/

**3.自定义列**

要定义自定义列并仅将所需的详细信息输出到表中，可以使用custom-columns选项。你可以选择内联定义自定义列或使用模板文件：-o=custom-columns=<spec> 或 -o=custom-columns-file=<filename>

示例：

**1）内联：**

kubectl get pods <pod-name> -ocustom-columns=NAME:.metadata.name,RSRC:.metadata.resourceVersion

**2）模板文件：**

kubectl get pods <pod-name> -ocustom-columns-file=template.txt

其中，template.txt文件内容是：

NAME          RSRC

metadata.name metadata.resourceVersion

运行任何一个命令的结果是:

NAME           RSRC

submit-queue       610995

**4.server-side 列**

kubectl支持从服务器接收关于对象的特定列信息。这意味着对于任何给定的资源，服务器将返回与该资源相关的列和行，以便客户端打印。通过让服务器封装打印的细节，这允许在针对同一集群使用的客户端之间提供一致的人类可读输出。默认情况下，此功能在kubectl 1.11及更高版本中启用。要禁用它，请将该--server-print=false参数添加到 kubectl get 命令中。

**要打印有关 pod 状态的信息，请使用如下命令：**

kubectl get pods <pod-name>--server-print=false

输出如下：

NAME                   AGE

nfs-provisioner-595dcd6b77-527np     5d21h

**5.** **排序列表对象**

要将对象排序后输出到终端窗口，可以将--sort-by参数添加到支持的kubectl命令。通过使用--sort-by参数指定任何数字或字符串字段来对对象进行排序。要指定字段，请使用jsonpath表达式。

**语法**

kubectl \[command\] \[TYPE\] \[NAME\]--sort-by=<jsonpath\_exp>

**要打印按名称排序的pod列表，请运行：**

kubectl get pods -n kube-system--sort-by=.metadata.name

NAME                               READY   STATUS   RESTARTS   AGE
    calico-node-cblk2                  1/1     Running  40         7d8h
    calico-node-q84kx                  1/1     Running  31         7d8h
    coredns-66bff467f8-f2nrb           1/1     Running  3          5d21h
    coredns-66bff467f8-x24ff           1/1     Running  4          5d21h
    etcd-master1                       1/1     Running  7          7d8h
    kube-apiserver-master1             1/1     Running  22         7d8h
    kube-controller-manager-master1    1/1    Running   81         7d8h
    kube-proxy-4xlzz                   1/1     Running  4          7d8h
    kube-proxy-pxjlx                   1/1     Running  5          7d8h
    kube-scheduler-master1             1/1     Running  72         7d8h
    metrics-server-8459f8db8c-lvx9x    2/2    Running   2          5d21h
    traefik-ingress-controller-c8dm6   1/1    Running   4          7d8h
    traefik-ingress-controller-nr4n6   1/1    Running   6          7d8h

常用操作

使用下面的列子帮你熟悉kubectl常用的操作

**1.kubectl apply  **

用文件或者标准输入来应用或者更新k8s的资源

# 使用 example-service.yaml 中的定义创建服务。

kubectl apply -f example-service.yaml

# 使用 example-controller.yaml 中的定义创建 replication controller。

kubectl apply -f example-controller.yaml

# 使用 <directory> 路径下的任意 .yaml, .yml, 或 .json 文件 创建对象。

kubectl apply -f <directory>

2.kubectl get

列出一个或多个资源。

# 以纯文本输出格式列出所有 pod。

kubectl get pods

# 以纯文本输出格式列出所有 pod，并包含附加信息(如节点名)。

kubectl get pods -o wide

# 以纯文本输出格式列出具有指定名称的副本控制器。提示：你可以使用别名 'rc' 缩短和替换 'replicationcontroller' 资源类型。

kubectl get replicationcontroller <rc-name>

# 以纯文本输出格式列出所有副本控制器和服务。

kubectl get rc,services

# 以纯文本输出格式列出所有守护程序集。

kubectl get ds

# 列出在节点 server01 上运行的所有 pod

kubectl get pods --field-selector=spec.nodeName=server01

**3.kubectl describe**

显示一个或多个资源的详细状态，默认情况下包括未初始化的资源。

# 显示名称为 <node-name> 的节点的详细信息。

kubectl describe nodes <node-name>

# 显示名为 <pod-name> 的 pod 的详细信息。

kubectl describe pods/<pod-name>

# 显示由名为 <rc-name> 的副本控制器管理的所有 pod 的详细信息。

**记住：**副本控制器创建的任何pod都以复制控制器的名称为前缀。

kubectl describe pods <rc-name>

#描述所有的 pod

kubectl describe pods

**注意：**

kubectl get命令通常用于检索同一资源类型的一个或多个资源。它具有丰富的参数，允许您使用-o或--output参数自定义输出格式。你可以指定-w 或--watch参数以开始观察特定对象的更新。kubectl describe命令更侧重于描述指定资源的许多相关方面。它可以调用对API服务器的多个API调用来为用户构建视图。例如，该kubectl describe node命令不仅检索有关节点的信息，还检索在其上运行的pod的摘要，为节点生成的事件等。

**4.kubectl delete**

从文件、标注输入或指定标签选择器、名称、资源选择器或资源中删除资源。

#使用 pod.yaml 文件中指定的类型和名称删除 pod。

kubectl delete -f pod.yaml

# 删除标签名= <label-name> 的所有 pod 和服务。

kubectl delete pods,services -l name=<label-name>

# 删除所有具有标签名称= <label-name> 的 pod 和服务，包括未初始化的那些。

kubectl delete pods,services -l name=<label-name> --include-uninitialized

# 删除所有 pod，包括未初始化的 pod。

kubectl delete pods --all

**5.kubectl exec**

对pod中的容器执行命令。

# 从 pod <pod-name> 中获取运行 'date' 的输出。默认情况下，输出来自第一个容器。

kubectl exec <pod-name> date

# 运行输出 'date' 获取在容器的 <container-name> 中 pod <pod-name> 的输出。

kubectl exec <pod-name> -c <container-name> date

# 获取一个交互 TTY 并运行 /bin/bash <pod-name >。默认情况下，输出来自第一个容器。

kubectl exec -ti <pod-name> -- /bin/bash

**6.kubectl logs**

打印 Pod 中容器的日志。

# 从 pod 返回日志快照。

kubectl logs <pod-name>

# 从 pod <pod-name> 开始流式传输日志。这类似于 'tail -f' Linux 命令。

kubectl logs -f <pod-name>

## 技术交流群    ##

为了大家更快速的学习知识，掌握技术，随时沟通问题，特组建了技术交流群，大家在群里可以分享自己的技术栈，抛出日常问题，群里会有很多大佬及时解答，这样我们就会结识很多志同道合的人，群里还有很多关于kubernetes/docker/devops/openstack/openshift/linux/IaaS/PaaS的免费文章和视频，长按下图可加我微信，备注运维或者k8s或者devops即可进群，让我们共同努力，向着美好的未来出发吧~~~

![format_png 2][]

**微信：**luckylucky421302

## 微信公众号    ##

长按如下指纹可关注公众号·

![format_png 3][]

[kubernetes_-k8s]: https://blog.csdn.net/weixin_38320674/article/details/106030727
[kubernetes_-_k8s]: https://blog.csdn.net/weixin_38320674/article/details/104935565
[kubernetes_-]: https://blog.csdn.net/weixin_38320674/article/details/105697736
[pod_pod_-]: https://blog.csdn.net/weixin_38320674/article/details/105697738
[kubernetes service]: https://blog.csdn.net/weixin_38320674/article/details/105697735
[kubernetes1.17.3_-]: http://mp.weixin.qq.com/s?__biz=MzU0NjEwMTg4Mg%3D%3D&chksm=fb638d18cc14040e17ba26f9a652387e053617831e85e7f07b73c2822f8d6c44e026519b003b&idx=1&mid=2247483917&scene=21&sn=2d336b1f62239a7b3e2db3417b5b9bab#wechat_redirect
[kubernetes1.17.3_master]: http://mp.weixin.qq.com/s?__biz=MzU0NjEwMTg4Mg%3D%3D&chksm=fb638d37cc1404214209da89028b11cffe35a4d062dfaff51d7b66148c0aed140f14f4851471&idx=1&mid=2247483938&scene=21&sn=ee88518233ef902651e39b9e6a322c9d#wechat_redirect
[k8s1.18_-]: https://blog.csdn.net/weixin_38320674/article/details/105781372
[k8s1.18_master_-]: https://blog.csdn.net/weixin_38320674/article/details/106089099
[kubernetes HPA-]: https://blog.csdn.net/weixin_38320674/article/details/105460033
[kubernetes_EFK]: https://blog.csdn.net/weixin_38320674/article/details/105852646
[kubernetes dashboard 2.0_RBAC]: https://blog.csdn.net/weixin_38320674/article/details/105697742
[kubernetes calico_BGP_IP-IP]: http://mp.weixin.qq.com/s?__biz=MzU0NjEwMTg4Mg%3D%3D&chksm=fb638d07cc14041110635f8d02650392722026ec3e3198ce9fbc5dae6d660366b2db2fa40607&idx=1&mid=2247483922&scene=21&sn=3f183076d1d894782144efbb46d9951d#wechat_redirect
[k8s]: https://blog.csdn.net/weixin_38320674/article/details/105828889
[kubernetes Statefulset]: http://mp.weixin.qq.com/s?__biz=MzU0NjEwMTg4Mg%3D%3D&chksm=fb638d64cc1404721dcce027b77cc01c99e069517c405feb98106320ef91fc3c7f11e4eb505f&idx=1&mid=2247484017&scene=21&sn=f4cef6930a68d4b2c9dd27d0e25655f5#wechat_redirect
[Statefulset_storageclass_ceph]: http://mp.weixin.qq.com/s?__biz=MzU0NjEwMTg4Mg%3D%3D&chksm=fb638d3fcc140429de016e4fb142538a738c6215855fa5eff4c8727fe169aefa068365e0bcbd&idx=1&mid=2247483946&scene=21&sn=33649711c598c89e810b4d03d79c1846#wechat_redirect
[jenkins_kubernetes_harbor_gitlab_devops_]: http://mp.weixin.qq.com/s?__biz=MzU0NjEwMTg4Mg%3D%3D&chksm=fb638d2fcc14043990967471ba8a2aaf389ab483594fd81395b5afda1c23a9eff4371df6bca4&idx=1&mid=2247483962&scene=21&sn=595eac335f7fb523bbb60cbbede109ca#wechat_redirect
[kubeadm_k8s]: https://blog.csdn.net/weixin_38320674/article/details/105721879
[format_png]: /images/20230312/8b24c9071bc545d0ba72318575f6bbd9.png
[format_png 1]: /images/20230312/dc6b9bd19a3f46c1a3406923a1ff8503.png
[format_png 2]: /images/20230312/9561d8c850894fc799296942393d165e.png
[format_png 3]: /images/20230312/213de3f7cf9448a6a84e6bbf0db19978.png