通过使用 kubectl
命令行工具和 yaml 或 json 格式编写的对象配置文件,用户可以创建、更新和删除 Kubernetes 对象。
本文档介绍如何使用配置文件定义和管理对象。
kubectl
工具支持三种对象管理:
请参阅Kubernetes 对象管理 以了解每种对象管理的优缺点。
可以使用 kubectl create -f
从配置文件创建对象。
有关详细信息,请参阅Kubernetes API 参考。
kubectl create -f <filename|url>
Warning:使用
replace
命令更新对象时,系统将会删除配置文件的 spec 中未指定的所有内容。 对于部分上由集群来管理的对象而言,不要使用这种对象管理方式。例如,对于
LoadBalancer
类型的服务而言,其externalIPs
字段值是独立于配置文件进行管理的。 独立管理的字段必须复制到配置文件中,以防止被replace
操作删除。
您可以使用 kubectl replace -f
命令基于配置文件来更新活跃状态的对象。
kubectl replace -f <filename|url>
您可以使用 kubectl delete -f
命令来删除配置文件中描述的对象。
kubectl delete -f <filename|url>
您可以使用 kubectl get -f
命令来查看配置文件中描述的对象的信息。
kubectl get -f <filename|url> -o yaml
指定了 -o yaml
参数将会打印完整的对象配置。
使用 kubectl get -h
命令查看选项列表。
当每个对象的配置都完整的定义和记录在它的配置文件中时,create
、replace
和 delete
命令就能正常使用。
然而,当一个存活态的对象被更新、并且更新的内容没有被合入该对象的配置文件时,下次再执行 replace
命令将导致更新的内容丢失。
如果控制器(如 HorizontalPodAutoscaler)直接更新存活态的对象,就会发生上面的情况。
下面是个例子:
如果您需要对同一对象支持多个写者,那么可以使用 kubectl apply
命令管理该对象。
假设您知道一个对象配置文件的 URL。
您可以在对象被创建之前使用 kubectl create --edit
命令来更改它的配置。
这对于指向那些读者可修改配置文件的教程和任务特别有用。
kubectl create -f <url> --edit
从指令性命令迁移到指令性对象配置包括几个手动步骤。
将存活态的对象导出为本地对象配置文件:
kubectl get <kind>/<name> -o yaml --export > <kind>_<name>.yaml
手动从对象配置文件中移除状态信息。
对于后续的对象管理,只使用 replace
。
kubectl replace -f <kind>_<name>.yaml
Warning:强烈不建议更新控制器的选择器。
建议的方法是定义一个单一的、不变的 PodTemplate 标签,该标签仅由控制器选择器使用,没有其他语义意义。
标签示例:
selector:
matchLabels:
controller-selector: "extensions/v1beta1/deployment/nginx"
template:
metadata:
labels:
controller-selector: "extensions/v1beta1/deployment/nginx"
此页是否对您有帮助?
Thanks for the feedback. If you have a specific, answerable question about how to use Kubernetes, ask it on Stack Overflow. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement.