Browse Source

简化部署文档

pull/1/MERGE
dailidong 6 years ago
parent
commit
b46d5fab2f
  1. 132
      docs/zh_CN/后端部署文档.md

132
docs/zh_CN/后端部署文档.md

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

Loading…
Cancel
Save