Apache DolphinScheduler 项目管理实战指南创建项目、工作组授权与项目首页统计解读【免费下载链接】dolphinschedulerApache DolphinScheduler is the modern data orchestration platform. Agile to create high performance workflow with low-code项目地址: https://gitcode.com/GitHub_Trending/dol/dolphinscheduler导读本文基于 Apache DolphinScheduler 官方《项目管理》文档系统讲解项目生命周期中最核心的三个操作创建项目、项目工作组授权以及项目首页状态统计。作为数据编排平台DolphinScheduler 以项目为逻辑隔离与权限边界所有工作流Workflow定义、任务实例与调度配置都隶属于某个项目。读完本文你将掌握项目创建的完整流程与校验规则、工作组授权的前后端实现原理以及项目首页三类统计指标任务实例状态、工作流实例状态、工作流定义统计背后的数据口径与状态机含义。一、项目管理在 DolphinScheduler 中的定位在 DolphinScheduler 中项目是组织数据编排任务的基本单元。一个项目可以包含多个工作流定义DAG每个工作流定义可以多次运行产生工作流实例而每个工作流实例又由若干任务实例组成。项目的核心价值体现在资源隔离不同项目的工作流、任务、调度配置相互独立权限控制项目创建者Owned User拥有项目操作权限管理员可进行跨项目的工作组授权统计聚合项目首页按时间范围聚合该项目下所有任务实例与工作流实例的状态分布。在 Web 界面中项目相关功能统一收纳在顶部的Project菜单下对应的前端源码位于 项目管理列表页项目首页统计位于 项目概览页。二、创建项目2.1 操作步骤登录 DolphinScheduler Web UI 后点击顶部导航的项目管理进入项目列表页面点击列表左上角的创建项目按钮对应前端btn-create-project按钮见 列表页源码在弹出的对话框中依次填写项目名称必填项目唯一标识不能与已有项目重名所属用户必填默认自动填入当前登录用户名且该输入框为只读disabled即项目创建者固定为当前操作用户项目描述选填补充项目用途说明点击提交完成创建。创建弹窗的表单实现位于 project-modal.tsx其中Owned Users字段通过disabled{true}锁定为当前登录用户Project Name与Owned Users均为必填校验项未填写时确认按钮会被禁用confirmDisabled{!this.model.projectName || !this.model.userName}。DolphinScheduler 创建项目弹窗项目名称与所属用户为必填项所属用户自动带出当前登录用户下方项目列表展示了所有已创建项目及其状态概览。2.2 前端表单校验与提交逻辑前端表单通过 use-form.ts 管理。提交时先经过 Naive UI 的validate校验项目名称、用户名非空校验通过后调用接口新建项目statusRef 0调用createProject(variables.model)编辑项目statusRef 1调用updateProject(variables.model, props.row.code)。其中row.code是项目的全局唯一编码Code由后端在创建时生成前端列表页以它为路由参数跳转项目首页见 use-table.ts。2.3 后端创建逻辑与校验规则创建项目的后端入口是 ProjectServiceImpl.createProject其执行流程如下描述长度校验checkDesc方法校验项目描述长度超过 255 个字符codePointCount 255会返回DESCRIPTION_TOO_LONG_ERROR权限校验通过canOperatorPermissions(loginUser, null, AuthorizationType.PROJECTS, PROJECT_CREATE)校验当前用户是否具备项目创建权限否则返回USER_NO_OPERATION_PERM重名校验调用projectDao.queryByName(name)检查项目名称是否已存在若存在返回PROJECT_ALREADY_EXISTS生成项目实体通过CodeGenerateUtils.genCode()生成项目唯一编码并将创建者 ID 与用户名写入项目记录落库projectDao.insert(project)成功返回项目数据失败返回CREATE_PROJECT_ERROR。整个创建过程由Transactional注解保证事务性。可见项目名称不仅是展示字段更是业务层的唯一性约束键。2.4 项目列表页的其他能力项目列表页use-table.ts还提供了与创建相关的配套操作搜索支持按项目名称关键字模糊搜索并分页刷新每页 10/30/50 条可切换编辑管理员或项目所属用户可修改项目名称与描述删除通过deleteProject(row.code)删除项目删除前有二次确认NPopconfirm工作组授权仅管理员userType ADMIN_USER可见工作组授权按钮点击后打开工作组授权弹窗项目名称链接点击项目名称跳转到/projects/${row.code}即进入该项目首页。三、项目工作组授权3.1 为什么要做工作组授权DolphinScheduler 中任务实际由Worker节点执行多个 Worker 节点可以组成一个逻辑上的工作组Worker Group用于将任务调度到特定的机器集群例如区分不同的资源池或环境。默认情况下项目可以访问所有工作组但在多租户或资源隔离场景下需要限制某个项目只能将任务提交到指定的工作组。项目工作组授权正是为满足这一需求而设计授权成功后该项目的工作流只能在其被分配的工作组上运行。3.2 操作步骤在项目管理页面找到目标项目所在行点击操作列中的工作组授权按钮仅管理员可见在弹出的授权弹窗中左侧为系统所有可用的工作组列表Transfer 穿梭框右侧为该项目当前已授权的工作组勾选需要分配的工作组点击分配WorkerGroup确认提交。弹窗实现见 worker-group-modal.tsx核心是一个NTransfer穿梭框组件数据加载逻辑在 use-worker-group.ts打开弹窗时调用queryAllWorkerGroups()加载系统全部工作组作为可选项调用queryWorkerGroupsByProjectCode(projectCode)加载该项目已分配的工作组提交时通过assignWorkerGroups(data, row.code)发送workerGroups以逗号分隔的字符串形式提交。3.3 后端授权实现原理后端授权接口位于 ProjectWorkerGroupRelationServiceImpl.assignWorkerGroupsToProject其处理逻辑体现了较强的健壮性设计管理员校验isAdmin(loginUser)不通过直接返回USER_NO_OPERATION_PERM因此该操作严格限定为管理员项目校验projectCode为空或项目不存在时返回PROJECT_NOT_EXIST清空授权的保护当提交的工作组列表为空即取消全部授权时会先通过getAllUsedWorkerGroups(project)检查这些工作组是否正被项目内任务实例、调度任务使用若仍在被使用则抛出USED_WORKER_GROUP_EXISTS异常避免误删导致任务无法调度存在性校验将待授权工作组与系统全部工作组求差集若存在系统内不存在的组名则返回WORKER_GROUP_NOT_EXIST差集计算与增量更新needDeletedWorkerGroups 项目已有授权 − 本次提交同样受正在使用不可删除保护后批量删除needAssignedWorkerGroups 本次提交 − 项目已有授权逐条构建ProjectWorkerGroup关系并插入project_worker_group表。这种求差集、增量变更的实现方式使得授权操作天然幂等重复提交相同的授权列表不会产生重复记录也不会误伤无关的工作组关系。四、项目首页4.1 进入项目首页在项目管理页面点击项目名称链接即可进入该项目首页前端路由/projects/${row.code}。项目首页本质上是一个面向该项目的运行监控仪表盘布局与组件实现见 overview/index.tsx由三张统计卡片组成任务实例状态统计、工作流实例状态统计、工作流定义统计并支持通过顶部日期选择器切换统计时间范围默认统计从当天 00:00:00 到当前时刻。项目首页概览左侧为任务实例状态统计环形图 明细列表右侧为工作流实例状态统计底部为按用户聚合的工作流定义统计柱状图。4.2 任务实例状态统计含义在指定时间范围内统计该项目下所有任务实例中各状态的个数。统计口径覆盖以下状态提交成功SUBMITTED_SUCCESS、正在运行RUNNING_EXECUTION、准备暂停READY_PAUSE、暂停PAUSE、准备停止READY_STOP、停止STOP、失败FAILURE、成功SUCCESS、需要容错NEED_FAULT_TOLERANCE、killKILL、等待线程WAITING_THREAD。前端通过 use-task-state.ts 调用countTaskState接口将返回的taskInstanceStatusCounts同时渲染为表格和环形图。对应后端接口为 DataAnalysisController.getTaskInstanceStateCount映射GET /projects/analysis/task-state-count可传startDate、endDate、projectCode三个参数不传projectCode时统计当前用户可见的所有项目。状态定义参考任务状态枚举定义在 TaskExecutionStatus其中NEED_FAULT_TOLERANCE表示任务实例所在 Worker 节点宕机后处于待容错状态需要在 Master 进行故障转移KILL表示任务被主动终止。4.3 工作流实例状态统计含义在指定时间范围内统计该项目下所有工作流实例中各状态的个数统计状态与任务实例状态基本一致。对应后端接口为 DataAnalysisController.getWorkflowInstanceStateCount映射GET /projects/analysis/workflow-state-count。状态定义参考工作流状态枚举定义在 WorkflowExecutionStatus每个状态还携带了可供停canStop、可暂停canPause、是否终态finalState、是否需要容错needFailover等行为属性。例如SUBMITTED_SUCCESS工作流已提交但尚未真正执行RUNNING_EXECUTION正在运行READY_PAUSE/PAUSE已发起暂停请求 / 已暂停READY_STOP/STOP已发起停止请求 / 已停止FAILURE执行失败SUCCESS执行成功FAILOVERMaster 故障后处于容错转移状态。这些准备态READY_PAUSE / READY_STOP属于非终态的过渡状态例如工作流暂停后其下游任务实例也会在 TaskInstanceDaoImpl 中联动处理。4.4 工作流定义统计含义统计当前项目下工作流定义的归属分布包括用户自己创建的工作流定义以及管理员授予该用户该用户有权限的工作流定义并按用户维度聚合展示。对应后端接口为 DataAnalysisController.countDefinitionByUser映射GET /projects/analysis/define-user-count。前端在 definition-card.tsx 中以柱状图形式渲染横轴为工作流定义所属用户纵轴为定义数量。该指标能从定义层面反映项目内容的创建活跃度与权限授权范围与前面两个基于实例运行态的统计互为补充。4.5 三个指标的联动视角任务实例、工作流实例、工作流定义三者构成了定义 → 实例 → 任务的完整观测链路工作流定义统计回答项目里有哪些工作流、分别归谁所有工作流实例状态统计回答这些工作流实际跑得怎么样任务实例状态统计回答构成工作流的每个任务节点的执行情况。当某个工作流实例处于失败状态时可以顺着项目首页 → 工作流实例列表 → 任务实例列表逐层下钻定位到具体失败任务与日志这也是项目管理入口在实际排障中的典型用法。五、与项目权限模型相关的延伸从项目管理页面的源码可以进一步推断其权限模型创建项目需要PROJECT_CREATE权限见ProjectServiceImpl.createProject中的canOperatorPermissions校验编辑/删除项目前端列表页中编辑按钮对所有项目可见删除与工作组授权按钮仅对管理员ADMIN_USER可见后端删除接口同样有管理员校验工作组授权严格限管理员且受工作组正在被使用则不可移除的保护USED_WORKER_GROUP_EXISTS。若需深入学习项目权限的完整实现可继续阅读 dolphinscheduler-api 下ProjectController、ProjectServiceImpl以及ProjectWorkerGroupRelationServiceImpl的完整代码与配套测试用例。六、常见问题与注意事项项目名称可以重复吗不可以。后端createProject通过projectDao.queryByName做唯一性校验重复创建会返回项目已存在错误。为什么所属用户输入框是灰色的创建项目的所属用户固定为当前登录用户这是权限归属的硬性绑定因此前端将其设置为只读。工作组授权只有管理员能看到按钮吗是的。前端通过IS_ADMIN判断按钮可见性use-table.ts后端也强制校验管理员身份双重保障。取消所有工作组授权安全吗后端会先检测这些工作组是否正被项目内任务或调度使用若在使用中则拒绝操作确保不会因为误操作导致任务失去可用的执行环境。项目首页统计的时间范围如何设定通过页面顶部日期选择器设定起止时间默认范围为当天零点至当前时刻两个实例统计卡片的日期切换相互独立。通过本文的操作指引与源码剖析你可以完整掌握 DolphinScheduler 项目的创建、授权与监控全流程为后续在项目中编排工作流、配置调度和执行任务打下基础。建议结合 dolphinscheduler-ui 的前端代码与 dolphinscheduler-api 的后端实现边看边练深入理解项目管理这一核心模块的运作机制。【免费下载链接】dolphinschedulerApache DolphinScheduler is the modern data orchestration platform. Agile to create high performance workflow with low-code项目地址: https://gitcode.com/GitHub_Trending/dol/dolphinscheduler创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Apache DolphinScheduler 项目管理实战指南创建项目、工作组授权与项目首页统计解读【免费下载链接】dolphinschedulerApache DolphinScheduler is the modern data orchestration platform. Agile to create high performance workflow with low-code项目地址: https://gitcode.com/GitHub_Trending/dol/dolphinscheduler导读本文基于 Apache DolphinScheduler 官方《项目管理》文档系统讲解项目生命周期中最核心的三个操作创建项目、项目工作组授权以及项目首页状态统计。作为数据编排平台DolphinScheduler 以项目为逻辑隔离与权限边界所有工作流Workflow定义、任务实例与调度配置都隶属于某个项目。读完本文你将掌握项目创建的完整流程与校验规则、工作组授权的前后端实现原理以及项目首页三类统计指标任务实例状态、工作流实例状态、工作流定义统计背后的数据口径与状态机含义。一、项目管理在 DolphinScheduler 中的定位在 DolphinScheduler 中项目是组织数据编排任务的基本单元。一个项目可以包含多个工作流定义DAG每个工作流定义可以多次运行产生工作流实例而每个工作流实例又由若干任务实例组成。项目的核心价值体现在资源隔离不同项目的工作流、任务、调度配置相互独立权限控制项目创建者Owned User拥有项目操作权限管理员可进行跨项目的工作组授权统计聚合项目首页按时间范围聚合该项目下所有任务实例与工作流实例的状态分布。在 Web 界面中项目相关功能统一收纳在顶部的Project菜单下对应的前端源码位于 项目管理列表页项目首页统计位于 项目概览页。二、创建项目2.1 操作步骤登录 DolphinScheduler Web UI 后点击顶部导航的项目管理进入项目列表页面点击列表左上角的创建项目按钮对应前端btn-create-project按钮见 列表页源码在弹出的对话框中依次填写项目名称必填项目唯一标识不能与已有项目重名所属用户必填默认自动填入当前登录用户名且该输入框为只读disabled即项目创建者固定为当前操作用户项目描述选填补充项目用途说明点击提交完成创建。创建弹窗的表单实现位于 project-modal.tsx其中Owned Users字段通过disabled{true}锁定为当前登录用户Project Name与Owned Users均为必填校验项未填写时确认按钮会被禁用confirmDisabled{!this.model.projectName || !this.model.userName}。DolphinScheduler 创建项目弹窗项目名称与所属用户为必填项所属用户自动带出当前登录用户下方项目列表展示了所有已创建项目及其状态概览。2.2 前端表单校验与提交逻辑前端表单通过 use-form.ts 管理。提交时先经过 Naive UI 的validate校验项目名称、用户名非空校验通过后调用接口新建项目statusRef 0调用createProject(variables.model)编辑项目statusRef 1调用updateProject(variables.model, props.row.code)。其中row.code是项目的全局唯一编码Code由后端在创建时生成前端列表页以它为路由参数跳转项目首页见 use-table.ts。2.3 后端创建逻辑与校验规则创建项目的后端入口是 ProjectServiceImpl.createProject其执行流程如下描述长度校验checkDesc方法校验项目描述长度超过 255 个字符codePointCount 255会返回DESCRIPTION_TOO_LONG_ERROR权限校验通过canOperatorPermissions(loginUser, null, AuthorizationType.PROJECTS, PROJECT_CREATE)校验当前用户是否具备项目创建权限否则返回USER_NO_OPERATION_PERM重名校验调用projectDao.queryByName(name)检查项目名称是否已存在若存在返回PROJECT_ALREADY_EXISTS生成项目实体通过CodeGenerateUtils.genCode()生成项目唯一编码并将创建者 ID 与用户名写入项目记录落库projectDao.insert(project)成功返回项目数据失败返回CREATE_PROJECT_ERROR。整个创建过程由Transactional注解保证事务性。可见项目名称不仅是展示字段更是业务层的唯一性约束键。2.4 项目列表页的其他能力项目列表页use-table.ts还提供了与创建相关的配套操作搜索支持按项目名称关键字模糊搜索并分页刷新每页 10/30/50 条可切换编辑管理员或项目所属用户可修改项目名称与描述删除通过deleteProject(row.code)删除项目删除前有二次确认NPopconfirm工作组授权仅管理员userType ADMIN_USER可见工作组授权按钮点击后打开工作组授权弹窗项目名称链接点击项目名称跳转到/projects/${row.code}即进入该项目首页。三、项目工作组授权3.1 为什么要做工作组授权DolphinScheduler 中任务实际由Worker节点执行多个 Worker 节点可以组成一个逻辑上的工作组Worker Group用于将任务调度到特定的机器集群例如区分不同的资源池或环境。默认情况下项目可以访问所有工作组但在多租户或资源隔离场景下需要限制某个项目只能将任务提交到指定的工作组。项目工作组授权正是为满足这一需求而设计授权成功后该项目的工作流只能在其被分配的工作组上运行。3.2 操作步骤在项目管理页面找到目标项目所在行点击操作列中的工作组授权按钮仅管理员可见在弹出的授权弹窗中左侧为系统所有可用的工作组列表Transfer 穿梭框右侧为该项目当前已授权的工作组勾选需要分配的工作组点击分配WorkerGroup确认提交。弹窗实现见 worker-group-modal.tsx核心是一个NTransfer穿梭框组件数据加载逻辑在 use-worker-group.ts打开弹窗时调用queryAllWorkerGroups()加载系统全部工作组作为可选项调用queryWorkerGroupsByProjectCode(projectCode)加载该项目已分配的工作组提交时通过assignWorkerGroups(data, row.code)发送workerGroups以逗号分隔的字符串形式提交。3.3 后端授权实现原理后端授权接口位于 ProjectWorkerGroupRelationServiceImpl.assignWorkerGroupsToProject其处理逻辑体现了较强的健壮性设计管理员校验isAdmin(loginUser)不通过直接返回USER_NO_OPERATION_PERM因此该操作严格限定为管理员项目校验projectCode为空或项目不存在时返回PROJECT_NOT_EXIST清空授权的保护当提交的工作组列表为空即取消全部授权时会先通过getAllUsedWorkerGroups(project)检查这些工作组是否正被项目内任务实例、调度任务使用若仍在被使用则抛出USED_WORKER_GROUP_EXISTS异常避免误删导致任务无法调度存在性校验将待授权工作组与系统全部工作组求差集若存在系统内不存在的组名则返回WORKER_GROUP_NOT_EXIST差集计算与增量更新needDeletedWorkerGroups 项目已有授权 − 本次提交同样受正在使用不可删除保护后批量删除needAssignedWorkerGroups 本次提交 − 项目已有授权逐条构建ProjectWorkerGroup关系并插入project_worker_group表。这种求差集、增量变更的实现方式使得授权操作天然幂等重复提交相同的授权列表不会产生重复记录也不会误伤无关的工作组关系。四、项目首页4.1 进入项目首页在项目管理页面点击项目名称链接即可进入该项目首页前端路由/projects/${row.code}。项目首页本质上是一个面向该项目的运行监控仪表盘布局与组件实现见 overview/index.tsx由三张统计卡片组成任务实例状态统计、工作流实例状态统计、工作流定义统计并支持通过顶部日期选择器切换统计时间范围默认统计从当天 00:00:00 到当前时刻。项目首页概览左侧为任务实例状态统计环形图 明细列表右侧为工作流实例状态统计底部为按用户聚合的工作流定义统计柱状图。4.2 任务实例状态统计含义在指定时间范围内统计该项目下所有任务实例中各状态的个数。统计口径覆盖以下状态提交成功SUBMITTED_SUCCESS、正在运行RUNNING_EXECUTION、准备暂停READY_PAUSE、暂停PAUSE、准备停止READY_STOP、停止STOP、失败FAILURE、成功SUCCESS、需要容错NEED_FAULT_TOLERANCE、killKILL、等待线程WAITING_THREAD。前端通过 use-task-state.ts 调用countTaskState接口将返回的taskInstanceStatusCounts同时渲染为表格和环形图。对应后端接口为 DataAnalysisController.getTaskInstanceStateCount映射GET /projects/analysis/task-state-count可传startDate、endDate、projectCode三个参数不传projectCode时统计当前用户可见的所有项目。状态定义参考任务状态枚举定义在 TaskExecutionStatus其中NEED_FAULT_TOLERANCE表示任务实例所在 Worker 节点宕机后处于待容错状态需要在 Master 进行故障转移KILL表示任务被主动终止。4.3 工作流实例状态统计含义在指定时间范围内统计该项目下所有工作流实例中各状态的个数统计状态与任务实例状态基本一致。对应后端接口为 DataAnalysisController.getWorkflowInstanceStateCount映射GET /projects/analysis/workflow-state-count。状态定义参考工作流状态枚举定义在 WorkflowExecutionStatus每个状态还携带了可供停canStop、可暂停canPause、是否终态finalState、是否需要容错needFailover等行为属性。例如SUBMITTED_SUCCESS工作流已提交但尚未真正执行RUNNING_EXECUTION正在运行READY_PAUSE/PAUSE已发起暂停请求 / 已暂停READY_STOP/STOP已发起停止请求 / 已停止FAILURE执行失败SUCCESS执行成功FAILOVERMaster 故障后处于容错转移状态。这些准备态READY_PAUSE / READY_STOP属于非终态的过渡状态例如工作流暂停后其下游任务实例也会在 TaskInstanceDaoImpl 中联动处理。4.4 工作流定义统计含义统计当前项目下工作流定义的归属分布包括用户自己创建的工作流定义以及管理员授予该用户该用户有权限的工作流定义并按用户维度聚合展示。对应后端接口为 DataAnalysisController.countDefinitionByUser映射GET /projects/analysis/define-user-count。前端在 definition-card.tsx 中以柱状图形式渲染横轴为工作流定义所属用户纵轴为定义数量。该指标能从定义层面反映项目内容的创建活跃度与权限授权范围与前面两个基于实例运行态的统计互为补充。4.5 三个指标的联动视角任务实例、工作流实例、工作流定义三者构成了定义 → 实例 → 任务的完整观测链路工作流定义统计回答项目里有哪些工作流、分别归谁所有工作流实例状态统计回答这些工作流实际跑得怎么样任务实例状态统计回答构成工作流的每个任务节点的执行情况。当某个工作流实例处于失败状态时可以顺着项目首页 → 工作流实例列表 → 任务实例列表逐层下钻定位到具体失败任务与日志这也是项目管理入口在实际排障中的典型用法。五、与项目权限模型相关的延伸从项目管理页面的源码可以进一步推断其权限模型创建项目需要PROJECT_CREATE权限见ProjectServiceImpl.createProject中的canOperatorPermissions校验编辑/删除项目前端列表页中编辑按钮对所有项目可见删除与工作组授权按钮仅对管理员ADMIN_USER可见后端删除接口同样有管理员校验工作组授权严格限管理员且受工作组正在被使用则不可移除的保护USED_WORKER_GROUP_EXISTS。若需深入学习项目权限的完整实现可继续阅读 dolphinscheduler-api 下ProjectController、ProjectServiceImpl以及ProjectWorkerGroupRelationServiceImpl的完整代码与配套测试用例。六、常见问题与注意事项项目名称可以重复吗不可以。后端createProject通过projectDao.queryByName做唯一性校验重复创建会返回项目已存在错误。为什么所属用户输入框是灰色的创建项目的所属用户固定为当前登录用户这是权限归属的硬性绑定因此前端将其设置为只读。工作组授权只有管理员能看到按钮吗是的。前端通过IS_ADMIN判断按钮可见性use-table.ts后端也强制校验管理员身份双重保障。取消所有工作组授权安全吗后端会先检测这些工作组是否正被项目内任务或调度使用若在使用中则拒绝操作确保不会因为误操作导致任务失去可用的执行环境。项目首页统计的时间范围如何设定通过页面顶部日期选择器设定起止时间默认范围为当天零点至当前时刻两个实例统计卡片的日期切换相互独立。通过本文的操作指引与源码剖析你可以完整掌握 DolphinScheduler 项目的创建、授权与监控全流程为后续在项目中编排工作流、配置调度和执行任务打下基础。建议结合 dolphinscheduler-ui 的前端代码与 dolphinscheduler-api 的后端实现边看边练深入理解项目管理这一核心模块的运作机制。【免费下载链接】dolphinschedulerApache DolphinScheduler is the modern data orchestration platform. Agile to create high performance workflow with low-code项目地址: https://gitcode.com/GitHub_Trending/dol/dolphinscheduler创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
