Kaynağa Gözat

简化部署文档

dailidong 6 yıl önce
ebeveyn
işleme
b46d5fab2f
1 değiştirilmiş dosya ile 60 ekleme ve 78 silme
  1. 60 78
      docs/zh_CN/后端部署文档.md

+ 60 - 78
docs/zh_CN/后端部署文档.md

@@ -3,7 +3,10 @@
 后端有2种部署方式,分别为自动化部署和编译源码部署
 
 ## 1、准备工作
-#### 准备一:基础软件安装(必装项请自行安装)
+
+目前最新安装包版本是1.0.1,下载地址: [码云下载](https://gitee.com/easyscheduler/EasyScheduler/attach_files/) ,下载escheduler-backend-1.0.1.tar.gz后,解压后会产生escheduler-backend-1.0.1目录(后面简称escheduler-backend)
+
+#### 准备一: 基础软件安装(必装项请自行安装)
 
  * [Mysql](http://geek.analysys.cn/topic/124) (5.5+) :  必装
  * [JDK](https://www.oracle.com/technetwork/java/javase/downloads/index.html) (1.8+) :  必装
@@ -17,28 +20,27 @@
  注意:EasyScheduler本身不依赖Hadoop、Hive、Spark、PostgreSQL,仅是会调用他们的Client,用于对应任务的运行。
 ```
 
-#### 准备二:下载安装包
-目前最新安装包版本是1.0.1,下载地址: [码云下载](https://gitee.com/easyscheduler/EasyScheduler/attach_files/)
-下载escheduler-backend-1.0.1.tar.gz后,解压后会产生escheduler-backend-1.0.1目录(简称escheduler-backend),进入该escheduler-backend目录
-
+#### 准备二: 创建部署用户
 
-## 2、部署
-以下两种方式任选其一部署即可,推荐自动化部署
+- 在所有需要部署调度的机器上创建部署用户,因为worker服务是以 sudo -u {linux-user} 方式来执行作业,所以部署用户需要有 sudo 权限,而且是免密的。
 
-### 2.1 自动化部署
+```部署账号
+vi /etc/sudoers
 
-我们先来大体了解下escheduler-backend目录下的文件(夹)说明
+# 例如部署用户是escheduler账号
+escheduler  ALL=(ALL)       NOPASSWD: NOPASSWD: ALL
 
+# 并且需要注释掉 Default requiretty 一行
+#Default requiretty
 ```
-bin : 基础服务启动脚本
-conf : 项目配置文件
-lib : 项目依赖jar包,包括各个模块jar和第三方jar
-script : 集群启动、停止和服务监控启停脚本
-sql : 项目依赖sql文件
-install.sh : 一键部署脚本
-```
 
-### 2.2 数据库初始化
+#### 准备三: ssh免密配置
+ 在部署机器和其他安装机器上配置ssh免密登录,如果要在部署机上安装调度,需要配置本机免密登录自己
+ 
+- [将 **主机器** 和各个其它机器SSH打通](http://geek.analysys.cn/topic/113)
+
+
+#### 准备四:数据库初始化
 
 * 创建database和账号
 
@@ -64,56 +66,36 @@ install.sh : 一键部署脚本
     mysql -h {host} -u {user} -p{password} -D {db} < quartz.sql
     ```
 
+#### 准备五: 修改部署目录权限及运行参数
 
-### 2.3 创建部署用户
-
-- 在所有需要部署调度的机器上创建部署用户,因为worker服务是以 sudo -u {linux-user} 方式来执行作业,所以部署用户需要有 sudo 权限,而且是免密的。
-
-```部署账号
-vi /etc/sudoers
-
-# 例如部署用户是escheduler账号
-escheduler  ALL=(ALL)       NOPASSWD: NOPASSWD: ALL
-
-# 并且需要注释掉 Default requiretty 一行
-#Default requiretty
-```
-
-### 2.4 ssh免密配置
- 在部署机器和其他安装机器上配置ssh免密登录,如果要在部署机上安装调度,需要配置本机免密登录自己
- 
-- [将 **主机器** 和各个其它机器SSH打通](http://geek.analysys.cn/topic/113)
-
-
-### 2.5. 修改安装目录权限
-
-- 安装目录如下:
+我们先来大体了解下解压后escheduler-backend目录下的文件(夹)的作用
 
 ```
-    bin
-    conf
-    install.sh
-    lib
-    script
-    sql
-    
+bin : 基础服务启动脚本
+conf : 项目配置文件
+lib : 项目依赖jar包,包括各个模块jar和第三方jar
+script : 集群启动、停止和服务监控启停脚本
+sql : 项目依赖sql文件
+install.sh : 一键部署脚本
 ```
-- 修改权限(deployUser修改为对应部署用户)
-
-    `sudo chown -R deployUser:deployUser *`
 
-### 2.6. 修改环境变量文件
+- 修改权限(请将deployUser自行修改为对应部署用户),使得部署用户对escheduler-backend目录有操作权限
+    
+    `sudo chown -R deployUser:deployUser escheduler-backend`
 
-- 根据业务需求,修改conf/env/目录下的**escheduler_env.py**,** .escheduler_env.sh**两个文件中的环境变量
+- 修改conf/env/目录下的`escheduler_env.py`,  `.escheduler_env.sh` 两个文件中的环境变量
 
-### 2.7. 修改部署参数
+- 修改部署参数(根据自己服务器及业务情况):
 
- - 修改 **install.sh**中的参数,替换成自身业务所需的值
+ - 修改 **install.sh**中的各参数,替换成自身业务所需的值
 
  -  如果使用hdfs相关功能,需要拷贝**hdfs-site.xml**和**core-site.xml**到conf目录下
 
 
-### 2.8. 一键部署
+## 2、部署
+推荐自动化部署,有经验的小伙伴也可以使用源码部署
+
+### 2.1 自动部署
 
 - 安装zookeeper工具 
 
@@ -123,7 +105,7 @@ escheduler  ALL=(ALL)       NOPASSWD: NOPASSWD: ALL
 
     `sh install.sh` 
 
-- jps查看服务是否启动
+- 使用jps命令查看服务是否启动(jps为java JDK自带)
 
 ```aidl
     MasterServer         ----- master服务
@@ -132,9 +114,10 @@ escheduler  ALL=(ALL)       NOPASSWD: NOPASSWD: ALL
     ApiApplicationServer ----- api服务
     AlertServer          ----- alert服务
 ```
+如果有以上5个服务,说明自动部署成功
 
-## 日志查看
-日志统一存放于指定文件夹内
+
+部署成功后,可以进行日志查看,日志统一存放于指定文件夹内
 
 ```日志路径
  logs/
@@ -144,8 +127,24 @@ escheduler  ALL=(ALL)       NOPASSWD: NOPASSWD: ALL
     |—— escheduler-api-server.log
     |—— escheduler-logger-server.log
 ```
-    
-## 启停服务
+
+### 2.2 编译源码来部署
+
+将源码包release版本1.0.1下载后,解压进入根目录
+
+* 执行编译命令:
+
+```
+ mvn -U clean package assembly:assembly -Dmaven.test.skip=true
+```
+
+* 查看目录
+
+正常编译完后,会在当前目录生成 target/escheduler-{version}/ , 然后参考
+
+
+
+### 2.3 系统常用启停服务
 
 * 一键停止集群所有服务
    
@@ -186,21 +185,4 @@ sh ./bin/escheduler-daemon.sh stop logger-server
 ```
 sh ./bin/escheduler-daemon.sh start alert-server
 sh ./bin/escheduler-daemon.sh stop alert-server
-```
-
-
-如果不喜欢自动化部署,我们也可以编译源码来部署
-### 编译源码部署
-
-将源码包下载后,
-
-* 执行编译命令:
-
-```
- mvn -U clean package assembly:assembly -Dmaven.test.skip=true
-```
-
-* 查看目录
-
-正常编译完后,会在当前目录生成 target/escheduler-{version}/
-
+```