You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@dolphinscheduler.apache.org by zh...@apache.org on 2022/07/27 14:45:44 UTC

[dolphinscheduler] 02/09: [doc] Add docs about complement dependent mode (#10587)

This is an automated email from the ASF dual-hosted git repository.

zhongjiajie pushed a commit to branch 3.0.0-prepare
in repository https://gitbox.apache.org/repos/asf/dolphinscheduler.git

commit b943c003a62e9cc9053c528da20f010bb8692ff9
Author: xiangzihao <46...@qq.com>
AuthorDate: Fri Jun 24 16:33:10 2022 +0800

    [doc] Add docs about complement dependent mode (#10587)
    
    (cherry picked from commit b21e211d2cbf7a2af2307f0a5c63dc9c2b837809)
---
 docs/docs/en/guide/project/workflow-definition.md |  2 +-
 docs/docs/zh/guide/project/workflow-definition.md | 51 +++++++++++++----------
 2 files changed, 31 insertions(+), 22 deletions(-)

diff --git a/docs/docs/en/guide/project/workflow-definition.md b/docs/docs/en/guide/project/workflow-definition.md
index 5b1614f1ec..2348488ebc 100644
--- a/docs/docs/en/guide/project/workflow-definition.md
+++ b/docs/docs/en/guide/project/workflow-definition.md
@@ -88,7 +88,7 @@ The following are the operation functions of the workflow definition list:
 ![workflow-run](../../../../img/new_ui/dev/project/workflow-run.png)
  
   Description of workflow operating parameters: 
-       
+
   * Failure strategy: When a task node fails to execute, other parallel task nodes need to execute this strategy. "Continue" means: after a certain task fails, other task nodes execute normally; "End" means: terminate all tasks execution, and terminate the entire process.
   * Notification strategy: When the process is over, send the process execution result notification email according to the process status, options including no send, send if sucess, send of failure, send whatever result.
   * Process priority: The priority of process operation, divide into five levels: highest (HIGHEST), high (HIGH), medium (MEDIUM), low (LOW), and lowest (LOWEST). When the number of master threads is insufficient, high priority processes will execute first in the execution queue, and processes with the same priority will execute in the order of first in, first out.
diff --git a/docs/docs/zh/guide/project/workflow-definition.md b/docs/docs/zh/guide/project/workflow-definition.md
index 7832e94d88..d0a7931bf4 100644
--- a/docs/docs/zh/guide/project/workflow-definition.md
+++ b/docs/docs/zh/guide/project/workflow-definition.md
@@ -4,11 +4,11 @@
 
 - 点击项目管理->工作流->工作流定义,进入工作流定义页面,点击“创建工作流”按钮,进入**工作流DAG编辑**页面,如下图所示:
 
-  ![workflow-dag](/img/new_ui/dev/project/workflow-dag.png)
+  ![workflow-dag](../../../../img/new_ui/dev/project/workflow-dag.png)
 
-- 工具栏中拖拽 <img src="/img/tasks/icons/shell.png" width="15"/> 到画板中,新增一个Shell任务,如下图所示:
+- 工具栏中拖拽 <img src="../../../../img/tasks/icons/shell.png" width="15"/> 到画板中,新增一个Shell任务,如下图所示:
   
-  ![demo-shell-simple](/img/tasks/demo/shell.jpg)
+  ![demo-shell-simple](../../../../img/tasks/demo/shell.jpg)
   
 - **添加 Shell 任务的参数设置:**
 
@@ -22,15 +22,15 @@
 
 - **配置任务之间的依赖关系:** 点击任务节点的右侧加号连接任务;如下图所示,任务 Node_B 和任务 Node_C 并行执行,当任务 Node_A 执行完,任务 Node_B、Node_C 会同时执行。
 
-  ![workflow-dependent](/img/new_ui/dev/project/workflow-dependent.png)
+  ![workflow-dependent](../../../../img/new_ui/dev/project/workflow-dependent.png)
 
-- **删除依赖关系:** 点击右上角"箭头"图标<img src="/img/arrow.png" width="35"/>,选中连接线,点击右上角"删除"图标<img src="/img/delete.png" width="35"/>,删除任务间的依赖关系。
+- **删除依赖关系:** 点击右上角"箭头"图标<img src="../../../../img/arrow.png" width="35"/>,选中连接线,点击右上角"删除"图标<img src="../../../../img/delete.png" width="35"/>,删除任务间的依赖关系。
 
-  ![workflow-delete](/img/new_ui/dev/project/workflow-delete.png)
+  ![workflow-delete](../../../../img/new_ui/dev/project/workflow-delete.png)
 
 - **保存工作流定义:** 点击”保存“按钮,弹出"设置DAG图名称"弹框,如下图所示,输入工作流定义名称,工作流定义描述,设置全局参数(选填,参考[全局参数](../parameter/global.md)),点击"添加"按钮,工作流定义创建成功。
 
-  ![workflow-save](/img/new_ui/dev/project/workflow-save.png)
+  ![workflow-save](../../../../img/new_ui/dev/project/workflow-save.png)
 
   > 其他类型任务,请参考 [任务节点类型和参数设置](#TaskParamers)。 <!-- markdown-link-check-disable-line -->
 
@@ -38,7 +38,7 @@
 
 点击项目管理->工作流->工作流定义,进入工作流定义页面,如下图所示:
 
-![workflow-list](/img/new_ui/dev/project/workflow-list.png)
+![workflow-list](../../../../img/new_ui/dev/project/workflow-list.png)
 
 工作流定义列表的操作功能如下:
 
@@ -52,18 +52,18 @@
 - **下载:** 下载工作流定义到本地。
 - **树形图:** 以树形结构展示任务节点的类型及任务状态,如下图所示:
 
-![workflow-tree](/img/new_ui/dev/project/workflow-tree.png)
+![workflow-tree](../../../../img/new_ui/dev/project/workflow-tree.png)
 
 ## 运行工作流
 
-- 点击项目管理->工作流->工作流定义,进入工作流定义页面,如下图所示,点击"上线"按钮<img src="/img/online.png" width="35"/>,上线工作流。
+- 点击项目管理->工作流->工作流定义,进入工作流定义页面,如下图所示,点击"上线"按钮<img src="../../../../img/online.png" width="35"/>,上线工作流。
 
-![workflow-online](/img/new_ui/dev/project/workflow-online.png)
+![workflow-online](../../../../img/new_ui/dev/project/workflow-online.png)
 
 
 - 点击”运行“按钮,弹出启动参数设置弹框,如下图所示,设置启动参数,点击弹框中的"运行"按钮,工作流开始运行,工作流实例页面生成一条工作流实例。
 
-![workflow-run](/img/new_ui/dev/project/workflow-run.png)
+![workflow-run](../../../../img/new_ui/dev/project/workflow-run.png)
   
   工作流运行参数说明: 
        
@@ -75,31 +75,40 @@
   * 收件人:选择通知策略||超时报警||发生容错时,会发送流程信息或告警邮件到收件人列表。
   * 抄送人:选择通知策略||超时报警||发生容错时,会抄送流程信息或告警邮件到抄送人列表。
   * 启动参数: 在启动新的流程实例时,设置或覆盖全局参数的值。
-  * 补数:包括串行补数、并行补数 2 种模式。串行补数:指定时间范围内,从开始日期至结束日期依次执行补数,依次生成N条流程实例;并行补数:指定时间范围内,多天同时进行补数,同时生成 N 条流程实例。 
+  * 补数:包括串行补数、并行补数 2 种模式,日期可以通过选择或者手动进行输入。串行补数:指定时间范围内,从开始日期至结束日期依次执行补数,依次生成N条流程实例;并行补数:指定时间范围内,多天同时进行补数,同时生成 N 条流程实例。手动输入日期:手动输入以逗号分割日期格式为 `yyyy-MM-dd HH:mm:ss` 的日期。日期选择:通过前端选择日期。
+    * 依赖模式:是否触发下游依赖节点依赖到当前工作流的工作流实例的补数(要求当前补数的工作流实例的定时状态为已上线,只会触发下游直接依赖到当前工作流的补数)。
     * 补数: 执行指定日期的工作流定义,可以选择补数时间范围(当定时配置未上线时默认会根据所选时间范围进行每天一次的补数,如果定时配置已上线则会根据所选的时间范围结合定时配置进行补数),比如需要补 5 月 9 号到 5 月 10 号的数据,如下图所示: 
 
-    ![workflow-date](/img/new_ui/dev/project/workflow-date.png)
+    ![workflow-date](../../../../img/new_ui/dev/project/workflow-date.png)
 
-    > 串行模式:补数从 5 月 9 号到 5 月 10 号依次执行,依次在流程实例页面生成十条流程实例;
+    > 串行模式:补数从 5 月 9 号到 5 月 10 号依次执行,依次在流程实例页面生成两条流程实例;
 
-    > 并行模式:同时执行 5 月 9 号到 5 月 10 号的任务,同时在流程实例页面生成十条流程实例。
+    > 并行模式:同时执行 5 月 9 号到 5 月 10 号的任务,同时在流程实例页面生成两条流程实例。
+
+    * 补数: 通过手动输入补数时间(不依赖定时配置)完成工作流定义的补数。比如需要补 5 月 9 号到 5 月 10 号的数据,如下图所示:
+
+    ![workflow-date](../../../../img/new_ui/dev/project/workflow_date_manual.png)    
+
+    > 串行模式:补数从 5 月 9 号到 5 月 10 号依次执行,依次在流程实例页面生成两条流程实例;
+
+    > 并行模式:同时执行 5 月 9 号到 5 月 10 号的任务,同时在流程实例页面生成两条流程实例。
 
 ## 工作流定时
 
-- 创建定时:点击项目管理->工作流->工作流定义,进入工作流定义页面,上线工作流,点击"定时"按钮<img src="/img/timing.png" width="35"/>,弹出定时参数设置弹框,如下图所示:
+- 创建定时:点击项目管理->工作流->工作流定义,进入工作流定义页面,上线工作流,点击"定时"按钮<img src="../../../../img/timing.png" width="35"/>,弹出定时参数设置弹框,如下图所示:
 
-  ![workflow-time01](/img/new_ui/dev/project/workflow-time01.png)
+  ![workflow-time01](../../../../img/new_ui/dev/project/workflow-time01.png)
 
 - 选择起止时间。在起止时间范围内,定时运行工作流;不在起止时间范围内,不再产生定时工作流实例。
 - 添加一个每隔 5 分钟执行一次的定时,如下图所示:
 
-  ![workflow-time02](/img/new_ui/dev/project/workflow-time02.png)
+  ![workflow-time02](../../../../img/new_ui/dev/project/workflow-time02.png)
 
 - 失败策略、通知策略、流程优先级、Worker 分组、通知组、收件人、抄送人同工作流运行参数。
 - 点击"创建"按钮,创建定时成功,此时定时状态为"**下线**",定时需**上线**才生效。
-- 定时上线:点击"定时管理"按钮<img src="/img/timeManagement.png" width="35"/>,进入定时管理页面,点击"上线"按钮,定时状态变为"上线",如下图所示,工作流定时生效。
+- 定时上线:点击"定时管理"按钮<img src="../../../../img/timeManagement.png" width="35"/>,进入定时管理页面,点击"上线"按钮,定时状态变为"上线",如下图所示,工作流定时生效。
 
-  ![workflow-time03](/img/new_ui/dev/project/workflow-time03.png)
+  ![workflow-time03](../../../../img/new_ui/dev/project/workflow-time03.png)
 
 ## 导入工作流