流水线以自动化的方式完成代码扫描、人工卡点、数据测试、发布、通知等步骤，实现持续、高效的数据交付。一条流水线中可以包含多个节点，每个节点对应配置一个扩展程序。本文将为您介绍如何配置流水线。

约束限制 #

仅平台管理员或项目管理员具备管理流水线的全部权限，其他账号仅可查看流水线。

前提条件 #

已创建项目。

操作步骤 #

1. 登录DataLeap控制台。
2. 单击左侧导航栏的项目管理，进入项目列表展示页面。
3. 勾选我管理的选项，显示由您管理的项目列表。
4. 单击项目列表中要管理项目操作列的 ... > 流水线管理按钮，进入流水线管理页面。
   
5. 可查看当前项目下的所有流水线信息列表，并执行以下操作：

   • 新建流水线
     单击新建流水线按钮，进入新建流水线页面，设置相关信息后，单击保存按钮，完成流水线创建。
     新建流水线相关参数说明如下表所示。其中名称前带 * 的参数为必填参数，名称前未带 * 的参数为可选参数。

     参数	说明
     基础配置
     *名称	流水线的名称，自行设定。 名称支持中文、字母、数字或下划线，长度不超过50个字符。
     描述	流水线的描述信息，长度不超过200个字符。
     触发类型	触发流水线的实体类型，支持任务、发布包、数据回溯和临时查询四个选项，默认选中任务。
     触发事件	触发流水线的事件，即指某一个事件发生时，能够自动、定时或手动地去触发流水线的执行。 当触发类型为任务时，支持的触发事件为调试、提交、离线任务关闭，默认选中提交。 当触发类型为发布包时，支持的触发事件为发布。 当触发类型为数据回溯时，支持的触发事件为创建。 当触发类型为临时查询时，支持的触发事件为调试。
     触发对象	流水线的生效范围。 当触发类型为任务时，支持全部任务和部分任务两个选项，默认选择全部任务。 当触发类型为发布包时，支持全部发布包和部分发布包两个选项，默认选择全部发布包。 当触发类型为数据回溯时，支持全部回溯和部分回溯两个选项，默认选择全部回溯。 当触发类型为临时查询时，仅支持全部查询，默认选中。 当选择部分任务/发布包/回溯时，可设置以下触发对象，支持同时配置多个： 部分任务/发布包 优先级：等于或不等于某个优先级，支持选项 D1~D5，下拉可选，支持选择多个。 任务类型：等于或不等于某个任务类型，支持离线任务、流式任务等多个选项，下拉可选，支持选择多个。 任务目录：等于、不等于或包含某个目录，下拉可选已创建的任务目录，支持选择多个。 任务名称：等于或不等于某个任务名称，可输入任务名称关键词后下拉选择，支持选择多个。 责任人：等于或不等于某个任务责任人，可输入任务责任人关键词后下拉选择，支持选择多个。 标签：等于或不等于某个标签，可输入标签关键词后下拉选择，支持选择多个。 部分回溯 发起人：等于或不等于某个发起人，可输入任务责任人关键词后下拉选择，支持选择多个。 回溯范围：等于或不等于某个回溯范围，支持单任务、多任务等多个选项，下拉可选，支持选择多个。 说明 建议减少维度设置，以便流水线的触发判断。
     流水线超时	可设置是否流水线运行超时后即认定执行失败。 默认选择否，即不开启。 当选择是时，需设置超时时间，当流水线运行时长超过设置值，其状态将变为失败。
     是否开启	表示流水线当前所处状态，可选择是否开启该流水线，默认处于关闭状态。 开启：即代表该流水线会开启，流水线中配置的内容在符合条件的时候会自动触发。 关闭：即代表该流水线会关闭，符合条件的时候也不会触发该流水线的执行。
     触发后的交互方式	触发流水线后，系统展示提示信息的方式。支持以下两种交互方式设置： 页面右上角通知本次操作触发了流水线：默认选中。 自动弹窗展示本次操作触发的流水线详情。 说明 该配置项仅适用于单个任务触发流水线的场景。
     流程配置
     *选择扩展程序	要配置流程的扩展程序。可按全部、DataLeap官方和开发者自研分类展示当前支持的扩展程序，并选择一个扩展程序作为节点。 DataLeap官方：支持人工卡点、执行发布、触发调式、选择器四个扩展程序。 人工卡点：简单的人工卡点功能，支持设置审核方式和审核人。 执行发布：主要应用于发布流水线的场景，基于流水线的编排能力，实现发布前后的处理和规范校验等。 触发调试：触发任务调试，成功时返回调试实例 id。 选择器：当满足某个执行条件时会运行对应的分支。 开发者自研：暂不支持自行配置，若您要开发自己的扩展程序，请提工单联系我们！ 说明 流水线至少要配置一个节点。 鼠标悬停在节点上会显示新增、删除图标，可按需增删节点。 通过节点前、后、下方显示的图标⊕，可分别增加前后串行以及下方并行多个节点。 节点删除后，当前节点所有已配置的数据都将被清除。 当前的扩展程序均来自智能市场，可单击智能市场链接跳转到相应页面查看并管理所有扩展程序。
     扩展程序配置	选择扩展程序后，需配置以下信息： 扩展程序：显示选择的扩展程序，不可编辑。 显示名称：扩展程序将显示的名称，默认为扩展程序名称，可按需修改。 ID：该扩展程序的ID，自动生成，不可编辑。 功能配置：扩展程序的自定义参数。各扩展程序支持的自定义参数不同，相应配置请见下面对应的说明。 运维配置：可配置是否允许置成功，默认为否。当选择是时，需配置可置成功的人和置成功时段。 可置成功的人：支持项目管理员和指定人两个选项，可多选。 项目管理员：本项目的所有管理员均可操作，且其中任一人置成功后即可跳过。 触发人：设置后流水线触发人可操作。 指定人：输入用户名关键词后，下拉可选，支持设置多个。 值班计划：输入值班计划名称后，下拉可选，支持设置多个。 置成功时段：每天允许置成功的时段。
     流程配置-扩展程序配置-执行发布功能配置
     复查信息配置	执行发布扩展程序的复查信息URL，按实际输入，可设置多条信息。
     流程配置-扩展程序配置-人工卡点功能配置
     *方式	人工卡点扩展程序的审核方式，支持任一人通过和所有人通过两个选项，下拉可选。
     *审核人	人工卡点扩展程序的审核人。输入用户名关键词后，下拉可选，支持设置多个。
     描述	人工卡点扩展程序的描述信息，长度不超过200个字符。
     Webhooks	Webhook 请求地址，以 http 或 https 开头。
     流程配置-扩展程序配置-选择器功能配置
     *匹配顺序	选择器规则的执行顺序，支持串行匹配第一个规则和并行匹配所有规则两个选项。 串行匹配：只运行首个满足规则的分支。 并行匹配：运行所有满足规则的分支。
     *所有规则都不匹配	当所有规则均不匹配时，支持节点失败和节点跳过两种运行方式选项。 节点失败：所有规则不满足时，选择器状态置为“失败”。 节点跳过：所有规则不满足时，选择器状态置为“跳过”。
     *分支规则配置	选择器的分支规则设置情况，支持设置多个检测规则。 分支规则由布尔表达式构成，求值结果为true/false，具体配置说明请参考选择器扩展程序使用说明。
     变量配置
     参数名	全局变量的名称，格式为 context:params:Name，其中Name为用户手动设置的信息。 流水线提供的以下内置变量，也支持用户自定义变量。 context:params:doradoProjectId：当前开发项目ID，默认填充，不可编辑。 context:params:doradoProjectName：当前开发项目的名称，默认填充已设定的名称，不可编辑。 context:params:pipelineId：流水线ID context:params:pipelineName：流水线名称 context:params:executionId：流水线执行实例ID context:params:executionStatus：流水线执行实例运行状态 context:params:nodeExecutionId：流水线当前执行节点实例ID context:params:nodeName：流水线当前执行节点名称 context:params:nodeId：流水线当前执行节点ID context:params:preNodeExecutionId：流水线前序执行节点实例ID context:params:preNodeName：流水线前序执行节点名称 context:params:executionUrl：流水线实例执行地址 context:params:nodeToken：流水线当前执行节点Token context:params:triggerUser：流水线触发人 context:params:triggerTime：流水线触发时间 context:params:triggerEventId：流水线触发的事件ID context:params:triggerOperation：流水线触发的事件操作
     参数值	该参数的值，按需输入。
     描述	该参数的描述信息，按需填写，例如参数 context:params:doradoProjectId 的描述信息为项目ID。
     通知配置
     通知状态	指当流水线进入何种状态时需要接收通知，下拉可选以下状态，支持多选。 准备中 运行中 运行成功 警告 运行失败 手动终止 运行超时 等待中 手动置成功 跳过
     节点流转通知	可选择是否开启节点流转通知，默认关闭。 如果当流水线中运行的节点发生变化时需要接收通知，可以开启此配置。
     通知用户类型	接收通知的人员类型，支持流水线触发人和指定用户两个选项，可多选。 流水线触发人：触发流水线的人员。 指定用户：可输入项目人员账号关键词下拉选择，支持多选。 说明 当触发流水线通知后，消息会发送到用户绑定的邮箱中。
     通知用户	需要通知的用户，下拉可选流水线所属项目的成员，支持多选。 说明 当通知用户类型为指定用户时，可设置该参数。
     Webhook	通过Webhook地址接收通知，按实际输入，可设置多个。

   • 查看流水线详情
     单击列表中某条信息的流水线名称，可以查看该流水线的触发记录，并执行以下操作：

     • 单击某条运行记录，可查看该次触发的详情。在详情页面，单击流水线中的某个节点，可查看此节点的运行详情。

       说明

       对于未成功的节点，支持置成功操作；而对于等待中状态的节点，还支持通过、拒绝等操作。

     • 单击某条未到终态的运行记录操作列的终止按钮，终止该流水线。

   • 开启/关闭流水线
     单击列表中某条信息操作列的开启/关闭按钮，可以关闭/开启该流水线。

   • 编辑流水线
     单击列表中某条信息操作列的编辑按钮，可以修改该流水线的信息。

操作结果 #

流水线开启后，在数据开发平台执行以下操作时，即可触发相应的流水线检查。

• 当任务在调试或提交上线时，若触发了流水线，则系统给出相应提示并可在流水线触发记录中查看流水线执行情况。
• 当开发任务选择提交并发布，或者在发布中心创建发布包时，若触发了流水线，则系统给出相应提示并可在发布包列表看到流水线执行情况。
• 当执行临时查询时，若触发了流水线，则系统给出相应提示并可在流水线记录中看到流水线执行情况。