使用配置文件命令式管理 Kubernetes 对象

Kubernetes 对象可以使用 `kubectl` 命令行工具以及 YAML 或 JSON 编写的对象配置文件进行创建、更新和删除。本文档解释了如何使用配置文件定义和管理对象。

准备工作

安装 kubectl。

你需要拥有一个 Kubernetes 集群，并且 `kubectl` 命令行工具必须配置为与你的集群通信。建议在至少有两个不是控制平面主机的节点组成的集群上运行本教程。如果你还没有集群，可以使用 minikube 创建一个，或者使用这些 Kubernetes 操场中的一个

• iximiuz Labs
• Killercoda
• KodeKloud
• Play with Kubernetes

要检查版本，请输入 kubectl version。

权衡

kubectl 工具支持三种对象管理方式

• 命令式命令
• 命令式对象配置
• 声明式对象配置

有关每种对象管理的优缺点讨论，请参阅Kubernetes 对象管理。

如何创建对象

你可以使用 `kubectl create -f` 从配置文件创建对象。有关详细信息，请参阅 Kubernetes API 参考。

• kubectl create -f <filename|url>

如何更新对象

你可以使用 `kubectl replace -f` 根据配置文件更新活动对象。

• kubectl replace -f <filename|url>

如何删除对象

你可以使用 `kubectl delete -f` 删除配置文件中描述的对象。

• kubectl delete -f <filename|url>

kubectl delete <type> <name>
kubectl delete <type> -l <label>

如何查看对象

你可以使用 `kubectl get -f` 查看配置文件中描述的对象的详细信息。

• kubectl get -f <filename|url> -o yaml

`-o yaml` 标志指定打印完整的对象配置。使用 `kubectl get -h` 查看选项列表。

限制

当每个对象的配置都完全定义并记录在其配置文件中时，`create`、`replace` 和 `delete` 命令非常有效。但是，当活动对象被更新且更新未合并到其配置文件中时，下次执行 `replace` 时，这些更新将丢失。如果控制器（例如 HorizontalPodAutoscaler）直接对活动对象进行更新，就可能发生这种情况。下面是一个示例：

1. 你从配置文件创建一个对象。
2. 另一个源通过更改某些字段来更新对象。
3. 你从配置文件替换对象。步骤 2 中另一个源所做的更改将丢失。

如果需要支持对同一对象的多个写入器，可以使用 `kubectl apply` 来管理对象。

从 URL 创建和编辑对象而不保存配置

假设你有一个对象配置文件的 URL。你可以使用 `kubectl create --edit` 在对象创建之前更改配置。这对于指向可能被读者修改的配置文件的教程和任务特别有用。

kubectl create -f <url> --edit

从命令式命令迁移到命令式对象配置

从命令式命令迁移到命令式对象配置涉及几个手动步骤。

1. 将活动对象导出到本地对象配置文件中。

   kubectl get <kind>/<name> -o yaml > <kind>_<name>.yaml
   

2. 手动从对象配置文件中删除 status 字段。

3. 对于后续的对象管理，请专门使用 `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"

下一步

• 使用命令式命令管理 Kubernetes 对象
• 使用配置文件声明式管理 Kubernetes 对象
• Kubectl 命令参考
• Kubernetes API 参考