kubectl 命令行工具

Kubernetes provides a kubectl 是使用 Kubernetes API 与 Kubernetes 集群的控制面进行通信的命令行工具。

kubectl 工具通过 Kubernetes API 与你的集群通信。 在配置方面，kubectl 在 $HOME/.kube 目录中查找名为 config 的文件。 你可以通过设置 KUBECONFIG 环境变量，或设置 --kubeconfig 参数来指定其他 kubeconfig 文件。

kubectl 的作用

kubectl 工具是用于创建、查看、更新和删除 Kubernetes 对象的主要接口。 它与运行在集群内部的 Kubernetes 组件以及这些组件所实现的 Kubernetes API 相辅相成。 无论你是在笔记本电脑上运行 kubectl，还是在集群中的 Pod 内运行，它都会向 API 服务器发送请求。 诸如客户端库这类其他客户端和 Headlamp 这类 Web 控制台也都通过相同的 API 进行通信。

kubectl 的工作方式

kubectl 工具通过 kubeconfig 文件中定义的集群、用户和上下文连接到 API 服务器并进行身份认证。 当你在集群外运行 kubectl 时，它会使用 kubeconfig 文件来查找 API 服务器地址和凭据。 当 kubectl 在 Pod 内运行时（例如 CI/CD 流水线中），它可以使用基于 Pod 中挂载的 ServiceAccount Token 的集群内认证方式。

当你执行命令时，kubectl 会将你的意图转换为一个或多个 HTTP 请求发送给 Kubernetes API。API 服务器会验证每个请求， 将其应用到存储在 etcd 中的集群状态，并返回结果。 这意味着每一个 kubectl 操作，无论是创建 Deployment 还是查看日志，都遵循同样的 API 驱动路径。

由于 kubeconfig 可以定义多个集群、用户和上下文，你可以使用 kubectl 在不同集群之间切换， 而无需重新配置环境。运行 kubectl config use-context 来切换当前上下文。

kubectl 可以做什么

kubectl 支持多种操作，大致分为以下几类：

• 管理资源 – 创建、更新和删除 Pod、Deployment、Service 等对象。 使用 kubectl apply 给予配置文件进行声明式管理。
• 查看集群状态 – 列出和描述对象、查看事件、检查资源使用情况。
• 调试 – 查看容器日志、在运行中的容器内执行命令，或端口转发到 Pod。
• 集群运维操作 – 对节点执行 drain 进行维护、cordon 节点防止调度新负载，以及管理集群配置。
• 脚本与自动化 – 使用 JSONPath 将输出格式化为 JSON、YAML 或自定义列，用于脚本和流水线。

关于语法、命令参考和示例，请查看 kubectl reference 文档。

声明式与命令式

在生产环境中，建议使用基于版本控制配置文件的声明式对象管理，并使用 kubectl apply。声明式管理有助于跟踪变更、协作，并集成 GitOps 工作流。 命令式命令（如 kubectl create 或 kubectl run）适用于开发和实验，但更难复现和审计。

通过插件扩展 kubectl

你可以通过插件扩展 kubectl，增加新的子命令。 插件是独立的二进制文件，遵循 kubectl-<plugin-name> 命名约定。 Kubernetes 社区维护了许多插件，并可以通过 Krew 插件管理器进行管理。

版本兼容性

kubectl 工具支持与集群控制平面版本上下浮动一个 minor 版本的兼容性。 例如，kubectl v1.32 可与 v1.31、v1.32 和 v1.33 的控制平面兼容。 使用兼容版本可以避免意外行为。详见版本偏移策略。

接下来

• 阅读 kubectl 参考文档获取语法和命令细节。
• 在你的机器上安装 kubectl。
• 了解 Kubernetes API 的工作方式。
• 查看构成集群的 Kubernetes 组件。
• 学习对象管理与声明式配置。
• 查看版本偏移策略以了解支持的版本组合。