Kubernetes集群管理工具kubectl命令技巧大全
一. kubectl概述
Kubectl是用于控制Kubernetes集群的命令行工具，通过kubectl能够对集群本身进行管理，并能够在集群上进行容器化应用的安装部署。
kubectl命令的语法如下所示：
kubectl [command] [TYPE] [NAME] [flags]
comand：指定要在一个或多个资源执行，例如操作create，get，describe，delete。
TYPE：指定资源类型，资源类型不区分大小写，您可以指定单数，复数或缩写形式。例如，以下命令产生相同的输出：
kubectl get pod pod1 kubectl get pods pod1 kubectl get po pod1
- NAME：指定资源的名称，名称区分大小写。如果省略名称，则显示所有资源的详细信息，例如：
kubectl get pods
- flags：指定可选的参数。例如，可以使用-s或者–server参数指定Kubernetes API server的地址和端口。
注意：在命令行中指定的标志将覆盖默认值和任何相应的环境变量。
如果需要帮助,可以通过kubectl help命令获取更多的信息。
二. kubectl操作的简短说明和常规语法
Basic Commands (Beginner): create 从文件或标准输入创建一个或多个资源 expose 使用 replication controller, service, deployment 或者 pod 并暴露它作为一个 新的 Kubernetes Service run 在集群中运行一个指定的镜像 set 为 objects 设置一个指定的特征 Basic Commands (Intermediate): explain 查看资源的文档 get 显示一个或更多 resources edit 使用默认编辑器编辑和更新服务器上一个或多个资源的定义 delete 从文件，stdin或指定标签选择器，名称，资源选择器或资源中删除资源 Deploy Commands: rollout 通过逐渐替换指定的复制控制器及其容器来执行滚动更新 scale 为 Deployment, ReplicaSet, Replication Controller 或者 Job 设置一个新的副本数量 autoscale 自动调整一个 Deployment, ReplicaSet, 或者 ReplicationController 的副本数量 Cluster Management Commands: certificate 修改 certificate 资源 cluster-info 显示集群信息 top Display Resource (CPU/Memory/Storage) usage. cordon 标记 node 为 unschedulable uncordon 标记 node 为 schedulable drain Drain node in preparation for maintenance taint 更新一个或者多个 node 上的 taints Troubleshooting and Debugging Commands: describe 显示一个指定 resource 或者 group 的 resources 详情 logs 输出容器在 pod 中的日志 attach Attach 到一个运行中的 container exec 在一个 container 中执行一个命令 port-forward Forward one or more local ports to a pod proxy 运行一个 proxy 到 Kubernetes API server cp 复制 files 和 directories 到 containers 和从容器中复制 files 和 directories. auth Inspect authorization Advanced Commands: apply 通过文件名或标准输入流(stdin)对资源进行配置 patch 使用 strategic merge patch 更新一个资源的 field(s) replace 通过 filename 或者 stdin替换一个资源 wait Experimental: Wait for one condition on one or many resources convert 在不同的 API versions 转换配置文件 Settings Commands: label 更新在这个资源上的 labels annotate 更新一个资源的注解 completion Output shell completion code for the specified shell (bash or zsh) Other Commands: alpha Commands for features in alpha api-resources Print the supported API resources on the server api-versions Print the supported API versions on the server, in the form of "group/version" config 修改 kubeconfig 文件 plugin Runs a command-line plugin version 输出 client 和 server 的版本信息
有关命令操作的更多信息，请参见kubectl官方参考文档。
三. kubectl常用命令
kubectl作为kubernetes的命令行工具，主要的职责就是对集群中的资源的对象进行操作，这些操作包括对资源对象的创建、删除和查看等。
四. kubectl输出选项
所有kubectl命令的默认输出格式是人类可读的纯文本格式。要以特定格式将详细信息输出到终端窗口，可以将-o或--output标志添加到受支持的kubectl命令中,例：
kubectl [command] [TYPE] [NAME] -o=<output_format>
根据kubectl操作，支持以下输出格式
| 输出格式 | 描述 |
|---|---|
| -o custom-columns= spec | 使用逗号分隔的自定义列列表打印表。 |
| -o custom-columns-file=filename | 使用文件中的自定义列模板打印表。 |
| -o json | 输出JSON格式的API对象。 |
| -o jsonpath=template | 打印在jsonpath表达式中定义的字段。 |
| -o jsonpath-file=filename | 打印文件中jsonpath表达式定义的字段。 |
| -o name | 仅打印资源名称，而不打印其他任何内容。 |
| -o wide | 以纯文本格式输出，并带有任何其他信息。对于Pod，包含节点名称。 |
| -o yaml | 输出YAML格式的API对象。 |
示例：
以下命令将单个pod的详细信息输出为YAML格式的对象
kubectl get pod web-pod-13je7 -o yaml
五. kubectl常用命令示例
1、kubectl create命令
此命令通过文件或者stdin创建一个资源对象，假设这里存在一个nginx部署的YAML配置文件，可以通过执行下面的命令创建部署对象。
kubectl create -f nginx-deployment.yaml
nginx部署的YAML配置文件的示例代码如下：
apiVersion: apps/v1 # for versions before 1.9.0 use apps/v1beta2
kind: Deployment
metadata:
name: nginx
spec:
replicas: 10
selector:
matchLabels:
app: nginx
revisionHistoryLimit: 2
template:
metadata:
labels:
app: nginx
spec:
imagePullSecrets:
- name: dc-hspfd
containers:
# 应用的镜像
- image: nginx
name: nginx
imagePullPolicy: IfNotPresent
# 应用的内部端口
ports:
- containerPort: 80
name: nginx80
# 持久化挂接位置，在docker中
volumeMounts:
- mountPath: /usr/share/nginx/html
name: nginx-data
- mountPath: /etc/nginx
name: nginx-conf
volumes:
# 宿主机上的目录
- name: nginx-data
nfs:
path: /nfs/nginx
server: 192.168.1.10
- name: nginx-conf
nfs:
path: /k8s-nfs/nginx/conf
server: 192.168.1.10Kubernetes 清单可以用 json 或 yaml 来定义。使用的文件扩展名包括 .yaml, .yml 和 .json。
kubectl create -f ./my-manifest.yaml # 创建资源 kubectl create -f ./my1.yaml -f ./my2.yaml # 从多个文件创建资源 kubectl create -f ./dir # 通过目录下的所有清单文件创建资源 kubectl create -f https://git.io/vPieo # 使用 url 获取清单创建资源 kubectl run nginx --image=nginx # 开启一个 nginx 实例 kubectl explain pods,svc # 获取 pod 和服务清单的描述文档
- 通过标准输入创建多个 YAML 对象
cat <<EOF | kubectl create -f -
apiVersion: v1
kind: Pod
metadata:
name: busybox-sleep
spec:
containers:
- name: busybox
image: busybox
args:
- sleep
- "1000000"
---
apiVersion: v1
kind: Pod
metadata:
name: busybox-sleep-less
spec:
containers:
- name: busybox
image: busybox
args:
- sleep
- "1000"
EOF2、kubectl get 命令
通过此命令列出一个或多个资源对象，在这里通过kubectl get命令获取default命名空间下的所有部署。
kubectl get deployment # 具有基本输出的 get 命令 kubectl get services # 列出命名空间下的所有 service kubectl get pods --all-namespaces # 列出所有命名空间下的 pod kubectl get pods -o wide # 列出命名空间下所有 pod，带有更详细的信息 kubectl get deployment my-dep # 列出特定的 deployment kubectl get pods --include-uninitialized # 列出命名空间下所有的 pod，包括未初始化的对象 # 有详细输出的 describe 命令 kubectl describe nodes my-node kubectl describe pods my-pod kubectl get services --sort-by=.metadata.name # List Services Sorted by Name
# 根据重启次数排序，列出所有 pod
kubectl get pods --sort-by=‘.status.containerStatuses[0].restartCount‘
# 查询带有标签 app=cassandra 的所有 pod，获取它们的 version 标签值
kubectl get pods --selector=app=cassandra rc -o jsonpath=‘{.items[*].metadata.labels.version}‘# 获取命名空间下所有运行中的 pod
kubectl get pods --field-selector=status.phase=Running
# 所有所有节点的 ExternalIP
kubectl get nodes -o jsonpath=‘{.items[*].status.addresses[?(@.type=="ExternalIP")].address}‘3、kubectl describe命令
此命令用于显示一个或多个资源对象的详细信息，在这里通过获取上述nginx部署的信息。
kubectl describe deployments/nginx
4、kubectl exec命令
此命令用于在Pod中的容器上执行一个命令，此处在nginx的一个容器上执行/bin/bash命令。
kubectl exec -it nginx-c5cff9dcc-dr88w /bin/bash
5、kubectl logs命令
此命令用于获取Pod中一个容器的日志信息，此处获取nginx一个容器的日志信息。
kubectl logs nginx-c5cff9dcc-dr88w
6、kubectl delete命令
此命令用于删除集群中已存在的资源对象，可以通过指定名称、标签选择器、资源选择器等。
kubectl delete -f ./pod.json # 使用 pod.json 中指定的类型和名称删除 pod kubectl delete pod,service baz foo # 删除名称为 "baz" 和 "foo" 的 pod 和 service kubectl delete pods,services -l name=myLabel # 删除带有标签 name=myLabel 的 pod 和 service kubectl delete pods,services -l name=myLabel --include-uninitialized # 删除带有标签 name=myLabel 的 pod 和 service，包括未初始化的对象 kubectl -n my-ns delete po,svc --all # 删除命名空间 my-ns 下所有的 pod 和 service，包括未初始化的对象
7、kubectl edit 命令
使用默认编辑器 编辑服务器上定义的资源。
使用命令行工具获取的任何资源都可以使用edit命令编辑。edit命令会打开使用KUBE_EDITOR，GIT_EDITOR 或者EDITOR环境变量定义的编辑器，可以同时编辑多个资源，但所编辑过的资源只会一次性提交。edit除命令参数外还接受文件名形式。
文件默认输出格式为YAML。要以JSON格式编辑，请指定“-o json”选项。
语法：
kubectl edit (RESOURCE/NAME | -f FILENAME)
示例：
# 编辑名为“docker-registry”的service kubectl edit svc/docker-registry # 使用一个不同的编辑器 KUBE_EDITOR="nano" kubectl edit svc/docker-registry # 编辑名为“docker-registry”的service，使用JSON格式、v1 API版本 kubectl edit svc/docker-registry --output-version=v1 -o json
选项：
-f, --filename=[]: 用来指定待编辑资源的文件名，目录名或者URL。
-o, --output="yaml": 输出格式，可选yaml或者json中的一种。
--output-version="": 输出资源使用的API版本（默认使用api-version）。8、kubectl rolling-update 命令
此命令用于滚动更新，对镜像、端口等的更新
kubectl rolling-update frontend-v1 -f frontend-v2.json # 滚动更新 pod：frontend-v1 kubectl rolling-update frontend-v1 frontend-v2 --image=image:v2 # 变更资源的名称并更新镜像 kubectl rolling-update frontend --image=image:v2 # 更新 pod 的镜像 kubectl rolling-update frontend-v1 frontend-v2 --rollback # 中止进行中的过程 at pod.json | kubectl replace -f - # 根据传入标准输入的 JSON 替换一个 pod
9、node 和集群管理
kubectl cordon my-node # #标记节点 my-node 为不可调度 kubectl drain my-node # #准备维护时，排除节点 my-node kubectl uncordon my-node # #标记节点 my-node 为可调度 kubectl top node my-node # #显示给定节点的度量值 kubectl cluster-info # #显示 master 和 service 的地址 kubectl cluster-info dump # #将集群的当前状态转储到标准输出 kubectl cluster-info dump --output-directory=/path/to/cluster-state # #将集群的当前状态转储到目录 /path/to/cluster-state # 如果带有该键和效果的污点已经存在，则将按指定的方式替换其值 kubectl taint nodes foo dedicated=special-user:NoSchedule
参考资料
1.《kubectl概述》：https://kubernetes.io/docs/reference/kubectl/overview/#syntax
2.《kubectl命令概述》：https://kubernetes.io/docs/reference/kubectl/overview/#syntax
相关推荐
朱培知浅ZLH 2020-11-16
cdbdqn00 2020-11-12
达观数据 2020-11-11
JustinChia 2020-11-11
远远的山 2020-11-09
jingtao 2020-11-08
大叔比较胖 2020-10-30
gracecxj 2020-10-30
onepiecedn 2020-10-29
kunyus 2020-10-28
JustHaveTry 2020-10-27
锋锋 2020-10-26
hubanbei00的家园 2020-10-25
谢恩铭 2020-10-23
btqszl 2020-10-21
kaidiphp 2020-10-13
guchengxinfen 2020-10-12
liverlife 2020-10-10
BigDataMining 2020-10-08