平台中心
首页 / 平台管理 / 工具链管理 / 工具链集成 / 快速部署并集成 / 构建节点

构建节点

构建节点用于扩展构建语言的种类和版本，用户可在各个构建节点中选择设置 构建缓存、挂载文件 和 构建节点资源 等操作。

查看构建节点详情

  1. 在左侧导航栏中，单击 工具链管理 > 工具链集成。

  2. 单击工具卡片。

  3. 单击 实例 右侧的 实例名称，进入部署详情页面。

  4. 在下方的 构建节点 区域，查看构建节点。

    • 在 平台默认 区域，展示了平台默认提供的构建节点。您可单击构建节点卡片，查看平台默认构建节点配置详情。

      提示：

      • 平台默认构建节点的 base 节点中包含两个容器：jnlp 容器和 tools 容器。

        • jnlp 容器：负责 Jenkins slave 与 Jenkins Master 连接的容器。

        • tools 容器：包含了流水线模板中用到的基本工具，例如 yq、jq、git、kubectl、docker、helm 等。

      • 其他平台默认构建语言节点默认继承 base 节点，即拥有 base 节点的两个容器所有功能。

    • 在 自定义 区域，展示了您自定义添加的构建节点，您可单击构建节点卡片，查看自定义构建节点配置详情。

      提示：其他自定义构建语言节点默认继承 base 节点，即拥有 base 节点的两个容器所有功能。

添加自定义构建节点

  1. 在 自定义 区域单击 添加构建节点，在弹出的 添加自定义构建节点 对话框中参考以下说明配置相关参数。

    • 名称：填写构建节点的名称，在创建流水线时，可在 流水线全局配置 或 环境配置 区域选择已创建的 构建节点 名称。

    • 在 容器 区域添加 一个 或 多个 构建节点容器。

      • 容器名：选择 或 输入 容器名，您输入的 容器名 将匹配集群资源中构建节点的容器名称，以便于在您使用相关语言构建时能调度与之对应的容器。

      • 镜像地址：手动输入构建节点使用的镜像地址。

      • 资源：创建构建节点时所需的资源，表单填写请参考如下表格。

        配置参数 参数说明
        CPU 资源请求 资源请求：工具运行时占用的最小资源。
        资源限制：工具运行时可以消耗的最大资源。
        CPU：核（core）、m（millicore），1 核 = 1000 m。
        内存：Mi（1 MiB = 220 bytes）、Gi（1 GiB = 230 bytes）,1 Gi = 210 Mi。
        CPU 资源限制
        内存资源请求
        内存资源限制

    • 保密字典：选择 一个 或 多个 已创建的保密字典。若保密字典列表中没有可以用的，可单击 添加保密字典，创建 镜像服务 类型的保密字典，参考 创建凭据 。

    • 主机选择器：选择主机的标签。主机选择器 可用于过滤、筛选包含所有选中的标签的主机。支持通过单击下拉选择框选择多个主机标签，同时，在下拉框中输入标签名称可对主机标签进行模糊搜索。

      提示：

      • 在选择主机标签时，下拉框下方会实时给出提示，显示符合要求的主机个数。

      • 键相同的标签，仅可选中其中一个（选中多个时，将不会有符合条件的主机）。

    • 构建缓存：添加构建缓存可复用构建过程中下载的依赖包，缩短构建时间，单击 添加 后填写如下表单。

      • 存储：支持选择 Persistent Volume Claim 和 Host Path Volume。
        若您选择 Persistent Volume Claim，须同时在 PVC 名称 框中选择资源中已存在的 PVC 名称。
        若您选择 Host Path Volume，须同时在 主机路径 框中选择资源中已存在的 主机路径。

      • 挂载路径：支持选择 Maven 缓存、Go 缓存 和 自定义。
        若选择 Maven 缓存、Go 缓存，则路径为默认值且无法修改。
        若选择 自定义，您须在右侧框中填写 挂载路径。

    • 环境变量：设置构建节点的环境变量，在构建过程中使用。单击 添加 按钮，输入环境变量的 键值对。

    • 挂载文件：添加一个或多个文件，挂载至构建节点的容器中，使用此构建节点的流水线都可访问您添加的文件。

      • 类型：支持选择 npm、maven 和 其他文件 类型。

      • 路径：根据选择的类型填写挂载文件的路径。

        提示：不同挂载文件的路径不可重复，且该挂载目录将变成只读权限。建议挂载目录不要挂载在特殊目录下，例如根目录等。

      • 文件名：挂载文件的名称。

      • 内容：挂载文件的内容。

  2. 单击 添加，完成添加自定义构建节点。

更新构建节点

  1. 在 Jenkins 部署详情页的 构建节点 区域，单击待更新构建节点的卡片，进入 构建节点详情 页。

  2. 在 构建节点详情 页单击 更新构建节点 按钮，进入更新构建节点页面。

  3. 在更新构建节点页面，填写表单，表单参数请参考 添加自定义构建节点。

  4. 单击 更新，完成更新构建节点。

删除构建节点

注意：平台默认构建节点不支持删除操作。

  1. 在 Jenkins 部署详情页的 自定义 构建节点区域，单击待删除自定义构建节点的卡片，进入 构建节点详情 页。

  2. 在 构建节点详情 页左下角单击 删除此构建节点 按钮。

  3. 单击 确定。