玩转k8s：kubectl命令行工具用法详解

duansamve

已于 2024-07-31 14:26:55 修改

阅读量3.7k

点赞数

分类专栏： Kubernetes 文章标签： kubernetes

于 2023-03-05 10:50:16 首次发布

本文链接：https://blog.csdn.net/duansamve/article/details/129343403

版权

kubectl是Kubernetes集群的命令行工具，用于创建、管理和操作各种资源，如pods、services、deployments等。本文详细介绍了kubectl的语法、常用命令、资源类型以及输出选项，提供了丰富的示例，帮助用户更好地理解和使用kubectl进行集群管理。

摘要由CSDN通过智能技术生成

Kubectl 是管理kubernetes的命令行工具，kubectl在$HOME/.kube目录下查找config配置文件。可以通过设置KUBECONFIG环境变量或设置--kubeconfig参数指定其他kubeconfig文件。

本文介绍kubectl语法和命令操作描述，并提供常见示例。包括支持的参数和子命令。

一、语法

kubectl使用以下语法，在终端运行命令：

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

其中：

command：指定要对一个或多个资源执行的操作，比如create、get、describe、delete、run。
TYPE：指定资源类型。资源类型不区分大小写，可以指定单数、复数或缩写形式。

例如：以下三个命令输出结果相同

kubectl get pod nginx-1635820653-568f555cfd-fmvr2
kubectl get pods nginx-1635820653-568f555cfd-fmvr2
kubectl get po nginx-1635820653-568f555cfd-fmvr2

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

kubectl get pods

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

a) 要对所有类型相同的资源进行分区，执行以下操作： TYPE1 name1 name2 name<#>，例如：

kubectl get pod nfs-client-provisioner-6fd5756874-qkwwq sentinel-0

b) 分别指定多个资源类型： TYPE1/name TYPE1/name2 TYPE2/name1 TYPE<#>/name<#>，例如：

kubectl get pod/nfs-client-provisioner-6fd5756874-qkwwq service/nginx-1635820653

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

a) 使用YAML而不是JSON，因为YAML更容易使用，特别是用于配置文件。例如：

kubectl get -f ./pod.yaml

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

-n 后跟 namespace, 查看指定的命名空间

-o

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

如果需要帮助，可以使用kubectl的help命令

kubectl -h

二、操作

基础命令

命令	说明
create	通过文件名或者标准输入创建资源
expose	将一个资源公开为一个新的Service
run	在集群中运行一个特定的镜像
set	在对象上设置特定的功能
expiain	文档参考资料
get	显示一个或多个资源
edit	使用默认的编辑器编辑一个资源
delete	通过文件名、标准输入、资源名称或标签选择器来删除资源

集群部署命令

命令	说明
rollout	管理资源的发布
rolling-update	对给定的复制控制器滚动更新
scale	扩容或缩容Pod数量，Deployment、ReplicaSet、RC或Job
autoscale	创建一个自动选择扩容或缩容并设置Pod数量

集群管理命令

命令	说明
certificate	修改证书资源
cluster-info	显示集群信息
top	显示资源（CPU/Memory/Storage）使用。需要Heapster运行
cordon	标记节点不可调度
uncordon	标记节点可调度
drain	驱逐节点上的应用，准备下线维护
taint	修改节点taint标记

故障和调试命令

命令	说明
describe	显示特定资源或资源组的详细信息
logs	在一个Pod中打印一个容器日志。如果Pod只有一个容器，容器名称是可选的
attach	附加到一个运行的容器
exec	执行命令到容器
port-forward	转发一个或多个本地端口到一个pod
proxy	运行一个proxy到kubernetes API server
cp	拷贝文件或目录到容器中
auth	检查授权

高级命令

命令	说明
apply	通过文件名或标准输入对资源应用配置
patch	使用补丁修改、更新资源的字段
replace	通过文件名或标准输入替换一个资源
convert	不同的API版本之间转换配置文件

设置命令

命令	说明
label	更新资源上的标签
annotate	更新资源上的注释
completion	用于实现kubectl工具自动不全

其他命令

命令	说明
api-versions	打印支持的API版本
api-resources	打印支持的服务器资源API
config	修改kubeconfig文件（用于访问API，比如配置认证信息）
help	所有命令帮助
plugin	运行一个命令行插件
version	打印客户端和服务版本信息

下表包含所有kubectl操作的描述和语法

操作	语法	描述
`alpha`	`kubectl alpha SUBCOMMAND [flags]`	列出与 alpha 特性对应的可用命令，这些特性在 Kubernetes 集群中默认情况下是不启用的。
`annotate`	`kubectl annotate (-f FILENAME \| TYPE NAME \| TYPE/NAME) KEY_1=VAL_1 … KEY_N=VAL_N [—overwrite] [—all] [—resource-version=version] [flags]`	添加或更新一个或多个资源的注解。
`api-resources`	`kubectl api-resources [flags]`	列出可用的 API 资源。
`api-versions`	`kubectl api-versions [flags]`	列出可用的 API 版本。
`apply`	`kubectl apply -f FILENAME [flags]`	从文件或 stdin 对资源应用配置更改。
`attach`	`kubectl attach POD -c CONTAINER [-i] [-t] [flags]`	附加到正在运行的容器，查看输出流或与容器（stdin）交互。
`auth`	`kubectl auth [flags] [options]`	检查授权。
`autoscale`	`kubectl autoscale (-f FILENAME \| TYPE NAME \| TYPE/NAME) [—min=MINPODS] —max=MAXPODS [—cpu-percent=CPU] [flags]`	自动伸缩由副本控制器管理的一组 pod。
`certificate`	`kubectl certificate SUBCOMMAND [options]`	修改证书资源。
`cluster-info`	`kubectl cluster-info [flags]`	显示有关集群中主服务器和服务的端口信息。
`completion`	`kubectl completion SHELL [options]`	为指定的 shell （bash 或 zsh）输出 shell 补齐代码。
`config`	`kubectl config SUBCOMMAND [flags]`	修改 kubeconfig 文件。有关详细信息，请参阅各个子命令。
`convert`	`kubectl convert -f FILENAME [options]`	在不同的 API 版本之间转换配置文件。配置文件可以是 YAML 或 JSON 格式。
`cordon`	`kubectl cordon NODE [options]`	将节点标记为不可调度。
`cp`	`kubectl cp <file-spec-src> <file-spec-dest> [options]`	在容器之间复制文件和目录。
`cr`