使用配置文件进行 Kubernetes 对象的命令式管理
Kubernetes 对象可以使用 kubectl 命令行工具以及用 YAML 或 JSON 编写的对象配置文件来创建、更新和删除。本文档介绍了如何使用配置文件定义和管理对象。
开始之前
安装 kubectl。
你需要有一个 Kubernetes 集群，并且 kubectl 命令行工具已配置为与你的集群通信。建议在至少有两个非控制平面主机节点的集群上运行本教程。如果还没有集群，可以使用 minikube 创建一个，或者使用以下 Kubernetes 线上实验环境之一：
要检查版本，输入 kubectl version。
权衡
kubectl 工具支持三种对象管理方式：
- 命令式命令
- 命令式对象配置
- 声明式对象配置
有关每种对象管理方式的优缺点讨论，请参阅Kubernetes 对象管理。
如何创建对象
你可以使用 kubectl create -f 从配置文件创建对象。有关详细信息，请参阅kubernetes API 参考。
kubectl create -f <文件名|URL>
如何更新对象
警告
使用replace 命令更新对象会丢弃配置文件中未指定的所有规范部分。这不应与规范部分由集群部分管理的对象一起使用，例如类型为 LoadBalancer 的 Services，其中 externalIPs 字段独立于配置文件进行管理。必须将独立管理的字段复制到配置文件中，以防止 replace 命令将其丢弃。你可以使用 kubectl replace -f 根据配置文件更新正在运行的对象。
kubectl replace -f <文件名|URL>
如何删除对象
你可以使用 kubectl delete -f 删除配置文件中描述的对象。
kubectl delete -f <文件名|URL>
注意
如果配置文件在 metadata 节中指定了 generateName 字段而不是 name 字段，则无法使用 kubectl delete -f <filename|url> 删除该对象。你将不得不使用其他标志来删除对象。例如：
kubectl delete <type> <name>
kubectl delete <type> -l <label>
如何查看对象
你可以使用 kubectl get -f 查看配置文件中描述的对象的信息。
kubectl get -f <文件名|URL> -o yaml
-o yaml 标志指定打印完整的对象配置。使用 kubectl get -h 查看选项列表。
限制
当每个对象的配置在其配置文件中完全定义和记录时，create、replace 和 delete 命令工作良好。但是，当一个正在运行的对象被更新，并且更新没有合并到其配置文件中时，下次执行 replace 时，这些更新将丢失。如果控制器（例如 HorizontalPodAutoscaler）直接更新正在运行的对象，则可能会发生这种情况。以下是一个例子：
- 你从配置文件创建对象。
- 另一个源通过更改某些字段来更新对象。
- 你从配置文件替换对象。其他源在步骤 2 中所做的更改将丢失。
如果你需要支持多个写入者修改同一对象，可以使用 kubectl apply 来管理对象。
从 URL 创建和编辑对象而不保存配置
假设你有对象配置文件的 URL。你可以使用 kubectl create --edit 在创建对象之前修改配置。这对于那些指向读者可以修改的配置文件的教程和任务特别有用。
kubectl create -f <url> --edit
从命令式命令迁移到命令式对象配置
从命令式命令迁移到命令式对象配置涉及几个手动步骤。
将正在运行的对象导出到本地对象配置文件
kubectl get <kind>/<name> -o yaml > <kind>_<name>.yaml手动从对象配置文件中移除 status 字段。
对于后续的对象管理，只使用
replace。kubectl replace -f <kind>_<name>.yaml
定义控制器选择器和 PodTemplate 标签
警告
强烈不建议更新控制器的选择器。推荐的方法是定义一个单一的、不可变的 PodTemplate 标签，该标签仅供控制器选择器使用，不包含其他语义意义。
标签示例
selector:
matchLabels:
controller-selector: "apps/v1/deployment/nginx"
template:
metadata:
labels:
controller-selector: "apps/v1/deployment/nginx"