You are viewing a plain text version of this content. The canonical link for it is here.
Posted to reviews@yunikorn.apache.org by GitBox <gi...@apache.org> on 2022/01/18 06:15:43 UTC

[GitHub] [incubator-yunikorn-site] yangwwei commented on a change in pull request #108: [YUNIKORN-1029] Add Chinese translation for documents

yangwwei commented on a change in pull request #108:
URL: https://github.com/apache/incubator-yunikorn-site/pull/108#discussion_r786411896



##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/api/scheduler.md
##########
@@ -0,0 +1,1317 @@
+---
+id: scheduler
+title: 调度

Review comment:
       调度器

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/design/architecture.md
##########
@@ -0,0 +1,56 @@
+---
+id: architecture
+title: 架构
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+Apache YuniKorn (Incubating) 是一个用于容器编排器系统的轻量级通用资源调度器。
+它的创建是为了在大规模、多租户和云原生环境中高效地实现各种工作负载的细粒度资源共享。
+YuniKorn为无状态批处理和有状态服务组成的混合工作负载带来了统一的、跨平台的调度体验。
+
+YuniKorn现在支持K8s并可以作为自定义K8s调度程序部署。
+YuniKorn的架构设计还允许添加不同的 shim(中介)层,并采用不同的ResourceManager实现,包括 Apache Hadoop YARN 或任何的其他系统。
+
+## 架构
+
+下图说明了YuniKorn的高级体系结构。
+
+<img src={require('./../assets/architecture.png').default} />
+
+## 组件
+
+### 调度器接口
+
+[调度器接口](https://github.com/apache/incubator-yunikorn-scheduler-interface) 是一个抽象层。资源管理平台(如YARN/K8s)将通过GRPC/编程语言绑定等API与之对话。
+
+### 调度器核心
+
+调度器核心封装了所有的调度算法,它从底层的资源管理平台(如YARN/K8s)收集资源,并负责容器分配请求。
+它决定每个请求的最佳位置,然后将响应分配发送到资源管理平台。
+调度器核心对底层平台是不可知的,所有的通信都是通过 [调度器接口](https://github.com/apache/incubator-yunikorn-scheduler-interface)。
+请阅读更多有关调度器核心的设计内容 [链接](scheduler_core_design.md)。
+
+### Kubernetes shim
+
+YuniKorn Kubernetes shim负责与Kubernetes交互,它负责转换Kubernetes集群资源,并通过调度器接口将资源请求发送到调度器核心。

Review comment:
       它负责转换Kubernetes集群资源 -> 它负责翻译Kubernetes集群的资源请求信息

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/get_started/core_features.md
##########
@@ -0,0 +1,72 @@
+---
+id: core_features
+title: 特征
+keywords:
+ - 特征
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+YuniKorn的主要特点包括:
+
+## 应用感知调度
+
+YuniKorn的关键区别之一就是它支持应用感知的调度。在默认的K8s调度程序中,它只能根据Pod进行调度,而不能基于用户、应用程序或者队列。
+然而,YuniKorn可以识别用户、应用程序或者队列,并在做出调度决策时,考虑更多的因素,如资源、排序等。
+这使我们能够对资源配额、资源公平性和优先级进行细粒度控制,这是多租户计算系统最重要的需求。
+
+## 层次资源队列
+
+层次队列提供了一种有效的机制来管理集群资源。
+队列的层次结构可以在逻辑上映射到组织结构。这为不同租户提供了对资源的细粒度控制。
+YuniKorn UI 提供了一个集中的视图来监视资源队列的使用情况,它可以帮助您了解不同租户是如何使用资源的。
+此外,通过利用最小/最大队列容量,它可以定义每个租户的弹性资源消耗。
+
+## 作业排序和排队
+
+应用可以在工作队列中正确排队,排序策略决定哪个应用程序可以首先获得资源。

Review comment:
       > 应用可以在工作队列中正确排队,排序策略决定哪个应用程序可以首先获得资源。
   
   YuniKorn 将每个资源队列中的队列进行排队,排序策略决定哪个应用程序可以首先获得资源。

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/get_started/core_features.md
##########
@@ -0,0 +1,72 @@
+---
+id: core_features
+title: 特征
+keywords:
+ - 特征
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+YuniKorn的主要特点包括:
+
+## 应用感知调度
+
+YuniKorn的关键区别之一就是它支持应用感知的调度。在默认的K8s调度程序中,它只能根据Pod进行调度,而不能基于用户、应用程序或者队列。
+然而,YuniKorn可以识别用户、应用程序或者队列,并在做出调度决策时,考虑更多的因素,如资源、排序等。
+这使我们能够对资源配额、资源公平性和优先级进行细粒度控制,这是多租户计算系统最重要的需求。
+
+## 层次资源队列
+
+层次队列提供了一种有效的机制来管理集群资源。
+队列的层次结构可以在逻辑上映射到组织结构。这为不同租户提供了对资源的细粒度控制。
+YuniKorn UI 提供了一个集中的视图来监视资源队列的使用情况,它可以帮助您了解不同租户是如何使用资源的。
+此外,通过利用最小/最大队列容量,它可以定义每个租户的弹性资源消耗。
+
+## 作业排序和排队
+
+应用可以在工作队列中正确排队,排序策略决定哪个应用程序可以首先获得资源。
+这个策略可以是多种多样的,例如简单的 `FIFO`、`Fair`、`StateAware`或基于`Priority`的策略。
+队列可以维持应用的顺序,调度器根据不同的策略为作业分配相应的资源。这种行为更容易被理解和控制。
+
+此外,当配置队列最大容量时,作业和任务可以在资源队列中正确排队。
+如果剩余的容量不够,它们可以排队等待,直到释放一些资源。这简化了客户端操作。
+与默认调度程序不同,资源由命名空间资源配额限制,这是由配额许可控制器强制执行的。
+如果下面的命名空间没有足够的配额,Pod就不能被创建。
+客户端需要复杂的逻辑来处理此类场景,例如按条件重试。
+
+## 资源公平性
+
+在多租户环境中,许多用户共享集群资源。
+为了避免租户争夺资源或者可能的资源不足,需要做到更细粒度的公平性需求,以此来实现跨用户以及跨团队/组织的公平性。
+考虑到权重或优先级,一些更重要的应用可以获得超过其配额的更多的需求资源。
+这往往与资源预算有关,更细粒度的公平模式可以进一步提高资源控制。

Review comment:
       > 这往往与资源预算有关,更细粒度的公平模式可以进一步提高资源控制。
   
    这往往与资源预算有关,更细粒度的公平模式可以进一步提高资源共享的效率。

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/user_guide/placement_rules.md
##########
@@ -0,0 +1,356 @@
+---
+id: placement_rules
+title: 应用放置规则
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+放置规则的基础在 [调度器配置设计文档](design/scheduler_configuration.md#placement-rules-definition) 中有描述。
+一个放置策略可以连接多个规则。
+[访问控制列表](user_guide/acls.md) 和规则过滤器根据规则定义,并根据规则强制执行。
+本文档通过示例说明了如何构建作为调度器一部分的策略,包括规则用法。
+
+## 配置
+规则是作为调度器队列配置的一部分按分区定义的。
+规则的定义顺序就是规则的执行顺序。
+如果某个规则与策略匹配,则该策略将停止执行其余规则。
+
+匹配规则生成一个完全限定的队列名称。
+这意味着返回的名称从 _root_ 队列开始。
+可以生成的队列层次结构中的层级数目没有限制。
+
+当执行规则时,已执行规则的结果是未知的,不会被考虑在内。
+与尚未执行的规则类似:规则不能影响其他规则,除非它们被配置为 [父级](#parent-parameter) 规则。
+
+如果策略不生成队列名称并且没有更多规则,则应用程序将被拒绝。
+
+配置中规则放置定义的基本结构:
+```yaml
+placementrules:
+  - name: <第一个规则名称>
+  - name: <第二个规则名称>
+```
+每个规则都可以在配置中采用一组预定义的参数。
+[规则](#rules) 章节的描述中给出了可以使用的规则名称。
+配置中的规则名称不区分大小写。
+规则名称必须遵循以下命名约定:
+* 以字母开头:a-z 或 A-Z
+* 后跟 0 个或多个字符 a-z、A-Z、0-9 或 _
+
+未知的规则,即名称未映射到下面定义的规则,将导致放置管理器的初始化错误。
+如果参数不正确,规则也可以在初始化期间抛出解析异常或错误。
+有错误的规则集永远不会变为活动状态。
+
+如果放置管理器具有活动规则集,则将其视为已初始化。
+当重新加载配置时,将创建一个新规则集来替换活动规则集。
+如果加载的新规则集包含错误,即被破坏,则放置管理器将忽略新规则集。
+这意味着放置管理器保持在加载损坏的规则集时的状态。
+如果放置管理器在已经初始化的情况下继续使用现有的活动规则集,它将记录有关损坏和忽略的配置的消息。

Review comment:
       放置管理器 -> 放置策略管理器

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/user_guide/placement_rules.md
##########
@@ -0,0 +1,356 @@
+---
+id: placement_rules
+title: 应用放置规则
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+放置规则的基础在 [调度器配置设计文档](design/scheduler_configuration.md#placement-rules-definition) 中有描述。
+一个放置策略可以连接多个规则。
+[访问控制列表](user_guide/acls.md) 和规则过滤器根据规则定义,并根据规则强制执行。
+本文档通过示例说明了如何构建作为调度器一部分的策略,包括规则用法。
+
+## 配置
+规则是作为调度器队列配置的一部分按分区定义的。
+规则的定义顺序就是规则的执行顺序。
+如果某个规则与策略匹配,则该策略将停止执行其余规则。
+
+匹配规则生成一个完全限定的队列名称。
+这意味着返回的名称从 _root_ 队列开始。
+可以生成的队列层次结构中的层级数目没有限制。
+
+当执行规则时,已执行规则的结果是未知的,不会被考虑在内。
+与尚未执行的规则类似:规则不能影响其他规则,除非它们被配置为 [父级](#parent-parameter) 规则。
+
+如果策略不生成队列名称并且没有更多规则,则应用程序将被拒绝。
+
+配置中规则放置定义的基本结构:
+```yaml
+placementrules:
+  - name: <第一个规则名称>
+  - name: <第二个规则名称>
+```
+每个规则都可以在配置中采用一组预定义的参数。
+[规则](#rules) 章节的描述中给出了可以使用的规则名称。
+配置中的规则名称不区分大小写。
+规则名称必须遵循以下命名约定:
+* 以字母开头:a-z 或 A-Z
+* 后跟 0 个或多个字符 a-z、A-Z、0-9 或 _
+
+未知的规则,即名称未映射到下面定义的规则,将导致放置管理器的初始化错误。
+如果参数不正确,规则也可以在初始化期间抛出解析异常或错误。
+有错误的规则集永远不会变为活动状态。
+
+如果放置管理器具有活动规则集,则将其视为已初始化。
+当重新加载配置时,将创建一个新规则集来替换活动规则集。
+如果加载的新规则集包含错误,即被破坏,则放置管理器将忽略新规则集。
+这意味着放置管理器保持在加载损坏的规则集时的状态。

Review comment:
       放置管理器 -> 放置策略管理器

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/user_guide/queue_config.md
##########
@@ -0,0 +1,349 @@
+---
+id: queue_config
+title: 分区和队列配置
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+队列配置的基础在 [配置设计文档](design/scheduler_configuration.md) 中给出。
+
+本文档提供了通用队列配置。
+它引用了 [访问控制列表](user_guide/acls.md) 和 [放置规则](user_guide/placement_rules.md) 文档。
+
+本文档通过示例说明了如何为调度器创建分区和队列配置。
+
+作为应用程序提交的一部分,调度器依赖于 shim 来可靠地提供用户信息。
+当前 shim 使用 [用户和组解析](usergroup_resolution) 中提供的方法识别用户和用户所属的组。
+
+## 配置
+这里描述的调度器的配置文件只提供了分区和队列的配置。
+
+默认情况下,我们在部署中使用名为 `queues.yaml` 的文件。
+可以通过调度器的命令行标志 `policyGroup` 更改文件名。
+更改文件名后必须在 deployment 详细信息中进行相应的更改,无论是 `configmap` 还是包含在 docker 容器中的文件。
+
+配置的示例文件位于调度器核心内 [queues.yaml](https://github.com/apache/incubator-yunikorn-core/blob/master/config/queues.yaml)。
+
+## 分区
+分区是调度器配置的顶层。
+配置中可以定义多个分区。
+
+配置中分区定义的基本结构:
+```yaml
+partitions:
+  - name: <name of the 1st partition>
+  - name: <name of the 2nd partition>
+```
+分区的默认名称是 `default`。
+分区定义包含特定 shim 的调度程器的完整配置。
+每个 shim 使用自己唯一的分区。
+
+分区必须至少定义以下键:
+* 名称
+* [队列](#queues)
+
+队列配置释义如下。
+
+可以选择为分区定义以下键:
+* [布置规则](#placement-rules)
+* [限制](#limits)
+* 节点排序策略
+* 抢占
+
+布置规则和限制在它们自己的章节中进行了详解
+
+`nodesortpolicy` 定义了节点为分区排序的方式。
+可以使用的值的详细信息在 [排序策略](sorting_policies.md#node-sorting) 文档中可以参考。
+
+抢占键目前只能有一个子键:_enabled_ 。
+这个布尔值定义了整个分区的抢占行为。
+
+_enabled_ 的默认值为 _false_ 。
+允许值:_true_ 或 _false_ ,任何其他值都会导致解析错误。
+
+设置了 _preemption_ 标志和 `nodesortpolicy` 为 _fair_ 的示例 `partition` yaml 描述:
+```yaml
+partitions:
+  - name: <分区名称>
+    nodesortpolicy: fair
+    preemption:
+      enabled: true
+```
+注意:
+目前,Kubernetes 唯一的 shim 不支持除 `default` 分区之外的任何其他分区。
+这已为 shim 在 [jira](https://issues.apache.org/jira/browse/YUNIKORN-22) 上进行了记录。
+
+### 队列
+
+YuniKorn 通过利用资源队列来管理资源。资源队列具有以下特征:
+- 队列可以有 **等级制的** 结构

Review comment:
       等级制度 -> 层级结构

##########
File path: i18n/zh-cn/docusaurus-plugin-content-pages/community/how_to_contribute.md
##########
@@ -0,0 +1,107 @@
+---
+id: how_to_contribute
+title: 如何贡献
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# 如何贡献
+
+YuniKorn 使用:
+* JIRA 用于问题跟踪。
+* GitHub 用于 Pull Requests(以后简称拉取请求)来管理代码审查和更改本身。
+* MarkDown 用于文档的源代码树。
+
+## 发现问题
+我们使用 JIRA 问题库来跟踪该项目的错误。
+找到您想要处理的问题,或者如果您发现了新问题,请提交新问题。
+有关报告问题的帮助,请查看 [如何报告问题](reporting_issues)。
+
+开始使用代码库的最简单方法是选择一个非常简单的 JIRA 问题并开始工作。
+这将帮助您熟悉代码库、构建系统、审查过程等。
+我们在 [此处](https://issues.apache.org/jira/issues/?jql=project%3DYUNIKORN%20AND%20status%3DOpen%20AND%20labels%3Dnewbie) 标记这些入门错误。
+
+如果没有人在处理现有问题,请您在只想打算尽快处理该问题时将其分配给自己。
+如果您选择现有的 JIRA,请查找链接到 JIRA ticket 的拉取请求。
+有人可能已经在处理它并且没有分配 ticket。
+具有拉取请求链接的 JIRA 将具有标签 `pull-request-available`,并且可以在问题链接下找到拉取请求的链接。
+
+对于任何不只是微不足道的更改,例如拼写错误或一行代码更改,讨论您在该问题上的预期方法是一个好主意。
+如果您在开始编写修复程序之前已经从 YuniKorn 社区获得了支持,那么您更有可能审查并提交您的补丁程序。
+
+如果您无法将 JIRA 分配给自己,请请求社区帮助分配并将您添加到 JIRA 的贡献者列表中。
+
+## 修复问题
+必须在 `master` 分支上创建修复或改进。
+将相关的 YuniKorn 项目 fork 到您自己的项目中并签出 `master` 分支。
+确保在开始之前签出最新的代码修订。
+创建一个分支来处理,一个好名字是你正在处理的 JIRA ID。
+
+现在可以开始编码了!在编写补丁时,请牢记以下几点:
+
+在您的补丁中需要包含测试。
+如果您的补丁添加了功能或修复了错误并且不包括测试,则通常不会被接受。
+如果您不确定如何为特定组件编写测试,请在 JIRA 上寻求指导。
+
+请让您的补丁只修改了 JIRA 描述的问题。
+如果我们对每个补丁的范围保持记录,这对每个人都会更好。
+一般来说,如果您在处理特定功能时发现错误,请为该错误提交 JIRA,并检查您是否可以将其分配给自己并独立于该功能进行修复。
+这有助于我们区分错误修复和功能,并让我们构建稳定的维护版本。
+
+确保您已遵守 [编码指南](coding_guidelines) 中的建议。
+在您提交之前,您还应该使用 `make test` 运行完整的测试套件。
+这样能确保所有测试都通过。
+
+最后,请写一个好的、清晰的提交信息,并带有一个简短的描述性标题。
+描述性标题必须以您正在处理的 JIRA ID 开头。
+一个例子是:`[YUNIKORN-2] Support Gang Scheduling`。
+提交消息将用于预填充拉取请求的信息。
+消息中的 JIRA ID 将自动链接拉取请求和 JIRA。
+下面的消息可用于解释问题是什么,以及如何解决。
+
+## 创建拉取请求
+请使用您的补丁在 github 上创建一个拉取请求。
+有关所有的详细信息,请参阅 [开启拉取请求](https://help.github.com/articles/using-pull-requests/)。
+
+对于提交者:您可以使用 GitHub UI 创建新分支、推送更改并创建 PR。
+对于贡献者:您已经 fork 了存储库并将您的更改提交到您的 fork。
+使用 GitHub UI 使用 `compare across forks` 选项创建 PR。
+
+拉取请求描述必须包含您正在处理的 JIRA 链接。
+如果您如上所述设置提交消息,则拉取请求将自动获取它。
+如果您没有这样做,您可以修改拉取请求的描述以添加 JIRA ID。
+例如,链接到 [YUNIKORN-2](https://issues.apache.org/jira/browse/YUNIKORN-2) 的拉取请求应具有如下描述:
+`[YUNIKORN-2] Support Gang Scheduling`
+
+## 提交更改
+当更改被批准后,它将被提交到存储库的 `master` 分支。
+提交消息必须在第一行包含 JIRA,并且应该包含 `Closes #1`,这样一个提交将自动关闭 PR。
+JIRA 不会自动关闭。
+
+## 报告安全问题
+YuniKorn 社区非常关心安全问题,并将积极解决任何安全问题作为重中之重。 
+我们遵循 Apache 安全指南来处理安全问题,请参阅 Apache 文档关于 [处理安全问题](https://www.apache.org/security/)。 
+如果您发现任何安全问题,请将漏洞报告发送至 security@apache.org,YuniKorn 安全团队将立即评估问题并与报告者一起制定修复计划。
+在与安全团队合作之前,请不要将问题透露给任何公共论坛。
+
+## 如果扔有问题?

Review comment:
       如果仍有问题?
   
   错别字扔

##########
File path: i18n/zh-cn/docusaurus-plugin-content-pages/release-announce/0.10.0.md
##########
@@ -0,0 +1,54 @@
+---
+id: rn-0.10.0
+title: 发布公告 v0.10.0
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+# 发布公告 v0.10.0
+我们非常高兴地宣布 Apache YuniKorn (Incubating) 社区已投票发布 0.10.0。Apache YuniKorn (Incubating) 是一个独立的资源调度器,旨在管理和调度容器编排框架上的大数据工作负载,支持本地和云端的用例。
+
+此版本中添加的显著功能是联邦调度,YuniKorn 现在可以在 Kubernetes 上运行应用程序时提供联邦调度功能。除此之外,此版本还包括各种错误修复和改进。

Review comment:
       此版本中添加的显著功能是 gang scheduling, YuniKorn 现在可以在 Kubernetes 上运行应用程序时提供gang scheduling 调度功能。除此之外,此版本还包括各种错误修复和改进。

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/design/architecture.md
##########
@@ -0,0 +1,56 @@
+---
+id: architecture
+title: 架构
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+Apache YuniKorn (Incubating) 是一个用于容器编排器系统的轻量级通用资源调度器。
+它的创建是为了在大规模、多租户和云原生环境中高效地实现各种工作负载的细粒度资源共享。

Review comment:
       目标是为了在大规模、多租户和云原生的环境中高效地实现各种工作负载的细粒度资源调度以及共享。

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/get_started/core_features.md
##########
@@ -0,0 +1,72 @@
+---
+id: core_features
+title: 特征
+keywords:
+ - 特征
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+YuniKorn的主要特点包括:
+
+## 应用感知调度
+
+YuniKorn的关键区别之一就是它支持应用感知的调度。在默认的K8s调度程序中,它只能根据Pod进行调度,而不能基于用户、应用程序或者队列。
+然而,YuniKorn可以识别用户、应用程序或者队列,并在做出调度决策时,考虑更多的因素,如资源、排序等。
+这使我们能够对资源配额、资源公平性和优先级进行细粒度控制,这是多租户计算系统最重要的需求。
+
+## 层次资源队列
+
+层次队列提供了一种有效的机制来管理集群资源。
+队列的层次结构可以在逻辑上映射到组织结构。这为不同租户提供了对资源的细粒度控制。
+YuniKorn UI 提供了一个集中的视图来监视资源队列的使用情况,它可以帮助您了解不同租户是如何使用资源的。
+此外,通过利用最小/最大队列容量,它可以定义每个租户的弹性资源消耗。

Review comment:
       此外,用户可以利用设置最小/最大队列容量来为每个租户设定其弹性资源配额。

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/design/architecture.md
##########
@@ -0,0 +1,56 @@
+---
+id: architecture
+title: 架构
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+Apache YuniKorn (Incubating) 是一个用于容器编排器系统的轻量级通用资源调度器。
+它的创建是为了在大规模、多租户和云原生环境中高效地实现各种工作负载的细粒度资源共享。
+YuniKorn为无状态批处理和有状态服务组成的混合工作负载带来了统一的、跨平台的调度体验。
+
+YuniKorn现在支持K8s并可以作为自定义K8s调度程序部署。
+YuniKorn的架构设计还允许添加不同的 shim(中介)层,并采用不同的ResourceManager实现,包括 Apache Hadoop YARN 或任何的其他系统。
+
+## 架构
+
+下图说明了YuniKorn的高级体系结构。

Review comment:
       下图说明了YuniKorn的系统架构。

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/get_started/core_features.md
##########
@@ -0,0 +1,72 @@
+---
+id: core_features
+title: 特征
+keywords:
+ - 特征
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+YuniKorn的主要特点包括:
+
+## 应用感知调度
+
+YuniKorn的关键区别之一就是它支持应用感知的调度。在默认的K8s调度程序中,它只能根据Pod进行调度,而不能基于用户、应用程序或者队列。
+然而,YuniKorn可以识别用户、应用程序或者队列,并在做出调度决策时,考虑更多的因素,如资源、排序等。
+这使我们能够对资源配额、资源公平性和优先级进行细粒度控制,这是多租户计算系统最重要的需求。

Review comment:
       YuniKorn的关键特性之一就是支持应用感知。在默认的K8s调度程序中,它只能根据Pod进行调度,而不能基于用户、作业或者队列进行更细粒度的调度。与之不同的是,YuniKorn可以识别用户、作业或者队列,并在做出调度决策时,考虑更多与它们相关的因素,如资源、排序等。这使我们能够对资源配额、资源公平性和优先级进行细粒度控制,这是多租户计算系统最重要的需求。

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/get_started/core_features.md
##########
@@ -0,0 +1,72 @@
+---
+id: core_features
+title: 特征
+keywords:
+ - 特征
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+YuniKorn的主要特点包括:
+
+## 应用感知调度
+
+YuniKorn的关键区别之一就是它支持应用感知的调度。在默认的K8s调度程序中,它只能根据Pod进行调度,而不能基于用户、应用程序或者队列。
+然而,YuniKorn可以识别用户、应用程序或者队列,并在做出调度决策时,考虑更多的因素,如资源、排序等。
+这使我们能够对资源配额、资源公平性和优先级进行细粒度控制,这是多租户计算系统最重要的需求。
+
+## 层次资源队列
+
+层次队列提供了一种有效的机制来管理集群资源。
+队列的层次结构可以在逻辑上映射到组织结构。这为不同租户提供了对资源的细粒度控制。
+YuniKorn UI 提供了一个集中的视图来监视资源队列的使用情况,它可以帮助您了解不同租户是如何使用资源的。
+此外,通过利用最小/最大队列容量,它可以定义每个租户的弹性资源消耗。
+
+## 作业排序和排队
+
+应用可以在工作队列中正确排队,排序策略决定哪个应用程序可以首先获得资源。
+这个策略可以是多种多样的,例如简单的 `FIFO`、`Fair`、`StateAware`或基于`Priority`的策略。
+队列可以维持应用的顺序,调度器根据不同的策略为作业分配相应的资源。这种行为更容易被理解和控制。

Review comment:
       > 队列可以维持应用的顺序,调度器根据不同的策略为作业分配相应的资源。这种行为更容易被理解和控制。
   
   队列中的应用会根据预定义的排序策略进行排序,而后按顺序调度。用户可以基于自身需求设置不同的排队策略,以满足不同的业务场景需求。

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/user_guide/placement_rules.md
##########
@@ -0,0 +1,356 @@
+---
+id: placement_rules
+title: 应用放置规则
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+放置规则的基础在 [调度器配置设计文档](design/scheduler_configuration.md#placement-rules-definition) 中有描述。

Review comment:
       放置规则的基本信息

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/get_started/get_started.md
##########
@@ -0,0 +1,71 @@
+---
+id: user_guide
+title: 开始
+slug: /
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+在阅读本指南之前,我们假设您有一个Kubernetes集群或本地Kubernetes开发环境,例如MiniKube。
+还假定 `kubectl` 在您的环境路径内,并且配置正确。
+遵循此 [指南](../developer_guide/env_setup.md) 来讲述如何使用 docker-desktop 设置本地Kubernetes集群。
+
+## 安装
+
+最简单的方法是使用我们的Helm Charts在现有的Kubernetes集群上部署YuniKorn。
+我们建议使用Helm 3或更高版本。
+
+```shell script
+helm repo add yunikorn  https://apache.github.io/incubator-yunikorn-release
+helm repo update
+kubectl create namespace yunikorn
+helm install yunikorn yunikorn/yunikorn --namespace yunikorn
+```
+
+默认情况下,helm chart将在集群中安装调度器、web服务器和 admission-controller。
+安装 `admission-controller` 后,它只需将所有流量路由到YuniKorn即可。
+这意味着资源调度会委托给YuniKorn。在helm安装过程中,可以通过将 `embedAdmissionController` 标志设置为false来禁用它。
+
+如果你不想使用helm的charts,您可以找到我们的细节教程 [点击这里](../developer_guide/deployment.md) 。

Review comment:
       如果你不想使用helm charts

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/get_started/get_started.md
##########
@@ -0,0 +1,71 @@
+---
+id: user_guide
+title: 开始
+slug: /
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+在阅读本指南之前,我们假设您有一个Kubernetes集群或本地Kubernetes开发环境,例如MiniKube。
+还假定 `kubectl` 在您的环境路径内,并且配置正确。
+遵循此 [指南](../developer_guide/env_setup.md) 来讲述如何使用 docker-desktop 设置本地Kubernetes集群。
+
+## 安装
+
+最简单的方法是使用我们的Helm Charts在现有的Kubernetes集群上部署YuniKorn。
+我们建议使用Helm 3或更高版本。
+
+```shell script
+helm repo add yunikorn  https://apache.github.io/incubator-yunikorn-release
+helm repo update
+kubectl create namespace yunikorn
+helm install yunikorn yunikorn/yunikorn --namespace yunikorn
+```
+
+默认情况下,helm chart将在集群中安装调度器、web服务器和 admission-controller。
+安装 `admission-controller` 后,它只需将所有流量路由到YuniKorn即可。
+这意味着资源调度会委托给YuniKorn。在helm安装过程中,可以通过将 `embedAdmissionController` 标志设置为false来禁用它。
+
+如果你不想使用helm的charts,您可以找到我们的细节教程 [点击这里](../developer_guide/deployment.md) 。
+
+## 卸载
+
+运行如下的命令卸载YuniKorn:
+
+```shell script
+helm uninstall yunikorn --namespace yunikorn
+```
+
+## 访问 Web UI
+
+部署调度器时,web UI也部署在容器中。
+标准端口上web界面的端口转发可以通过以下方式打开:
+
+```shell script
+kubectl port-forward svc/yunikorn-service 9889:9889 -n yunikorn
+kubectl port-forward svc/yunikorn-service 9080:9080 -n yunikorn
+```

Review comment:
       This might be done in a bit older version. In the latest doc, we just need to do port-forwarding for port 9889: https://yunikorn.apache.org/docs/next/#access-the-web-ui. So, please change this to:
   
   ```shell script
   kubectl port-forward svc/yunikorn-service 9889:9889 -n yunikorn
   ```

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/get_started/get_started.md
##########
@@ -0,0 +1,71 @@
+---
+id: user_guide
+title: 开始
+slug: /
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+在阅读本指南之前,我们假设您有一个Kubernetes集群或本地Kubernetes开发环境,例如MiniKube。
+还假定 `kubectl` 在您的环境路径内,并且配置正确。
+遵循此 [指南](../developer_guide/env_setup.md) 来讲述如何使用 docker-desktop 设置本地Kubernetes集群。
+
+## 安装
+
+最简单的方法是使用我们的Helm Charts在现有的Kubernetes集群上部署YuniKorn。
+我们建议使用Helm 3或更高版本。
+
+```shell script
+helm repo add yunikorn  https://apache.github.io/incubator-yunikorn-release
+helm repo update
+kubectl create namespace yunikorn
+helm install yunikorn yunikorn/yunikorn --namespace yunikorn
+```
+
+默认情况下,helm chart将在集群中安装调度器、web服务器和 admission-controller。
+安装 `admission-controller` 后,它只需将所有流量路由到YuniKorn即可。

Review comment:
       `admission-controller` 一旦安装,它将把所有集群流量路由到 YuniKorn。

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/get_started/core_features.md
##########
@@ -0,0 +1,72 @@
+---
+id: core_features
+title: 特征
+keywords:
+ - 特征
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+YuniKorn的主要特点包括:
+
+## 应用感知调度
+
+YuniKorn的关键区别之一就是它支持应用感知的调度。在默认的K8s调度程序中,它只能根据Pod进行调度,而不能基于用户、应用程序或者队列。
+然而,YuniKorn可以识别用户、应用程序或者队列,并在做出调度决策时,考虑更多的因素,如资源、排序等。
+这使我们能够对资源配额、资源公平性和优先级进行细粒度控制,这是多租户计算系统最重要的需求。
+
+## 层次资源队列
+
+层次队列提供了一种有效的机制来管理集群资源。
+队列的层次结构可以在逻辑上映射到组织结构。这为不同租户提供了对资源的细粒度控制。
+YuniKorn UI 提供了一个集中的视图来监视资源队列的使用情况,它可以帮助您了解不同租户是如何使用资源的。
+此外,通过利用最小/最大队列容量,它可以定义每个租户的弹性资源消耗。
+
+## 作业排序和排队
+
+应用可以在工作队列中正确排队,排序策略决定哪个应用程序可以首先获得资源。
+这个策略可以是多种多样的,例如简单的 `FIFO`、`Fair`、`StateAware`或基于`Priority`的策略。
+队列可以维持应用的顺序,调度器根据不同的策略为作业分配相应的资源。这种行为更容易被理解和控制。
+
+此外,当配置队列最大容量时,作业和任务可以在资源队列中正确排队。
+如果剩余的容量不够,它们可以排队等待,直到释放一些资源。这简化了客户端操作。
+与默认调度程序不同,资源由命名空间资源配额限制,这是由配额许可控制器强制执行的。
+如果下面的命名空间没有足够的配额,Pod就不能被创建。
+客户端需要复杂的逻辑来处理此类场景,例如按条件重试。
+
+## 资源公平性
+
+在多租户环境中,许多用户共享集群资源。
+为了避免租户争夺资源或者可能的资源不足,需要做到更细粒度的公平性需求,以此来实现跨用户以及跨团队/组织的公平性。
+考虑到权重或优先级,一些更重要的应用可以获得超过其配额的更多的需求资源。
+这往往与资源预算有关,更细粒度的公平模式可以进一步提高资源控制。
+
+## 资源预留
+
+YuniKorn会自动为未完成的请求进行资源预订。

Review comment:
       YuniKorn会自动为未完成的请求进行资源预留。

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/get_started/core_features.md
##########
@@ -0,0 +1,72 @@
+---
+id: core_features
+title: 特征
+keywords:
+ - 特征
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+YuniKorn的主要特点包括:
+
+## 应用感知调度
+
+YuniKorn的关键区别之一就是它支持应用感知的调度。在默认的K8s调度程序中,它只能根据Pod进行调度,而不能基于用户、应用程序或者队列。
+然而,YuniKorn可以识别用户、应用程序或者队列,并在做出调度决策时,考虑更多的因素,如资源、排序等。
+这使我们能够对资源配额、资源公平性和优先级进行细粒度控制,这是多租户计算系统最重要的需求。
+
+## 层次资源队列
+
+层次队列提供了一种有效的机制来管理集群资源。
+队列的层次结构可以在逻辑上映射到组织结构。这为不同租户提供了对资源的细粒度控制。
+YuniKorn UI 提供了一个集中的视图来监视资源队列的使用情况,它可以帮助您了解不同租户是如何使用资源的。
+此外,通过利用最小/最大队列容量,它可以定义每个租户的弹性资源消耗。
+
+## 作业排序和排队
+
+应用可以在工作队列中正确排队,排序策略决定哪个应用程序可以首先获得资源。
+这个策略可以是多种多样的,例如简单的 `FIFO`、`Fair`、`StateAware`或基于`Priority`的策略。
+队列可以维持应用的顺序,调度器根据不同的策略为作业分配相应的资源。这种行为更容易被理解和控制。
+
+此外,当配置队列最大容量时,作业和任务可以在资源队列中正确排队。
+如果剩余的容量不够,它们可以排队等待,直到释放一些资源。这简化了客户端操作。
+与默认调度程序不同,资源由命名空间资源配额限制,这是由配额许可控制器强制执行的。
+如果下面的命名空间没有足够的配额,Pod就不能被创建。
+客户端需要复杂的逻辑来处理此类场景,例如按条件重试。
+
+## 资源公平性
+
+在多租户环境中,许多用户共享集群资源。
+为了避免租户争夺资源或者可能的资源不足,需要做到更细粒度的公平性需求,以此来实现跨用户以及跨团队/组织的公平性。
+考虑到权重或优先级,一些更重要的应用可以获得超过其配额的更多的需求资源。
+这往往与资源预算有关,更细粒度的公平模式可以进一步提高资源控制。
+
+## 资源预留
+
+YuniKorn会自动为未完成的请求进行资源预订。
+如果Pod无法分配,YuniKorn将尝试在一个满足条件的节点上保留它,并在这个保留节点上暂时分配pod(在尝试其他节点之前)。
+这种机制可以避免这个Pod被后来提交的更小、更不挑剔的豆荚所挤占。
+此功能在批处理工作负载场景中非常重要,因为当对集群提交大量异构Pod时,很有可能一些Pod会被抛弃,即使它们提交得更早。

Review comment:
       > 如果Pod无法分配,YuniKorn将尝试在一个满足条件的节点上保留它,并在这个保留节点上暂时分配pod(在尝试其他节点之前)。
   这种机制可以避免这个Pod被后来提交的更小、更不挑剔的豆荚所挤占。
   此功能在批处理工作负载场景中非常重要,因为当对集群提交大量异构Pod时,很有可能一些Pod会被抛弃,即使它们提交得更早。
   
   如果 Pod 在一段时间内午无法被分配,YuniKorn将尝试在一个满足条件的节点上为其预留资源,并在这个节点上暂停分配资源给其他的 Pod;同时,YuniKorn 将提升改 Pod 调度的优先级,尽可能尽快把它分配到某个节点 (倾向但不限于预留的节点)。这种机制可以避免这个 Pod 需要的资源被后来提交的更小的、更不挑剔的 Pod 所挤占。此功能在批处理工作负载场景中非常重要,因为当对集群提交大量异构Pod时,很有可能一些Pod会处于“饥饿”状态,即使它们提交得更早。

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/user_guide/placement_rules.md
##########
@@ -0,0 +1,356 @@
+---
+id: placement_rules
+title: 应用放置规则
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+放置规则的基础在 [调度器配置设计文档](design/scheduler_configuration.md#placement-rules-definition) 中有描述。
+一个放置策略可以连接多个规则。
+[访问控制列表](user_guide/acls.md) 和规则过滤器根据规则定义,并根据规则强制执行。
+本文档通过示例说明了如何构建作为调度器一部分的策略,包括规则用法。
+
+## 配置
+规则是作为调度器队列配置的一部分按分区定义的。
+规则的定义顺序就是规则的执行顺序。
+如果某个规则与策略匹配,则该策略将停止执行其余规则。
+
+匹配规则生成一个完全限定的队列名称。
+这意味着返回的名称从 _root_ 队列开始。
+可以生成的队列层次结构中的层级数目没有限制。
+
+当执行规则时,已执行规则的结果是未知的,不会被考虑在内。
+与尚未执行的规则类似:规则不能影响其他规则,除非它们被配置为 [父级](#parent-parameter) 规则。
+
+如果策略不生成队列名称并且没有更多规则,则应用程序将被拒绝。
+
+配置中规则放置定义的基本结构:
+```yaml
+placementrules:
+  - name: <第一个规则名称>
+  - name: <第二个规则名称>
+```
+每个规则都可以在配置中采用一组预定义的参数。
+[规则](#rules) 章节的描述中给出了可以使用的规则名称。
+配置中的规则名称不区分大小写。
+规则名称必须遵循以下命名约定:
+* 以字母开头:a-z 或 A-Z
+* 后跟 0 个或多个字符 a-z、A-Z、0-9 或 _
+
+未知的规则,即名称未映射到下面定义的规则,将导致放置管理器的初始化错误。
+如果参数不正确,规则也可以在初始化期间抛出解析异常或错误。
+有错误的规则集永远不会变为活动状态。
+
+如果放置管理器具有活动规则集,则将其视为已初始化。
+当重新加载配置时,将创建一个新规则集来替换活动规则集。
+如果加载的新规则集包含错误,即被破坏,则放置管理器将忽略新规则集。

Review comment:
       放置管理器 -> 放置策略管理器

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/user_guide/placement_rules.md
##########
@@ -0,0 +1,356 @@
+---
+id: placement_rules
+title: 应用放置规则
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+放置规则的基础在 [调度器配置设计文档](design/scheduler_configuration.md#placement-rules-definition) 中有描述。
+一个放置策略可以连接多个规则。
+[访问控制列表](user_guide/acls.md) 和规则过滤器根据规则定义,并根据规则强制执行。
+本文档通过示例说明了如何构建作为调度器一部分的策略,包括规则用法。
+
+## 配置
+规则是作为调度器队列配置的一部分按分区定义的。
+规则的定义顺序就是规则的执行顺序。
+如果某个规则与策略匹配,则该策略将停止执行其余规则。
+
+匹配规则生成一个完全限定的队列名称。
+这意味着返回的名称从 _root_ 队列开始。
+可以生成的队列层次结构中的层级数目没有限制。
+
+当执行规则时,已执行规则的结果是未知的,不会被考虑在内。
+与尚未执行的规则类似:规则不能影响其他规则,除非它们被配置为 [父级](#parent-parameter) 规则。
+
+如果策略不生成队列名称并且没有更多规则,则应用程序将被拒绝。
+
+配置中规则放置定义的基本结构:
+```yaml
+placementrules:
+  - name: <第一个规则名称>
+  - name: <第二个规则名称>
+```
+每个规则都可以在配置中采用一组预定义的参数。
+[规则](#rules) 章节的描述中给出了可以使用的规则名称。
+配置中的规则名称不区分大小写。
+规则名称必须遵循以下命名约定:
+* 以字母开头:a-z 或 A-Z
+* 后跟 0 个或多个字符 a-z、A-Z、0-9 或 _
+
+未知的规则,即名称未映射到下面定义的规则,将导致放置管理器的初始化错误。
+如果参数不正确,规则也可以在初始化期间抛出解析异常或错误。
+有错误的规则集永远不会变为活动状态。
+
+如果放置管理器具有活动规则集,则将其视为已初始化。
+当重新加载配置时,将创建一个新规则集来替换活动规则集。
+如果加载的新规则集包含错误,即被破坏,则放置管理器将忽略新规则集。
+这意味着放置管理器保持在加载损坏的规则集时的状态。
+如果放置管理器在已经初始化的情况下继续使用现有的活动规则集,它将记录有关损坏和忽略的配置的消息。
+
+规则结果中的 点 "." 字符串会被替换为 "\_dot_" 。
+点被替换的原因是因为它用作完全限定队列名称中的层次结构分隔符。

Review comment:
       点被替换的原因是它在定义资源队列时被用作父队列与子队列中间的分隔符。

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/user_guide/placement_rules.md
##########
@@ -0,0 +1,356 @@
+---
+id: placement_rules
+title: 应用放置规则
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+放置规则的基础在 [调度器配置设计文档](design/scheduler_configuration.md#placement-rules-definition) 中有描述。
+一个放置策略可以连接多个规则。
+[访问控制列表](user_guide/acls.md) 和规则过滤器根据规则定义,并根据规则强制执行。
+本文档通过示例说明了如何构建作为调度器一部分的策略,包括规则用法。
+
+## 配置
+规则是作为调度器队列配置的一部分按分区定义的。
+规则的定义顺序就是规则的执行顺序。
+如果某个规则与策略匹配,则该策略将停止执行其余规则。
+
+匹配规则生成一个完全限定的队列名称。
+这意味着返回的名称从 _root_ 队列开始。
+可以生成的队列层次结构中的层级数目没有限制。
+
+当执行规则时,已执行规则的结果是未知的,不会被考虑在内。
+与尚未执行的规则类似:规则不能影响其他规则,除非它们被配置为 [父级](#parent-parameter) 规则。
+
+如果策略不生成队列名称并且没有更多规则,则应用程序将被拒绝。
+
+配置中规则放置定义的基本结构:
+```yaml
+placementrules:
+  - name: <第一个规则名称>
+  - name: <第二个规则名称>
+```
+每个规则都可以在配置中采用一组预定义的参数。
+[规则](#rules) 章节的描述中给出了可以使用的规则名称。
+配置中的规则名称不区分大小写。
+规则名称必须遵循以下命名约定:
+* 以字母开头:a-z 或 A-Z
+* 后跟 0 个或多个字符 a-z、A-Z、0-9 或 _
+
+未知的规则,即名称未映射到下面定义的规则,将导致放置管理器的初始化错误。
+如果参数不正确,规则也可以在初始化期间抛出解析异常或错误。
+有错误的规则集永远不会变为活动状态。
+
+如果放置管理器具有活动规则集,则将其视为已初始化。

Review comment:
       放置管理器 -> 放置策略管理器
   
   

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/get_started/get_started.md
##########
@@ -0,0 +1,71 @@
+---
+id: user_guide
+title: 开始
+slug: /
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+在阅读本指南之前,我们假设您有一个Kubernetes集群或本地Kubernetes开发环境,例如MiniKube。
+还假定 `kubectl` 在您的环境路径内,并且配置正确。
+遵循此 [指南](../developer_guide/env_setup.md) 来讲述如何使用 docker-desktop 设置本地Kubernetes集群。
+
+## 安装
+
+最简单的方法是使用我们的Helm Charts在现有的Kubernetes集群上部署YuniKorn。
+我们建议使用Helm 3或更高版本。
+
+```shell script
+helm repo add yunikorn  https://apache.github.io/incubator-yunikorn-release
+helm repo update
+kubectl create namespace yunikorn
+helm install yunikorn yunikorn/yunikorn --namespace yunikorn
+```
+
+默认情况下,helm chart将在集群中安装调度器、web服务器和 admission-controller。
+安装 `admission-controller` 后,它只需将所有流量路由到YuniKorn即可。
+这意味着资源调度会委托给YuniKorn。在helm安装过程中,可以通过将 `embedAdmissionController` 标志设置为false来禁用它。
+
+如果你不想使用helm的charts,您可以找到我们的细节教程 [点击这里](../developer_guide/deployment.md) 。
+
+## 卸载
+
+运行如下的命令卸载YuniKorn:
+
+```shell script
+helm uninstall yunikorn --namespace yunikorn
+```
+
+## 访问 Web UI
+
+部署调度器时,web UI也部署在容器中。
+标准端口上web界面的端口转发可以通过以下方式打开:
+
+```shell script
+kubectl port-forward svc/yunikorn-service 9889:9889 -n yunikorn
+kubectl port-forward svc/yunikorn-service 9080:9080 -n yunikorn
+```
+
+`9889` 是 Web UI 的默认端口, `9080` 是调度器 Restful 服务的默认端口,web UI 会从中检索信息。
+完成此操作后,web UI将在以下地址可用: http://localhost:9889 。

Review comment:
       `9889` 是 Web UI 的默认端口 。 完成此操作后,web UI将在以下地址可用: http://localhost:9889 。

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/user_guide/placement_rules.md
##########
@@ -0,0 +1,356 @@
+---
+id: placement_rules
+title: 应用放置规则
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+放置规则的基础在 [调度器配置设计文档](design/scheduler_configuration.md#placement-rules-definition) 中有描述。
+一个放置策略可以连接多个规则。
+[访问控制列表](user_guide/acls.md) 和规则过滤器根据规则定义,并根据规则强制执行。
+本文档通过示例说明了如何构建作为调度器一部分的策略,包括规则用法。
+
+## 配置
+规则是作为调度器队列配置的一部分按分区定义的。
+规则的定义顺序就是规则的执行顺序。
+如果某个规则与策略匹配,则该策略将停止执行其余规则。
+
+匹配规则生成一个完全限定的队列名称。
+这意味着返回的名称从 _root_ 队列开始。
+可以生成的队列层次结构中的层级数目没有限制。
+
+当执行规则时,已执行规则的结果是未知的,不会被考虑在内。
+与尚未执行的规则类似:规则不能影响其他规则,除非它们被配置为 [父级](#parent-parameter) 规则。
+
+如果策略不生成队列名称并且没有更多规则,则应用程序将被拒绝。
+
+配置中规则放置定义的基本结构:
+```yaml
+placementrules:
+  - name: <第一个规则名称>
+  - name: <第二个规则名称>
+```
+每个规则都可以在配置中采用一组预定义的参数。
+[规则](#rules) 章节的描述中给出了可以使用的规则名称。
+配置中的规则名称不区分大小写。
+规则名称必须遵循以下命名约定:
+* 以字母开头:a-z 或 A-Z
+* 后跟 0 个或多个字符 a-z、A-Z、0-9 或 _
+
+未知的规则,即名称未映射到下面定义的规则,将导致放置管理器的初始化错误。
+如果参数不正确,规则也可以在初始化期间抛出解析异常或错误。
+有错误的规则集永远不会变为活动状态。
+
+如果放置管理器具有活动规则集,则将其视为已初始化。
+当重新加载配置时,将创建一个新规则集来替换活动规则集。
+如果加载的新规则集包含错误,即被破坏,则放置管理器将忽略新规则集。
+这意味着放置管理器保持在加载损坏的规则集时的状态。
+如果放置管理器在已经初始化的情况下继续使用现有的活动规则集,它将记录有关损坏和忽略的配置的消息。
+
+规则结果中的 点 "." 字符串会被替换为 "\_dot_" 。
+点被替换的原因是因为它用作完全限定队列名称中的层次结构分隔符。
+替换点发生在构建完整队列层次结构并且结果合格之前。
+这意味着我们允许用户名和/或标签值包含点,而这些点不会影响队列层次结构。
+例如,对于配置中必须用点映射到用户名的队列,您必须按如下方式指定它们:
+具有用户 `user.name` 的用户规则将生成队列名称 `root.user_dot_name` 作为输出。
+如果必须将该“用户队列”添加到配置中,则应使用 `user_dot_name` 名称。
+
+### creat 参数
+create 参数是一个布尔标志,它定义如果由规则生成的队列不存在时是否可以创建它。
+我们无法保证队列是否能创建,因为现有队列可能会阻止创建队列。
+如果规则生成的队列不存在且标志未设置为 _true_ ,则规则的结果将失败。
+
+带有 `create` 标志的规则的基本 yaml 配置:
+```yaml
+placementrules:
+  - name: <规则名称>
+    create: true
+```
+
+默认值为 _false_ 。
+允许值:_true_ 或 _false_,任何其他值都会导致解析错误。
+
+### parent 参数
+parent 参数允许指定为当前规则生成父队列的规则。
+父规则可以嵌套,一个父规则 _可以_ 包含另一个父规则。
+可以嵌套的父规则没有强制限制。
+
+父规则被视为在列表顶层指定的规则,因此与放置定义中的任何其他规则具有相同的参数和要求。
+例外情况是,在已生成完全限定队列的规则上使用父规则被视为配置错误。
+此错误只会出现在 [fixed](#fixed-rule) 类型的规则上,有关详细信息,请参阅规则规范。
+
+注意:规则的执行会向下遍历父规则列表,并首先执行列表中的最后一个。
+这意味着最后一个父规则将在根的正下方生成队列。
+有关详细信息,请参阅示例。
+
+具有 `parent` 规则的规则的基本 yaml 配置:
+```yaml
+placementrules:
+  - name: <规则名称>
+    parent:
+      name: <父规则名称>
+```
+
+parent 的默认值为 _no_ 。
+
+### filter 参数
+规则上的 filter 允许过滤该规则适用的用户。
+filter 是一个复杂的配置对象。
+
+可配置的 _用户_ 和 _组_ 可以是以下两种类型之一:
+* 一个正则表达式
+* 用户或组的列表。
+
+如果用户或组的条目在 yaml 中超过1条,则始终将其视为用户或组的列表。
+列表中的重复条目将被忽略并且不会导致错误。
+不允许在其他列表元素以外指定正则表达式。
+
+用户和组名遵循标准的 linux 用户和组约定。
+对于用户名:
+* 以字母开头:a-z 或 A-Z
+* 后跟0个或多个字符 a-z、A-Z、0-9 或 _ . @ -
+* 最后一个字符也可以是 $
+
+对于组名:
+* 以字母开头:a-z 或 A-Z
+* 后跟0个或多个字符 a-z、A-Z、0-9 或 _ -
+
+如果列表恰好是一条,则它可以是单个用户或组,也可以是正则表达式。
+当条目包含用户名或组名中不允许的字符时,该条目被视为正则表达式。
+正则表达式必须按照指定的方式编译。
+不编译的正则表达式将被忽略。
+
+特别是对于组的正则表达式:匹配一次执行一个组,而不是针对组列表。
+
+基本的 `filter` yaml 配置:
+```yaml
+filter:
+  type: deny
+  users:
+    - <用户名称或正则表达式>
+    - <用户名称>
+  groups:
+    - <组名称或正则表达式>
+    - <组名称>
+```
+
+filter 的默认值为 _no_ 。
+
+### value 参数
+这是一个通用值,可用于传递给规则以实现或更改其行为。
+value 被 [fixed](#fixed-rule) 和 [tag](#tag-rule) 规则使用。
+value 是字符串形式的单个值,不会被系统解释或操作。
+
+设置了 `value` 的规则的基本 yaml 配置:
+```yaml
+placementrules:
+  - name: <规则名称>
+    value: "任意string"
+```
+
+值的默认值为 _no_ 。
+
+## 访问控制列表
+访问控制列表不在规则中定义,但它们会影响放置策略的结果。
+可以在队列上定义两个访问控制列表:
+1.提交 ACL:_submitacl_
+1.管理 ACL:_adminacl_
+
+只有当队列允许通过任一 ACL 进行提交访问时,放置规则才会匹配。
+管理队列 ACL 还提供 _提交_ 访问。
+如果队列不存在或没有设置 ACL,则检查父队列的 ACL。
+重复此递归检查,直到 ACL 提供访问权限或在检查根队列的 ACL 之后。
+
+有关 ACL 语法的更多详细信息,请查看 [ACL 文档](user_guide/acls.md)。
+
+## 规则
+### Provided 规则
+配置中使用的名称:*provided*
+
+返回在提交应用程序期间提供的队列。
+如果队列不是完全限定的,则此规则的行为是完全限定应用程序提供的队列。
+如果设置了父规则,并且应用程序提交中提供的队列完全合格,则不会执行父规则。

Review comment:
       原文可能有点问题。
   这里想表达的意思是:如果所指定的队列名为全域名 ( 例如 root.a.b.c),那么该应用会被提交到该全域名所指向的队列并忽略其他规则;如果所指定的队列名为非全域名,该规则的父规则将得以执行以此来决定全域名。

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/user_guide/queue_config.md
##########
@@ -0,0 +1,349 @@
+---
+id: queue_config
+title: 分区和队列配置
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+队列配置的基础在 [配置设计文档](design/scheduler_configuration.md) 中给出。
+
+本文档提供了通用队列配置。
+它引用了 [访问控制列表](user_guide/acls.md) 和 [放置规则](user_guide/placement_rules.md) 文档。

Review comment:
       本文档提供了通用队列配置的相关信息。请同时参考 [访问控制列表](user_guide/acls.md) 和 [放置规则](user_guide/placement_rules.md) 文档。

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/user_guide/queue_config.md
##########
@@ -0,0 +1,349 @@
+---
+id: queue_config
+title: 分区和队列配置
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+队列配置的基础在 [配置设计文档](design/scheduler_configuration.md) 中给出。

Review comment:
       队列配置的基本信息在 [配置设计文档](design/scheduler_configuration.md)  中有描述。

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/user_guide/queue_config.md
##########
@@ -0,0 +1,349 @@
+---
+id: queue_config
+title: 分区和队列配置
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+队列配置的基础在 [配置设计文档](design/scheduler_configuration.md) 中给出。
+
+本文档提供了通用队列配置。
+它引用了 [访问控制列表](user_guide/acls.md) 和 [放置规则](user_guide/placement_rules.md) 文档。
+
+本文档通过示例说明了如何为调度器创建分区和队列配置。
+
+作为应用程序提交的一部分,调度器依赖于 shim 来可靠地提供用户信息。
+当前 shim 使用 [用户和组解析](usergroup_resolution) 中提供的方法识别用户和用户所属的组。
+
+## 配置
+这里描述的调度器的配置文件只提供了分区和队列的配置。
+
+默认情况下,我们在部署中使用名为 `queues.yaml` 的文件。
+可以通过调度器的命令行标志 `policyGroup` 更改文件名。
+更改文件名后必须在 deployment 详细信息中进行相应的更改,无论是 `configmap` 还是包含在 docker 容器中的文件。
+
+配置的示例文件位于调度器核心内 [queues.yaml](https://github.com/apache/incubator-yunikorn-core/blob/master/config/queues.yaml)。
+
+## 分区
+分区是调度器配置的顶层。
+配置中可以定义多个分区。
+
+配置中分区定义的基本结构:
+```yaml
+partitions:
+  - name: <name of the 1st partition>
+  - name: <name of the 2nd partition>
+```
+分区的默认名称是 `default`。
+分区定义包含特定 shim 的调度程器的完整配置。
+每个 shim 使用自己唯一的分区。
+
+分区必须至少定义以下键:
+* 名称
+* [队列](#queues)
+
+队列配置释义如下。
+
+可以选择为分区定义以下键:
+* [布置规则](#placement-rules)
+* [限制](#limits)
+* 节点排序策略
+* 抢占
+
+布置规则和限制在它们自己的章节中进行了详解
+
+`nodesortpolicy` 定义了节点为分区排序的方式。
+可以使用的值的详细信息在 [排序策略](sorting_policies.md#node-sorting) 文档中可以参考。
+
+抢占键目前只能有一个子键:_enabled_ 。
+这个布尔值定义了整个分区的抢占行为。
+
+_enabled_ 的默认值为 _false_ 。
+允许值:_true_ 或 _false_ ,任何其他值都会导致解析错误。
+
+设置了 _preemption_ 标志和 `nodesortpolicy` 为 _fair_ 的示例 `partition` yaml 描述:
+```yaml
+partitions:
+  - name: <分区名称>
+    nodesortpolicy: fair
+    preemption:
+      enabled: true
+```
+注意:
+目前,Kubernetes 唯一的 shim 不支持除 `default` 分区之外的任何其他分区。
+这已为 shim 在 [jira](https://issues.apache.org/jira/browse/YUNIKORN-22) 上进行了记录。

Review comment:
       > 目前,Kubernetes 唯一的 shim 不支持除 `default` 分区之外的任何其他分区。
   这已为 shim 在 [jira](https://issues.apache.org/jira/browse/YUNIKORN-22) 上进行了记录
   
   目前,YuniKorn在Kubernetes上不支持除 `default` 分区之外的任何其他分区。详情请见: [YUNIKORN-22](https://issues.apache.org/jira/browse/YUNIKORN-22) 

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/user_guide/placement_rules.md
##########
@@ -0,0 +1,356 @@
+---
+id: placement_rules
+title: 应用放置规则
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+放置规则的基础在 [调度器配置设计文档](design/scheduler_configuration.md#placement-rules-definition) 中有描述。
+一个放置策略可以连接多个规则。
+[访问控制列表](user_guide/acls.md) 和规则过滤器根据规则定义,并根据规则强制执行。
+本文档通过示例说明了如何构建作为调度器一部分的策略,包括规则用法。
+
+## 配置
+规则是作为调度器队列配置的一部分按分区定义的。
+规则的定义顺序就是规则的执行顺序。
+如果某个规则与策略匹配,则该策略将停止执行其余规则。
+
+匹配规则生成一个完全限定的队列名称。
+这意味着返回的名称从 _root_ 队列开始。
+可以生成的队列层次结构中的层级数目没有限制。
+
+当执行规则时,已执行规则的结果是未知的,不会被考虑在内。
+与尚未执行的规则类似:规则不能影响其他规则,除非它们被配置为 [父级](#parent-parameter) 规则。
+
+如果策略不生成队列名称并且没有更多规则,则应用程序将被拒绝。
+
+配置中规则放置定义的基本结构:
+```yaml
+placementrules:
+  - name: <第一个规则名称>
+  - name: <第二个规则名称>
+```
+每个规则都可以在配置中采用一组预定义的参数。
+[规则](#rules) 章节的描述中给出了可以使用的规则名称。
+配置中的规则名称不区分大小写。
+规则名称必须遵循以下命名约定:
+* 以字母开头:a-z 或 A-Z
+* 后跟 0 个或多个字符 a-z、A-Z、0-9 或 _
+
+未知的规则,即名称未映射到下面定义的规则,将导致放置管理器的初始化错误。
+如果参数不正确,规则也可以在初始化期间抛出解析异常或错误。
+有错误的规则集永远不会变为活动状态。
+
+如果放置管理器具有活动规则集,则将其视为已初始化。
+当重新加载配置时,将创建一个新规则集来替换活动规则集。
+如果加载的新规则集包含错误,即被破坏,则放置管理器将忽略新规则集。
+这意味着放置管理器保持在加载损坏的规则集时的状态。
+如果放置管理器在已经初始化的情况下继续使用现有的活动规则集,它将记录有关损坏和忽略的配置的消息。
+
+规则结果中的 点 "." 字符串会被替换为 "\_dot_" 。
+点被替换的原因是因为它用作完全限定队列名称中的层次结构分隔符。
+替换点发生在构建完整队列层次结构并且结果合格之前。
+这意味着我们允许用户名和/或标签值包含点,而这些点不会影响队列层次结构。
+例如,对于配置中必须用点映射到用户名的队列,您必须按如下方式指定它们:
+具有用户 `user.name` 的用户规则将生成队列名称 `root.user_dot_name` 作为输出。
+如果必须将该“用户队列”添加到配置中,则应使用 `user_dot_name` 名称。
+
+### creat 参数
+create 参数是一个布尔标志,它定义如果由规则生成的队列不存在时是否可以创建它。
+我们无法保证队列是否能创建,因为现有队列可能会阻止创建队列。
+如果规则生成的队列不存在且标志未设置为 _true_ ,则规则的结果将失败。
+
+带有 `create` 标志的规则的基本 yaml 配置:
+```yaml
+placementrules:
+  - name: <规则名称>
+    create: true
+```
+
+默认值为 _false_ 。
+允许值:_true_ 或 _false_,任何其他值都会导致解析错误。
+
+### parent 参数
+parent 参数允许指定为当前规则生成父队列的规则。
+父规则可以嵌套,一个父规则 _可以_ 包含另一个父规则。
+可以嵌套的父规则没有强制限制。
+
+父规则被视为在列表顶层指定的规则,因此与放置定义中的任何其他规则具有相同的参数和要求。
+例外情况是,在已生成完全限定队列的规则上使用父规则被视为配置错误。
+此错误只会出现在 [fixed](#fixed-rule) 类型的规则上,有关详细信息,请参阅规则规范。
+
+注意:规则的执行会向下遍历父规则列表,并首先执行列表中的最后一个。
+这意味着最后一个父规则将在根的正下方生成队列。
+有关详细信息,请参阅示例。
+
+具有 `parent` 规则的规则的基本 yaml 配置:
+```yaml
+placementrules:
+  - name: <规则名称>
+    parent:
+      name: <父规则名称>
+```
+
+parent 的默认值为 _no_ 。
+
+### filter 参数
+规则上的 filter 允许过滤该规则适用的用户。
+filter 是一个复杂的配置对象。
+
+可配置的 _用户_ 和 _组_ 可以是以下两种类型之一:
+* 一个正则表达式
+* 用户或组的列表。
+
+如果用户或组的条目在 yaml 中超过1条,则始终将其视为用户或组的列表。
+列表中的重复条目将被忽略并且不会导致错误。
+不允许在其他列表元素以外指定正则表达式。
+
+用户和组名遵循标准的 linux 用户和组约定。
+对于用户名:
+* 以字母开头:a-z 或 A-Z
+* 后跟0个或多个字符 a-z、A-Z、0-9 或 _ . @ -
+* 最后一个字符也可以是 $
+
+对于组名:
+* 以字母开头:a-z 或 A-Z
+* 后跟0个或多个字符 a-z、A-Z、0-9 或 _ -
+
+如果列表恰好是一条,则它可以是单个用户或组,也可以是正则表达式。
+当条目包含用户名或组名中不允许的字符时,该条目被视为正则表达式。
+正则表达式必须按照指定的方式编译。
+不编译的正则表达式将被忽略。
+
+特别是对于组的正则表达式:匹配一次执行一个组,而不是针对组列表。
+
+基本的 `filter` yaml 配置:
+```yaml
+filter:
+  type: deny
+  users:
+    - <用户名称或正则表达式>
+    - <用户名称>
+  groups:
+    - <组名称或正则表达式>
+    - <组名称>
+```
+
+filter 的默认值为 _no_ 。
+
+### value 参数
+这是一个通用值,可用于传递给规则以实现或更改其行为。
+value 被 [fixed](#fixed-rule) 和 [tag](#tag-rule) 规则使用。
+value 是字符串形式的单个值,不会被系统解释或操作。
+
+设置了 `value` 的规则的基本 yaml 配置:
+```yaml
+placementrules:
+  - name: <规则名称>
+    value: "任意string"
+```
+
+值的默认值为 _no_ 。
+
+## 访问控制列表
+访问控制列表不在规则中定义,但它们会影响放置策略的结果。
+可以在队列上定义两个访问控制列表:
+1.提交 ACL:_submitacl_
+1.管理 ACL:_adminacl_
+
+只有当队列允许通过任一 ACL 进行提交访问时,放置规则才会匹配。
+管理队列 ACL 还提供 _提交_ 访问。
+如果队列不存在或没有设置 ACL,则检查父队列的 ACL。
+重复此递归检查,直到 ACL 提供访问权限或在检查根队列的 ACL 之后。
+
+有关 ACL 语法的更多详细信息,请查看 [ACL 文档](user_guide/acls.md)。
+
+## 规则
+### Provided 规则
+配置中使用的名称:*provided*
+
+返回在提交应用程序期间提供的队列。
+如果队列不是完全限定的,则此规则的行为是完全限定应用程序提供的队列。
+如果设置了父规则,并且应用程序提交中提供的队列完全合格,则不会执行父规则。
+
+支持的参数:
+* create
+* parent
+* filter
+
+示例:如果用户名称不存在,则创建由用户传递的队列

Review comment:
       > 示例:如果用户名称不存在,则创建由用户传递的队列
   
   示例:如果用户指定的队列不存在与给定的用户名的父队列下,则创建它

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/user_guide/queue_config.md
##########
@@ -0,0 +1,349 @@
+---
+id: queue_config
+title: 分区和队列配置
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+队列配置的基础在 [配置设计文档](design/scheduler_configuration.md) 中给出。
+
+本文档提供了通用队列配置。
+它引用了 [访问控制列表](user_guide/acls.md) 和 [放置规则](user_guide/placement_rules.md) 文档。
+
+本文档通过示例说明了如何为调度器创建分区和队列配置。
+
+作为应用程序提交的一部分,调度器依赖于 shim 来可靠地提供用户信息。
+当前 shim 使用 [用户和组解析](usergroup_resolution) 中提供的方法识别用户和用户所属的组。
+
+## 配置
+这里描述的调度器的配置文件只提供了分区和队列的配置。
+
+默认情况下,我们在部署中使用名为 `queues.yaml` 的文件。
+可以通过调度器的命令行标志 `policyGroup` 更改文件名。
+更改文件名后必须在 deployment 详细信息中进行相应的更改,无论是 `configmap` 还是包含在 docker 容器中的文件。
+
+配置的示例文件位于调度器核心内 [queues.yaml](https://github.com/apache/incubator-yunikorn-core/blob/master/config/queues.yaml)。
+
+## 分区
+分区是调度器配置的顶层。
+配置中可以定义多个分区。
+
+配置中分区定义的基本结构:
+```yaml
+partitions:
+  - name: <name of the 1st partition>
+  - name: <name of the 2nd partition>
+```
+分区的默认名称是 `default`。
+分区定义包含特定 shim 的调度程器的完整配置。
+每个 shim 使用自己唯一的分区。
+
+分区必须至少定义以下键:
+* 名称
+* [队列](#queues)
+
+队列配置释义如下。
+
+可以选择为分区定义以下键:
+* [布置规则](#placement-rules)
+* [限制](#limits)
+* 节点排序策略
+* 抢占
+
+布置规则和限制在它们自己的章节中进行了详解
+
+`nodesortpolicy` 定义了节点为分区排序的方式。
+可以使用的值的详细信息在 [排序策略](sorting_policies.md#node-sorting) 文档中可以参考。
+
+抢占键目前只能有一个子键:_enabled_ 。
+这个布尔值定义了整个分区的抢占行为。
+
+_enabled_ 的默认值为 _false_ 。
+允许值:_true_ 或 _false_ ,任何其他值都会导致解析错误。
+
+设置了 _preemption_ 标志和 `nodesortpolicy` 为 _fair_ 的示例 `partition` yaml 描述:
+```yaml
+partitions:
+  - name: <分区名称>
+    nodesortpolicy: fair
+    preemption:
+      enabled: true
+```
+注意:
+目前,Kubernetes 唯一的 shim 不支持除 `default` 分区之外的任何其他分区。
+这已为 shim 在 [jira](https://issues.apache.org/jira/browse/YUNIKORN-22) 上进行了记录。
+
+### 队列
+
+YuniKorn 通过利用资源队列来管理资源。资源队列具有以下特征:
+- 队列可以有 **等级制的** 结构
+- 每个队列都可以预设 **最小/最大容量** ,其中最小容量定义了保障资源,最大容量定义了资源限制(又名资源配额)
+- 任务必须在某个子队列下运行
+- 队列可以是 **静态的**(从配置文件加载)或 **动态的**(由 YuniKorn 内部管理)
+- 队列级别 **资源公平** 由调度器强制执行
+- 作业只能在特定队列下运行

Review comment:
       a job can only run under a specific queue
   
   这句话想表达是
   
   一个作业只能运行在某一个特定的队列,即一个作业无法垮队列运行。

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/user_guide/queue_config.md
##########
@@ -0,0 +1,349 @@
+---
+id: queue_config
+title: 分区和队列配置
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+队列配置的基础在 [配置设计文档](design/scheduler_configuration.md) 中给出。
+
+本文档提供了通用队列配置。
+它引用了 [访问控制列表](user_guide/acls.md) 和 [放置规则](user_guide/placement_rules.md) 文档。
+
+本文档通过示例说明了如何为调度器创建分区和队列配置。
+
+作为应用程序提交的一部分,调度器依赖于 shim 来可靠地提供用户信息。
+当前 shim 使用 [用户和组解析](usergroup_resolution) 中提供的方法识别用户和用户所属的组。
+
+## 配置
+这里描述的调度器的配置文件只提供了分区和队列的配置。
+
+默认情况下,我们在部署中使用名为 `queues.yaml` 的文件。
+可以通过调度器的命令行标志 `policyGroup` 更改文件名。
+更改文件名后必须在 deployment 详细信息中进行相应的更改,无论是 `configmap` 还是包含在 docker 容器中的文件。
+
+配置的示例文件位于调度器核心内 [queues.yaml](https://github.com/apache/incubator-yunikorn-core/blob/master/config/queues.yaml)。
+
+## 分区
+分区是调度器配置的顶层。
+配置中可以定义多个分区。
+
+配置中分区定义的基本结构:
+```yaml
+partitions:
+  - name: <name of the 1st partition>
+  - name: <name of the 2nd partition>
+```
+分区的默认名称是 `default`。
+分区定义包含特定 shim 的调度程器的完整配置。
+每个 shim 使用自己唯一的分区。
+
+分区必须至少定义以下键:
+* 名称
+* [队列](#queues)
+
+队列配置释义如下。
+
+可以选择为分区定义以下键:
+* [布置规则](#placement-rules)
+* [限制](#limits)
+* 节点排序策略
+* 抢占
+
+布置规则和限制在它们自己的章节中进行了详解
+
+`nodesortpolicy` 定义了节点为分区排序的方式。
+可以使用的值的详细信息在 [排序策略](sorting_policies.md#node-sorting) 文档中可以参考。
+
+抢占键目前只能有一个子键:_enabled_ 。
+这个布尔值定义了整个分区的抢占行为。
+
+_enabled_ 的默认值为 _false_ 。
+允许值:_true_ 或 _false_ ,任何其他值都会导致解析错误。
+
+设置了 _preemption_ 标志和 `nodesortpolicy` 为 _fair_ 的示例 `partition` yaml 描述:
+```yaml
+partitions:
+  - name: <分区名称>
+    nodesortpolicy: fair
+    preemption:
+      enabled: true
+```
+注意:
+目前,Kubernetes 唯一的 shim 不支持除 `default` 分区之外的任何其他分区。
+这已为 shim 在 [jira](https://issues.apache.org/jira/browse/YUNIKORN-22) 上进行了记录。
+
+### 队列
+
+YuniKorn 通过利用资源队列来管理资源。资源队列具有以下特征:
+- 队列可以有 **等级制的** 结构
+- 每个队列都可以预设 **最小/最大容量** ,其中最小容量定义了保障资源,最大容量定义了资源限制(又名资源配额)
+- 任务必须在某个子队列下运行

Review comment:
        leaf queue 应该翻译为  叶子队列 (即没有子队列的队列)

##########
File path: i18n/zh-cn/docusaurus-plugin-content-pages/community/events.md
##########
@@ -0,0 +1,61 @@
+---
+id: events
+title: 事件
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+即将举行的会议
+---
+
+加入我们 **4:30pm - 6:00pm,太平洋标准时间,2021 年 11 月 18 日**
+
+**Wilfred Spiegelenburg** 将向我们介绍 YuniKorn 社区的最新状态。不要错过!将此事件添加到您的日历:[:calendar:](https://calendar.google.com/event?action=TEMPLATE&tmeid=NHE2a2Vvc3FucDRhbDhmamowNGllcmRka24gYXBhY2hlLnl1bmlrb3JuQG0&tmsrc=apache.yunikorn%40gmail.com)
+
+_Abstract_: Apache YuniKorn (Incubating) 今年早些时候发布了 v0.11 版本,其中包含了许多新功能和改进,比如 Gang 调度、REST API 增强和 Kubernetes 1.19 支持。
+在一个月内,我们计划发布主要的 v1.0.0 版本,它将支持 Kubernetes 1.20 和 1.21、改进的节点排序以及大量的小修复和增强功能!
+在本次会议中,我们将深入探讨在 Kubernetes 上使用临时占位 pod 背后的帮派调度实现、通过简化的调度器核心代码和新的节点排序算法显著提高性能。

Review comment:
       感觉gang scheduling翻译成帮派调度有点奇怪
   要不然这个就不要翻译,直接gang scheduling以避免误导用户

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/user_guide/placement_rules.md
##########
@@ -0,0 +1,356 @@
+---
+id: placement_rules
+title: 应用放置规则
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+放置规则的基础在 [调度器配置设计文档](design/scheduler_configuration.md#placement-rules-definition) 中有描述。
+一个放置策略可以连接多个规则。
+[访问控制列表](user_guide/acls.md) 和规则过滤器根据规则定义,并根据规则强制执行。
+本文档通过示例说明了如何构建作为调度器一部分的策略,包括规则用法。
+
+## 配置
+规则是作为调度器队列配置的一部分按分区定义的。
+规则的定义顺序就是规则的执行顺序。
+如果某个规则与策略匹配,则该策略将停止执行其余规则。
+
+匹配规则生成一个完全限定的队列名称。
+这意味着返回的名称从 _root_ 队列开始。
+可以生成的队列层次结构中的层级数目没有限制。
+
+当执行规则时,已执行规则的结果是未知的,不会被考虑在内。
+与尚未执行的规则类似:规则不能影响其他规则,除非它们被配置为 [父级](#parent-parameter) 规则。
+
+如果策略不生成队列名称并且没有更多规则,则应用程序将被拒绝。
+
+配置中规则放置定义的基本结构:
+```yaml
+placementrules:
+  - name: <第一个规则名称>
+  - name: <第二个规则名称>
+```
+每个规则都可以在配置中采用一组预定义的参数。
+[规则](#rules) 章节的描述中给出了可以使用的规则名称。
+配置中的规则名称不区分大小写。
+规则名称必须遵循以下命名约定:
+* 以字母开头:a-z 或 A-Z
+* 后跟 0 个或多个字符 a-z、A-Z、0-9 或 _
+
+未知的规则,即名称未映射到下面定义的规则,将导致放置管理器的初始化错误。
+如果参数不正确,规则也可以在初始化期间抛出解析异常或错误。
+有错误的规则集永远不会变为活动状态。
+
+如果放置管理器具有活动规则集,则将其视为已初始化。
+当重新加载配置时,将创建一个新规则集来替换活动规则集。
+如果加载的新规则集包含错误,即被破坏,则放置管理器将忽略新规则集。
+这意味着放置管理器保持在加载损坏的规则集时的状态。
+如果放置管理器在已经初始化的情况下继续使用现有的活动规则集,它将记录有关损坏和忽略的配置的消息。
+
+规则结果中的 点 "." 字符串会被替换为 "\_dot_" 。
+点被替换的原因是因为它用作完全限定队列名称中的层次结构分隔符。
+替换点发生在构建完整队列层次结构并且结果合格之前。
+这意味着我们允许用户名和/或标签值包含点,而这些点不会影响队列层次结构。
+例如,对于配置中必须用点映射到用户名的队列,您必须按如下方式指定它们:
+具有用户 `user.name` 的用户规则将生成队列名称 `root.user_dot_name` 作为输出。
+如果必须将该“用户队列”添加到配置中,则应使用 `user_dot_name` 名称。
+
+### creat 参数
+create 参数是一个布尔标志,它定义如果由规则生成的队列不存在时是否可以创建它。
+我们无法保证队列是否能创建,因为现有队列可能会阻止创建队列。
+如果规则生成的队列不存在且标志未设置为 _true_ ,则规则的结果将失败。
+
+带有 `create` 标志的规则的基本 yaml 配置:
+```yaml
+placementrules:
+  - name: <规则名称>
+    create: true
+```
+
+默认值为 _false_ 。
+允许值:_true_ 或 _false_,任何其他值都会导致解析错误。
+
+### parent 参数
+parent 参数允许指定为当前规则生成父队列的规则。
+父规则可以嵌套,一个父规则 _可以_ 包含另一个父规则。
+可以嵌套的父规则没有强制限制。
+
+父规则被视为在列表顶层指定的规则,因此与放置定义中的任何其他规则具有相同的参数和要求。
+例外情况是,在已生成完全限定队列的规则上使用父规则被视为配置错误。
+此错误只会出现在 [fixed](#fixed-rule) 类型的规则上,有关详细信息,请参阅规则规范。
+
+注意:规则的执行会向下遍历父规则列表,并首先执行列表中的最后一个。
+这意味着最后一个父规则将在根的正下方生成队列。
+有关详细信息,请参阅示例。
+
+具有 `parent` 规则的规则的基本 yaml 配置:
+```yaml
+placementrules:
+  - name: <规则名称>
+    parent:
+      name: <父规则名称>
+```
+
+parent 的默认值为 _no_ 。
+
+### filter 参数
+规则上的 filter 允许过滤该规则适用的用户。
+filter 是一个复杂的配置对象。
+
+可配置的 _用户_ 和 _组_ 可以是以下两种类型之一:
+* 一个正则表达式
+* 用户或组的列表。
+
+如果用户或组的条目在 yaml 中超过1条,则始终将其视为用户或组的列表。
+列表中的重复条目将被忽略并且不会导致错误。
+不允许在其他列表元素以外指定正则表达式。
+
+用户和组名遵循标准的 linux 用户和组约定。
+对于用户名:
+* 以字母开头:a-z 或 A-Z
+* 后跟0个或多个字符 a-z、A-Z、0-9 或 _ . @ -
+* 最后一个字符也可以是 $
+
+对于组名:
+* 以字母开头:a-z 或 A-Z
+* 后跟0个或多个字符 a-z、A-Z、0-9 或 _ -
+
+如果列表恰好是一条,则它可以是单个用户或组,也可以是正则表达式。
+当条目包含用户名或组名中不允许的字符时,该条目被视为正则表达式。
+正则表达式必须按照指定的方式编译。
+不编译的正则表达式将被忽略。
+
+特别是对于组的正则表达式:匹配一次执行一个组,而不是针对组列表。
+
+基本的 `filter` yaml 配置:
+```yaml
+filter:
+  type: deny
+  users:
+    - <用户名称或正则表达式>
+    - <用户名称>
+  groups:
+    - <组名称或正则表达式>
+    - <组名称>
+```
+
+filter 的默认值为 _no_ 。
+
+### value 参数
+这是一个通用值,可用于传递给规则以实现或更改其行为。
+value 被 [fixed](#fixed-rule) 和 [tag](#tag-rule) 规则使用。
+value 是字符串形式的单个值,不会被系统解释或操作。
+
+设置了 `value` 的规则的基本 yaml 配置:
+```yaml
+placementrules:
+  - name: <规则名称>
+    value: "任意string"
+```
+
+值的默认值为 _no_ 。
+
+## 访问控制列表
+访问控制列表不在规则中定义,但它们会影响放置策略的结果。
+可以在队列上定义两个访问控制列表:
+1.提交 ACL:_submitacl_
+1.管理 ACL:_adminacl_
+
+只有当队列允许通过任一 ACL 进行提交访问时,放置规则才会匹配。
+管理队列 ACL 还提供 _提交_ 访问。
+如果队列不存在或没有设置 ACL,则检查父队列的 ACL。
+重复此递归检查,直到 ACL 提供访问权限或在检查根队列的 ACL 之后。
+
+有关 ACL 语法的更多详细信息,请查看 [ACL 文档](user_guide/acls.md)。
+
+## 规则
+### Provided 规则
+配置中使用的名称:*provided*
+
+返回在提交应用程序期间提供的队列。
+如果队列不是完全限定的,则此规则的行为是完全限定应用程序提供的队列。
+如果设置了父规则,并且应用程序提交中提供的队列完全合格,则不会执行父规则。
+
+支持的参数:
+* create
+* parent
+* filter
+
+示例:如果用户名称不存在,则创建由用户传递的队列
+```yaml
+placementrules:
+  - name: provided
+    create: true
+    parent:
+      name: user
+      create: true
+```
+使用 `developer` 作为用户进行应用提交请求,应用提交给队列:`my_special_queue`<br/>
+结果:`root.developer.my_special_queue`(父规则设置用户名)
+
+使用 `developer` 作为用户进行应用提交请求,应用提交给队列:`root.dev_queue`<br/>
+结果:`root.dev_queue`(忽略父规则)
+
+### 用户名称规则
+配置中使用的名称:*user*
+
+根据作为提交应用程序一部分的用户名返回队列。
+
+支持的参数:
+* create
+* parent
+* filter
+
+示例:根据用户名提交到队列,如果队列不存在则不创建队列:
+```yaml
+placementrules:
+  - name: user
+    create: false
+```
+
+使用 `finance.test` 作为用户进行应用提交请求,队列确实存在:<br/>
+结果:`root.finance_dot_test`(注意点 dot 的替换)
+
+使用 `developer` 作为用户进行应用提交请求,队列不存在:<br/>
+结果:失败,执行下一条规则
+
+### 固定规则
+配置中使用的名称:*fixed*
+
+返回在规则参数 _value_ 中配置的名称。
+配置的值必须是合法的队列名称或队列层次结构。
+该名称不必是完全限定的队列名称。

Review comment:
       full qualified 最好翻译为全域名?全文需要用统一该翻译

##########
File path: i18n/zh-cn/docusaurus-plugin-content-pages/community/get_involved.md
##########
@@ -0,0 +1,125 @@
+---
+id: get_involved
+title: 进行参与
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# 进行参与
+
+Apache YuniKorn(Incubating)社区非常多样化,我们有来自阿里巴巴、苹果、Cloudera、Linkedin、微软、Nvidia、腾讯、优步等(按英文字母顺序排序)。
+社区深信这种多样性的重要性和 “The Apache Way” 的价值。
+我们欢迎任何形式的贡献、代码、文档或建议!:smiley: 别等了,现在就加入我们吧!
+
+## 如何加入 YuniKorn 社区
+
+请通过以下渠道之一加入我们:
+
+### 通过 github 贡献
+- 这里解释了贡献项目的基本步骤 - [如何贡献](how_to_contribute)
+
+### 沟通渠道
+
+- Mailing lists:
+  - 对于希望为项目开发做出贡献或讨论的人: [dev@yunikorn.apache.org](mailto:dev@yunikorn.apache.org)   
+    订阅: dev@ [订阅](mailto:dev-subscribe@yunikorn.apache.org?subject="subscribe%20to%20YuniKorn%20dev%20list") ([退订](mailto:dev-unsubscribe@yunikorn.apache.org?subject="unsubscribe%20from%20YuniKorn%20dev%20list") [归档](https://lists.apache.org/list.html?dev@yunikorn.apache.org))
+  - 对于 JIRA 问题更新订阅: issues@ [订阅](mailto:issues-subscribe@yunikorn.apache.org?subject="subscribe%20to%20YuniKorn%20issues%20list") ([退订](mailto:issues-unsubscribe@yunikorn.apache.org?subject="unsubscribe%20from%20YuniKorn%20issues%20list") [归档](https://lists.apache.org/list.html?issues@yunikorn.apache.org))
+  - 对于 GitHub 拉取请求消息订阅: reviews@ [订阅](mailto:reviews-subscribe@yunikorn.apache.org?subject="subscribe%20to%20YuniKorn%20reviews%20list") ([退订](mailto:reviews-unsubscribe@yunikorn.apache.org?subject="unsubscribe%20from%20YuniKorn%20reviews%20list") [归档](https://lists.apache.org/list.html?reviews@yunikorn.apache.org))
+
+
+- 我们使用 [Slack](https://slack.com/) 作为我们的协作系统, 您可以通过访问 [这个链接](https://join.slack.com/t/yunikornworkspace/shared_invite/enQtNzAzMjY0OTI4MjYzLTBmMDdkYTAwNDMwNTE3NWVjZWE1OTczMWE4NDI2Yzg3MmEyZjUyYTZlMDE5M2U4ZjZhNmYyNGFmYjY4ZGYyMGE) 来加入我们。
+目前,我们在工作区中有以下频道:`#yunikorn-dev` 和 `#yunikorn-user`。
+
+- 我们会定期进行多个时区和语言的社区同步,请查找[社区会议](#community-meetings) 来参加在线会议。
+
+### 社区会议
+
+#### 目标受众:
+- 有兴趣为 YuniKorn 项目做出贡献的开发人员。
+- 正在使用或有兴趣了解该项目的用户。
+
+#### 日程
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+
+<Tabs
+  defaultValue="scheduleEN"
+  values={[
+    {label: 'America/EU/India', value: 'scheduleEN'},
+    {label: '中文/Mandarin', value: 'scheduleCN'},
+  ]}>
+  <TabItem value="scheduleEN"> 📆 美国太平洋时间每周三上午 9:30 每两周一次。 <a href="https://cloudera.zoom.us/j/721195559">单击此处加入 Zoom 会议。</a> </TabItem>
+  <TabItem value="scheduleCN"> 📆 中国标准时间 (GMT+8) 每周三下午 1:00。  <a href="https://cloudera.zoom.us/j/721195559">单击此处加入 Zoom 会议。</a> </TabItem>
+</Tabs>
+
+#### 资源
+
+- 会议记录: [Google 文档](https://docs.google.com/document/d/165gzC7uhcKc5XDWiMYSRKBiPQBy2tDtXADUPuhGlUa0/edit#heading=h.461goivmz24v)
+
+- 日历: [Google 日历](https://calendar.google.com/calendar/b/3/r/week/2020/3/26?cid=YXBhY2hlLnl1bmlrb3JuQGdtYWlsLmNvbQ) :point_left:
+
+## 成为一个 Committer
+
+Committers 是对项目存储库具有写入权限的社区成员,
+即他们可以自己修改代码并接受其他人对所有 YuniKorn 存储库的贡献。
+PPMC 根据各种考虑对候选人进行投票:
+
+- 代码贡献
+  - 一致的代码贡献
+  - 优化 CI/CD 管道
+  - 帮助进行代码审查
+  - 测试和验证候选版本
+  - 性能调优及相关工具开发
+  - 提出改进建议
+
+- 非代码贡献
+  - 参与社区活动,如会议、聚会等。
+  - 提供反馈、报告问题并参与路线图讨论
+  - 项目发布帮助
+  - 改进项目文档
+  - 帮助项目采用
+  - 与其他项目集成,扩展用例
+
+contributor 或非 contributor 都可以成为 committer,社区非常感谢代码或非代码贡献。
+
+## 成为 PPMC 成员
+
+PPMC 为 Podling Project Management Committee。
+它负责项目管理、治理并确保项目可以在 [Apache Way](https://www.apache.org/theapacheway/) 下运行。
+委员会根据 PPMC 成员的投票做出决定。
+PPMC 成员有权对各种事情进行有约束力的投票,例如项目发布、添加新的提交者或 PPMC 成员等。
+
+在成为 PPMC 成员之前,贡献者必须先成为提交者。
+提交者何时有资格被添加到 PPMC 没有严格的规定。
+管理委员会根据每个提交者的参与和影响做出决定。
+一般来说,对项目做出一致的代码或非代码贡献的提交者应被视为 PPMC 候选人。

Review comment:
       > 一般来说,对项目做出一致的代码或非代码贡献的提交者应被视为 PPMC 候选人。
   
   一般来说,对项目做出持续的代码或非代码贡献的贡献者应被视为 PPMC 候选人。

##########
File path: i18n/zh-cn/docusaurus-plugin-content-docs/version-0.12.1/user_guide/usergroup_resolution.md
##########
@@ -0,0 +1,68 @@
+---
+id: usergroup_resolution
+title: 用户和组解析
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+## 用户解析
+
+用户信息是调度周期的一个重要方面。它是可用于确定作业应提交到的队列的关键标志之一。Yunikorn 调度器依靠 K8s Shim 来提供用户信息。在 Kubernetes 的世界中,没有定义识别实际用户的对象。这是设计使然,可以在 [此处](https://kubernetes.io/docs/reference/access-authn-authz/authentication/#users-in-kubernetes) 找到更多信息。

Review comment:
       Yunikorn -> YuniKorn 需要保持一致
   请复查其他地方确保用词一致

##########
File path: i18n/zh-cn/docusaurus-plugin-content-pages/release-announce/0.10.0.md
##########
@@ -0,0 +1,54 @@
+---
+id: rn-0.10.0
+title: 发布公告 v0.10.0
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+# 发布公告 v0.10.0
+我们非常高兴地宣布 Apache YuniKorn (Incubating) 社区已投票发布 0.10.0。Apache YuniKorn (Incubating) 是一个独立的资源调度器,旨在管理和调度容器编排框架上的大数据工作负载,支持本地和云端的用例。
+
+此版本中添加的显著功能是联邦调度,YuniKorn 现在可以在 Kubernetes 上运行应用程序时提供联邦调度功能。除此之外,此版本还包括各种错误修复和改进。
+
+## 概述
+Apache YuniKorn (Incubating) 社区在此版本中修复了 187 个 JIRA 问题:[YuniKorn 在 0.10.0 中解决的 jira 问题](https://issues.apache.org/jira/issues/?filter=12349466)。
+
+发布负责人: Tao Yang
+
+发布时间: 2021-04-09
+
+## 主要更新
+
+### 支持的 Kubernetes 版本
+从此版本开始,支持的 Kubernetes 版本已更新为 1.16.x、1.17.x 和 1.18.x。(早期版本支持 1.13.x、1.14.x 和 1.15.x)YuniKorn 支持矩阵主要支持 3 个主要的 Kubernetes 版本。
+
+### 联邦调度
+在这个版本中,YuniKorn 开始支持联邦调度。用户可以将联邦应用于需要联邦调度语义的应用,如 Spark、Tensorflow、Pytorch 等。YuniKorn 主动为联邦调度应用预留资源,它与 cluster-autoscaler 配合使用更高效。初始的支持已经在 Spark 上进行了很好的测试,它可以与 K8s 上的原生 Spark 或 Spark K8s operator 一起使用。有关如何启用和使用联邦调度的更多信息,请阅读 [此处](/docs/user_guide/gang_scheduling) 的文档。

Review comment:
       请将 联邦调度 改名为 gang scheduling

##########
File path: i18n/zh-cn/docusaurus-plugin-content-pages/community/roadmap.md
##########
@@ -0,0 +1,57 @@
+---
+id: roadmap
+title: 路线图
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+
+# 未来发展:长期的目标
+
+- 应用程序和任务优先级的支持
+- 抢占资源分配
+- 用户和组配额和限制执行
+- 除了当前的独立模式之外,还会提供另一种部署模式作为默认调度程序的插件
+
+# 下一个发布研发内容
+
+发布详情:
+- 版本:1.0.0
+- 目标发布日期:2022 年 3 月
+- 发布负责人:Wilfred Spiegelenburg
+- 开发状态:[问题跟踪器](https://issues.apache.org/jira/issues/?filter=12348416)
+
+计划的主要功能:
+- [YUNIKORN-971](https://issues.apache.org/jira/browse/YUNIKORN-971) 将 YuniKorn 实现为 Kubernetes 调度插件
+- [YUNIKORN-978](https://issues.apache.org/jira/browse/YUNIKORN-978) 准入控制器部署改进
+- [YUNIKORN-984](https://issues.apache.org/jira/browse/YUNIKORN-984) 实施用户和组限制(阶段 1)
+- [YUNIKORN-954](https://issues.apache.org/jira/browse/YUNIKORN-954) 移除旧的 REST api
+- [YUNIKORN-720](https://issues.apache.org/jira/browse/YUNIKORN-720) 改进了队列指标

Review comment:
       对调度器资源队列指标监测系统的改进

##########
File path: i18n/zh-cn/docusaurus-plugin-content-pages/release-announce/0.11.0.md
##########
@@ -0,0 +1,57 @@
+---
+id: rn-0.11.0 
+title: 发布公告 v0.11.0
+---
+
+<!--
+Licensed to the Apache Software Foundation (ASF) under one
+or more contributor license agreements.  See the NOTICE file
+distributed with this work for additional information
+regarding copyright ownership.  The ASF licenses this file
+to you under the Apache License, Version 2.0 (the
+"License"); you may not use this file except in compliance
+with the License.  You may obtain a copy of the License at
+
+  http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing,
+software distributed under the License is distributed on an
+"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+KIND, either express or implied.  See the License for the
+specific language governing permissions and limitations
+under the License.
+-->
+# 发布公告 v0.11.0
+我们非常高兴地宣布 Apache YuniKorn (Incubating) 社区已投票发布 0.11.0。Apache YuniKorn (Incubating) 是一个独立的资源调度器,旨在管理和调度容器编排框架(如 Kubernetes)上的大数据工作负载,支持本地和云端的用例。
+此版本有几个 REST API、UI 可用性和联邦调度的改进。

Review comment:
       联邦调度 - gang scheduling




-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: reviews-unsubscribe@yunikorn.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org