This is an automated email from the ASF dual-hosted git repository.
lidongdai pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/dolphinscheduler-website.git
The following commit(s) were added to refs/heads/master by this push:
new 54f9ca7 Update dev_run.md (#440)
54f9ca7 is described below
commit 54f9ca7b3402f0b731aa6562f048ab5a49602b01
Author: aaronlinv <[email protected]>
AuthorDate: Sat Oct 2 11:57:58 2021 +0800
Update dev_run.md (#440)
* Update dev run
* Update dev_run.md
Co-authored-by: David <[email protected]>
---
docs/en-us/dev/user_doc/dev_run.md | 9 ++++++--
docs/zh-cn/dev/user_doc/dev_run.md | 45 ++++++++++++++++++++------------------
2 files changed, 31 insertions(+), 23 deletions(-)
diff --git a/docs/en-us/dev/user_doc/dev_run.md
b/docs/en-us/dev/user_doc/dev_run.md
index 14aa250..1f70a6e 100644
--- a/docs/en-us/dev/user_doc/dev_run.md
+++ b/docs/en-us/dev/user_doc/dev_run.md
@@ -49,9 +49,9 @@ spring.datasource.username=root
spring.datasource.password=123456
```
-v. Refresh the dao module and run the main method of
org.apache.dolphinscheduler.dao.upgrade.shell.CreateDolphinScheduler to
automatically insert the tables and data which are required by the project.
+v. Refresh the dao module and run the main method of
org.apache.dolphinscheduler.dao.upgrade.shell.CreateDolphinScheduler to
automatically insert the tables and data which are required by the project.If
you encounter problems such as non-existent database fields, you can try to
solve them by running the sql file of the corresponding database under
`dolphinscheduler\sql`.
-vi. Modify the registry.properties of the dolphinscheduler-service module:
+vi. Modify registry.properties for dolphinscheduler-service module and
worker.properties for dolphinscheduler-server module respectively, note:
`1.3.6-SNAPSHOT` here is based on the actual generated file
```properties
#registry.plugin.dir config the Registry Plugin dir.
@@ -61,6 +61,11 @@ registry.plugin.name=zookeeper
registry.servers=127.0.0.1:2181
```
+```properties
+#task.plugin.dir config the #task.plugin.dir config the Task Plugin dir .
WorkerServer while find and load the Task Plugin Jar from this dir when deploy
and start WorkerServer on the server .
+task.plugin.dir=./dolphinscheduler-task-plugin/dolphinscheduler-task-shell/target/dolphinscheduler-task-shell-1.3.6-SNAPSHOT
+```
+
vii. Add the console output to logback-worker.xml, logback-master.xml, and
logback-api.xml.
```xml
diff --git a/docs/zh-cn/dev/user_doc/dev_run.md
b/docs/zh-cn/dev/user_doc/dev_run.md
index 34d9ebd..9a26319 100644
--- a/docs/zh-cn/dev/user_doc/dev_run.md
+++ b/docs/zh-cn/dev/user_doc/dev_run.md
@@ -1,8 +1,6 @@
#### 搭建 dev 分支开发环境
-> 参考：[DolphinScheduler 在 Windows
本地搭建开发环境，源码启动](https://dolphinscheduler.apache.org/zh-cn/blog/DS_run_in_windows.html)
-
-1. **下载源码**
+1. **下载源码**
GitHub ：https://github.com/apache/dolphinscheduler
@@ -14,44 +12,44 @@
这里选用 dev 分支。
-2. **Windows 安装 zookeeper**
+2. ** 安装 ZooKeeper**
- 1. 下载 zk
https://www.apache.org/dyn/closer.lua/zookeeper/zookeeper-3.6.3/apache-zookeeper-3.6.3-bin.tar.gz
+ 1. 下载 ZooKeeper
https://www.apache.org/dyn/closer.lua/zookeeper/zookeeper-3.6.3/apache-zookeeper-3.6.3-bin.tar.gz
2. 解压 apache-zookeeper-3.6.3-bin.tar.gz
- 3. 在 zk 的目录下新建 zkData、zkLog文件夹
+ 3. 在 ZooKeeper 的目录下新建 zkData、zkLog文件夹
4. 将 conf 目录下的 zoo_sample.cfg 文件，复制一份，重命名为 zoo.cfg，修改其中数据和日志的配置，如：
```shell
- dataDir=D:\\code\\apache-zookeeper-3.6.3-bin\\zkData ## 此处使用绝对路径
- dataLogDir=D:\\code\\apache-zookeeper-3.6.3-bin\\zkLog
+ dataDir=/data/zookeeper/data ## 此处使用绝对路径
+ dataLogDir=/data/zookeeper/datalog
```
- 5. 在 bin 中运行 zkServer.cmd，然后运行 zkCli.cmd 查看 zk 运行状态，可以查看 zk 节点信息即代表安装成功。
+ 5. 在 bin 中运行 zkServer.sh，然后运行 zkCli.sh 查看 ZooKeeper 运行状态，可以查看 ZooKeeper
节点信息即代表安装成功。
-3. **搭建后端环境**
+3. **搭建后端环境**
- 1. 在本地新建一个数据库用于调试，DolphinScheduler 支持 mysql 和 postgresql，这里使用 mysql
进行配置，库名可为 ：dolphinscheduler；
+ 1. 在本地新建一个数据库用于调试，DolphinScheduler 支持 MySQL 和 PostgreSQL，这里使用 MySQL
进行配置，库名可为 ：dolphinscheduler；
2. 把代码导入 IDEA，修改根项目中 pom.xml，将 mysql-connector-java 依赖的 scope 修改为
compile；
- 3. 在 terminal 中执行 `mvn -U install package -Prelease
-Dmaven.test.skip=true`，安装所需要的注册插件；
+ 3. 在 terminal 中执行 `mvn -U clean install package -Prelease
-Dmaven.test.skip=true`，安装所需要的注册插件；
4. 修改 dolphinscheduler-dao 模块的 datasource.properties；
```properties
# mysql
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
-
spring.datasource.url=jdbc:mysql://localhost:3306/dolphinscheduler?useUnicode=true&characterEncoding=UTF-8
- spring.datasource.username=root
- spring.datasource.password=123456
+
spring.datasource.url=jdbc:mysql://xxx:3306/dolphinscheduler?useUnicode=true&characterEncoding=UTF-8&allowMultiQueries=true
# 替换您的数据库 ip 地址
+ spring.datasource.username=xxx
# 替换您的数据库用户名
+ spring.datasource.password=xxx
# 替换您的数据库密码
```
- 5. 刷新 dao 模块，运行
org.apache.dolphinscheduler.dao.upgrade.shell.CreateDolphinScheduler 的 main
方法，自动插入项目所需的表和数据；
+ 5. 刷入项目所需的表和数据；dev 分支数据库字段变化比较频繁，在数据库里直接运行项目根目录下 `dolphinscheduler\sql`
文件夹下对应数据库的 sql 文件 ，MySQL 下直接运行 `dolphinscheduler_mysql.sql`
- 6. 修改 dolphinscheduler-service 模块的 registry.properties；
+ 6. 分别修改 dolphinscheduler-service 模块的 registry.properties 和
dolphinscheduler-server 模块的 worker.properties，注意：这里的 `1.3.6-SNAPSHOT`
需要根据实际生成的文件进行填写
```properties
#registry.plugin.dir config the Registry Plugin dir.
@@ -60,6 +58,11 @@
registry.plugin.name=zookeeper
registry.servers=127.0.0.1:2181
```
+
+ ```properties
+ #task.plugin.dir config the #task.plugin.dir config the Task Plugin
dir . WorkerServer while find and load the Task Plugin Jar from this dir when
deploy and start WorkerServer on the server .
+
task.plugin.dir=./dolphinscheduler-task-plugin/dolphinscheduler-task-shell/target/dolphinscheduler-task-shell-1.3.6-SNAPSHOT
+ ```
7. 在 logback-worker.xml、logback-master.xml、logback-api.xml 中添加控制台输出；
@@ -73,25 +76,25 @@
8. 启动 MasterServer，执行
org.apache.dolphinscheduler.server.master.MasterServer 的 main 方法，需要设置 VM
Options:
- ```java
+ ```
-Dlogging.config=classpath:logback-master.xml
-Ddruid.mysql.usePingMethod=false
```
9. 启动
WorkerServer，执行org.apache.dolphinscheduler.server.worker.WorkerServer的
main方法，需要设置 VM Options:
- ```java
+ ```
-Dlogging.config=classpath:logback-worker.xml
-Ddruid.mysql.usePingMethod=false
```
10. 启动 ApiApplicationServer，执行
org.apache.dolphinscheduler.api.ApiApplicationServer 的 main 方法，需要设置 VM Options:
- ```java
+ ```
-Dlogging.config=classpath:logback-api.xml
-Dspring.profiles.active=api
```
11. 如果需要用到日志功能，执行 org.apache.dolphinscheduler.server.log.LoggerServer 的
main 方法。
- 12. 后端 swagger 地址
：http://localhost:12345/dolphinscheduler/doc.html?language=zh_CN&lang=cn
+ 12. 后端 Open API 文档地址
：http://localhost:12345/dolphinscheduler/doc.html?language=zh_CN&lang=cn
4. **搭建前端环境**
