华为云首页用户手册

编译构建 CodeArts Build-发布私有依赖到私有依赖库:发布自研工具包WebUtil

时间：2023-11-01 16:15:39

编译构建 CodeArts Build

发布自研工具包WebUtil

对于自行研发的工具包（需要以一定频率编译发布依赖包），推荐使用编译构建服务提供的“Maven构建”构建并发布私有依赖到私有依赖库。强烈建议尽可能使用此方式发布依赖，此方式具备以下优势：

工具包版本迭代时，可以一键发布，避免版本迭代带来的重复的手工上传依赖动作。
可结合构建任务、流水线的定时构建、合并代码触发等功能实现自动化持续集成。
使用构建任务发布的内容由maven自动生成，可有效避免人为造成的文件缺失、损坏，保证上传依赖的完整性、有效性。

配置方法如下：

新建构建任务，其中，代码源选择刚创建好的代码仓库“WebUtil”，构建模板选择“Maven”，并将任务名称命名为“发布WebUtil到私有依赖库”。
Maven模板预置了“Maven构建”和“上传软件包到软件发布库”步骤以及配套的默认构建命令，多数场景下，直接使用即可完成构建并将生成的软件包上传到软件发布库。
删除“上传软件包到软件发布库”构建步骤。

本例主要介绍将项目依赖的工具包发布到私有依赖库，因此不需要“上传软件包到软件发布库”构建步骤，如需要归档软件包到发布库，也可以选择保留该步骤，构建包默认生成于“./target”目录下，一般会自动生成。
配置“Maven构建”步骤。
- 注释默认的“mvn package”命令，开放被注释的“mvn deploy”命令。
  检查构建命令：模板已给出默认参数配置，此处只需确认参数正确即可。
  - 默认命令要从根目录读取“pom”文件，本例中WebUtil项目“pom”文件在根目录，无需调整。
  - WebUtil项目要求使用jdk1.8编译、运行，确认工具版本选择“maven3.5.3-jdk8-open”无误。
  - 本次构建目标为发布私有包，默认命令为“mvn deploy”，已经开放。
    “mvn deploy”命令作用为将项目打包，并发布到指定的依赖仓库，可供其他项目直接引用，必要时（无需发布到私有仓库或私有仓库故障）也可选择使用“mvn install”命令，将项目打包并install到构建缓存，同样可以供其他项目直接引用（构建时需要使用缓存，缓存内容不保证数据持久性，如丢失需重新构建）。
    
    默认命令参数说明可参考Maven构建默命令含义。
- 展开“发布依赖包到私有依赖库”，选择“配置所有pom”，选择需要发布的私有依赖仓库。
  检查缓存配置：
  - 编译构建提供了构建缓存加速功能，可通过缓存配置选择是否使用缓存。
  - 由于网络抖动、并发构建或其他极端情况，可能出现缓存内容异常导致构建异常，此时需要参考缓存清理步骤清理缓存。
保存任务，执行成功后，进入私有依赖库即可查看上传的依赖包。