Kubernetes集群管理工具kubectl命令技巧大全
Posted aaron-23
tags:
篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了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.10
Kubernetes 清单可以用 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"
EOF
2、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
以上是关于Kubernetes集群管理工具kubectl命令技巧大全的主要内容,如果未能解决你的问题,请参考以下文章
第七章 kubernetes 集群命令行工具 kubectl
Kubernetes集群命令的管理工具kubectl实例讲解