概念 - Kubernetes 对象管理

kubectl 命令行工具支持创建和管理 Kubernetes 对象的几种不同方式。该文档概述了不同的方法。阅读 Kubectl 小书，了解 Kubectl 管理对象的详细信息。

• 管理技巧
• 命令式命令
• 命令式对象配置
• 声明式对象配置
• 下一步怎么做

管理技巧

警告：应该仅用一种技术来管理 Kubernetes 对象。同一对象的混合及匹配技术会导致不确定的行为。

管理技巧	操作于	推荐环境	支持的写入器	学习曲线
命令式命令	活动对象	开发项目	1+	最低
命令式对象配置	独立文件	生产项目	1	中等
声明式对象配置	多目录多文件	生产项目	1+	最高

命令式命令

使用命令式命令时，用户可以直接在集群中的活动对象上进行操作。用户向 kubectl 命令提供操作作为参数或标志。

这是开始或在集群中运行一次性任务的最简单方法。由于该技术直接在活动对象上运行，因此它不提供以前配置的历史记录。

例子

通过创建 Deployment 对象来运行 Nginx 容器的实例：

kubectl run nginx --image nginx

使用不同的语法执行相同的操作：

kubectl 创建部署 nginx --image nginx

权衡取舍

与对象配置相比的优势：

• 命令简单，易学且易于记忆；
• 命令仅需一步即可对集群进行更改。

与对象配置相比的缺点：

• 命令不与变更审核流程继承；
• 命令不提供与更改关联的审核跟踪；
• 除实时内容外，命令不提供记录源；
• 命令不提供用于创建新对象的模版。

命令式对象配置

在命令式对象配置中，kubectl 命令指定操作（创建、替换等），可选标志和至少一个文件名。指定的文件必须包含 YAML 或 JSON 格式的对象的完整定义。

有关对象定义的更多详细信息，请参见 API 参考。

警告：命令式 replace 命令将现有归还替换为新提供的规范，并删除对配置文件中缺少的对象的所有更改。该方法不应与规则独立于配置文件进行更新的资源类型一起使用。例如，LoadBalancer 类型的服务的 externalIPs 字段独立于集群的配置进行更新。

例子

创建在配置文件中定义的对象：

kubectl create -f nginx.yaml

删除两个配置文件中定义的对象：

kubectl delete -f nginx yaml -f redis.yaml

通过覆盖实时配置来更新配置文件中定义的对象：

kubectl replace -f nginx.yaml

权衡取舍

与命令式命令相比的优势：

• 对象配置可以存储在源控制系统（如 Git）中；
• 对象配置可以与流程集成，例如在推送和审核跟踪之前检查更改；
• 对象配置提供了用于创建新对象的模版。

与命令式命令相比的缺点：

• 对象配置需要对对象架构由基本的了解；
• 对象配置需要额外的写入 YAML 文件的步骤。

与声明式对象配置相比的优势：

• 命令式对象配置行为更简单易懂；
• 从 Kubernetes 1.5 版本开始，命令式对象配置更加成熟。

与声明式对象配置相比的缺点：

• 命令式对象配置最适合文件而不是目录；
• 对活动对象的更新必须反映在配置文件中，否则在下一次替换期间将丢失。

声明式对象配置

使用声明式对象配置时，用户对本地存储的对象配置文件进行操作，但是，用户未定义要对该文件执行的操作。创建、更新及删除操作由 kubectl 自动检测到每个对象。这样可以处理目录，其中可能需要对不同的对象执行不同的操作。

注意：声明式对象配置保留其他编写者所做的更改，即使这些更改未合并回到对象配置文件中。这可以通过使用 patch API 操作仅写入观察到的差异，而不是使用 replace API 操作来替换整个对象配置来实现。

例子

处理 configs 目录中的所有对象配置文件，并创建或修补活动对象。我们可以先进行比较以查看将要进行的更改，然后应用：

kubectl diff -f configs/
kubectl apply -f configs/

递归处理目录：

kubectl diff -R -f configs/
kubectl apply -R -f configs/

权衡取舍

与命令式对象配置相比的优势：

• 即使未将它们重新合并到配置文件中，也将保留直接对活动对象所做的更改；
• 声明式对象配置更好地支持对目录进行操作并自动检测每个对象的操作类型（创建、修补、删除）。

与命令式对象配置相比的缺点：

• 声明式对象配置在意外发生时更难调试和理解结果；
• 使用差异的部分更新会创建复杂的合并及补丁操作。

下一步怎么做

• 使用命令式命令管理 Kubernetes 对象（敬请期待～～）
• 使用对象配置管理 Kubernetes 对象（命令式）（敬请期待～～）
• 使用对象配置管理 Kubernetes 对象（声明式）（敬请期待～～）
• 使用 Kustomize（声明式）管理 Kubernetes 对象（敬请期待～～）
• Kubectl 命令参考
• Kubectl 小书
• Kubernetes API 参考