---
title: Kubernetes 对象管理
content_template: templates/concept
---

{{% capture overview %}}
`kubectl` 命令行工具支持 Kubernetes 对象几种不同的创建和管理方法。本文档简要介绍了这些方法.
{{% /capture %}}

{{% capture body %}}

## 管理技巧

**警告:** Kubernetes 对象应该只使用一种技术进行管理。混合使用不同的技术，会导致相同对象出现未定义的行为。

| 管理技术             | 操作         |推荐环境 | 支持撰写  | 学习曲线 |
|----------------------------------|----------------------|------------------------|--------------------|----------------|
| 命令式的方式              | 活动对象         | 开发项目   | 1+                 | 最低         |
| 命令式对象配置  | 单文件     | 生产项目    | 1                  | 中等       |
| 声明式对象配置 | 文件目录 | 生产项目    | 1+                 | 最高        |

## 命令式的方式

当使用命令式的命令时，用户直接对集群中的活动对象进行操作。用户提供 `kubectl` 命令的参数或标记进行操作。

这是在集群中启动或运行一次性任务的最简单的方法。因为这种技术直接在活动对象上运行，所以它没有提供以前配置的历史记录。

### 例子

通过创建 Deployment 对象来运行 nginx 容器的实例:

```sh
kubectl run nginx --image nginx
```

使用不同的语法做同样的事情:

```sh
kubectl create deployment nginx --image nginx
```

### 权衡

与对象配置相比的优点:

 - 命令简单易学，易于记忆。
 - 命令只需要一个步骤即可对群集进行更改。

与对象配置相比的缺点:

 - 命令不与变更审核流程整合。
 - 命令不提供与更改相关联的审计跟踪。
 - 除了活动对象之外，命令不提供记录来源。
 - 命令不提供用于创建新对象的模板。

## 命令式对象配置

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

请参阅[参考资源](/docs/resources-reference/v1.6/)
查看有关对象定义的更多细节。

**警告:** 命令式 `replace` 命令用新提供的命令替换现有资源规格，将对配置文件中缺少的对象的所有更改都丢弃。这种方法不应更新与配置文件无关的资源类型。例如，`LoadBalancer` 类型的服务使其 `externalIPs` 字段与集群的配置无关。

### 例子

创建对象定义配置文件:

```sh
kubectl create -f nginx.yaml
```

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

```sh
kubectl delete -f nginx.yaml -f redis.yaml
```

通过覆写实时配置更新配置文件中定义的对象:

```sh
kubectl replace -f nginx.yaml
```

### 权衡

与命令式的命令相比的优点:

 - 对象配置可以存储在源码控制系统中，如Git。
 - 对象配置可以与进程集成，例如在推送和审计跟踪之前查看更改。
 - 对象配置提供了一个用于创建新对象的模板。

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

 - 对象配置需要对对象模式有基本的了解。
 - 对象配置需要编写 YAML 文件的附加步骤。

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

 - 命令对象配置行为更简单易懂。
 - 至于 Kubernetes 1.5 版本，命令式对象配置更为成熟。

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

 - 命令对象配置最适合于文件，而不是目录。
 - 活动对象的更新必须反映在配置文件中，否则在下次更替时将丢失。

## 声明式对象配置

当使用声明式对象配置时，用户对本地存储的对象配置文件进行操作，但是用户没有定义要对文件执行的操作。通过 `kubectl` 自动检测每个对象进行创建、更新和删除操作。这样可以在目录层级上工作，因为不同的对象可能需要不同的操作。

**注意:** 声明式对象配置保留由其他对象进行的更改，即使更改未合并到对象配置文件中。这可以通过使用 `patch` API 操作来写入观察到的差异，而不是使用`replace` API 操作来替换整个对象的配置。

### 例子

处理`configs` 目录中的所有对象配置文件，创建或修补(patch)活动对象:

```sh
kubectl apply -f configs/
```

递归处理目录:

```sh
kubectl apply -R -f configs/
```

### 权衡

与命令式对象配置相比的优点:

 - 直接对活动对象进行的更改将被保留，即使它们未被并入到配置文件中。
 - 声明式对象配置更好地支持目录操作，并自动检测每个对象的操作类型 (创建、修补，删除)。

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

- 声明式对象配置在意外情况下难以调试和了解结果。
- 使用差异的部分更新会创建复杂的合并和补丁操作。

 {{% /capture %}}

 {{% capture whatsnext %}}
 -  [使用命令式的命令管理 Kubernetes 对象](/docs/tutorials/object-management-kubectl/imperative-object-management-command/)
 -  [使用对象配置管理 Kubernetes 对象(必要)](/docs/tutorials/object-management-kubectl/imperative-object-management-configuration/)
 -  [使用对象配置(声明式)管理 Kubernetes 对象](/docs/tutorials/object-management-kubectl/declarative-object-management-configuration/)
 -  [Kubectl 命令参考](/docs/user-guide/kubectl/v1.6/)
 -  [Kubernetes 对象模式参考](/docs/resources-reference/v1.6/)

 {{< comment >}}
 {{< /comment >}}
 {{% /capture %}}
