You need to enable JavaScript to run this app.
文档中心
大数据研发治理套件

大数据研发治理套件

复制全文
下载 pdf
部署参数
管理部署参数
复制全文
下载 pdf
管理部署参数

在多环境(开发、测试、生产)协作中,同一份 Pipeline 文件往往需要绑定各环境中不同的资源组、数据源和队列。部署参数把这些环境差异抽成 Key-Value:Pipeline 文件中引用参数 Key,发布时由目标项目 Profile 中的值完成替换并固化,实现"一份文件、多环境发布"。本文为您介绍如何创建并管理部署参数。

使用限制

  • Profile 与参数均归属于当前项目,不支持跨项目共享或自动同步,多项目环境需分别维护。
  • 同一 Profile 内 Key 唯一;部署参数与运行参数中的同名 Key 各自独立,不互相覆盖或回退。
  • 项目新增或变更资源后,不会自动新增或修改部署参数,需手动执行"补充预置参数"。该操作只补充缺失项,不覆盖已有 Key 的值、分类与资源绑定,也不会恢复已删除的参数。
  • 补充预置参数时,若建议 Key 已存在,则自动追加 1、2……后缀(取最小可用编号)。
  • 部署参数不提供加密属性,敏感信息请使用支持加密的运行参数。
  • 部署参数适合存放发布时即需确定的内容,例如计算/集成/调度资源组、引擎队列、数据源、执行身份、调度周期(Cron)、环境标识(env)等。需要在每次任务执行时动态变化的业务值,请使用运行参数。

前提条件

  • 已准备相应项目,并具备参数配置、资源使用及发布权限。
  • 各项目已绑定所需引擎、实例、队列、资源组和数据源。

新增部署参数

  1. 登录 DataLeap 控制台,进入 New IDE 项目平台。
  2. 选择项目管控 > 部署参数,进入部署参数管理页面。
    Image
  3. 若无所需的 Profile 和分类,可按需创建:
    • 单击新建 Profile 按钮,在弹出的窗口中,输入 Profile 名称并保存,完成 Profile 创建。
    • 选择 Profile 后,单击新建分类,输入分类名称后保存,可在该 Profile 下完成分类创建。

    说明

    • 同一项目下的 Profile 名称不可重复,同一 Profile 下的分类名称不可重复。
    • 项目下含有系统内置的 Profile 为 default(默认),默认选中;Profile 下含有内置的分类,包括执行身份、资源组、数据源等。
  4. 在所选的 Profile 下,可通过以下方式新增部署参数:
    • 手动新增
      单击新增部署参数按钮,在弹出的侧拉窗口中,设置相关信息后,单击新增按钮完成手动添加。

      参数

      说明

      Profile

      该参数所属的 Profile,默认填充页面中已选定的 Profile。此处不可编辑,可在 Profile 下拉框中切换。

      分类

      该参数所属的分类,下拉可选预置分类或自定义分类。

      • 预置分类:系统内置的参数分类,不可编辑、删除。
      • 自定义分类:手动创建的分类,可编辑、删除。

      Key

      参数名称,手动输入。同一 Profile 内唯一。

      说明

      当前 Profile 下存在同名 Key 时,将按 Upsert 语义更新该条目。

      Value

      直接输入参数值。

    • 补充预置参数

      1. 单击补充预置参数按钮,系统扫描当前项目已绑定的资源后,在弹出的窗口中,将显示当前 Profile 中缺少的项目资源参数列表。
        Image
      2. 勾选一条或多条要补充的参数后,单击添加所选参数按钮,完成部署参数添加。

    说明

    • 新增资源后,可按需手动补充预置参数。补充预置参数不会覆盖已有 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等。

最近更新时间:2026.11.06 14:18:37
这个页面对您有帮助吗?
有用
有用
无用
无用