This is an automated email from the ASF dual-hosted git repository.
lgcareer pushed a commit to branch master
in repository
https://gitbox.apache.org/repos/asf/incubator-dolphinscheduler-website.git
The following commit(s) were added to refs/heads/master by this push:
new 35d3c51 add 1.3.0(upcoming) chinese docs
new 7feeaa6 Merge pull request #124 from lgcareer/master-1.3.0
35d3c51 is described below
commit 35d3c51e3569b24d42cff74d4400b4d449755b05
Author: lgcareer <[email protected]>
AuthorDate: Fri Jun 5 14:36:41 2020 +0800
add 1.3.0(upcoming) chinese docs
---
docs/zh-cn/1.3.0/user_doc/cluster-deployment.md | 400 +++++++++++++++++++++
docs/zh-cn/1.3.0/user_doc/hardware-environment.md | 48 +++
docs/zh-cn/1.3.0/user_doc/quick-start.md | 58 +++
docs/zh-cn/1.3.0/user_doc/standalone-deployment.md | 341 ++++++++++++++++++
4 files changed, 847 insertions(+)
diff --git a/docs/zh-cn/1.3.0/user_doc/cluster-deployment.md
b/docs/zh-cn/1.3.0/user_doc/cluster-deployment.md
new file mode 100644
index 0000000..aa7a524
--- /dev/null
+++ b/docs/zh-cn/1.3.0/user_doc/cluster-deployment.md
@@ -0,0 +1,400 @@
+# 集群部署(Cluster)
+
+# 1、基础软件安装(必装项请自行安装)
+
+ * PostgreSQL (8.2.15+) or MySQL (5.7系列) : 两者任选其一即可
+ * [JDK](https://www.oracle.com/technetwork/java/javase/downloads/index.html)
(1.8+) : 必装，请安装好后在/etc/profile下配置 JAVA_HOME 及 PATH 变量
+ * ZooKeeper (3.4.6+) ：必装
+ * Hadoop (2.6+) or MinIO ：选装，如果需要用到资源上传功能，可以选择上传到Hadoop or MinIO上
+
+```markdown
+ 注意：DolphinScheduler本身不依赖Hadoop、Hive、Spark,仅是会调用他们的Client，用于对应任务的提交。
+```
+
+# 2、下载二进制tar.gz包
+
+- 请下载最新版本的后端安装包至服务器部署目录,比如创建 /opt/dolphinscheduler 做为安装部署目录，下载地址：
[下载](https://dolphinscheduler.apache.org/zh-cn/docs/release/download.html)
(以1.2.0版本为例)，下载后上传tar包到该目录中，并进行解压
+
+```shell
+# 创建部署目录,部署目录请不要创建在/root、/home等高权限目录
+mkdir -p /opt/dolphinscheduler;
+cd /opt/dolphinscheduler;
+# 解压缩
+tar -zxvf apache-dolphinscheduler-incubating-1.3.0-dolphinscheduler-bin.tar.gz
-C /opt/dolphinscheduler;
+
+mv apache-dolphinscheduler-incubating-1.3.0-dolphinscheduler-bin
dolphinscheduler-bin
+```
+
+# 3、创建部署用户和hosts映射
+
+-
在**所有**部署调度的机器上创建部署用户，并且一定要配置sudo免密。假如我们计划在ds1,ds2,ds3,ds4这4台机器上部署调度，首先需要在每台机器上都创建部署用户
+
+```shell
+# 创建用户需使用root登录，设置部署用户名，请自行修改，后面以dolphinscheduler为例
+useradd dolphinscheduler;
+
+# 设置用户密码，请自行修改，后面以dolphinscheduler123为例
+echo "dolphinscheduler123" | passwd --stdin dolphinscheduler
+
+# 配置sudo免密
+echo 'dolphinscheduler ALL=(ALL) NOPASSWD: NOPASSWD: ALL' >> /etc/sudoers
+sed -i 's/Defaults requirett/#Defaults requirett/g' /etc/sudoers
+
+```
+
+```
+ 注意：
+ - 因为是以 sudo -u {linux-user} 切换不同linux用户的方式来实现多租户运行作业，所以部署用户需要有 sudo 权限，而且是免密的。
+ - 如果发现/etc/sudoers文件中有"Default requiretty"这行，也请注释掉
+ - 如果用到资源上传的话，还需要在`HDFS或者MinIO`上给该部署用户分配读写的权限
+```
+
+# 4、配置hosts映射和ssh打通及修改目录权限
+
+- 以第一台机器(hostname为ds1)作为部署机，在ds1上配置所有待部署机器的hosts, 在ds1以root登录
+
+ ```shell
+ vi /etc/hosts
+
+ #add ip hostname
+ 192.168.xxx.xxx ds1
+ 192.168.xxx.xxx ds2
+ 192.168.xxx.xxx ds3
+ 192.168.xxx.xxx ds4
+ ```
+
+ *注意：请删掉或者注释掉127.0.0.1这行*
+
+- 同步ds1上的/etc/hosts到所有部署机器
+
+ ```shell
+ for ip in ds2 ds3; #请将此处ds2 ds3替换为自己要部署的机器的hostname
+ do
+ sudo scp -r /etc/hosts $ip:/etc/ #在运行中需要输入root密码
+ done
+ ```
+
+ *备注：当然 通过`sshpass -p xxx sudo scp -r /etc/hosts $ip:/etc/`就可以省去输入密码了*
+
+ > centos下sshpass的安装：
+ >
+ > 1. 先安装epel
+ >
+ > yum install -y epel-release
+ >
+ > yum repolist
+ >
+ > 2. 安装完成epel之后，就可以按照sshpass了
+ >
+ > yum install -y sshpass
+ >
+ >
+
+- 在ds1上，切换到部署用户并配置ssh本机免密登录
+
+ ```shell
+ su dolphinscheduler;
+
+ ssh-keygen -t rsa -P '' -f ~/.ssh/id_rsa
+ cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
+ chmod 600 ~/.ssh/authorized_keys
+ ```
+ 注意：*正常设置后，dolphinscheduler用户在执行命令`ssh localhost` 是不需要再输入密码的*
+
+
+
+- 在ds1上，配置部署用户dolphinscheduler ssh打通到其他待部署的机器
+
+ ```shell
+ su dolphinscheduler;
+ for ip in ds2 ds3; #请将此处ds2 ds3替换为自己要部署的机器的hostname
+ do
+ ssh-copy-id $ip #该操作执行过程中需要手动输入dolphinscheduler用户的密码
+ done
+ # 当然 通过 sshpass -p xxx ssh-copy-id $ip 就可以省去输入密码了
+ ```
+
+- 在ds1上，修改目录权限，使得部署用户对dolphinscheduler-backend目录有操作权限
+
+ ```shell
+ sudo chown -R dolphinscheduler:dolphinscheduler dolphinscheduler-backend
+ ```
+
+# 5、数据库初始化
+
+-
进入数据库，默认数据库是PostgreSQL，如选择MySQL的话，后续需要添加mysql-connector-java驱动包到DolphinScheduler的lib目录下，这里以MySQL为例
+```
+mysql -uroot -p
+```
+
+- 进入数据库命令行窗口后，执行数据库初始化命令，设置访问账号和密码。**注: {user} 和 {password}
需要替换为具体的数据库用户名和密码**
+
+ ``` mysql
+ mysql> CREATE DATABASE dolphinscheduler DEFAULT CHARACTER SET utf8 DEFAULT
COLLATE utf8_general_ci;
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO '{user}'@'%'
IDENTIFIED BY '{password}';
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO '{user}'@'localhost'
IDENTIFIED BY '{password}';
+ mysql> flush privileges;
+ ```
+
+- 创建表和导入基础数据
+
+ - 修改 conf 目录下 application-dao.properties 中的下列配置
+
+ ```shell
+ vi conf/application-dao.properties
+ ```
+
+ - 如果选择 MySQL，请注释掉 PostgreSQL 相关配置(反之同理), 还需要手动添加 [[ mysql-connector-java
驱动 jar ](https://downloads.mysql.com/archives/c-j/)] 包到 lib
目录下，这里下载的是mysql-connector-java-5.1.47.jar，然后正确配置数据库连接相关信息
+
+ ```properties
+ #postgre
+ #spring.datasource.driver-class-name=org.postgresql.Driver
+ #spring.datasource.url=jdbc:postgresql://localhost:5432/dolphinscheduler
+ # mysql
+ spring.datasource.driver-class-name=com.mysql.jdbc.Driver
+
spring.datasource.url=jdbc:mysql://xxx:3306/dolphinscheduler?useUnicode=true&characterEncoding=UTF-8
需要修改ip
+ spring.datasource.username=xxx
需要修改为上面的{user}值
+ spring.datasource.password=xxx
需要修改为上面的{password}值
+ ```
+
+ - 修改并保存完后，执行 script 目录下的创建表及导入基础数据脚本
+
+ ```shell
+ sh script/create-dolphinscheduler.sh
+ ```
+
+ *注意: 如果执行上述脚本报 ”/bin/java: No such file or directory“
错误，请在/etc/profile下配置 JAVA_HOME 及 PATH 变量*
+
+# 6、修改运行参数
+
+- 修改 conf/env 目录下的 `dolphinscheduler_env.sh` 环境变量(以相关用到的软件都安装在/opt/soft下为例)
+
+ ```shell
+ export HADOOP_HOME=/opt/soft/hadoop
+ export HADOOP_CONF_DIR=/opt/soft/hadoop/etc/hadoop
+ #export SPARK_HOME1=/opt/soft/spark1
+ export SPARK_HOME2=/opt/soft/spark2
+ export PYTHON_HOME=/opt/soft/python
+ export JAVA_HOME=/opt/soft/java
+ export HIVE_HOME=/opt/soft/hive
+ export FLINK_HOME=/opt/soft/flink
+ export
PATH=$HADOOP_HOME/bin:$SPARK_HOME2/bin:$PYTHON_HOME:$JAVA_HOME/bin:$HIVE_HOME/bin:$PATH:$FLINK_HOME/bin:$PATH
+
+ ```
+
+ `注: 这一步非常重要,例如 JAVA_HOME 和 PATH
是必须要配置的，没有用到的可以忽略或者注释掉；如果找不到.dolphinscheduler_env.sh, 请运行 ls -a`
+
+
+
+- 将jdk软链到/usr/bin/java下(仍以 JAVA_HOME=/opt/soft/java 为例)
+
+ ```shell
+ sudo ln -s /opt/soft/java/bin/java /usr/bin/java
+ ```
+
+ - 修改一键部署脚本 `install.sh`中的各参数，特别注意以下参数的配置
+
+ ```shell
+ # 这里填 mysql or postgresql
+ dbtype="mysql"
+
+ # 数据库连接地址
+ dbhost="localhost:3306"
+
+ # 数据库名
+ dbname="dolphinscheduler"
+
+ # 数据库用户名，此处需要修改为上面设置的{user}具体值
+ username="xxx"
+
+ # 数据库密码, 如果有特殊字符，请使用\转义，需要修改为上面设置的{passowrd}具体值
+ passowrd="xxx"
+
+ #将DS安装到哪个目录，如: /opt/soft/dolphinscheduler，不同于现在的目录
+ installPath="/opt/soft/dolphinscheduler"
+
+ #使用哪个用户部署，使用1.3小节创建的用户
+ deployUser="dolphinscheduler"
+
+ #Zookeeper地址，单机本机是localhost:2181，记得把2181端口带上
+ zkQuorum="localhost:2181"
+
+ #在哪些机器上部署DS服务，本机选localhost
+ ips="localhost"
+
+ #ssh端口,默认22
+ sshPort="22"
+
+ #master服务部署在哪台机器上
+ masters="localhost"
+
+ #worker服务部署在哪台机器上,并指定此worker属于哪一个worker组
+ workers="localhost:default"
+
+ #报警服务部署在哪台机器上
+ alertServer="localhost"
+
+ #后端api服务部署在在哪台机器上
+ apiServers="localhost"
+
+
+ # 邮件配置，以qq邮箱为例
+ # 邮件协议
+ mailProtocol="SMTP"
+
+ # 邮件服务地址
+ mailServerHost="smtp.exmail.qq.com"
+
+ # 邮件服务端口
+ mailServerPort="25"
+
+ # mailSender和mailUser配置成一样即可
+ # 发送者
+ mailSender="[email protected]"
+
+ # 发送用户
+ mailUser="[email protected]"
+
+ # 邮箱密码
+ mailPassword="xxx"
+
+ # TLS协议的邮箱设置为true，否则设置为false
+ starttlsEnable="true"
+
+ # 邮件服务地址值，参考上面 mailServerHost
+ sslTrust="smtp.exmail.qq.com"
+
+ # 开启SSL协议的邮箱配置为true，否则为false。注意: starttlsEnable和sslEnable不能同时为true
+ sslEnable="false"
+
+ # excel下载路径
+ xlsFilePath="/tmp/xls"
+
+ #
业务用到的比如sql等资源文件上传到哪里，可以设置：HDFS,S3,NONE，单机如果想使用本地文件系统，请配置为HDFS，因为HDFS支持本地文件系统；如果不需要资源上传功能请选择NONE。强调一点：使用本地文件系统不需要部署hadoop
+ resourceStorageType="HDFS"
+
+ # 资源上传根路径,主持HDFS和S3,由于hdfs支持本地文件系统，需要确保本地文件夹存在且有读写权限
+ resourceUploadPath="/data/dolphinscheduler"
+
+ # 具备权限创建resourceUploadPath的用户
+ hdfsRootUser="hdfs"
+
+ # 这里以保存到本地文件系统为例
+
#注：但是如果你想上传到HDFS的话，NameNode启用了HA，则需要将core-site.xml和hdfs-site.xml放到conf目录下，本例即是放到/opt/dolphinscheduler/conf下面，并配置namenode
cluster名称；如果NameNode不是HA,则修改为具体的ip或者主机名即可
+ defaultFS="file:///data/dolphinscheduler" #hdfs://{具体的ip/主机名}:8020
+
+
+ #
如果ResourceManager是HA，则配置为ResourceManager节点的主备ip或者hostname,比如"192.168.xx.xx,192.168.xx.xx"，否则如果是单ResourceManager或者根本没用到yarn,请配置yarnHaIps=""即可，我这里没用到yarn，配置为""
+ yarnHaIps=""
+
+ # 如果是单ResourceManager，则配置为ResourceManager节点ip或主机名，否则保持默认值即可。我这里没用到yarn，保持默认
+ singleYarnIp="ark1"
+
+
+
+ *注：如果打算用到`资源中心`功能，请执行以下命令：*
+
+ ```shell
+ sudo mkdir /data/dolphinscheduler
+ sudo chown -R dolphinscheduler:dolphinscheduler /data/dolphinscheduler
+ ```
+
+ *特别注意：*
+
+ - 如果需要用资源上传到Hadoop集群功能， 并且Hadoop集群的NameNode 配置了 HA的话 ，需要开启
HDFS类型的资源上传，同时需要将Hadoop集群下的core-site.xml和hdfs-site.xml复制到/opt/dolphinscheduler/conf，非NameNode
HA跳过次步骤
+
+# 7、一键部署
+
+- 切换到部署用户dolphinscheduler，然后执行一键部署脚本
+
+ `sh install.sh`
+
+ ```
+ 注意：
+ 第一次部署的话，在运行中第3步`3,stop server`出现5次以下信息，此信息可以忽略
+ sh: bin/dolphinscheduler-daemon.sh: No such file or directory
+ ```
+
+- 脚本完成后，会启动以下5个服务，使用`jps`命令查看服务是否启动(`jps`为`java JDK`自带)
+
+```aidl
+ MasterServer ----- master服务
+ WorkerServer ----- worker服务
+ LoggerServer ----- logger服务
+ ApiApplicationServer ----- api服务
+ AlertServer ----- alert服务
+```
+如果以上服务都正常启动，说明自动部署成功
+
+
+部署成功后，可以进行日志查看，日志统一存放于logs文件夹内
+
+```日志路径
+ logs/
+ ├── dolphinscheduler-alert-server.log
+ ├── dolphinscheduler-master-server.log
+ |—— dolphinscheduler-worker-server.log
+ |—— dolphinscheduler-api-server.log
+ |—— dolphinscheduler-logger-server.log
+```
+
+
+
+# 8、登录系统
+
+- 访问前端页面地址,接口ip(自行修改)
+http://192.168.xx.xx:12345/dolphinscheduler
+
+ <p align="center">
+ <img src="/img/login.png" width="60%" />
+ </p>
+
+
+
+# 9、启停服务
+
+* 一键停止集群所有服务
+
+ ` sh ./bin/stop-all.sh`
+
+* 一键开启集群所有服务
+
+ ` sh ./bin/start-all.sh`
+
+* 启停Master
+
+```shell
+sh ./bin/dolphinscheduler-daemon.sh start master-server
+sh ./bin/dolphinscheduler-daemon.sh stop master-server
+```
+
+* 启停Worker
+
+```shell
+sh ./bin/dolphinscheduler-daemon.sh start worker-server
+sh ./bin/dolphinscheduler-daemon.sh stop worker-server
+```
+
+* 启停Api
+
+```shell
+sh ./bin/dolphinscheduler-daemon.sh start api-server
+sh ./bin/dolphinscheduler-daemon.sh stop api-server
+```
+
+* 启停Logger
+
+```shell
+sh ./bin/dolphinscheduler-daemon.sh start logger-server
+sh ./bin/dolphinscheduler-daemon.sh stop logger-server
+```
+
+* 启停Alert
+
+```shell
+sh ./bin/dolphinscheduler-daemon.sh start alert-server
+sh ./bin/dolphinscheduler-daemon.sh stop alert-server
+```
+
+`注：服务用途请具体参见《系统架构设计》小节`
+
diff --git a/docs/zh-cn/1.3.0/user_doc/hardware-environment.md
b/docs/zh-cn/1.3.0/user_doc/hardware-environment.md
new file mode 100644
index 0000000..ddb309b
--- /dev/null
+++ b/docs/zh-cn/1.3.0/user_doc/hardware-environment.md
@@ -0,0 +1,48 @@
+# 软硬件环境建议配置
+
+DolphinScheduler 作为一款开源分布式工作流任务调度系统，可以很好的部署和运行在 Intel
架构服务器环境及主流虚拟化环境下，并支持主流的Linux操作系统环境。
+
+## 1. Linux 操作系统版本要求
+
+| 操作系统 | 版本 |
+| :----------------------- | :----------: |
+| Red Hat Enterprise Linux | 7.0 及以上 |
+| CentOS | 7.0 及以上 |
+| Oracle Enterprise Linux | 7.0 及以上 |
+| Ubuntu LTS | 16.04 及以上 |
+
+> **注意：**
+>以上 Linux 操作系统可运行在物理服务器以及 VMware、KVM、XEN 主流虚拟化环境上。
+
+## 2. 服务器建议配置
+DolphinScheduler 支持运行在 Intel x86-64 架构的 64 位通用硬件服务器平台。对生产环境的服务器硬件配置有以下建议：
+### 生产环境
+
+| **CPU** | **内存** | **硬盘类型** | **网络** | **实例数量** |
+| --- | --- | --- | --- | --- |
+| 4核+ | 8 GB+ | SAS | 千兆网卡 | 1+ |
+
+> **注意：**
+> - 以上建议配置为部署 DolphinScheduler 的最低配置，生产环境强烈推荐使用更高的配置。
+> - 硬盘大小配置建议 50GB+ ，系统盘和数据盘分开。
+
+
+## 3. 网络要求
+
+DolphinScheduler正常运行提供如下的网络端口配置：
+
+| 组件 | 默认端口 | 说明 |
+| --- | --- | --- |
+| MasterServer | 5566 | 非通信端口，只需本机端口不冲突即可 |
+| WorkerServer | 7788 | 非通信端口，只需本机端口不冲突即可 |
+| ApiApplicationServer | 12345 | 提供后端通信端口 |
+| nginx | 8888 | 提供 UI 端通信端口 |
+
+> **注意：**
+> - MasterServer 和 WorkerServer 不需要开启网络间通信，只需本机端口不冲突即可
+> - 管理员可根据实际环境中 DolphinScheduler 组件部署方案，在网络侧和主机侧开放相关端口
+
+## 4. 客户端 Web 浏览器要求
+
+DolphinScheduler 推荐 Chrome 以及使用 Chrome 内核的较新版本浏览器访问前端可视化操作界面。
+
diff --git a/docs/zh-cn/1.3.0/user_doc/quick-start.md
b/docs/zh-cn/1.3.0/user_doc/quick-start.md
new file mode 100644
index 0000000..b57b21a
--- /dev/null
+++ b/docs/zh-cn/1.3.0/user_doc/quick-start.md
@@ -0,0 +1,58 @@
+# 快速上手
+
+* 管理员用户登录
+ >地址：192.168.xx.xx:8888 用户名密码：admin/dolphinscheduler123
+
+<p align="center">
+ <img src="/img/login.png" width="60%" />
+ </p>
+
+* 创建队列
+<p align="center">
+ <img src="/img/create-queue.png" width="60%" />
+ </p>
+
+ * 创建租户
+ <p align="center">
+ <img src="/img/addtenant.png" width="60%" />
+ </p>
+
+ * 创建普通用户
+<p align="center">
+ <img src="/img/useredit2.png" width="60%" />
+ </p>
+
+ * 创建告警组
+ <p align="center">
+ <img src="/img/mail_edit.png" width="60%" />
+ </p>
+
+ * 创建Worker分组
+ <p align="center">
+ <img src="/img/worker_group.png" width="60%" />
+ </p>
+
+ * 创建token令牌
+ <p align="center">
+ <img src="/img/creat_token.png" width="60%" />
+ </p>
+
+ * 使用普通用户登录
+ > 点击右上角用户名“退出”，重新使用普通用户登录。
+
+ * 项目管理->创建项目->点击项目名称
+<p align="center">
+ <img src="/img/project.png" width="60%" />
+ </p>
+
+ * 点击工作流定义->创建工作流定义->上线工作流定义
+
+<p align="center">
+ <img src="/img/dag1.png" width="60%" />
+ </p>
+
+ * 运行工作流定义->点击工作流实例->点击工作流实例名称->双击任务节点->查看任务执行日志
+
+ <p align="center">
+ <img src="/img/task-log.png" width="60%" />
+</p>
\ No newline at end of file
diff --git a/docs/zh-cn/1.3.0/user_doc/standalone-deployment.md
b/docs/zh-cn/1.3.0/user_doc/standalone-deployment.md
new file mode 100644
index 0000000..aba96fa
--- /dev/null
+++ b/docs/zh-cn/1.3.0/user_doc/standalone-deployment.md
@@ -0,0 +1,341 @@
+# 单机部署(Standalone)
+
+DolphinScheduler单机部署分为后端部署和前端部署两部分：
+
+# 1、基础软件安装(必装项请自行安装)
+
+ * PostgreSQL (8.2.15+) or MySQL (5.7系列) : 两者任选其一即可
+ * [JDK](https://www.oracle.com/technetwork/java/javase/downloads/index.html)
(1.8+) : 必装，请安装好后在/etc/profile下配置 JAVA_HOME 及 PATH 变量
+ * ZooKeeper (3.4.6+) ：必装
+ * Hadoop (2.6+) or MinIO ：选装，
如果需要用到资源上传功能，针对单机可以选择本地文件目录作为上传文件夹(此操作不需要部署Hadoop)；当然也可以选择上传到Hadoop or MinIO集群上
+
+```markdown
+ 注意：DolphinScheduler本身不依赖Hadoop、Hive、Spark,仅是会调用他们的Client，用于对应任务的运行。
+```
+
+# 2、下载二进制tar.gz包
+
+- 请下载最新版本的后端安装包至服务器部署目录,比如创建 /opt/dolphinscheduler 做为安装部署目录，下载地址：
[下载](https://dolphinscheduler.apache.org/zh-cn/docs/release/download.html)
(以1.3.0版本为例)，下载后上传tar包到该目录中，并进行解压
+
+```shell
+# 创建部署目录,部署目录请不要创建在/root、/home等高权限目录
+mkdir -p /opt/dolphinscheduler;
+cd /opt/dolphinscheduler;
+# 解压缩
+tar -zxvf apache-dolphinscheduler-incubating-1.3.0-dolphinscheduler-bin.tar.gz
-C /opt/dolphinscheduler;
+
+mv apache-dolphinscheduler-incubating-1.3.0-dolphinscheduler-bin
dolphinscheduler-bin
+```
+
+# 3、创建部署用户并赋予目录操作权限
+
+- 创建部署用户，并且一定要配置sudo免密。以创建dolphinscheduler用户为例
+
+```shell
+# 创建用户需使用root登录
+useradd dolphinscheduler;
+
+# 添加密码
+echo "dolphinscheduler" | passwd --stdin dolphinscheduler
+
+# 配置sudo免密
+sed -i '$adolphinscheduler ALL=(ALL) NOPASSWD: NOPASSWD: ALL' /etc/sudoers
+sed -i 's/Defaults requirett/#Defaults requirett/g' /etc/sudoers
+
+# 修改目录权限，使得部署用户对dolphinscheduler-backend目录有操作权限
+chown -R dolphinscheduler:dolphinscheduler dolphinscheduler-backend
+```
+
+```
+ 注意：
+ - 因为任务执行服务是以 sudo -u {linux-user} 切换不同linux用户的方式来实现多租户运行作业，所以部署用户需要有 sudo
权限，而且是免密的。初学习者不理解的话，完全可以暂时忽略这一点
+ - 如果发现/etc/sudoers文件中有"Default requiretty"这行，也请注释掉
+ - 如果用到资源上传的话，还需要给该部署用户分配操作`本地文件系统或者HDFS或者MinIO`的权限
+```
+
+# 4、ssh免密配置
+
+- 切换到部署用户并配置ssh本机免密登录
+
+```shell
+su dolphinscheduler;
+
+ssh-keygen -t rsa -P '' -f ~/.ssh/id_rsa
+cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
+chmod 600 ~/.ssh/authorized_keys
+```
+注意：*正常设置后，dolphinscheduler用户在执行命令`ssh localhost` 是不需要再输入密码的*
+
+# 5、数据库初始化
+
+-
进入数据库，默认数据库是PostgreSQL，如选择MySQL的话，后续需要添加mysql-connector-java驱动包到DolphinScheduler的lib目录下
+```
+mysql -uroot -p
+```
+
+- 进入数据库命令行窗口后，执行数据库初始化命令，设置访问账号和密码。**注: {user} 和 {password}
需要替换为具体的数据库用户名和密码**
+
+ ``` mysql
+ mysql> CREATE DATABASE dolphinscheduler DEFAULT CHARACTER SET utf8 DEFAULT
COLLATE utf8_general_ci;
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO '{user}'@'%'
IDENTIFIED BY '{password}';
+ mysql> GRANT ALL PRIVILEGES ON dolphinscheduler.* TO '{user}'@'localhost'
IDENTIFIED BY '{password}';
+ mysql> flush privileges;
+ ```
+
+
+- 创建表和导入基础数据
+
+ - 修改 conf 目录下 application-dao.properties 中的下列配置
+
+ - ```shell
+ vi conf/application-dao.properties
+ ```
+
+ - 如果选择 MySQL，请注释掉 PostgreSQL 相关配置(反之同理), 还需要手动添加 [[ mysql-connector-java
驱动 jar ](https://downloads.MySQL.com/archives/c-j/)] 包到 lib
目录下，这里下载的是mysql-connector-java-5.1.47.jar，然后正确配置数据库连接相关信息
+
+ ```properties
+ # postgre
+ #spring.datasource.driver-class-name=org.postgresql.Driver
+ #spring.datasource.url=jdbc:postgresql://localhost:5432/dolphinscheduler
+ # mysql
+ spring.datasource.driver-class-name=com.mysql.jdbc.Driver
+
spring.datasource.url=jdbc:mysql://xxx:3306/dolphinscheduler?useUnicode=true&characterEncoding=UTF-8
需要修改ip，本机localhost即可
+ spring.datasource.username=xxx
需要修改为上面的{user}值
+ spring.datasource.password=xxx
需要修改为上面的{password}值
+ ```
+
+ - 修改并保存完后，执行 script 目录下的创建表及导入基础数据脚本
+
+ ```shell
+ sh script/create-dolphinscheduler.sh
+ ```
+
+ *注意: 如果执行上述脚本报 ”/bin/java: No such file or directory“
错误，请在/etc/profile下配置 JAVA_HOME 及 PATH 变量*
+
+# 6、修改运行参数
+
+- 修改 conf/env 目录下的 `dolphinscheduler_env.sh` 环境变量(以相关用到的软件都安装在/opt/soft下为例)
+
+ ```shell
+ export HADOOP_HOME=/opt/soft/hadoop
+ export HADOOP_CONF_DIR=/opt/soft/hadoop/etc/hadoop
+ #export SPARK_HOME1=/opt/soft/spark1
+ export SPARK_HOME2=/opt/soft/spark2
+ export PYTHON_HOME=/opt/soft/python
+ export JAVA_HOME=/opt/soft/java
+ export HIVE_HOME=/opt/soft/hive
+ export FLINK_HOME=/opt/soft/flink
+ export
PATH=$HADOOP_HOME/bin:$SPARK_HOME2/bin:$PYTHON_HOME:$JAVA_HOME/bin:$HIVE_HOME/bin:$PATH:$FLINK_HOME/bin:$PATH
+
+ ```
+
+ `注: 这一步非常重要,例如 JAVA_HOME 和 PATH
是必须要配置的，没有用到的可以忽略或者注释掉；如果找不到.dolphinscheduler_env.sh, 请运行 ls -a`
+
+
+
+- 将jdk软链到/usr/bin/java下(仍以 JAVA_HOME=/opt/soft/java 为例)
+
+ ```shell
+ sudo ln -s /opt/soft/java/bin/java /usr/bin/java
+ ```
+
+ - 修改一键部署脚本 `install.sh`中的各参数，特别注意以下参数的配置
+
+ ```shell
+ # 这里填 mysql or postgresql
+ dbtype="mysql"
+
+ # 数据库连接地址
+ dbhost="localhost:3306"
+
+ # 数据库名
+ dbname="dolphinscheduler"
+
+ # 数据库用户名，此处需要修改为上面设置的{user}具体值
+ username="xxx"
+
+ # 数据库密码, 如果有特殊字符，请使用\转义，需要修改为上面设置的{passowrd}具体值
+ passowrd="xxx"
+
+ #将DS安装到哪个目录，如: /opt/soft/dolphinscheduler，不同于现在的目录
+ installPath="/opt/soft/dolphinscheduler"
+
+ #使用哪个用户部署，使用1.3小节创建的用户
+ deployUser="dolphinscheduler"
+
+ #Zookeeper地址，单机本机是localhost:2181，记得把2181端口带上
+ zkQuorum="localhost:2181"
+
+ #在哪些机器上部署DS服务，本机选localhost
+ ips="localhost"
+
+ #ssh端口,默认22
+ sshPort="22"
+
+ #master服务部署在哪台机器上
+ masters="localhost"
+
+ #worker服务部署在哪台机器上,并指定此worker属于哪一个worker组
+ workers="localhost:default"
+
+ #报警服务部署在哪台机器上
+ alertServer="localhost"
+
+ #后端api服务部署在在哪台机器上
+ apiServers="localhost"
+
+
+ # 邮件配置，以qq邮箱为例
+ # 邮件协议
+ mailProtocol="SMTP"
+
+ # 邮件服务地址
+ mailServerHost="smtp.exmail.qq.com"
+
+ # 邮件服务端口
+ mailServerPort="25"
+
+ # mailSender和mailUser配置成一样即可
+ # 发送者
+ mailSender="[email protected]"
+
+ # 发送用户
+ mailUser="[email protected]"
+
+ # 邮箱密码
+ mailPassword="xxx"
+
+ # TLS协议的邮箱设置为true，否则设置为false
+ starttlsEnable="true"
+
+ # 邮件服务地址值，参考上面 mailServerHost
+ sslTrust="smtp.exmail.qq.com"
+
+ # 开启SSL协议的邮箱配置为true，否则为false。注意: starttlsEnable和sslEnable不能同时为true
+ sslEnable="false"
+
+ # excel下载路径
+ xlsFilePath="/tmp/xls"
+
+ #
业务用到的比如sql等资源文件上传到哪里，可以设置：HDFS,S3,NONE，单机如果想使用本地文件系统，请配置为HDFS，因为HDFS支持本地文件系统；如果不需要资源上传功能请选择NONE。强调一点：使用本地文件系统不需要部署hadoop
+ resourceStorageType="HDFS"
+
+ # 资源上传根路径,主持HDFS和S3,由于hdfs支持本地文件系统，需要确保本地文件夹存在且有读写权限
+ resourceUploadPath="/data/dolphinscheduler"
+
+ # 具备权限创建resourceUploadPath的用户
+ hdfsRootUser="hdfs"
+
+ # 这里以保存到本地文件系统为例
+
#注：但是如果你想上传到HDFS的话，NameNode启用了HA，则需要将core-site.xml和hdfs-site.xml放到conf目录下，本例即是放到/opt/dolphinscheduler/conf下面，并配置namenode
cluster名称；如果NameNode不是HA,则修改为具体的ip或者主机名即可
+ defaultFS="file:///data/dolphinscheduler" #hdfs://{具体的ip/主机名}:8020
+
+
+ #
如果ResourceManager是HA，则配置为ResourceManager节点的主备ip或者hostname,比如"192.168.xx.xx,192.168.xx.xx"，否则如果是单ResourceManager或者根本没用到yarn,请配置yarnHaIps=""即可，我这里没用到yarn，配置为""
+ yarnHaIps=""
+
+ # 如果是单ResourceManager，则配置为ResourceManager节点ip或主机名，否则保持默认值即可。我这里没用到yarn，保持默认
+ singleYarnIp="ark1"
+
+
+
+ *注：如果打算用到`资源中心`功能，请执行以下命令：*
+
+ ```shell
+ sudo mkdir /data/dolphinscheduler
+ sudo chown -R dolphinscheduler:dolphinscheduler /data/dolphinscheduler
+ ```
+
+# 7、一键部署
+
+- 切换到部署用户，执行一键部署脚本
+
+ `sh install.sh`
+
+ ```
+ 注意：
+ 第一次部署的话，在运行中第3步`3,stop server`出现5次以下信息，此信息可以忽略
+ sh: bin/dolphinscheduler-daemon.sh: No such file or directory
+ ```
+
+- 脚本完成后，会启动以下5个服务，使用`jps`命令查看服务是否启动(`jps`为`java JDK`自带)
+
+```aidl
+ MasterServer ----- master服务
+ WorkerServer ----- worker服务
+ LoggerServer ----- logger服务
+ ApiApplicationServer ----- api服务
+ AlertServer ----- alert服务
+```
+如果以上服务都正常启动，说明自动部署成功
+
+
+部署成功后，可以进行日志查看，日志统一存放于logs文件夹内
+
+```日志路径
+ logs/
+ ├── dolphinscheduler-alert-server.log
+ ├── dolphinscheduler-master-server.log
+ |—— dolphinscheduler-worker-server.log
+ |—— dolphinscheduler-api-server.log
+ |—— dolphinscheduler-logger-server.log
+```
+
+
+
+# 8、登录系统
+
+- 访问前端页面地址,接口ip(自行修改)
+http://192.168.xx.xx:12345/dolphinscheduler
+
+ <p align="center">
+ <img src="/img/login.png" width="60%" />
+ </p>
+
+# 9、启停服务
+
+* 一键停止集群所有服务
+
+ ` sh ./bin/stop-all.sh`
+
+* 一键开启集群所有服务
+
+ ` sh ./bin/start-all.sh`
+
+* 启停Master
+
+```shell
+sh ./bin/dolphinscheduler-daemon.sh start master-server
+sh ./bin/dolphinscheduler-daemon.sh stop master-server
+```
+
+* 启停Worker
+
+```shell
+sh ./bin/dolphinscheduler-daemon.sh start worker-server
+sh ./bin/dolphinscheduler-daemon.sh stop worker-server
+```
+
+* 启停Api
+
+```shell
+sh ./bin/dolphinscheduler-daemon.sh start api-server
+sh ./bin/dolphinscheduler-daemon.sh stop api-server
+```
+
+* 启停Logger
+
+```shell
+sh ./bin/dolphinscheduler-daemon.sh start logger-server
+sh ./bin/dolphinscheduler-daemon.sh stop logger-server
+```
+
+* 启停Alert
+
+```shell
+sh ./bin/dolphinscheduler-daemon.sh start alert-server
+sh ./bin/dolphinscheduler-daemon.sh stop alert-server
+```
+
+`注：服务用途请具体参见《系统架构设计》小节`
+
