Maven构建任务

场景概述

编译构建服务支持通过yaml文件配置构建脚本，用户可以将构建时需要配置的构建环境、构建参数、构建命令、构建步骤等操作，通过yaml语法编写成build.yml文件实现，并且将build.yml文件和被构建的代码一起存储到代码仓库。执行构建任务时，系统会以build.yml文件作为构建脚本执行构建任务，使构建过程可追溯、可还原，安全可信。本节已使用Maven构建为例。

前提条件

• 已注册华为账号并开通华为云。
• 已有可用项目，如果没有，请新建项目。

新建代码仓

1. 使用华为云账号登录软件开发生产线首页。
2. 单击需要创建代码仓的项目名称。
3. 在页面左侧目录中选择“代码 > 代码托管”。

   

4. 进入代码托管页面，单击“新建仓库”，选择“普通仓库”。
5. 根据表1填写参数，单击“确定”。

   表1 新建代码仓

   参数名称	参数说明
   代码仓库名称	自定义代码仓名称。例如：maven_yml_build。 以数字、字母或者“_”开头。 可包含“.”和“-”。 不能以“.git”、“.atom”或者“.”结尾。
   描述	对代码仓的描述。
   选择gitignore	根据编程语言选择“.gitignore”，例如：Java。
   权限设置	勾选全部。 允许项目内人员访问仓库：选择后会自动将项目中的项目经理设为仓库管理员，开发人员设为仓库普通成员。当项目新增这两个角色时，也会自动同步到已经存在的仓库中。 允许生成README文件：可以通过编辑README文件，记录项目的架构、编写目的等信息，相当于对整个仓库的一种注释。 自动创建代码检查任务（免费）：仓库创建完成后在代码检查任务列表中，可看到对应仓库的检查任务。
   是否公开	设置为“私有”。 私有：仓库仅对仓库成员可见，仓库成员可访问仓库或者提交代码。 公开只读：仓库对所有访客公开只读，但不出现在访客的仓库列表及搜索中，您可以选择开源许可证作为备注。

创建build.yml文件

1. 在页面导航中选择“代码 > 代码托管”。
2. 单击新建代码仓中创建的代码仓名称。
3. 单击“新建 > 新建目录”，如图1所示。
   图1 新建目录
   

4. 根据表2填写参数信息，单击“确定”。

   表2 新建目录

   参数名称	参数说明
   目录名称	可自定义，例如“.cloudbuild”。
   提交信息	目录的备注信息，用于记录该文件夹文件的描述信息。

5. 单击步骤4创建的目录名称。
6. 单击“新建 > 新建文件”，如图2所示。
   图2 新建文件
   

7. 文件命名为“build.yml”，将如下代码拷贝到文件中。

   # This YAML is the default template and can be modified based on this 
   ---
   version: 2.0
   steps:
     BUILD:
     - maven:
         image: cloudbuild@maven3.5.3-jdk8-open
         inputs:
           settings:
             public_repos:
               - https://mirrors.huawei.com/maven
           cache: true # 是否开启缓存
           command: mvn package -Dmaven.test.failure.ignore=true -U -e -X -B
     - upload_artifact:
         inputs:
           path: "**/target/*.?ar"
     - build_image:
         inputs:
           organization: codeci_gray # 组织名称
           image_name: maven_demo # 镜像名称
           image_tag: 1.0 # 镜像版本
           dockerfile_path: ./Dockerfile

8. 单击“确定”。

创建Java文件

1. 参考步骤4，创建名为“src/main/java”的目录。
2. 在“src/main/java”的目录下，参考步骤6和步骤7，创建名为“HelloWorld.java”的文件。文件中代码如下：

   /**
    * Hello world
    *
    */
   
   public class HelloWorld {
   
     public static void main(String[] args) {
       System.out.println("Hello World!");
     }
   
   }

3. 单击“确定”。

创建Dockerfile文件

1. 在根目录下，参考步骤6和步骤7，创建名为“Dockerfile”的文件。文件中代码如下：

   FROM swr.cn-north-5.myhuaweicloud.com/codeci/special_base_image:centos7-base-1.0.2-in
   MAINTAINER <devcloud@demo.com> 
   USER root 
   RUN mkdir /demo 
   COPY ./target/server-1.0.jar /demo/app.jar

2. 单击“确定”。

创建pom.xml文件

1. 在根目录下，参考步骤6和步骤7，创建名为“pom.xml”的文件。文件中代码如下：

   <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
     <modelVersion>4.0.0</modelVersion>
     <groupId>com.huawei.demo</groupId>
     <artifactId>server</artifactId>
     <packaging>jar</packaging>
     <version>1.0</version>
     <name>server</name>
     <url>http://maven.apache.org</url>
     <dependencies>
       <dependency>
           <groupId>junit</groupId>
           <artifactId>junit</artifactId>
           <version>3.8.1</version>
           <scope>test</scope>
       </dependency>
     </dependencies>
   
   
     <build>
       <pluginManagement>
         <plugins>
           <plugin>  
             <groupId>org.apache.maven.plugins</groupId>  
             <artifactId>maven-jar-plugin</artifactId>  
             <version>2.6</version>  
             <configuration>  
               <archive>  
                 <manifest>  
                   <addClasspath>true</addClasspath>  
                 </manifest>  
                 <manifestEntries>  
                   <Main-Class>  
                     HelloWorld
                   </Main-Class>  
                 </manifestEntries>  
               </archive>  
             </configuration>  
           </plugin> 
         </plugins>
       </pluginManagement>
     </build>
   </project>

2. 单击“确定”。

创建构建任务

1. 在页面导航中选择“持续交付 > 编译构建”，如图3所示。
   图3 编译构建首页
   

2. 单击“新建任务”。
3. 根据表3填写参数信息，如图4所示。

   表3 基本信息配置

   参数名称	参数说明
   任务名称	自定义任务名称，例如：maven_yml_build。
   源码源	选择“Repo”。
   源码仓库	选择新建代码仓中创建的代码仓库名称。
   分支	选择新建代码仓中创建的分支，若没有创建，选择默认“master”即可。
   任务描述	对该构建任务的描述。

   图4 创建构建任务
   

4. 单击“下一步”。
5. 选择“空白构建模板”，单击“下一步”。
6. 单击“代码化”页签，可查看到导入的构建脚本，如图5所示。
   图5 代码化页签
   

7. 单击页面右上角的“新建并执行”。

查看并验证构建结果

• 查看上传的软件包。
  1. 选择页面导航栏“制品仓库 > 软件发布库”。
  2. 在软件发布库查看发布的软件包。软件包与创建构建任务时的任务名称一致，如图6所示。
     图6 查看软件包
     
• 查看推送的镜像。
  1. 进入容器镜像服务SWR。
  2. 单击导航栏“我的镜像”，在组织中筛选创建build.yml文件时代码中填写的“组织名称”，如：codeci_gray。
  3. 在筛选结果中单击创建build.yml文件时代码中填写的“镜像名称”，如：maven_demo，如图7所示。
     图7 筛选镜像