文档首页 > > 用户指南> 构建任务>

新建构建任务

新建构建任务

分享
更新时间:2021/04/07 GMT+08:00

前提准备

配置基本信息

  1. 登录DevCloud首页。
  2. 在顶部导航栏单击服务 > 编译构建,进入编译构建服务。
  3. 单击“新建任务”,进入“基本信息”页面,请根据表1填写基本信息。
    表1 基本信息

    参数项

    描述

    任务名称

    任务的名称。

    归属项目

    任务所属项目。

    构建环境主机类型

    包括两种类型:“x86服务器”“鲲鹏(ARM)服务器”

    在不同芯片架构上运行的软件,需要选择对应的环境主机。请根据需要选择对应主机,如软件最终在鲲鹏服务器上运行,则选择鲲鹏服务器,示例参考

    任务描述

    展开“高级设置”,单击“添加描述”,对任务进行描述。

    执行主机

    展开“高级设置”,选择执行机。

    • 默认执行机:默认使用平台提供的公共执行资源。
    • 自定义执行机:选择代理资源池,通过资源池,用户可以拥有自己的执行资源,在执行任务时,可以选择自己通过代理接入的执行机执行任务。

选择代码源

  1. 配置完基本信息,单击“下一步”,进入“选择代码源”页面。
  2. 请根据需要选择代码源,并配置对应源码源信息。
    表2 选择代码源

    代码源

    描述

    Codehub

    编译构建服务默认从代码托管拉取代码构建,请选择已经创建的代码仓库及分支。

    GitHub

    对于托管在GitHub上的代码,可以使用GitHub连接实现代码拉取,详见使用GitHub仓库构建

    通用Git

    对于托管在其他服务上的代码,可以使用通用Git连接实现代码拉取,详见使用通用Git构建

    码云

    对于托管在码云上的代码,可以使用码云连接实现代码拉取,详见使用码云仓库构建

    来自流水线

    源码源如果选择来自流水线,则只能通过流水线驱动执行,不能单独执行。

    其中,Codehub代码源和通用Git代码源可选择使用指定代码仓库Tag或CommitID构建,展开高级设置即可配置。
    • 指定Tag构建

      Tag是指代码仓库中的标签,关于如何创建Tag请参见代码托管-标签管理

      在编译构建任务中,可以通过指定Tag来使用历史版本代码进行构建。

      1. 选择“指定Tag构建”,输入克隆深度,保存任务。

        克隆深度是指距离最近一次提交之间的提交次数,该值越大,检出代码的时间越长。深度为正整数,推荐最大深度为25。

        例如:克隆深度输入5,那么在执行任务时,参数“Tag”填写距离最近提交的前5个标签名中的任意一个都可以。

      2. 执行任务时,会出现弹窗,按需要输入Tag值,单击“确定”,即可启动任务执行。

          

    • 指定CommitID构建

      CommitID是指向提交代码(commit)时生成的编号,在代码仓库中显示为“提交号”

      在编译构建任务中,可以通过指定CommitID来使用历史版本代码进行构建。

      1. 选择“指定CommitID构建”,输入克隆深度,保存任务。

        克隆深度是指距离最近一次提交之间的提交次数,该值越大,检出代码的时间越长。深度为正整数,推荐最大深度为25。

        例如:克隆深度输入5,那么在执行任务时,参数“CommitID”填写距离最近提交的前5个提交号中的任意一个都可以。

      2. 执行任务时,会出弹窗,按需要输入CommitID,单击“确定”,即可启动任务执行。

选择构建模板

  1. 配置完代码源,单击“下一步”,进入“选择构建模板”页面。
  2. 选择适合自己项目的构建模板,单击“确定”;也可以不使用模板,直接创建。。
  3. 进入“构建步骤”页签,页面展示所选模板的默认步骤组合,单击可根据需要添加构建步骤,步骤配置请参考构建步骤

    系统预置的工具版本如果满足不了需求,可以使用SWR公共镜像或者使用dockerHub公共镜像进行自定义环境构建。

  4. (可选)根据需要配置其他页签信息。

    • “基本信息”页签修改任务名称、归属项目、任务描述。
    • “源码选择”页签修改源码源、源码仓库、仓库分支;配置子模块自动更新等信息。

      子模块属于Git的一个概念,是为了解决代码仓库包含并使用其他项目代码仓库的问题,详见子模块管理(Git Submodule操作)

      展开高级设置,可以看到“子模块自动更新”开关,默认关闭。打开开关,当代码仓库存在子模块时,系统在构建时会自动拉取子模块仓库的代码;反之关闭,系统不会自动拉取子模块仓库的代码。

    • “参数设置”页签配置执行任务时的自定义参数。
    • “执行计划”页签配置执行计划。

  5. 配置完所有信息,单击“新建”,完成任务创建。
分享:

    相关文档

    相关产品