Modified docker deploy's doc into en (#1091)

Author: caijieming-baidu

example/docker/README.md

@@ -1,38 +1,82 @@
-Docker部署Tera
+Use Docker to deploy Tera
 ===============
-##第一章 准备
-###Dokcer篇
-* 安装Docker
-  请参见https://docs.docker.com/ 。Ubuntu下Docker安装命令为：
+##Prerequisites
+###Install Docker
+* For docker installation, please refer to [Docker](https://docs.docker.com/). Ubuntu's Docker installation:
 
   ```
     wget -qO- https://get.docker.com/ | sh
   ```
 
-* 为Docker添加Non-root权限
+* Manage Docker as a non-root user
+ 
+  To create the docker group and add your user:
+
+	1. Log into Ubuntu as a user with sudo privileges.
+	2. Create the docker group. bash $ sudo groupadd docker
+	3. Add your user to the docker group.
+		
+		```$ sudo usermod -aG docker $USER```
+	
+	4. Log out and log back in so that your group membership is re-evaluated.
+
+
+###Enable Password-less SSH
+* Generate the SSH keys: ssh-keygen -t rsa
+	
+		Generating public/private key pair.
+		Enter file in which to save the key (/xxx/.ssh/id_rsa):
+		Enter passphrase (empty for no passphrase):
+		Enter same passphrase again:
+		Your identification has been saved in /xxx/.ssh/id_rsa.
+		Your public key has been saved in /xxx/.ssh/id_rsa.pub.
+	
+* Copy the key to each Node:
+
+		ssh-copy-id {username}@node1
+		ssh-copy-id {username}@node2
+		ssh-copy-id {username}@node3
+
+###Install Python and Tera Image
+* Use exsample/docker/install.sh to install python package and download Tera docker image. For example:
+ 
+  ```
+     //Cluster has 3 nodes: 
+     //		deplying node is 192.168.100.2; 
+     //		other two slave node is 192.168.100.3 and 192.168.100.4
+     //
+     // exec installation like (no need to setup installation in deplying node):
+    sh install.sh 192.168.100.3 192.168.100.4
+  ```
 
-  执行sudo usermod -aG docker $USER，登出再登进
 
-###机器篇
-* 配置集群间免密码ssh登陆
+##Running
+###Configuration
 
-###Python和Docker镜像篇
-* 安装Python包并下载Tera镜像
 
-  执行exsample/docker/install.sh脚本。参数为集群中除本机外的ip地址。例如，集群中有三台主机：192.168.100.2，192.168.100.3，192.168.100.4，当前登录192.168.100.2，则安装命令为：
-  
+* Use example/docker/conf as a template to configure your Tera cluster, for example:
+
   ```
-    ./install.sh 192.168.100.3 192.168.100.4
+  ip   	: ip address, use the colon as a separator
+  hdfs  ：configure the number of hdfs's datanode
+  zk    ：configure the number of zookeeper's node
+  tera  ：configure the number of Tera's tablet servers
+  log_prefix：log file's dir ($HOME by default)
+  
+  conf template:
+  {	
+  	"ip":"192.168.100.2:192.168.100.3:192.168.100.4", 
+  	"hdfs":3, 
+  	"zk":3, 
+  	"tera":3
+  }
   ```
 
+###Execution
 
-##第二章 奔跑
-
-###执行篇
-
-* 一键启动
+* Fast startup
 
-  直接执行/example/docker/cluster_setup.py会自动搭建一个本地Tera集群。配置如下：
+  use /example/docker/cluster_setup.py, it will create a Tera cluster automatically：
 
   ```
     hdfs：namenode*1，datanode*1
@@ -41,38 +85,26 @@ Docker部署Tera
     log： $HOME
   ```
 
-* 启动自定义Tera集群
+* Self-configure Tera cluster
 
-  cluster_setup.py脚本默认启动zk，hdfs和Tera，可通过参数选择启动某一或两项。
+  cluster_setup.py will start zk, hdfs and tera together by default; User can use flags to setup one or more cluster respectively。
 
 
-      --help：  显示帮助
-      --conf：  配置文件路径（配置文件说明见配置篇）
-      --docker：Tera的docker镜像ID
-      --zk：    启动zookeeper集群
-      --hdfs：  启动hdfs集群
-      --tera：  启动tera集群
+      --help：  show help manual
+      --conf：  cluster's configuration information, see below
+      --docker：Tera's docker image ID
+      --zk：    startup zookeeper cluster
+      --hdfs：  startup hdfs cluster
+      --tera：  startup tera cluster
 
       
-  例如：
+  for example：
 
   ```
-  python cluster_setup.py --conf my_config --docker abc   // 使用镜像abc启动配置为my_config的Tera集群
+  // use TeraImage and my_config file to startup Tera cluster
+  python cluster_setup.py --conf my_config --docker TeraImage  
   
-  python cluster_setup.py --zk --hdfs   // 启动单机版zk和hdfs
+  // startup zk and hdfs
+  python cluster_setup.py --zk --hdfs
   ```
 
-###配置篇
-
-
-* 修改example/docker目录下conf中的配置自定义Tera集群，其中：
-
-  ```
-  ip    ：集群ip地址，用冒号分隔
-  hdfs  ：hdfs集群中datanode的个数
-  zk    ：Zookeeper集群中zk个数
-  tera  ：Tera集群中tablenode个数
-  log_prefix：log目录（默认为$HOME）
-  
-  例如 {"ip":"192.168.100.2:192.168.100.3:192.168.100.4", "hdfs":3, "zk":3, "tera":3}
-  ```

example/docker/readme-cn.md

@@ -0,0 +1,78 @@
+Docker部署Tera
+===============
+##第一章 准备
+###Dokcer篇
+* 安装Docker
+  请参见https://docs.docker.com/ 。Ubuntu下Docker安装命令为：
+
+  ```
+    wget -qO- https://get.docker.com/ | sh
+  ```
+
+* 为Docker添加Non-root权限
+
+  执行sudo usermod -aG docker $USER，登出再登进
+
+###机器篇
+* 配置集群间免密码ssh登陆
+
+###Python和Docker镜像篇
+* 安装Python包并下载Tera镜像
+
+  执行exsample/docker/install.sh脚本。参数为集群中除本机外的ip地址。例如，集群中有三台主机：192.168.100.2，192.168.100.3，192.168.100.4，当前登录192.168.100.2，则安装命令为：
+  
+  ```
+    ./install.sh 192.168.100.3 192.168.100.4
+  ```
+
+
+##第二章 奔跑
+
+###执行篇
+
+* 一键启动
+
+  直接执行/example/docker/cluster_setup.py会自动搭建一个本地Tera集群。配置如下：
+  
+  ```
+    hdfs：namenode*1，datanode*1
+    zk：  standalone
+    tera：master*1， tabletnode*1
+    log： $HOME
+  ```
+  
+* 启动自定义Tera集群
+
+  cluster_setup.py脚本默认启动zk，hdfs和Tera，可通过参数选择启动某一或两项。
+
+
+      --help：  显示帮助
+      --conf：  配置文件路径（配置文件说明见配置篇）
+      --docker：Tera的docker镜像ID
+      --zk：    启动zookeeper集群
+      --hdfs：  启动hdfs集群
+      --tera：  启动tera集群
+
+      
+  例如：
+
+  ```
+  python cluster_setup.py --conf my_config --docker abc   // 使用镜像abc启动配置为my_config的Tera集群
+  
+  python cluster_setup.py --zk --hdfs   // 启动单机版zk和hdfs
+  ```
+
+###配置篇
+
+
+* 修改example/docker目录下conf中的配置自定义Tera集群，其中：
+
+  ```
+  ip    ：集群ip地址，用冒号分隔
+  hdfs  ：hdfs集群中datanode的个数
+  zk    ：Zookeeper集群中zk个数
+  tera  ：Tera集群中tablenode个数
+  log_prefix：log目录（默认为$HOME）
+  
+  例如 {"ip":"192.168.100.2:192.168.100.3:192.168.100.4", "hdfs":3, "zk":3, "tera":3}
+  ```