配置编译构建

  1. 单击[全部服务]图标,选择[企业应用/交付中心]菜单项。

  2. 单击左侧导航树中的[交付中心/持续交付]菜单项,进入交付管理页面。

  3. 单击左侧导航树中的[编译构建]菜单项,进入编辑构建管理页面。

  4. 单击[构建任务]页签,单击<新建编译构建>按钮,弹出配置页面。

  5. 配置名称和描述。单击<下一步>按钮。

  6. 单击<添加参数>和<添加步骤>按钮配置构建参数和步骤。您也可以单击配置页面右上角<从模板导入>,选择已创建的构建模板,以所选模板为基础配置参数和步骤。

    • PaaS平台提供了构建模板功能,您可以根据业务所需,使用平台内置模板,也可以自定义常用模板(参见管理模板中的“新建模板”,使用时直接选择,方便快捷。平台内置了五种构建模板,能够覆盖常用的编译构建方式。

      • npm项目构建镜像并上传到[软件仓库/镜像仓库]。

      • gradle项目构建镜像并上传到[软件仓库/镜像仓库]。

      • gradle项目构建Jar包并上传到[软件仓库/应用仓库]。

      • maven项目构建镜像并上传到[软件仓库/镜像仓库]。

      • maven项目构建Jar包并上传到[软件仓库/应用仓库]。

  7. 单击<确定>按钮,完成配置。

  8. 单击<运行>按钮,可直接运行编译构建任务。但本例中无需手动运行,待后续配置流水线任务随流水线运行。

构建参数

配置编译构建步骤中所需参数。

表-1 构建参数

参数

说明

参数名称

需要与步骤中的参数名称对应。例如镜像名称SERVICE_NAME,镜像版本BUILD_VERSION。

参数值

为选填,可以在后续运行流水线时设置。

参数类型

支持字符串类型的参数。

是否必填

选择该参数是否为必填项。

构建步骤

编译构建步骤可以根据需求添加,各步骤的参数说明如下:

代码检出

参数

说明

代码仓库

选择对接系统外平台中待编译构建的代码库及其分支/标签。

分支/标签

支持通过分支名、tag名和commitID匹配待检出的代码。

高级配置

  • 目标目录:设置构建环境中用于存放代码和运行数据的目录,默认为Jenkins工作空间的根目录。当同一个编译构建任务中存在两个代码检出任务时,设置不同路径,可避免数据重叠。

  • 超时时间:默认为10分钟,即超时未完成代码检出则任务失败,编译构建任务中止。

构建

参数

说明

构建环境类型

选择编译构建的环境,支持容器镜像和Jenkins固定节点两种。

说明:您可以根据业务所需,使用PaaS平台内置环境,也可以自定义(参见管理构建环境中的“新建构建环境”)构建环境。

操作系统

选择构建容器使用的操作系统。

构建类型

选择所需的构建类型。目前支持开发工具包为JDK1.8的三种构建类型:Gradle、SBT和Maven。

工具集合及版本

根据构建类型,选择适合的工具集合及版本。

命令选项

启动环境构建时需要执行的命令。

是否启用单元测试

  • 测试通过率:代码通过单元测试的概率高于此数值时,测试通过;低于此数值,则任务失败,编译构建任务中止。

  • 测试报告输出路径:单元测试报告的保存路径。如不填写,则保存在Gradle、Maven单元测试的默认路径。

说明:仅容器镜像类型的环境支持单元测试。

镜像构建

将代码构建为镜像。支持三种方式,一个“镜像构建”任务只能配置一种构建方式,如需配置多种方式,请添加多个“镜像构建”任务。

三种方式如下:

参数

说明

架构

支持构建X86和ARM架构的镜像,在构建镜像时请选择对应的架构。

Spring Boot工程

  • 构建包路径:构建生成的容器镜像在构建环境中的存放路径。

  • JVM参数:运行springboot程序需要设置的JVM参数。

  • 镜像名称:默认为${SERVICE_NAME}:${BUILD_VERSION},需与构建参数的名称一致。

  • 基础镜像:构建所需的基础镜像,默认为平台内置的包含java运行环境的基础镜像。您也可以输入[软件中心/镜像仓库]中的镜像地址。

通用前端工程

  • 前端资源文件夹:前端编译后的静态资源文件夹。

  • 镜像名称:默认为${SERVICE_NAME}:${BUILD_VERSION},需与构建参数的名称一致。

  • 基础镜像:构建所需的基础镜像,默认为平台内置的包含java运行环境的基础镜像。您也可以输入[软件中心/镜像仓库]中的镜像地址。

自定义

  • 前置脚本:用于准备镜像构建上下文的前置脚本内容。

  • 构建文件:请输入Dockerfile文件路径。

  • 构建上下文:请输入构建上下文目录路径。

  • 镜像名称:默认为${SERVICE_NAME}:${BUILD_VERSION},需与构建参数的名称一致。

发布容器镜像到软件中心

将已构建的容器镜像上传到软件中心-镜像仓库中,可以选择已有的项目和分类进行上传。

参数

说明

镜像仓库目标项目

选择已有的镜像所属项目。

镜像仓库目标分类

选择已有的镜像的分类。

从已构建的镜像中选择

选择已构建的镜像,即:对已构建的镜像进行升级或者替换。

输入镜像名称

若是新建镜像,此处请输入镜像名称。镜像名称默认为${SERVICE_NAME}:${BUILD_VERSION},即与“构建镜像”中的镜像名称一致。

发布软件包到软件中心

将编译构建后的软件包上传到软件中心-应用仓库。

参数

说明

软件包类型

可以选择jar包、war包或者helm包。关于软件包的介绍,具体可见【企业应用指南-软件中心-应用仓库-制作应用包】。

构建包路径

构建包放置路径,如不填写,默认为:target/*.jar,build/libs//*.jar。

软件包名称

编译构建后上传至软件仓库中的名称。

软件包版本

自定义软件包版本。

制作Helm包

将构建生成的镜像制作为Helm包。

参数

说明

选择镜像

默认为${SERVICE_NAME}:${BUILD_VERSION},即与“构建镜像"中的镜像名称一致。

输出路径

Helm包在构建环境中的保存路径,为app-pack/${SERVICE_NAME}-${BUILD_VERSION}.zip,不可修改。

配置模板

Helm包的制作需要在代码工程根路径下进行必要的配置并确保配置正确。单击<模板下载>,下载Helm包模板,参考压缩包中的[README]文件配置。

执行Pipeline脚本

Pipeline流式构建,支持构建任务脚本化。可以在此处输入编写好的pipeline脚本。

执行shell脚本

可以在此处输入需要执行的shell脚本。

执行Windows批处理脚本

可以在此处输入需要执行的Windows批处理脚本。