cku328 commented on a change in pull request #1541:
URL: https://github.com/apache/ozone/pull/1541#discussion_r522695675



##########
File path: hadoop-hdds/docs/content/concept/OzoneManager.zh.md
##########
@@ -24,32 +24,26 @@ summary: Ozone Manager 是 Ozone 主要的命名空间服务,它管理了卷
   limitations under the License.
 -->
 
-<div class="alert alert-warning">
-
-注意:本页面翻译的信息可能滞后,最新的信息请参看英文版的相关页面。
-
-</div>
-
 Ozone Manager(OM)管理 Ozone 的命名空间。
 
-当向 Ozone 写入数据时,你需要向 OM 请求一个块,OM 会返回一个块并记录下相关信息。当你想要读取那个文件时,你也需要先通过 OM 获取那个块的地址。
+当向 Ozone 写入数据时,你需要向 OM 请求一个块,OM 会返回这个块并记录下相关信息。当你想要读取那个文件时,你也需要先通过 OM 获取那个块的地址。
 
 OM 允许用户在卷和桶下管理键,卷和桶都是命名空间的一部分,也由 OM 管理。
 
-每个卷都是 OM 下的一个独立命名空间的根,这一点和 HDFS 不同,HDFS 提供的是单个根目录的文件系统。
+每个卷都是 OM 下一个独立命名空间的根,这一点和 HDFS 不同,HDFS 提供的是单个根目录的文件系统。
 
-与 HDFS 中单根的树状结构相比,Ozone 的命名空间是卷的集合,或者可以看作是个森林,因此可以非常容易地部署多个 OM 来进行扩展。
+Ozone 的命名空间是卷的集合,或者可以看作是相对于 HDFS 单根树状结构的森林。因此,Ozone 可以非常容易地支持部署多个 OM 来进行扩展。
 
 ## Ozone Manager 元数据
 
 OM 维护了卷、桶和键的列表。它为每个用户维护卷的列表,为每个卷维护桶的列表,为每个桶维护键的列表。
 
-OM 使用 Apache Ratis(Raft 协议的一种实现)来复制 OM 的状态,这为 Ozone 提供了高可用性保证。
+OM 使用 Apache Ratis(一种Raft 协议的开源实现)来复制 OM 的状态,这为 Ozone 提供了高可用性保证。

Review comment:
       ```suggestion
   OM 使用 Apache Ratis(一种 Raft 协议的开源实现)来复制 OM 的状态,这为 Ozone 提供了高可用性保证。
   ```

##########
File path: hadoop-hdds/docs/content/concept/OzoneManager.zh.md
##########
@@ -24,32 +24,26 @@ summary: Ozone Manager 是 Ozone 主要的命名空间服务,它管理了卷
   limitations under the License.
 -->
 
-<div class="alert alert-warning">
-
-注意:本页面翻译的信息可能滞后,最新的信息请参看英文版的相关页面。
-
-</div>
-
 Ozone Manager(OM)管理 Ozone 的命名空间。
 
-当向 Ozone 写入数据时,你需要向 OM 请求一个块,OM 会返回一个块并记录下相关信息。当你想要读取那个文件时,你也需要先通过 OM 获取那个块的地址。
+当向 Ozone 写入数据时,你需要向 OM 请求一个块,OM 会返回这个块并记录下相关信息。当你想要读取那个文件时,你也需要先通过 OM 获取那个块的地址。
 
 OM 允许用户在卷和桶下管理键,卷和桶都是命名空间的一部分,也由 OM 管理。
 
-每个卷都是 OM 下的一个独立命名空间的根,这一点和 HDFS 不同,HDFS 提供的是单个根目录的文件系统。
+每个卷都是 OM 下一个独立命名空间的根,这一点和 HDFS 不同,HDFS 提供的是单个根目录的文件系统。
 
-与 HDFS 中单根的树状结构相比,Ozone 的命名空间是卷的集合,或者可以看作是个森林,因此可以非常容易地部署多个 OM 来进行扩展。
+Ozone 的命名空间是卷的集合,或者可以看作是相对于 HDFS 单根树状结构的森林。因此,Ozone 可以非常容易地支持部署多个 OM 来进行扩展。
 
 ## Ozone Manager 元数据
 
 OM 维护了卷、桶和键的列表。它为每个用户维护卷的列表,为每个卷维护桶的列表,为每个桶维护键的列表。
 
-OM 使用 Apache Ratis(Raft 协议的一种实现)来复制 OM 的状态,这为 Ozone 提供了高可用性保证。
+OM 使用 Apache Ratis(一种Raft 协议的开源实现)来复制 OM 的状态,这为 Ozone 提供了高可用性保证。
 
 
 ## Ozone Manager 和 Storage Container Manager
 
-为了方便理解 OM 和 SCM 之间的关系,我们来看看写入键和读取键的过程。
+为了方便理解 OM 和 SCM 之间的关系,我们可以跟踪一个键的读写过程。
 
 ### 写入键
 

Review comment:
       ```suggestion
   
   ![Write Path](OzoneManager-WritePath.png)
   
   ```
   Missing image.

##########
File path: hadoop-hdds/docs/content/concept/OzoneManager.zh.md
##########
@@ -24,32 +24,26 @@ summary: Ozone Manager 是 Ozone 主要的命名空间服务,它管理了卷
   limitations under the License.
 -->
 
-<div class="alert alert-warning">
-
-注意:本页面翻译的信息可能滞后,最新的信息请参看英文版的相关页面。
-
-</div>
-
 Ozone Manager(OM)管理 Ozone 的命名空间。

Review comment:
       ```suggestion
   ![Ozone Manager](OzoneManager.png)
   
   Ozone Manager(OM)管理 Ozone 的命名空间。
   ```
   Missing image.

##########
File path: hadoop-hdds/docs/content/concept/OzoneManager.zh.md
##########
@@ -70,4 +64,54 @@ OM 使用 Apache Ratis(Raft 协议的一种实现)来复制 OM 的状态,
 
 * OM 返回块列表以及对应的块 token。
 
-* 用户连接数据节点,出示块 token,然后读取键数据。
\ No newline at end of file
+* 用户连接数据节点,出示块 token,然后读取键数据。
+
+
+## Ozone Manager 的主要组件
+
+为了详细地了解 Ozone Manager,本节针对它所提供的网络服务和持久化状态提供一个快速概述。
+
+Ozone为客户端和管理命令提供网络服务,主要的服务如下:
+
+ * 键、桶、卷 / 增删改查
+ * 分块上传(Initiate, Complete…)
+    * 支持大文件的多步上传
+ * 与文件系统相关的调用(针对分层查询而非对象存储的扁平化命名空间进行了优化)
+   * GetFileStatus, CreateDirectory, CreateFile, LookupFile
+ * ACL 相关
+   * 使用 [内部 ACLs]({{< ref path="security/SecurityAcls.zh.md" lang="zh" >}}) 代替 
[Ranger]({{< ref path="security/SecurityWithRanger.zh.md" lang="zh" >}}) 
管理访问控制列表
+ * Delegation token(获取 / 刷新 / 取消)

Review comment:
       ```suggestion
    * 授权令牌(获取 / 刷新 / 取消)
   ```

##########
File path: hadoop-hdds/docs/content/concept/OzoneManager.zh.md
##########
@@ -70,4 +64,54 @@ OM 使用 Apache Ratis(Raft 协议的一种实现)来复制 OM 的状态,
 
 * OM 返回块列表以及对应的块 token。
 
-* 用户连接数据节点,出示块 token,然后读取键数据。
\ No newline at end of file
+* 用户连接数据节点,出示块 token,然后读取键数据。
+
+
+## Ozone Manager 的主要组件
+
+为了详细地了解 Ozone Manager,本节针对它所提供的网络服务和持久化状态提供一个快速概述。
+
+Ozone为客户端和管理命令提供网络服务,主要的服务如下:
+
+ * 键、桶、卷 / 增删改查
+ * 分块上传(Initiate, Complete…)
+    * 支持大文件的多步上传
+ * 与文件系统相关的调用(针对分层查询而非对象存储的扁平化命名空间进行了优化)
+   * GetFileStatus, CreateDirectory, CreateFile, LookupFile
+ * ACL 相关
+   * 使用 [内部 ACLs]({{< ref path="security/SecurityAcls.zh.md" lang="zh" >}}) 代替 
[Ranger]({{< ref path="security/SecurityWithRanger.zh.md" lang="zh" >}}) 
管理访问控制列表
+ * Delegation token(获取 / 刷新 / 取消)
+   * 用于安全相关
+ * 管理 API
+   * 获取 S3 的访问密钥
+   * ServiceList(用于服务发现)
+   * DBUpdates(用于 [Recon]({{< ref path="feature/Recon.md" lang="en" >}}) 下载快照)
+ 
+ **Persisted state**
+
+以下数据将保存在 Ozone Manager 端的指定 RocksDB 目录中:
+
+ * 卷 / 桶 / 键 表
+    * 这些都由 OM 负责管理
+    * 键的元数据包含用于查找数据的块 ID(其中又包含容器的 ID)
+ * OpenKey 表
+    * 存放已经被创建,但是还未被提交的键
+ * Delegation token 表
+    * 用于安全相关
+ * PrefixInfo 表
+    * 使用特定的索引表来存储目录级的 ACL 信息,并为分层查询提供更好的性能
+ * S3 密钥表
+   * 用于 S3 密钥的管理
+ * 分块上传信息表
+   * 用于跟踪正在进行的分块上传
+ * 删除表
+   * 跟踪应从数据节点上删除的块
+
+## 需要关注的配置项
+
+配置项 | 默认值 | 描述
+----|---------|------------
+ozone.om.address | 0.0.0.0:9862 | OM 的 RPC 地址,客户端需要用到
+ozone.om.http-address | 0.0.0.0:9874 | 默认的 HTTP Server 地址和端口
+ozone.metadata.dirs | none | 存储持久化数据的目录(RockDB)

Review comment:
       none -> 无
   

##########
File path: hadoop-hdds/docs/content/concept/OzoneManager.zh.md
##########
@@ -70,4 +64,54 @@ OM 使用 Apache Ratis(Raft 协议的一种实现)来复制 OM 的状态,
 
 * OM 返回块列表以及对应的块 token。
 
-* 用户连接数据节点,出示块 token,然后读取键数据。
\ No newline at end of file
+* 用户连接数据节点,出示块 token,然后读取键数据。
+
+
+## Ozone Manager 的主要组件
+
+为了详细地了解 Ozone Manager,本节针对它所提供的网络服务和持久化状态提供一个快速概述。
+
+Ozone为客户端和管理命令提供网络服务,主要的服务如下:

Review comment:
       ```suggestion
   Ozone 为客户端和管理命令提供网络服务,主要的服务如下:
   ```
   Missing a blank.

##########
File path: hadoop-hdds/docs/content/concept/OzoneManager.zh.md
##########
@@ -70,4 +64,54 @@ OM 使用 Apache Ratis(Raft 协议的一种实现)来复制 OM 的状态,
 
 * OM 返回块列表以及对应的块 token。
 
-* 用户连接数据节点,出示块 token,然后读取键数据。
\ No newline at end of file
+* 用户连接数据节点,出示块 token,然后读取键数据。
+
+
+## Ozone Manager 的主要组件
+
+为了详细地了解 Ozone Manager,本节针对它所提供的网络服务和持久化状态提供一个快速概述。
+
+Ozone为客户端和管理命令提供网络服务,主要的服务如下:
+
+ * 键、桶、卷 / 增删改查
+ * 分块上传(Initiate, Complete…)
+    * 支持大文件的多步上传
+ * 与文件系统相关的调用(针对分层查询而非对象存储的扁平化命名空间进行了优化)
+   * GetFileStatus, CreateDirectory, CreateFile, LookupFile
+ * ACL 相关
+   * 使用 [内部 ACLs]({{< ref path="security/SecurityAcls.zh.md" lang="zh" >}}) 代替 
[Ranger]({{< ref path="security/SecurityWithRanger.zh.md" lang="zh" >}}) 
管理访问控制列表
+ * Delegation token(获取 / 刷新 / 取消)
+   * 用于安全相关
+ * 管理 API
+   * 获取 S3 的访问密钥
+   * ServiceList(用于服务发现)
+   * DBUpdates(用于 [Recon]({{< ref path="feature/Recon.md" lang="en" >}}) 下载快照)
+ 
+ **Persisted state**
+
+以下数据将保存在 Ozone Manager 端的指定 RocksDB 目录中:
+
+ * 卷 / 桶 / 键 表
+    * 这些都由 OM 负责管理
+    * 键的元数据包含用于查找数据的块 ID(其中又包含容器的 ID)
+ * OpenKey 表
+    * 存放已经被创建,但是还未被提交的键
+ * Delegation token 表

Review comment:
       ```suggestion
    * 授权令牌表
   ```

##########
File path: hadoop-hdds/docs/content/concept/OzoneManager.zh.md
##########
@@ -70,4 +64,54 @@ OM 使用 Apache Ratis(Raft 协议的一种实现)来复制 OM 的状态,
 
 * OM 返回块列表以及对应的块 token。
 
-* 用户连接数据节点,出示块 token,然后读取键数据。
\ No newline at end of file
+* 用户连接数据节点,出示块 token,然后读取键数据。
+
+
+## Ozone Manager 的主要组件
+
+为了详细地了解 Ozone Manager,本节针对它所提供的网络服务和持久化状态提供一个快速概述。
+
+Ozone为客户端和管理命令提供网络服务,主要的服务如下:
+
+ * 键、桶、卷 / 增删改查
+ * 分块上传(Initiate, Complete…)
+    * 支持大文件的多步上传
+ * 与文件系统相关的调用(针对分层查询而非对象存储的扁平化命名空间进行了优化)
+   * GetFileStatus, CreateDirectory, CreateFile, LookupFile
+ * ACL 相关
+   * 使用 [内部 ACLs]({{< ref path="security/SecurityAcls.zh.md" lang="zh" >}}) 代替 
[Ranger]({{< ref path="security/SecurityWithRanger.zh.md" lang="zh" >}}) 
管理访问控制列表
+ * Delegation token(获取 / 刷新 / 取消)
+   * 用于安全相关
+ * 管理 API
+   * 获取 S3 的访问密钥
+   * ServiceList(用于服务发现)
+   * DBUpdates(用于 [Recon]({{< ref path="feature/Recon.md" lang="en" >}}) 下载快照)
+ 
+ **Persisted state**

Review comment:
       ```suggestion
   **持久化状态**
   ```




----------------------------------------------------------------
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.

For queries about this service, please contact Infrastructure at:
[email protected]



---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to