配置编译构建

  1. 登录控制台首页,选择[产品与服务/企业应用/项目协作]菜单项,进入项目协作界面。

  1. 选择左边导航树的[项目协作/项目]菜单项,进入项目管理界面。

  1. 在界面右边窗口的项目列表中,单击选择需要编辑的项目,进入项目生命期界面。

  1. 选择“交付”页签,进入持续交付服务页面。

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

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

  1. 配置名称和描述,在下拉列表中选择所属项目,单击<下一步>按钮。

提示 此处的项目为【企业应用-项目协作】云服务中创建的项目,具体可参见:新建项目

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

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

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

构建参数

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

表-1 构建参数

参数

说明

显示名称

输入自定义名称。

参数名称

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

默认值

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

参数类型

支持字符串类型的参数。

是否必填

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

 

构建步骤

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

代码检出

参数

说明

代码仓库

选择对接系统外平台

对接代码库中待编译构建的代码库及其分支/标签。

分支/标签

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

高级配置

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

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

 

构建

参数

说明

构建环境类型

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

提示您可以根据业务所需,使用PaaS平台内置环境,也可以自定义(参见新建构建环境)构建环境。

操作系统

平台内置了操作系统为CentOS6.5、开发工具包为JDK1.8的三种构建环境(GradleSBTMaven),能够覆盖常见的构建环境。

构建类型

目前支持GradleSBTMaven三种类型。

工具集合及版本

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

命令选项

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

是否启用单元测试

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

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

提示仅容器镜像类型的环境支持单元测试。

 

镜像构建

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

三种方式如下:

参数

说明

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/*.jarbuild/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批处理脚本。