在多环境(开发、测试、生产)协作中,同一份 Pipeline 文件往往需要绑定各环境中不同的资源组、数据源和队列。部署参数把这些环境差异抽成 Key-Value:Pipeline 文件中引用参数 Key,发布时由目标项目 Profile 中的值完成替换并固化,实现"一份文件、多环境发布"。本文为您介绍如何创建并管理部署参数。
使用限制
- Profile 与参数均归属于当前项目,不支持跨项目共享或自动同步,多项目环境需分别维护。
- 同一 Profile 内 Key 唯一;部署参数与运行参数中的同名 Key 各自独立,不互相覆盖或回退。
- 项目新增或变更资源后,不会自动新增或修改部署参数,需手动执行"补充预置参数"。该操作只补充缺失项,不覆盖已有 Key 的值、分类与资源绑定,也不会恢复已删除的参数。
- 补充预置参数时,若建议 Key 已存在,则自动追加 1、2……后缀(取最小可用编号)。
- 部署参数不提供加密属性,敏感信息请使用支持加密的运行参数。
- 部署参数适合存放发布时即需确定的内容,例如计算/集成/调度资源组、引擎队列、数据源、执行身份、调度周期(Cron)、环境标识(env)等。需要在每次任务执行时动态变化的业务值,请使用运行参数。
前提条件
- 已准备相应项目,并具备参数配置、资源使用及发布权限。
- 各项目已绑定所需引擎、实例、队列、资源组和数据源。
新增部署参数
- 登录 DataLeap 控制台,进入 New IDE 项目平台。
- 选择项目管控 > 部署参数,进入部署参数管理页面。

- 若无所需的 Profile 和分类,可按需创建:
- 单击新建 Profile 按钮,在弹出的窗口中,输入 Profile 名称并保存,完成 Profile 创建。
- 选择 Profile 后,单击新建分类,输入分类名称后保存,可在该 Profile 下完成分类创建。
说明
- 同一项目下的 Profile 名称不可重复,同一 Profile 下的分类名称不可重复。
- 项目下含有系统内置的 Profile 为 default(默认),默认选中;Profile 下含有内置的分类,包括执行身份、资源组、数据源等。
- 在所选的 Profile 下,可通过以下方式新增部署参数:
说明
- 新增资源后,可按需手动补充预置参数。补充预置参数不会覆盖已有 Key 的值、分类或资源绑定;资源改名或重新绑定不会导致重复生成。
- 部署参数不提供加密属性配置,请勿在其中明文保存密码或访问密钥。
其他管理操作
管理 Profile
对手动创建的 Profile,可执行以下管理操作:
- 重命名 Profile
从 Profile 下拉框中选择指定 Profile 后,单击重命名按钮,可以修改该 Profile 的名称。 - 删除 Profile
从 Profile 下拉框中选择指定 Profile 后,单击删除 Profile 按钮,二次确认后,可删除该 Profile。删除后,该 Profile 下的分类和部署参数会被级联删除,历史审计记录仍保留。
说明
项目下含有系统内置的 Profile 为 default(默认),不支持编辑、删除。
管理参数分类
选择 Profile 后,可对该 Profile 下手动创建的分类进行以下管理操作:
- 从分类下拉框中选择指定分类后,单击重命名分类按钮,可以修改该分类的名称。
- 从分类下拉框中选择指定分类后,单击删除分类按钮,二次确认后,可删除该分类。删除后,该分类中的部署参数会被级联删除。
说明
Profile 下含有内置的分类,包括执行身份、资源组、数据源等,不支持编辑、删除。
管理部署参数
创建部署参数后,还可按需执行以下管理操作:
- 查询部署参数
可通过筛选和搜索,快速查找到指定的参数。
- 在 Profile 下拉框中选择指定 Profile,列表仅展示该 Profile 下的参数。
- 在分类下拉框中选择指定分类,列表仅展示当前 Profile 下该分类下的参数。
- 在 Key 前缀输入框中输入前缀关键字(可留空),单击查询,按 Key 前缀过滤列表。
- 编辑部署参数
单击某条信息的编辑按钮,可以修改该部署参数的配置信息。说明
修改部署参数后,需重新发布相关 Pipeline 才生效。
- 删除部署参数
单击某条信息的删除按钮,二次确认后,可以删除该部署参数。说明
- 删除只影响该条目,不会删除分类或 Profile。
- 删除参数不会删除真实资源,也不会影响已发布 Pipeline 的历史快照;但仍引用该 Key 的 Pipeline 再次发布时会报错。
后续操作
创建部署参数后,即可在配置 Pipeline 时按需引用。相关操作请参见使用部署参数进行 Pipeline 多环境发布、创建与编辑 Pipeline、Copy Data、Jar、SQL、Notebook等。