From cc8d1b9998ae52ec9147bb2d5a34df096c01dafc Mon Sep 17 00:00:00 2001
From: pandaamanda <xiong.zhongliang@zte.com.cn>
Date: Tue, 15 Oct 2019 09:43:20 +0800
Subject: [PATCH 1/3] 
 zh-trans:/zh/docs/concepts/overview/working-with-objects/object-management.md

---
 .../working-with-objects/object-management.md | 368 ++++++++++++++++++
 1 file changed, 368 insertions(+)
 create mode 100644 content/zh/docs/concepts/overview/working-with-objects/object-management.md

diff --git a/content/zh/docs/concepts/overview/working-with-objects/object-management.md b/content/zh/docs/concepts/overview/working-with-objects/object-management.md
new file mode 100644
index 0000000000000..ccceb4a2a1a0b
--- /dev/null
+++ b/content/zh/docs/concepts/overview/working-with-objects/object-management.md
@@ -0,0 +1,368 @@
+---
+title: Kubernetes 对象管理
+content_template: templates/concept
+weight: 15
+---
+
+{{% capture overview %}}
+<!--
+The `kubectl` command-line tool supports several different ways to create and manage
+Kubernetes objects. This document provides an overview of the different
+approaches. Read the [Kubectl book](https://kubectl.docs.kubernetes.io) for
+details of managing objects by Kubectl.
+-->
+`kubectl` 命令行工具支持多种不同的方式来创建和管理 Kubernetes 对象。本文档概述了不同的方法。阅读 [Kubectl book](https://kubectl.docs.kubernetes.io) 来了解 kubectl 管理对象的详细信息。
+{{% /capture %}}
+
+{{% capture body %}}
+
+<!--
+## Management techniques
+-->
+
+## 管理技术
+
+{{< warning >}}
+<!--
+A Kubernetes object should be managed using only one technique. Mixing
+and matching techniques for the same object results in undefined behavior.
+-->
+应该只使用一种技术来管理 Kubernetes 对象。混合和匹配技术作用在同一对象上将导致未定义行为。
+{{< /warning >}}
+
+| Management technique             | Operates on          |Recommended environment | Supported writers  | Learning curve |
+|----------------------------------|----------------------|------------------------|--------------------|----------------|
+| Imperative commands              | Live objects         | Development projects   | 1+                 | Lowest         |
+| Imperative object configuration  | Individual files     | Production projects    | 1                  | Moderate       |
+| Declarative object configuration | Directories of files | Production projects    | 1+                 | Highest        |
+
+<!--
+## Imperative commands
+-->
+
+## 命令式命令
+
+<!--
+When using imperative commands, a user operates directly on live objects
+in a cluster. The user provides operations to
+the `kubectl` command as arguments or flags.
+-->
+
+使用命令式命令时，用户可以在集群中的活动对象上进行操作。用户将操作传给 `kubectl` 命令作为参数或标志。
+
+<!--
+This is the simplest way to get started or to run a one-off task in
+a cluster. Because this technique operates directly on live
+objects, it provides no history of previous configurations.
+-->
+
+这是开始或者在集群中运行一次性任务的最简单方法。因为这个技术直接在活动对象上操作，所以它不提供以前配置的历史记录。
+
+<!--
+### Examples
+-->
+
+### 例子
+
+<!--
+Run an instance of the nginx container by creating a Deployment object:
+-->
+
+通过创建 Deployment 对象来运行 nginx 容器的实例：
+
+```sh
+kubectl run nginx --image nginx
+```
+
+<!--
+Do the same thing using a different syntax:
+-->
+
+使用不同的语法来达到同样的上面的效果：
+
+```sh
+kubectl create deployment nginx --image nginx
+```
+
+<!--
+### Trade-offs
+-->
+
+### 权衡
+
+<!--
+Advantages compared to object configuration:
+-->
+
+与对象配置相比的优点：
+
+<!--
+- Commands are simple, easy to learn and easy to remember.
+- Commands require only a single step to make changes to the cluster.
+-->
+
+- 命令简单，易学且易于记忆。
+- 命令仅需一步即可对集群进行更改。
+
+<!--
+Disadvantages compared to object configuration:
+-->
+
+与对象配置相比的缺点：
+
+<!--
+- Commands do not integrate with change review processes.
+- Commands do not provide an audit trail associated with changes.
+- Commands do not provide a source of records except for what is live.
+- Commands do not provide a template for creating new objects.
+-->
+
+- 命令不与变更审查流程集成。
+- 命令不提供与更改关联的审核跟踪。
+- 除了实时内容外，命令不提供记录源。
+- 命令不提供用于创建新对象的模板。
+
+
+<!--
+## Imperative object configuration
+-->
+
+## 命令式对象配置
+
+<!--
+In imperative object configuration, the kubectl command specifies the
+operation (create, replace, etc.), optional flags and at least one file
+name. The file specified must contain a full definition of the object
+in YAML or JSON format.
+-->
+
+在命令式对象配置中，kubectl 命令指定操作（创建，替换等），可选标志和至少一个文件名。指定的文件必须包含 YAML 或 JSON 格式的对象的完整定义。
+
+<!--
+See the [API reference](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/)
+for more details on object definitions.
+-->
+
+有关对象定义的详细信息，请参考 [API reference](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/)。
+
+{{< warning >}}
+<!--
+The imperative `replace` command replaces the existing
+spec with the newly provided one, dropping all changes to the object missing from
+the configuration file.  This approach should not be used with resource
+types whose specs are updated independently of the configuration file.
+Services of type `LoadBalancer`, for example, have their `externalIPs` field updated
+independently from the configuration by the cluster.
+-->
+`replace` 命令式命令将现有规范替换为新提供的规范，并删除对配置文件中缺少的对象的所有更改。此方法不应与规范独立于配置文件进行更新的资源类型一起使用。比如类型为 `LoadBalancer` 的服务，它的 `externalIPs` 字段就是独立于集群的配置进行更新。
+{{< /warning >}}
+
+<!--
+### Examples
+-->
+
+### 例子
+
+<!--
+Create the objects defined in a configuration file:
+-->
+
+创建在配置文件中定义的对象：
+
+```sh
+kubectl create -f nginx.yaml
+```
+
+<!--
+Delete the objects defined in two configuration files:
+-->
+删除在两个配置文件中定义的对象：
+
+```sh
+kubectl delete -f nginx.yaml -f redis.yaml
+```
+
+<!--
+Update the objects defined in a configuration file by overwriting
+the live configuration:
+-->
+通过覆盖实时配置来更新配置文件中定义的对象：
+
+```sh
+kubectl replace -f nginx.yaml
+```
+
+<!--
+### Trade-offs
+-->
+
+### 权衡
+
+<!--
+Advantages compared to imperative commands:
+-->
+
+与命令式命令相比的优点：
+
+<!--
+- Object configuration can be stored in a source control system such as Git.
+- Object configuration can integrate with processes such as reviewing changes before push and audit trails.
+- Object configuration provides a template for creating new objects.
+-->
+
+- 对象配置可以存储在源控制系统中，比如 Git。
+- 对象配置可以与流程集成，例如在推送和审计之前检查更新。
+- 对象配置提供了用于创建新对象的模板。
+
+<!--
+Disadvantages compared to imperative commands:
+-->
+
+与命令式命令相比的缺点：
+
+<!--
+- Object configuration requires basic understanding of the object schema.
+- Object configuration requires the additional step of writing a YAML file.
+-->
+
+- 对象配置需要对对象架构有基本的了解。
+- 对象配置需要额外的写 YAML 文件的步骤。
+
+<!--
+Advantages compared to declarative object configuration:
+-->
+
+与声明式对象配置相比的优点：
+
+<!--
+- Imperative object configuration behavior is simpler and easier to understand.
+- As of Kubernetes version 1.5, imperative object configuration is more mature.
+-->
+
+- 命令式对象配置行为更加简单易懂。
+- 从 Kubernetes 1.5 版本开始，命令式对象配置更加成熟。
+
+<!--
+Disadvantages compared to declarative object configuration:
+-->
+
+与声明式对象配置相比的缺点：
+
+<!--
+- Imperative object configuration works best on files, not directories.
+- Updates to live objects must be reflected in configuration files, or they will be lost during the next replacement.
+-->
+
+- 命令式对象配置针对文件而不是目录上效果最佳。
+- 对活动对象的更新必须反映在配置文件中，否则将在下一次替换是丢失。
+
+<!--
+## Declarative object configuration
+-->
+
+## 声明式对象配置
+
+<!--
+When using declarative object configuration, a user operates on object
+configuration files stored locally, however the user does not define the
+operations to be taken on the files. Create, update, and delete operations
+are automatically detected per-object by `kubectl`. This enables working on
+directories, where different operations might be needed for different objects.
+-->
+
+使用声明式对象配置时，用户对本地存储的对象配置文件进行操作，但是用户未定义要对该文件执行的操作。会自动通过 `kubectl` 按对象检测来创建、更新和删除对象。这使得可以在目录上工作，其中可能需要对不同的对象执行不同的操作。
+
+{{< note >}}
+<!--
+Declarative object configuration retains changes made by other
+writers, even if the changes are not merged back to the object configuration file.
+This is possible by using the `patch` API operation to write only
+observed differences, instead of using the `replace`
+API operation to replace the entire object configuration.
+-->
+声明式对象配置保留其他编写者所做的修改，即使这些更改并未合并到对象配置文件中。可以通过使用 `patch` API 操作仅写入观察到的差异，而不是使用 `replace` API 操作来替换整个对象配置来实现。
+{{< /note >}}
+
+<!--
+### Examples
+
+Process all object configuration files in the `configs` directory, and create or
+patch the live objects. You can first `diff` to see what changes are going to be
+made, and then apply:
+-->
+
+### 例子
+
+处理 `configs` 目录中的所有对象配置文件，创建并更新活动对象。可以首先使用 `diff` 子命令查看将要进行的更改，然后在进行应用：
+
+```sh
+kubectl diff -f configs/
+kubectl apply -f configs/
+```
+
+<!--
+Recursively process directories:
+-->
+递归处理目录：
+
+```sh
+kubectl diff -R -f configs/
+kubectl apply -R -f configs/
+```
+
+<!--
+### Trade-offs
+-->
+
+### 权衡
+
+<!--
+Advantages compared to imperative object configuration:
+-->
+
+与命令式对象配置相比的优点：
+
+<!--
+- Changes made directly to live objects are retained, even if they are not merged back into the configuration files.
+- Declarative object configuration has better support for operating on directories and automatically detecting operation types (create, patch, delete) per-object.
+-->
+
+- 即使未将对活动对象所做的更改未合并回到配置文件中，也将保留这些更改。
+- 声明性对象配置更好地支持对目录进行操作并自动检测每个对象的操作类型（创建，修补，删除）。
+
+<!--
+Disadvantages compared to imperative object configuration:
+-->
+
+与命令式对象配置相比的缺点：
+
+<!--
+- Declarative object configuration is harder to debug and understand results when they are unexpected.
+- Partial updates using diffs create complex merge and patch operations.
+-->
+
+- 声明式对象配置难于调试并且出现异常时难以理解。
+- 使用差异的部分更新会创建复杂的合并和补丁操作。
+
+{{% /capture %}}
+
+{{% capture whatsnext %}}
+
+<!--
+- [Managing Kubernetes Objects Using Imperative Commands](/docs/tasks/manage-kubernetes-objects/imperative-command/)
+- [Managing Kubernetes Objects Using Object Configuration (Imperative)](/docs/tasks/manage-kubernetes-objects/imperative-config/)
+- [Managing Kubernetes Objects Using Object Configuration (Declarative)](/docs/tasks/manage-kubernetes-objects/declarative-config/)
+- [Managing Kubernetes Objects Using Kustomize (Declarative)](/docs/tasks/manage-kubernetes-objects/kustomization/)
+- [Kubectl Command Reference](/docs/reference/generated/kubectl/kubectl-commands/)
+- [Kubectl Book](https://kubectl.docs.kubernetes.io)
+- [Kubernetes API Reference](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/)
+-->
+- [使用命令式命令管理 Kubernetes 对象](/docs/tasks/manage-kubernetes-objects/imperative-command/)
+- [使用对象配置管理 Kubernetes 对象（命令式）](/docs/tasks/manage-kubernetes-objects/imperative-config/)
+- [使用对象配置管理 Kubernetes 对象（声明式）](/docs/tasks/manage-kubernetes-objects/declarative-config/)
+- [使用 Kustomize（声明式）管理 Kubernetes 对象](/docs/tasks/manage-kubernetes-objects/kustomization/)
+- [Kubectl 命令参考](/docs/reference/generated/kubectl/kubectl-commands/)
+- [Kubectl Book](https://kubectl.docs.kubernetes.io)
+- [Kubernetes API 参考](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/)
+
+{{% /capture %}}

From 117906e71ea89b57d9488494147786db92a73622 Mon Sep 17 00:00:00 2001
From: ZhongliangXiong <xiong.zhongliang@zte.com.cn>
Date: Tue, 15 Oct 2019 10:24:59 +0800
Subject: [PATCH 2/3] Update
 content/zh/docs/concepts/overview/working-with-objects/object-management.md

Co-Authored-By: LiuDui <1693291525@qq.com>
---
 .../concepts/overview/working-with-objects/object-management.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/zh/docs/concepts/overview/working-with-objects/object-management.md b/content/zh/docs/concepts/overview/working-with-objects/object-management.md
index ccceb4a2a1a0b..064d8f797090a 100644
--- a/content/zh/docs/concepts/overview/working-with-objects/object-management.md
+++ b/content/zh/docs/concepts/overview/working-with-objects/object-management.md
@@ -20,7 +20,7 @@ details of managing objects by Kubectl.
 ## Management techniques
 -->
 
-## 管理技术
+## 管理技巧
 
 {{< warning >}}
 <!--

From a5f562707c795800e45d98cba2d9242bb51ed946 Mon Sep 17 00:00:00 2001
From: ZhongliangXiong <xiong.zhongliang@zte.com.cn>
Date: Tue, 15 Oct 2019 10:25:12 +0800
Subject: [PATCH 3/3] Update
 content/zh/docs/concepts/overview/working-with-objects/object-management.md

Co-Authored-By: LiuDui <1693291525@qq.com>
---
 .../concepts/overview/working-with-objects/object-management.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/zh/docs/concepts/overview/working-with-objects/object-management.md b/content/zh/docs/concepts/overview/working-with-objects/object-management.md
index 064d8f797090a..1d98c2af1c709 100644
--- a/content/zh/docs/concepts/overview/working-with-objects/object-management.md
+++ b/content/zh/docs/concepts/overview/working-with-objects/object-management.md
@@ -143,7 +143,7 @@ See the [API reference](/docs/reference/generated/kubernetes-api/{{< param "vers
 for more details on object definitions.
 -->
 
-有关对象定义的详细信息，请参考 [API reference](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/)。
+有关对象定义的详细信息，请查看 [API 参考](/docs/reference/generated/kubernetes-api/{{< param "version" >}}/)。
 
 {{< warning >}}
 <!--