使用自定义执行机执行Maven构建（自定义执行机/图形化构建）

当编译构建服务提供的内置执行机构建环境不满足业务要求时，您可接入自行提供的计算资源，通过注册的方式托管到编译构建服务中，委托编译构建服务进行调度并执行构建任务。本实践我们通过“Maven构建”和“上传软件包到软件发布库”两个构建步骤来演示使用自定义执行机的构建场景。

本实践需要依赖使用的其他服务如下：

已参考自定义购买ECS购买自定义执行机使用的弹性云服务器。

表1 操作流程
流程	说明
新建项目	为本实践新建项目。
新建自定义执行机资源池	为本实践新建所需的自定义执行机资源池。
新建CodeArts Repo代码仓	为本实践新建存储代码的代码仓。
新建并执行编译构建任务	为本实践新建构建任务，包括“Maven构建”和“上传软件包到软件发布库”构建步骤。
查看构建任务和构建结果	为您介绍通过查看构建日志确认该实践的构建任务使用的执行机和在制品仓中查看上传的软件包。

单击“新建资源池”，在弹出的窗口中参考表2配置参数后，单击“保存”。

表2 资源池配置参数说明
参数名称	参数说明
资源池名称	资源池的名称，根据需要自定义。例如：custom_pool。
资源池类型	选择LINUX_DOCKER。执行任务时将拉起一个Linux docker容器，任务在容器中运行。
资源池描述	根据需要输入资源池描述。可不填写。
资源池可以被租户下所有子用户使用	勾选后，此资源池可以被当前租户下所有子用户使用。可不勾选。

单击“新建代理”，在弹出的窗口中，参考表3配置代理信息，其他参数项保持默认即可。

表3 新建代理参数说明
参数	说明
是否安装Docker	勾选此项，配需安装Docker。
自动安装Docker	打开开关，自动安装Docker。
AK	参考获取AK/SK获取。
SK	参考获取AK/SK获取。
代理名称	自定义代理名称。例如：agent_test_custom。
代理工作空间	填写代理工作空间，需符合标准的linux目录格式。例如：/opt/agent_test_custom。

勾选协议，依次单击“生成命令”和“复制命令”。单击“关闭”。

图1 新建代理
根据“步骤三”提示，在弹性云服务器列表页，单击前提准备中购买的服务器所在行的“远程登录”按钮，执行6中复制的命令。
在代理列表页面，单击“刷新列表”，后台自动同步信息后，代理列表中会增加一条代理执行机信息。代理执行机的代理别名为“agent_test_custom-mwlye1NlLG”。

图2 代理执行机

在导航栏中选择“服务 > 代码托管”，进入代码托管服务首页。
单击“新建仓库”，在新建仓库页面“归属项目”选择新建项目中创建的项目名称，“仓库类型”选择“模板仓库”，单击“下一步”。
选择“Java Maven Demo”仓库模板，单击“下一步”。
“代码仓库名称”填写为“custom_repo”，其他参数保持默认即可。单击“确定”，完成代码仓的创建。

创建完成后的代码仓文件目录如图3所示。

图3 代码仓文件目录

单击“新建任务”，根据表4填写参数信息，单击“下一步”。

表4 基本信息配置
参数	说明
任务名称	自定义任务名称，例如：custom_task。
代码源	选择“Repo”。拉取CodeArts Repo代码仓中的代码进行编译构建。
代码仓	选择新建CodeArts Repo代码仓中新建的代码仓库名称“custom_repo”。
默认分支	选择默认“master”即可。
任务描述	对该构建任务的描述。

参考配置“构建环境配置”步骤，其他参数保持默认即可，单击“保存并执行”。

表5 构建环境配置参数说明
参数	说明
执行主机	选择自定义执行。
选择代理资源池	在下拉框中选择新建自定义执行机资源池中新建的资源池“custom_pool”。

图4 构建环境配置

在构建日志中，控制台会滚动打印构建任务执行日志信息。如图5所示，使用的执行机为新建自定义执行机资源池中新建的代理资源池“custom_pool”下的执行机“agent_test_custom-mwlye1NlLG”，表示当前构建任务是在该代理执行机中运行的。

图5 构建日志
待构建任务执行完成后，每个构建步骤标记表示构建任务执行成功。

图6 构建任务执行成功
单击步骤日志的“上传软件包至软件发布库”，在日志中查看上传到软件发布库的路径为“/custom_task/20240620.19/”，如图7所示。

图7 查看上传的软件包路径
在导航栏选择“制品仓库 > 软件发布库”，文件路径为“/custom_task/20240620.19/javaMavenDemo-1.0.jar”。

图8 软件包信息