华为云用户手册

操作步骤 访问CodeArts Build服务首页。 在编译构建首页右上角单击“更多”，在下拉列表选择“自定义构建环境”。 进入自定义构建环境页面，选择合适的基础镜像，单击即可下载Dockerfile模板。 编辑下载的Dockerfile文件。 可根据需要加入项目需要的其他依赖和工具，完成Dockerfile文件自定义，如下为添加了jdk和maven工具的示例。 RUN yum install -y java-1.8.0-openjdk.x86_64 RUN yum install -y maven RUN echo 'hello world!' RUN yum clean all

代码化构建 1 2 3 4 5 6 7 8 9 10 11 version: 2.0 # 必须是2.0 steps: BUILD: - android_sign: inputs: file_path: build/bin/*.apk keystore_file: androidapk.jks keystore_password: xxxxxx alias: keyalias key_password: xxxxxx apksigner_commond: --verbose 参数名 参数类型 描述 是否必填 默认值 file_path string 需要签名的APK路径。 是 无 keystore_file string Keystore文件名。 是 无 keystore_password string Keystore文件密码。 否 无 alias string 别名。 是 无 key_password string 密码。 否 无 apksigner_commond string apksigner命令。 是 无

图形化构建 配置构建步骤时，在“Android构建”步骤后添加“Android APK签名”步骤。 参数说明如下： 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 需要签名的APK路径 Android构建后生成要签名的.apk文件位置，支持正则表达式，如：可以使用build/bin/*.apk匹配构建出来的APK包。 Keystore文件 用于签名的Keystore文件，参考生成Keystore签名文件制作，单击下拉列表，展示文件管理页面已经上传的Keystore文件，请根据需要选择。 keystore password 密钥文件密码。 别名（Alias） 密钥别名。 key password 密钥密码。 apksigner命令行 用户自定义签名参数，默认“--verbose”显示签名详情。 验证签名是否成功。 配置完成后执行构建任务，当显示任务执行成功后，查看构建日志，若“Android APK签名”对应日志中显示“结果: Signed”即为签名成功。

生成Keystore签名文件 使用JDK的keytool工具生成签名文件 找到JDK安装位置以及keytool。 执行生成密钥命令，生成.jks文件。 keytool -genkeypair -storepass 123456 -alias apksign -keypass 123456 -keyalg RSA -validity 20000 -keystore D:/android.jks 使用Android Studio生成签名文件 打开Studio，选择“Build下的Generate Signed Bundle/APK”。 选择“APK”，单击“Next”。 单击“Create new...”，在弹出框填写相关信息，单击“OK”，然后单击“Next”。 签名文件成功生成，查看文件。 生成的签名文件，可以上传到“文件管理”统一管理。

文件管理 文件上传后，可以编辑文件、下载文件、删除文件、为用户配置文件操作权限。 在搜索框输入关键字，可搜索文件。 单击操作列，可修改文件名称，并设置是否允许租户内所有成员在编译构建中使用该文件。 单击操作列，可以下载文件。 单击操作列，在下拉框中选择“删除”，可根据弹框提示确认是否删除。 单击操作列，在下拉框中选择“编辑权限”，可在弹出的界面配置用户操作文件的权限。 表1 文件管理角色权限说明 权限类型 拥有该权限的角色 添加用户 项目下所有用户。 查看 文件创建者、相同租户的用户。 使用 文件创建者、文件创建者配置了使用权限的用户。 更新 文件创建者、文件创建者配置了更新权限的用户。 删除 文件创建者、文件创建者配置了删除权限的用户。 编辑权限 文件创建者。 创建者默认有所有权限并且不可被删除和修改。

图形化构建 在配置构建步骤中，添加“上传软件包到软件发布库”构建步骤，参考表1配置参数。 当执行机选择Windows执行时，需添加“上传软件包到软件发布库(Windows环境)”构建步骤。 表1 上传软件包到软件发布库参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 构建包路径 填写构建结果所在路径。 构建包路径支持正则匹配，“**”递归遍历当前目录，“*”匹配0或者多个字符，“?”匹配一个字符。 系统文件分隔符使用“/”，路径不区分大小写。 举例说明： *.class：当前目录下匹配“.class”结尾的文件。 **/*.class：当前目录下递归匹配所有的“.class”结尾的文件。 test/a??.java：匹配“test”目录下以“a”开头后跟两个字符的java文件。 **/test/**/XYZ*：递归匹配父目录为“test”文件是“XYZ”开头的所有文件，比如“abc/test/def/ghi/XYZ123”。 发布版本号 可选参数。 配置当前构建任务生成的软件包上传到软件发布库中的目录名。 不指定（推荐）：以构建编号命名上传到发布库的文件存储目录名。 指定：可能会覆盖同名存储目录下的文件。 包名 可选参数。 配置当前构建任务生成的软件包上传到软件发布库中的软件包名称。 不指定（推荐）：以文件原始名命名上传到发布库的文件名。包名推荐设置为空，可以上传构建包路径匹配的所有文件。 指定：上传多个文件时，可能会存在被覆盖的情况。如果包名需要设置且存在多个文件上传的情况，推荐增加多个“上传软件包到软件发布库”的构建步骤。 自定义上传目录 可选参数。 填写自定义上传目录后，上传的软件包将上传至“自定义上传目录/版本号/软件包名”的目录下。 失败后是否继续运行 当前步骤执行失败后是否继续执行下一个步骤，根据实际使用场景选择是或否。

代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 7 8 9 10 version: 2.0 # 必须是2.0 steps: BUILD: - upload_artifact: inputs: path: "**/target/*.?ar" version: 2.1 name: packageName custom_upload_path: /phoenix-sample-ci/ ignore_fail: true 表2 代码示例参数说明 参数 类型 说明 path string 填写构建结果所在路径。 构建包路径支持正则匹配，“**”递归遍历当前目录，“*”匹配0或者多个字符，“?”匹配一个字符。 系统文件分隔符使用“/”，路径不区分大小写。 举例说明： *.class：当前目录下匹配“.class”结尾的文件。 **/*.class：当前目录下递归匹配所有的“.class”结尾的文件。 test/a??.java：匹配“test”目录下以“a”开头后跟两个字符的java文件。 **/test/**/XYZ*：递归匹配父目录为“test”文件是“XYZ”开头的所有文件，比如“abc/test/def/ghi/XYZ123”。 version string 可选参数。 填写发布版本号。 不填写（推荐）：以构建编号命名上传到发布库的文件存储目录名。 填写：可能会覆盖同名存储目录下的文件。 name string 可选参数。 填写构建生成的包名。 不填写（推荐）：以文件原始名命名上传到发布库的文件名。 填写：上传多个文件时，可能会存在被覆盖的情况。 custom_upload_path string 可选参数。 填写自定义上传目录后，上传的软件包将上传至“自定义上传目录/版本号/软件包名”的目录下。 ignore_fail string 用于控制当前步骤执行失败后是否继续执行下一个步骤。 true：是。 为空：否。

系统预定义参数 系统预定义参数的参数值由系统自动生成，无需定义，如表1所示，可在代码中使用${参数名}引用。 表1 系统预定义参数 参数 说明 BUILDNUMBER 构建编号。格式为“日期.今日该构建任务执行次数”，例如：20200312.3。 TIMESTAMP 构建任务执行时间戳。例如：20190219191621。 INCREASENUM 该构建任务执行总次数，从1开始自增长，每执行1次加1。 PROJECT_ID 该构建任务所在的项目编号。 WORKSPACE 该构建任务拉取的源代码根目录，即工作空间。 GIT_TAG 代码tag名，在配置代码下载时指定tag构建才有值。 COMMIT_ID_SHORTER 代码提交号的前8位。在配置代码下载时指定CommitID构建才有值。 COMMIT_ID 代码提交号。例如：b6192120acc67074990127864d3fecaf259b20f5。

使用参数的操作指导 以图1为例为您介绍如何使用自定义的参数。 图1 自定义参数 在编译构建任务配置页面切换到“构建步骤”页签，在“上传软件包至软件发布库”构建步骤的“发布版本号”中输入“${myparam}”，保存并执行构建任务。 在弹框中，将“myparam”修改为“1.0.1.2”，单击“确定”，等待构建任务执行完成。 图2 填写运行参数值 进入软件发布库，找到刚构建的构建包，即可看到版本号就是修改后的的“myparam”值。 图3 查看构建包

添加自定义参数的配置指导 在编译构建任务配置页面，切换至“参数设置”页签，单击“新建参数”，参考表2配置参数。 表2 添加自定义参数 名称 类型 默认值 私密参数 运行时设置 参数描述 自定义参数名称。支持字母，数字，下划线“_”，长度不超过128个字符。 说明： 以下字段不可用：LD_PRELOAD、LD_LIBRARY_PATH、PATH、BASH_ENV、GIT_SSH_COMMAND、path。 不支持任何符号。 字符串 自定义参数的默认值。长度不超过8192个字符。 设置是否为私密参数。参数为私密参数时，系统会将输入参数进行加密存储，使用时再进行解密，同时在运行日志里不可见。 设置该参数是否在执行构建任务时设置。 打开“运行时设置”开关，表示通过单击按钮执行构建任务时支持变更参数值，并且系统会把该参数上报到流水线服务。 自定义关于该参数的描述信息。长度不超过1024个字符。 枚举 在弹出的对话框中，填写自定义的“可选取值”，每个参数值必须以英文分号结尾。长度不超过8192个字符。 配置完可选取值后，在“默认值”的下拉框中为该参数配置一个默认值。 自增长 自定义参数的默认值。长度不超过8192个字符。

代码化构建 参考以下代码样例，在创建代码化构建使用的YAML文件中的PRE_BUILD部分代码信息。 1 2 3 4 5 6 7 version: 2.0 # 必须是2.0 steps: PRE_BUILD: - sh: inputs: command: echo ${a} ignore_fail: true 表2 代码示例参数说明 参数 类型 说明 command string 请根据需要填写执行构建的shell命令。 ignore_fail string 用于控制当前步骤执行失败后是否继续执行下一个步骤。 true：是。 为空：否。

图形化构建 在配置构建步骤中，添加“执行shell命令”构建步骤，参考表1配置参数。 表1 执行shell命令参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 工具版本 根据用户实际开发环境的需要，选择对应的工具版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 命令 请根据需要填写执行构建的shell命令。 失败后是否继续运行 当前步骤执行失败后是否继续执行下一个步骤，根据实际使用场景选择是或否。

代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 7 version: 2.0 # 必须是2.0 steps: BUILD: - gnu_arm: inputs: command: make ignore_fail: true 表2 代码示例参数说明 参数 类型 说明 command string 填写Gnu-arm构建命令。 如果Makefile不在代码根目录下，用户需要使用cd命令进入到正确的目录，再使用make命令。 用户不使用make命令，可以参考下列镜像自带的编译命令： 可选：gnuarm201405镜像：使用arm-none-linux-gnueabi-gcc命令，如下。 arm-none-linux-gnueabi-gcc -o main main.c gnuarm-linux-gcc-4.4.3镜像：使用arm-linux-gcc命令，如下。 arm-linux-gcc -o main main.c gnuarm-7-2018-q2-update镜像：使用arm-none-eabi-gcc命令，如下： arm-none-eabi-gcc --specs=nosys.specs -o main main.c 说明： Linux下的GNU的makefile编写，请参见官网。 注意Makefile只有行注释“#”，如果要使用或者输出“#”字符，需要进行转义，如使用“\#”。 ignore_fail string 用于控制当前步骤执行失败后是否继续执行下一个步骤。 true：是。 为空：否。

图形化构建 在配置构建步骤中，添加“Gnu-arm构建”构建步骤，参考表1配置参数。 表1 Gnu-arm构建参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 工具版本 根据用户实际开发环境的需要，选择对应的工具版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 命令 配置Gnu-arm构建命令，一般使用系统默认给出的make命令即可。 如果Makefile不在代码根目录下，用户需要使用cd命令进入到正确的目录，再使用make命令。 用户不使用make命令，可以参考下列镜像自带的编译命令： 可选：gnuarm201405镜像：使用arm-none-linux-gnueabi-gcc命令，如下。 arm-none-linux-gnueabi-gcc -o main main.c gnuarm-linux-gcc-4.4.3镜像：使用arm-linux-gcc命令，如下。 arm-linux-gcc -o main main.c gnuarm-7-2018-q2-update镜像：使用arm-none-eabi-gcc命令，如下： arm-none-eabi-gcc --specs=nosys.specs -o main main.c 说明： Linux下的GNU的makefile编写，请参见官网。 注意Makefile只有行注释“#”，如果要使用或者输出“#”字符，需要进行转义，如使用“\#”。 失败后是否继续运行 当前步骤执行失败后是否继续执行下一个步骤，根据实际使用场景选择是或否。

图形化构建 在配置构建步骤中，添加“Msbuild构建”构建步骤，参考表3配置参数。 表3 Msbuild构建参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 工具版本 根据用户实际开发环境的需要，选择对应的工具版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 powershell命令 配置Msbuild命令，一般使用系统默认给出的命令即可。常见命令可参考常用Powershell命令。 nuget restore命令会还原csharp项目依赖。 msbuild命令构建项目： OutputPath会指定生成路径，此路径设置会以csproject文件为相对路径。 项目存在多个csproject时可能会因此导致构建失败，删除路径指定参数后可构建成功。 .NET Core项目请尝试使用.NET相关命令构建。

常用Powershell命令 如果在构建任务中使用powershell命令，在命令行窗口按如下格式输入命令即可。 powershell –Command Powershell命令 Powershell命令参数列表 表4 常用Powershell命令 Powershell命令 命令使用说明 Compress-Archive（压缩命令） powershell –Command Compress-Archive -Path [SourcePath] -DestinationPath [Target.zip] SourcePath：指定需要压缩的文件或文件夹，支持通配符和相对路径。 Target.zip：输出的压缩文件名，可用于上传到软件发布库时填写文件名。 Expand-Archive（解压缩命令） powershell –Command Expand-Archive -Path [SourcePath] -DestinationPath [TargetPath] SourcePath：指定需要解压的文件，如“demo.zip”。 TargetPath：要解压到的目标路径，支持通配符和相对路径。 Copy-Item（复制命令） powershell –Command Copy-Item -Recurse -Path [SourcePath] -DestinationPath [TargetPath] SourcePath：指定需要复制的文件或文件夹，支持通配符和相对路径。 TargetPath：要复制到的目标路径，支持通配符和相对路径。 说明： -Recurse选项为循环复制子文件夹，但若在SourcePath中使用了通配符，此开关会失效，不会复制指定目录下的子文件夹。 文档只介绍了构建常用的Powershell命令，更多Powershell命令请参见官方文档。

约束与限制 为方便使用，CodeArts Build提供的Msbuild构建环境原则上尽可能保持与本地环境一致，但因Windows系统与CodeArts Build本身一些系统限制，少数场景下可能会导致构建失败。使用前建议仔细阅读以下规格说明。 Msbuild构建仅支持图形化构建。 Msbuild构建仅可单独使用，如果构建任务中已有其他构建步骤，将无法添加“Msbuild构建”。 不支持带空格的文件路径 C#项目中目录或文件名中包含空格会导致构建失败，目录/文件的命名请使用字母、数字、下划线的组合，勿使用其他特殊字符，避免不必要的构建失败。 文件全路径长度不得超过260个字符 Windows系统中，文件全路径的最大长度限制为260个字符，超过此长度会导致Msbuild构建失败。 CodeArts Build需在指定目录下执行命令，即您的构建场景实际与以下步骤类似： cd C:\编译构建的默认路径\您的项目路径 msbuild 项目文件全路径长度实际为项目下文件相对路径长度与编译构建服务默认路径长度之和。 编译构建服务默认路径长度为45字符。因此，在使用Msbuild构建的过程中，您的项目文件路径需满足：项目下文件相对路径（以代码仓库为根目录）长度不可大于215字符。 一些特殊场景（如构建时指定输出目录为“Output/release”)下，可能会额外占用路径长度。 建议您的项目下文件相对路径（以代码仓库为根目录）长度保持在200个字符以下，原则上尽可能短。 不可直接引用系统不具备的组件 部分场景下，解决方案中可能不使用NuGet等管理工具，直接引用默认路径下的程序集。但构建时环境中不具备此程序集，导致编译告警，如果项目代码中使用了此引用，甚至会直接导致失败。 由于Windows系统特殊性，通常情况下，此类程序集默认安装于本地系统，无需指定程序集位置，VS构建时会从默认配置的几个程序集路径查找，可以构建成功。而云端构建环境对应目录无此程序集，进而导致云端构建环境与本地不一致带来的失败。 为解决此类场景，Msbuild集成了NuGet，可以在构建时从远程仓库下载对应程序集，此时只需于项目中指定“packages.config”，并于其中声明依赖的程序集即可。 特殊情况下，项目引用的程序集可能无法在远程仓库找到，此时需要手工保存程序集至代码仓库中，并显式指定程序集路径。 详细解决方案请参见找不到程序集（**.dll）。 命令行中路径分隔符使用'/'而非'\' 部分场景下，可能需要在命令行中使用路径参数，此处需注意，Msbuild构建环境要求路径分隔符统一使用“／”格式。 错误示例： cd test\test1或cd test\\test1 正确示例： cd test/test1 避免直接指定低版本SDK路径 CodeArts Build提供了“.NET Framework”的4.7.2版本和3.5版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 一般来讲，4.7.2版本可以兼容4.0以上版本SDK，3.5版本可以兼容3.5版本以下SDK，项目中可以引用兼容版本的SDK内容。 在某些场景下，用户可能将引用直接指向了某个低版本的SDK路径，此时会因找不到SDK导致构建失败。 如果您的项目出现此类场景，建议： 尝试更改您的引用路径，尽可能使用兼容版本SDK。 如果您的项目因为不可回避的原因，必须指向低版本SDK路径，请联系客服。

Msbuild构建场景 表1 已支持的场景 场景类型 说明 无外部依赖 参考镜像版本及对应工具版本，对于仅使用了环境预装依赖库的项目，选择合适的镜像版本即可直接使用msbuild或.NET命令进行构建。 例如：项目使用了dotnetframework4.7.2的SDK和Office操作的相关官方依赖库（MSOffice）。可选用“msbuild15-dotnetframework4.7.2”版本镜像，使用msbuild命令构建。 使用Nuget进行依赖管理 对于使用了环境预装依赖库以外的项目，但使用了Nuget对所有依赖库进行管理的项目，选择合适的镜像版本后，可先使用nuget restore命令下载所有依赖，此后使用msbuild命令进行构建。.NET命令无需先执行nuget命令。 例如：项目使用了“dotnetframework4.7.2”的SDK，依赖了Myget上某Package并使用Nuget添加了该依赖。可选用“msbuild15-dotnetframework4.7.2”版本镜像，使用nuget restore && msbuild命令构建。 其他 对于有其他命令需求的项目，如Git、JDK、Nant、Nodejs等，使用对应的命令进行操作。 表2 未支持的场景 场景类型 说明 未使用Nuget管理依赖库 依赖了本地安装的依赖库，且没有使用nuget对依赖进行管理。详细解决方案请参见找不到程序集（**.dll）。 例如：某项目使用“dotnetframework4.7.2”的SDK，本地安装了Nunit依赖库，但没有使用Nuget对其进行管理。 此时使用msbuild命令对其进行构建时会出现找不到库的错误，导致构建失败。 解决方案版本低于VS2015（不包含） 对于使用VS2015（不含）以前版本创建的解决方案，会出现版本过低不兼容的情况，导致构建失败。请尝试升级解决方案。

图形化构建 在配置构建步骤中，添加“Kotlin构建”构建步骤，参考表1配置参数。 表1 Kotlin构建参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 工具版本 根据用户实际开发环境的需要，选择对应的工具版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 命令 配置Kotlin构建命令，一般使用系统默认给出的命令即可。如有特殊构建要求，可以在文本域中输入自定义的构建脚本。更多命令使用方法可参考Kotlin官网。 失败后是否继续运行 当前步骤执行失败后是否继续执行下一个步骤，根据实际使用场景选择是或否。

代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 7 version: 2.0 # 必须是2.0 steps: BUILD: - kotlin: inputs: command: gradle build ignore_fail: true 表2 代码示例参数说明 参数 类型 说明 command string 配置Kotlin构建命令。更多命令使用方法可参考Kotlin官网。 ignore_fail string 用于控制当前步骤执行失败后是否继续执行下一个步骤。 true：是。 为空：否。

代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 7 8 version: 2.0 # 必须是2.0 steps: BUILD: - swr: image: cloudbuild@ddd inputs: command: echo 'hello' ignore_fail: true 表2 使用SWR镜像代码示例参数说明 参数 类型 说明 image string 填写镜像地址，分为以下两种填写方式： 以cloudbuild开始，@作为分隔符，后面是编译构建支持的工具版本对应的名称。例如：cloudbuild@maven3.5.3-jdk8-open，其中“maven3.5.3-jdk8-open”为Maven构建的工具版本名称。 4中获取的镜像地址。 command string 配置执行命令。 例如：若使用的镜像是用于Maven构建，则配置Maven构建命令；若使用的镜像是用于NPM构建，则配置NPM构建命令，以此类推。 ignore_fail string 用于控制当前步骤执行失败后是否继续执行下一个步骤。 true：是。 为空：否。

图形化构建 在配置构建步骤中，添加“使用SWR公共镜像”构建步骤，参考表1配置参数。 表1 使用SWR公共镜像参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 镜像地址 填写4中获取的镜像地址。 命令 配置命令，一般使用系统默认生成的命令即可。如有特殊构建要求，可以在文本域中输入自定义的构建脚本。 例如：若使用的镜像是用于Maven构建，则配置Maven构建命令；若使用的镜像是用于NPM构建，则配置NPM构建命令，以此类推。 失败后是否继续运行 当前步骤执行失败后是否继续执行下一个步骤，根据实际使用场景选择是或否。

制作镜像并推送到SWR仓库 图形化构建 在配置构建步骤中，“Maven构建”步骤后添加“制作镜像并推送到SWR仓库”构建步骤。 “Maven构建”构建步骤参数保持默认即可，如当前参数配置不满足使用要求，可参考Maven构建修改参数配置。“制作镜像并推送到SWR仓库”构建步骤参数配置说明如表1。 表1 制作镜像并推送到SWR仓库参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 工具版本 选择使用的Docker版本，使用默认版本即可。 当前编译构建服务支持Docker18.03和Docker20.10版本。 镜像仓库 选择需要推送的镜像仓库。支持推送至华为云镜像仓库SWR和其他镜像仓库，根据实际情况选择即可。 授权用户 推送的镜像仓库的所属用户。支持推送至当前用户和其他用户。 需确保用户对组织内所有镜像具有编辑或管理权限，详见授权管理。 当“镜像仓库”选择“华为云镜像仓库SWR”时需要配置该参数。 IAM 账号 在下拉框中选择自定义构建环境前的准备工作中创建的“IAM账户”服务扩展点，通过服务扩展点推送至其他用户的SWR中。 当“授权用户”选择“其他用户”时需要配置该参数。 推送区域 选择需要推送的区域。镜像制作成功后，会将镜像依次推送到选中区域的SWR仓库。 当“镜像仓库”选择“华为云镜像仓库SWR”时需要配置该参数。 镜像仓接入点 选择自定义构建环境前的准备工作中创建的“Docker repository”服务扩展点，通过服务扩展点推送至其他镜像仓库。 当“镜像仓库”选择“其他镜像仓库”时需要配置该参数。 组织 在下拉框中选择自定义构建环境前的准备工作中创建好的组织名，选择镜像推送到SWR后所属的组织。 镜像名字 自定义填写制作完成后的镜像名称。 需以数字或字母开头，仅支持小写字母、数字、“_”、“-”，字符长度为1~255。 镜像标签 用来标记镜像的版本，可自定义。通过“镜像名:标签”可以唯一指定镜像。 仅支持大小写字母、数字、“.”、“_”、“-”，不可以“.”或“-”开头，字符长度为1~128。 工作目录 可选参数。 填写docker build命令中的“上下文路径”参数，该路径是代码仓库根目录的相对路径。 上下文路径，指的是docker在构建镜像时，docker build命令将该路径下的所有内容打包给容器引擎，帮助构建镜像。 Dockerfile路径 可选参数。 Dockerfile文件所在路径，请填写相对于工作目录的路径，如：工作目录为根目录， 且Dockerfile文件在根目录下，则此处填写为“./Dockerfile”。 添加构建元数据到镜像 配置是否将本次构建信息添加到镜像中，镜像制作完成后可以通过docker inspect命令查看镜像元数据。 失败后是否继续运行 当前步骤执行失败后是否继续执行下一个步骤，根据实际使用场景选择是或否。 代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 7 8 9 10 11 12 13 version: 2.0 # 必须是2.0 steps: BUILD: - build_image: name: buildImage inputs: regions: ["x-x-x", "x-x-xxx"] organization: codeci_test image_name: demo image_tag: ${GIT_COMMIT} dockerfile_path: dockerfile/Dockerfile # set_meta_data: true ignore_fail: true 表2 制作镜像并推送到SWR仓库代码示例参数说明 参数 类型 说明 regions list 可选参数。 选择要上传的区域SWR。默认上传到当前任务所在region的SWR。如果配置多个region，镜像制作成功后，会将镜像依次推送到填写region的SWR仓库中。 organization string 配置镜像推送到SWR后所属的组织名称。组织名称为自定义构建环境前的准备工作中创建好的组织名。 image_name string 可选参数。 自定义填写制作完成后的镜像名称。 需以数字或字母开头，仅支持小写字母、数字、“_”、“-”，字符长度为1~255。 默认值：demo。 image_tag string 可选参数。 用来标记镜像的版本，可自定义。通过“镜像名:标签”可以唯一指定镜像。 仅支持大小写字母、数字、“.”、“_”、“-”，不可以“.”或“-”开头，字符长度为1~128。 默认值：v1.1。 context_path string 可选参数。 填写docker build命令中的“上下文路径”参数，该路径是代码仓库根目录的相对路径。 上下文路径，指的是docker在构建镜像时，docker build命令将该路径下的所有内容打包给容器引擎，帮助构建镜像。 默认值：.。 dockerfile_path string 可选参数。 Dockerfile文件所在路径，请填写相对于工作目录的路径，如：工作目录为根目录， 且Dockerfile文件在根目录下，则此处填写为“./Dockerfile”。 默认值：./Dockerfile。 set_meta_data bool 可选参数。 配置是否将本次构建信息添加到镜像中，镜像制作完成后可以通过docker inspect命令查看镜像元数据。 true：添加。 false：不添加。 默认值：false。 ignore_fail string 用于控制当前步骤执行失败后是否继续执行下一个步骤。 true：是。 为空：否。

代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 7 8 9 10 11 12 13 version: 2.0 # 必须是2.0 steps: BUILD: - go: inputs: command: | export GO15VENDOREXPERIMENT=1 export GOPROXY=https://goproxy.cn mkdir -p $GOPATH/src/example.com/demo/ cp -rf . $GOPATH/src/example.com/demo/ go install example.com/demo cp -rf $GOPATH/bin/ ./bin ignore_fail: true 表2 代码示例参数说明 参数 类型 说明 command string 配置Go项目构建命令。更多命令使用方法可参考Go官网。 ignore_fail string 用于控制当前步骤执行失败后是否继续执行下一个步骤。 true：是。 为空：否。

图形化构建 在配置构建步骤中，添加“Go语言构建”构建步骤，参考表1配置参数。 表1 Go语言构建参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 工具版本 根据用户实际开发环境的需要，选择对应的工具版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 命令 配置Go项目构建命令，一般使用系统默认给出的命令即可，如有特殊构建要求，可以在文本域中输入自定义的构建脚本。更多命令使用方法可参考Go官网。 失败后是否继续运行 当前步骤执行失败后是否继续执行下一个步骤，根据实际使用场景选择是或否。

图形化构建 在配置构建步骤中，添加“Ant构建”构建步骤，参考表1配置参数。 表1 Ant构建参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 工具版本 根据用户实际开发环境的需要，选择对应的工具版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 命令 配置Ant构建命令，一般使用系统默认给出的命令即可。如有特殊构建要求，可以在文本域中输入自定义的构建脚本。更多命令使用方法可参考Ant官网。 失败后是否继续运行 当前步骤执行失败后是否继续执行下一个步骤，根据实际使用场景选择是或否。

代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 7 version: 2.0 # 必须是2.0 steps: BUILD: - ant: inputs: command: ant -f build.xml ignore_fail: true 表2 代码示例参数说明 参数名称 参数类型 参数说明 command string 配置Ant构建命令。更多命令使用方法可参考Ant官网。 ignore_fail string 用于控制当前步骤执行失败后是否继续执行下一个步骤。 true：是。 为空：否。

图形化构建 在配置构建步骤中，添加“CMake构建”构建步骤，参考表1配置参数。 表1 CMake构建参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 工具版本 根据用户实际开发环境的需要，选择对应的工具版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 命令 配置CMake命令，一般使用系统默认给出的命令即可。如有特殊构建要求，可以在文本域中输入自定义的构建脚本。更多命令使用方法可参考CMake官网。 失败后是否继续运行 当前步骤执行失败后是否继续执行下一个步骤，根据实际使用场景选择是或否。

代码化构建 参考以下代码示例，修改在创建代码化构建使用的YAML文件中的BUILD部分代码信息。 1 2 3 4 5 6 7 8 9 10 11 version: 2.0 # 必须是2.0 steps: BUILD: - cmake: inputs: command: | # 新建build目录 切换到build目录、 mkdir build && cd build # 生成Unix 平台的makefiles文件并执行构建 cmake -G 'Unix Makefiles' ../ && make -j ignore_fail: true 表2 代码示例参数说明 参数 类型 说明 command string 配置CMake命令。更多命令使用方法可参考CMake官网。 ignore_fail string 用于控制当前步骤执行失败后是否继续执行下一个步骤。 true：是。 为空：否。

图形化构建 在配置构建步骤中，添加“PyInstaller构建”构建步骤，参考表1配置参数。 表1 PyInstaller构建参数说明 参数 说明 步骤显示名称 构建步骤的名称，可自定义修改。 支持中文、英文、数字、“-”、“_”、英文逗号、英文分号、英文冒号、“.”、“/”、圆括号（中英文）。 字符长度范围为1~128。 工具版本 根据用户实际开发环境的需要，选择对应的工具版本。 CodeArts Build支持的工具版本，可查看构建工具版本。若当前的工具版本不满足您的使用要求，您可以自定义构建环境。 命令 配置构建打包命令，默认命令是将项目打包成一个可执行文件。更多命令使用方法可参考PyInstaller官网。 失败后是否继续运行 当前步骤执行失败后是否继续执行下一个步骤，根据实际使用场景选择是或否。