华为云用户手册

步骤二：创建日志空间 在“容器日志接入”页面，选择左侧导航栏的“日志空间”。 单击“申请实时日志空间”。 根据界面提示填写日志空间参数。 配置实时日志空间信息，参数说明如表2所示，配置完成后，单击“下一步”。 表2 实时日志空间信息参数说明 参数名称 参数说明 空间名称 自定义日志空间名称，建议包含日志类型语义。 空间描述 输入日志空间描述，非必填项。 日志类型 选择需接入的日志类型。 日志大小 预计一天的日志量，默认为1GB。 开启日志检索 如果需要使用日志检索功能，可以打开该开关。 检索空间类型 选择ClickHouse。 原索引名称(ClickHouse) 可选择现有的ClickHouse，如果不填会自动生成。 TTL 日志索引的生命周期，即可以检索的日志时间范围。 配置实时日志字段信息，参数说明如表3所示，配置完成后，单击“下一步”。 表3 实时日志字段信息参数说明 参数名称 参数说明 自定义字段 勾选需要接入的日志字段，包括通用字段、容器字段和虚机字段。 新增自定义环境变量 如需添加自定义环境变量，请选择环境变量名，然后单击“添加”。虚机暂无可选自定义环境变量。 清洗规则 选择日志清洗规则。 请优先使用算子清洗模式采样，原始日志采样清洗只适用于单纯采样，不需要清洗的场景。 日志样例 输入日志样例。 解析脚本 配置解析脚本，将日志样例清洗为字段显示。 解析脚本中不支持使用中划线“-”，支持使用下划线“_”。 清洗字段 配置解析脚本后单击“配置解析脚本”，自动生成清洗字段，查看字段是否符合预期。 开启汇聚 选择是否开启日志汇集，如果日志量较大且不需要关注原始日志时可以进行日志汇集。 开启后需要配置汇集相关参数。 汇聚粒度 开启汇聚后，需要设置汇集粒度。支持分钟级和秒级数据汇聚。选择分钟级，每一分钟会生成一个统计点，选择秒级，每一秒会生成一个统计点。 汇聚时间戳 仅支持时间戳格式字段timestamp，获取当前计算的日志的时间。 时间戳格式 选择时间戳格式。支持秒、毫秒、纳秒级时间戳，获取当前计算的日志的时间格式。 汇聚维度 结合业务场景需要，选择日志是以哪些日志字段进行日志汇聚，支持多选。 汇聚度量 设置对日志字段以COUNT、SUM、MAX、MIN进行度量。 原始字段是日志中的字段，用来获取原始值；度量字段是用户自定义字段名，计算后，度量的值会赋值给该字段。 输出原始日志 选择是否需要输出原始日志。如果打开输出原始日志，原始日志也会上报。 日志字段确认，确认日志字段配置是否达到预期，已达到预期，单击“下一步”。 其中字段来源COMMON表示通用字段、CONTAINER表示容器字段、VM表示虚机字段。 申请日志空间共享，如果需要其他自有服务共用这个空间进行日志下发和日志检索，可以添加共享服务。配置完成后，单击“保存”。

解决方案 本文将以Spring Cloud Demo项目为例，带您体验使用AppStage的开发中心、运维中心及运行时引擎进行工程创建、代码开发、打包发布、部署上线的全过程。 图1 应用上云流程 工程创建 创建产品/服务/微服务信息：企业资源接入AppStage前，需要先将企业产品/服务/微服务信息录入AppStage系统中，信息录入成功后，AppStage将同步产品/服务/微服务信息至AppStage的开发中心、运维中心等各个中心。 添加开发中心用户：开发中心的用户数根据购买规格有相应的用户数量限制，组织管理员通过用户的添加或删除来合理管理开发中心的使用人员。 创建团队：在开发中心进行服务开发前，需要组织管理员先创建一个团队，将团队关联需要开发的服务。 配置服务信息：将团队关联服务后，还需将团队关联的服务关联CodeArts项目，后续的服务开发管理过程中才能正常使用CodeArts服务的代码托管、流水线、编译构建功能。 添加团队成员：在团队多用户协作开发过程中，不同角色成员执行各自权限和责任事项，因此需要在团队中添加协作开发的各角色成员（项目经理、开发人员、测试人员等），实现统一有序的成员信息管理。 创建版本：为服务创建版本，进而在版本管理活动中进行流水线和发布流程等有序开发和特定发布过程管理。 代码开发 创建代码仓库：开发人员进行代码开发前，需要先创建代码仓库用于托管代码。本实践中使用代码托管 CodeArts Repo服务提供的模板创建，适用于本地没有仓库，希望按模板初始化一个仓库的场景。 下载代码到本地：开发人员进行代码文件的操作前，需要使用Git Bash客户端和TortoiseGit客户端下载代码仓库文件到本地环境中。 开发业务代码和编写IaC脚本：开发人员在本地开发业务代码以及IaC部署脚本。 提交代码到代码仓库：开发人员在本地完成业务代码和IaC脚本后，需要提交代码文件至代码仓库。 打包发布 创建/配置/执行流水线：通过流水线配置代码打包发布的编译构建自动化任务（包括添加业务包构建、IaC自动部署包构建任务），对这些自动化任务进行自定义编排后，一次配置后即可一键自动化触发调度执行，最终生成代码构建产物。 发布流水线构建的包到运维中心：版本开发及编译构建完成，且发布准入检查项均通过后，将版本软件包发布到运维中心的软件仓库。 部署上线 安装部署软件包：完成环境准备，并将发布在运维中心的软件包进行安装部署。 业务验证：软件包部署完成后，验证是否部署成功。

背景信息 Spring Cloud为微服务开发提供了一套完整的解决方案，大幅简化了分布式系统中基础设施如服务发现与注册、配置管理、负载均衡、数据监控以及分布式调用链等的开发工作。通过Spring Cloud提供的简易框架，开发者能够基于Spring Boot轻松实现微服务项目的构建。 然而，除了开发阶段的便捷性外，我们还需要关注应用的部署、运维和监控等方面，以确保微服务应用在生产环境中的稳定性和性能。应用平台（AppStage）是基于平台工程理念打造的下一代应用全生命周期管理平台，帮助客户快速高效地实现应用全生命周期管理，为应用构建、运维和运营等生命周期管理活动提供自助式服务能力。 原生Spring Cloud应用仅需引入AppStage组件依赖并进行简单配置，即可轻松接入AppStage。接入后，用户即可体验到平台所提供的丰富功能，如服务注册与发现、智能运维、应用监控、服务治理、应用运营等。

准备工作 在执行操作前，需要提前完成如下准备工作，以满足操作的环境要求。 已申请公测 已购买AppStage的开发中心、运维中心、运行时引擎 已关联组织 已配置服务授权 已关联CodeArts 已配置凭证授权 已添加组织的部门/成员信息 AppStage租户需要在华为云上已购买一个OBS桶并配置桶名（用于存放编译构建的产物），具体操作方法请参见创建桶。 父主题： 一站式应用开发、应用托管以及应用运维

配置说明 在Yaml文件中，添加如下代码： version: 2.0 buildspace: #表示使用BuildSpace fixed: true path: kk clean: true clean_exclude: - cache #排除的具体路径 - aa #排除的具体路径 - bb #排除的具体路径 代码参数说明如下： 参数名 参数类型 描述 是否必填 默认值 fixed string true：使用固定路径。 false：不使用固定路径。 否 false path string 当使用固定路径时，路径为：/devcloud/slavespace/usr1/+"${domainId}"+/。配置path参数，表示在前面的固定路径基础上拼接路径。 例如：“path”配置路径为“kk”，那么固定路径为：/devcloud/slavespace/usr1/+"${domainId}"+/kk。 否 无 clean string true：需要清理固定路径。即路径是固定的，但是每次执行完会清理路径下的文件。 false：不清理固定路径。但是工作空间有限的，当文件容量达到工作空间上限后，需要手动清理工作空间(clean配置为true即可)。 说明： 如果未配置清理固定路径，当文件容量达到工作空间上限后，会自动清理当前租户下的固定路径中所有文件。 工作空间指的是用户自定义的执行机的规格。 否 true clean_exclude string 表示使用路径清理，但是排除以下路径。仅支持指定固定路径下的一级文件夹。 否 不涉及

背景说明 在编译构建服务中，默认每一次构建都会使用一个空白的且随机的目录(比如/devcloud/ws/sMMM/workspace/j_X/)作为此次构建的根目录，这个根目录所代表的空间称为BuildSpace。 BuildSpace的路径默认是随机的，即使是同一个项目的不同构建任务的BuildSpace也会被随机分配。 但是在某些场景下固定一个BuildSpace的路径是有必要的，因此编译构建服务支持配置BuildSpace，以固定构建执行目录。

图形化配置 预置“构建环境配置”步骤。 参数说明如下： 参数项 说明 构建环境主机类型 X86服务器、鲲鹏（ARM）服务器。 执行主机 用来执行编译构建任务的计算资源，在编译构建服务中，该计算资源为虚拟机。执行主机包括内置执行机和自定义执行机。 内置执行机：编译构建服务自身提供的执行主机，用户无需配置即可开箱即用。 自定义执行机：用户自行提供的计算资源，通过注册的方式托管到编译构建服务中，通过编译构建服务进行调度并执行构建任务。 可根据实际情况选择内置执行机或自定义执行机，自定义执行机为在资源池中添加的代理执行机，具体自定义操作可参考资源池管理。

代码化构建 代码示例如下： 1 2 3 4 5 6 7 version: 2.0 # 必须是2.0，该版本号必填且唯一 env: # 定义构建环境信息。非必填，如果不填写，默认使用X86 resource: type:docker # 资源池类型：docker或custom，其中docker表示使用默认执行机，custom表示使用自定义执行机 arch:X86 # 构建环境主机类型：X86或ARM class:8U16G # 规格：2U8G、4U8G、8U16G、16U32G或16U64G，当type为custom时无需填写该参数 pool：Mydocker #资源池名称，当type为custom时需要填写该参数

代码化构建（单仓下载） 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 version: 2.0 # 必须是2.0 steps: PRE_BUILD: - checkout: name: checkout inputs: scm: codehub # 代码来源:支持Repo和opensource url: xxxxxxxxx # 拉取代码的ssh地址。 branch: ${codeBranch} # 任何时候都必填，支持参数化 commit: ${commitId} lfs: true submodule: true depth: 100 tag: ${tag} path: test 参数说明如下: 参数名 参数类型 描述 是否必填 默认值 scm string 代码源：当前只支持CodeArts Repo，如果yaml中没配置，则使用构建任务配置的代码仓信息。 否 codehub url string 拉取代码的ssh地址。 是 无 branch string 拉取的代码分支：支持参数化。 是 无 commit string commitId构建时拉取的commitId：支持参数化。 否 无 tag string tag构建时拉取的tag：支持参数化，如果commitId和tag同时存在，优先执行commitId构建。 否 无 depth int 浅克隆深度：当选择commitId构建时，depth必须大于等于commitId所在深度。 否 1 submodule bool 是否拉取子模块：true为拉取；false为不拉取。 否 false lfs bool 是否开启git lfs：为true时会执行git lfs pull。 否 false path string clone的子路径：代码将会下载到子目录下面。 否 无

代码化构建（manifest多仓下载） 在安卓、鸿蒙等场景下，一次构建需要同时集成数百甚至上千个代码仓，多个代码仓的集成下载效率至关重要。 编译构建集成Repo下载工具，用户只需进行简单配置即可实现多个代码仓的联动集成。当前支持Repo、gerrit两种类型的代码仓。 配置参考如下： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 version: 2.0 # 必须是2.0 steps: PRE_BUILD: - manifest_checkout: name: "manifest" inputs: manifest_url: "https://example.example.example.example.example.com/xx/manifest.git" manifest_branch: "master" manifest_file: "default.xml" path: "dir/dir02" repo_url: "https://example.example.example.example.example.com/xx/git-repo.git" repo_branch: "master" username: "someone" password: "${PASSWD}" 参数说明如下： 参数名 参数类型 描述 是否必填 默认值 name string 步骤名称。 否 manifest_checkout manifest_url string 指定manifest仓地址，包含xml文件的仓库。 是 无 manifest_branch string 指定manifest分支或revision。 否 HEAD manifest_file string manifest文件路径。 否 default.xml path string 自定义manifest所有子仓下载路径，为工作目录的相对路径 路径不能以“/”开头，不能包含“.”。 否 默认为工作目录。 repo_url string repo仓库地址。 否 https://gerrit.googlesource.com/git-repo repo_branch string repo仓库分支。 否 stable username string 下载仓库时使用的用户名。 否。 下载非公开仓库时需填写。 无 password string 下载仓库时使用的密码，https密码。 否。 下载非公开仓库时需填写。 无 manifest_file中定义的多个仓库，必须为同一种代码源。 manifest_url与manifest_file必须为同一种代码源；如果为非公开仓库，username&password应该有下载权限。 repo_url对应的repo仓库，需要有下载权限（仓库开源，或者仓库私有但配置了账号密码）。 以上非必填的参数，如果配置的值为空，则使用默认值。 建议在使用非公开仓库时，用户名密码通过构建的私密参数进行配置，详情参考配置构建任务参数 （可选操作）。 该功能目前仅支持北京四区域使用，其余区域后续上线。

图形化构建 可选择使用指定代码仓库Tag或CommitID构建，同时可选择开启子模块（submodules）自动更新与Git LFS。 预置“代码下载配置”步骤。 参数说明如下： 参数项 说明 使用指定代码仓库Tag或CommitID构建 不指定、指定Tag构建、指定CommitID构建。 子模块（submodules）自动更新 子模块属于Git的一个概念，是为了解决代码仓库包含并使用其他项目代码仓库的问题，详见子模块管理（Git Submodule操作）。 开启：当代码仓库存在子模块时，系统在构建时会自动拉取子模块仓库的代码。 不开启：系统不会自动拉取子模块仓库的代码。 开启Git LFS 根据需要选择是否开启“Git LFS”，构建默认不拉取音视频、图像等大型文件，开启“Git LFS”后，构建将会全量拉取文件。 指定Tag构建：需按照以下操作执行。 Tag是指代码仓库中的标签，若代码源选择Repo，那么关于如何创建Tag可参见标签管理。 在编译构建任务中，选择“指定Tag构建”，可以使用历史版本代码进行构建。 执行任务时，会出现弹窗，输入标签名，单击“确定”，即可执行任务。 指定CommitID构建：需按照以下操作执行。 CommitID是指提交代码时生成的编号，若代码源选择Repo，则在代码仓库中显示如下。 在编译构建任务中，可以通过指定CommitID来使用历史版本代码进行构建。 选择“指定CommitID构建”，输入克隆深度，保存任务。 克隆深度是指距离最近一次提交的提交次数，该值越大，检出代码的时间越长。深度为正整数，推荐最大深度为25。 例如：克隆深度输入5，那么在执行任务时，参数“CommitID”填写距离最近提交的前5个提交号中的任意一个都可以。 执行任务时，会出现弹窗，按需要输入CommitID，单击“确定”，即可启动任务执行。

编辑构建任务 登录编译构建服务首页。 在编译构建任务列表搜索目标任务。 单击编译构建任务所在行，在下拉列表中选择“编辑”，进入“编辑任务”页面。 基本信息：可修改任务名称、代码源、代码仓、默认分支、任务描述等信息。 构建步骤：可修改构建步骤、步骤参数等信息。 参数设置：可配置执行任务时的自定义参数。 执行计划：可配置触发事件（持续集成）和定时执行。 修改历史：可查看构建任务的修改记录。 权限管理：可配置不同角色的权限。 通知：可配置任务事件类型通知信息（包括任务构建成功、失败、删除、配置更新、被禁用）。 根据需要选择对应页签并进行编辑，单击“保存”完成修改。

删除构建任务 单击编译构建任务所在行，在下拉列表中选择“删除”。请根据实际情况确定是否删除对应构建任务。 删除的构建任务可到构建任务回收站中查看。在编译构建首页右上角单击“更多”，在下拉列表选择“构建任务回收站”。 页面中展示已删除的构建任务，根据需要可以完成以下相关操作。 操作 说明 修改任务保留时间 单击“任务保留时间”下拉列表，根据需要选择时长，可选天数范围为1~30天。 搜索任务 在搜索框中输入待搜索内容，单击搜索，即可在页面中查看搜索结果。 删除任务 在列表中勾选待删除的任务，单击“删除”，即可将所选任务从回收站中删除。 恢复任务 在列表中勾选待恢复的任务，单击“恢复”，即可将所选任务恢复到编译构建服务的任务列表中。 清空回收站 单击“清空回收站”，可将回收站中所有任务删除。

配置CMake构建加速 添加“CMake构建”构建步骤。 工具版本选择“cmake3.16.5-gcc7.3.0”，根据加速原理以及效果的不同，构建加速分为L1/L2/L3三种模式，请根据购买的加速规格使用加速命令，下方示例为开启L1模式加速： cmake -G'Unix Makefiles'../&& BuildAccelerateL1 make -j8 //开启构建加速只需在make前添加加速命令：BuildAccelerateL1 //切换模式只需将BuildAccelerate后的L1替换为L2/L3。 //最大并发CPU核数，即make -j后面的数字，最大256。 单击“新建”，开始执行构建任务。 加速命令只允许写在最外层，不允许通过shell脚本等调用。 同一次构建任务中禁止混用不同级别的加速命令，将导致任务无法保存与执行，例如： 使用yaml配置CMake构建支持使用构建加速，与图形化构建相同，修改工具版本并添加加速命令即可，如何使用yaml配置CMake构建请参考使用CMake构建。

配置基本信息 新建项目。 新建代码仓库。 登录编译构建服务首页。 单击“新建任务”，进入配置“基本信息”页面，填写构建任务基本信息。使用图形化构建，参考表1；使用代码化构建，参考表2。 表1 图形化构建基本信息配置说明 参数项 描述 任务名称 任务的名称。 归属项目 任务所属项目。 代码源 Repo：从代码托管服务拉取代码进行构建。 其他项目Repo：从其他项目的代码托管中拉取代码进行构建，请选择已有的项目、该项目下已经创建的代码仓以及默认分支。 来自流水线：如果选择来自流水线，则只能通过流水线任务驱动执行，不能单独执行。 以下为第三方代码仓库，首次使用第三方代码仓，需新建服务扩展点，详情可参考新建服务扩展点（可选操作）。 GitHub：拉取托管在GitHub上的代码进行构建。 通用Git：拉取托管在其他服务上的代码进行构建。 GitCode：拉取托管在GitCode仓库上的代码进行构建。 码云：拉取托管在码云上的代码进行构建。 Gerrit：拉取托管在Gerrit上的代码进行构建。 代码仓 选择实际使用的代码仓。 默认分支 选择仓库默认分支。 任务描述 对任务进行描述。 表2 代码化构建基本信息配置说明 参数项 描述 任务名称 任务的名称。 归属项目 任务所属项目。 代码源 选择Repo：表示从代码托管拉取代码进行构建。 代码仓 选择实际使用的代码仓。 默认分支 选择仓库默认分支。 任务描述 对任务进行描述。

配置构建任务执行计划（可选操作） 编译构建支持用户配置触发事件和定时执行任务，从而使得开发者达到项目持续集成的目的。 切换至“执行计划”页签，根据实际需要配置执行计划。 持续集成：将“提交代码触发执行”按钮设置为开启状态，构建任务所引用的代码源发生提交代码行为时，则会触发执行构建任务。 代码源为“Repo”时才能使用。 定时执行：将“启用定时执行”按钮设置为开启状态，选择需要构建任务定时执行的时间，并可按需开启是否“代码变化才执行”。 功能开启后，构建任务会按照您设定的执行日与时间定时执行。 若同时开启了“代码变化才执行”按钮，只有到达设定的执行日和时间，并且代码与上次构建有所变动时才会执行构建任务。

配置构建任务角色权限（可选操作） 编译构建支持为当前构建任务的各个角色配置权限，默认的用户角色类型及对构建任务的操作权限说明参考表3。 表3 编译构建默认角色权限矩阵 项目角色 编辑 删除 查看 执行 复制 禁用 权限管理 任务创建者 √（*） √（*） √（*） √（*） √（*） √（*） √（*） 项目创建者 √（*） √（*） √（*） √（*） √（*） √（*） √（*） 项目经理 √ √ √ √ √ √ √ 开发人员 √ √ √ √ √ √ × 测试经理 × × √ × × × × 测试人员 × × × × × × × 参与者 × × × × × × × 浏览者 × × √ × × × × “√”表示默认有权限，“×”表示默认没有权限。 拥有“权限管理”权限的角色可以修改权限矩阵，但带“*”的权限不可修改。 项目创建者、项目经理和开发人员可以创建编译构建任务。 切换至“权限管理”页签，可根据实际需要配置不同角色的操作权限。 单击“同步项目权限”，可将当前构建任务的权限同步为项目权限。项目权限配置详情请参考配置项目级角色权限。

配置基本信息 新建项目。 新建代码仓库。 登录编译构建服务首页。 单击“新建任务”，进入配置“基本信息”页面，填写构建任务基本信息。使用图形化构建，参考表1；使用代码化构建，参考表2。 表1 图形化构建基本信息配置说明 参数项 描述 任务名称 任务的名称。 归属项目 任务所属项目。 代码源 Repo：从代码托管服务拉取代码进行构建。 其他项目Repo：从其他项目的代码托管中拉取代码进行构建，请选择已有的项目、该项目下已经创建的代码仓以及默认分支。 来自流水线：如果选择来自流水线，则只能通过流水线任务驱动执行，不能单独执行。 以下为第三方代码仓库，首次使用第三方代码仓，需新建服务扩展点，详情可参考新建服务扩展点（可选操作）。 GitHub：拉取托管在GitHub上的代码进行构建。 通用Git：拉取托管在其他服务上的代码进行构建。 GitCode：拉取托管在GitCode仓库上的代码进行构建。 码云：拉取托管在码云上的代码进行构建。 Gerrit：拉取托管在Gerrit上的代码进行构建。 代码仓 选择实际使用的代码仓。 默认分支 选择仓库默认分支。 任务描述 对任务进行描述。 表2 代码化构建基本信息配置说明 参数项 描述 任务名称 任务的名称。 归属项目 任务所属项目。 代码源 选择Repo：表示从代码托管拉取代码进行构建。 代码仓 选择实际使用的代码仓。 默认分支 选择仓库默认分支。 任务描述 对任务进行描述。

配置构建任务参数 （可选操作） 编译构建服务默认生成codeBranch参数和系统预定义参数。用户可以根据需要修改codeBranch参数类型和参数值，并添加其他自定义参数。 系统预定义参数的参数值由系统自动生成，无需定义，可通过${参数名}引用。 配置指导如下： 切至“参数设置”页签，单击“新建参数”。 新建字符串类型参数：“类型”选择“字符串”，根据实际需要修改参数名、参数类型、参数值，以及是否设置为私密参数或者运行时设置。 新建枚举类型参数：填写参数名称，“类型”选择“枚举”，在弹出的对话框中，填写“可选取值”，每个参数值必须以英文分号结尾。设置完后，在“默认值”列单击下拉列表，为该参数设置一个默认值。 新建自增长类型参数：“类型”选择“自增长”，在“默认值”列设置参数。 使用参数示例如下。 使用自定义参数 配置执行参数。 编辑构建任务，选择“参数设置”页签，添加一条参数，设置参数名称和参数值（本例参数名设置为“myparam”、默认值设置为“1.0.1.1”），打开“运行时设置”。 使用执行参数。 切换到“构建步骤”页签，配置构建步骤，在发布版本号文本框里输入“${myparam}”,保存构建任务。 执行构建任务。 弹出“设定参数并执行”框，根据实际情况输入值或者使用默认值。 本构建任务是Maven构建并且开通了制品仓库服务，所以可以在制品仓库服务里查到该任务的构建包。 进入软件发布库，找到刚构建的构建包，即可看到版本号就是用户自定义的执行参数“myparam”值。 系统预定义参数 配置执行参数。 编辑构建任务，选择“构建步骤”页签，配置构建步骤，在发布版本号文本框里输入“${BUILDNUMBER}”，保存构建任务。 参数名 说明 BUILDNUMBER 构建编号。格式为“日期.今日该构建任务执行次数”，例如：20200312.3。 TIMESTAMP 构建执行时间戳。例如：20190219191621。 INCREASENUM 该任务构建执行总次数，从1开始自增长，每执行1次加1。 PROJECT_ID 项目编号。 WORKSPACE 工作空间，源代码根目录。 GIT_TAG 代码tag名，使用tag构建时才有值。 COMMIT_ID_SHORTER 代码提交号的前8位。 COMMIT_ID 代码提交号。例如：b6192120acc67074990127864d3fecaf259b20f5。 执行构建任务。 本构建任务是Maven构建并且开通了制品仓库服务，所以可以在软件发布库里查到该任务的构建包。 进入软件发布库，找到刚构建的构建包，即可看到版本号就是系统的执行参数“BUILDNUMBER”的值。

配置构建步骤 单击“下一步”，进入“构建步骤”页签。 配置构建步骤。 图形化构建：页面展示所选模板的默认步骤组合。单击构建步骤上的可根据实际需要添加构建步骤，每个构建步骤的配置指导请参考配置构建步骤。 若构建步骤中预置的工具版本无法满足使用需求，可以通过制作镜像并推送到SWR仓库自定义环境进行构建。 代码化构建：页面左上角单击“代码化”页签，则系统会在配置基本信息中配置的代码仓库及分支中，自动读取YAML文件，也可在此处对YAML文件进行修改。 如果在此处修改了YAML文件，则执行构建任务后，修改的内容会覆盖前提准备中的原YAML文件。 配置完成后，单击“新建”，即可完成构建任务的创建。

单任务YAML文件结构说明 该示例为通过YAML文件执行Maven构建。 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 version: 2.0 # 必须是2.0，该版本号必填且唯一 params: # 构建参数，可在构建过程中引用。如果不填写，则优先使用配置构建任务参数中的构建参数 - name: paramA value: valueA - name: paramB value: valueB env: # 定义构建环境信息。非必填，如果不填写，默认使用X86 resource: type:docker # 资源池类型：docker或custom，其中docker表示使用默认执行机，custom表示使用自定义执行机 arch:X86 # 构建环境主机类型：X86或ARM class:8U16G # 规格：2U8G、4U8G、8U16G、16U32G或16U64G，当type为custom时无需填写该参数 pool：Mydocker #资源池名称，当type为custom时需要填写该参数 steps: PRE_BUILD: # 用于做构建前的准备，例如下载代码，执行shell等 - checkout: name: 代码下载 # 可选 inputs: # 步骤参数 scm: codehub # 代码来源:只支持Repo url: xxxxxxxxx # 拉取代码的ssh地址。 branch: ${codeBranch} # 拉取的代码分支：支持参数化。 - sh: inputs: command: echo ${paramA} BUILD: # 用于定义构建步骤，仅支持配置一个BUILD。不同构建步骤的代码样例，可参考配置构建步骤中各个构建步骤的代码化构建部分 - maven: # 步骤关键字，仅支持特定关键字 name: maven build # 可选 image: xxx # 可以自定义镜像地址，请看下方说明 inputs: command: mvn clean package - upload_artifact: inputs: path: "**/target/*.?ar"

代码化构建 （代码化构建仅支持代码源为Repo。） 编译构建支持通过YAML文件配置构建脚本，您可以将构建过程需要用到的构建环境、构建参数、构建命令、构建工具等信息通过YAML语法编写成build.yml文件，并且将build.yml文件随着被构建的代码一起存储代码仓库，执行构建任务时，系统会以build.yml文件作为构建脚本执行构建任务，使构建过程可追溯、可还原，安全可信。功能优势如下： 清晰描述构建过程：构建参数、构建命令、构建步骤、以及构建后的操作，使构建过程可信。 每次构建使用对应当前commit的build.yml配置，保证构建可还原可追溯，不必担心因修改了构建配置而不能重复执行之前的任务。 如果新特性需要修改构建脚本，开发人员可以拉一个新的分支修改build.yml去测试，而不用担心影响其他分支。 代码化构建支持单任务和多任务。

终端节点 终端节点用于在VPC和终端节点服务之间建立便捷、安全、私密的连接通道。 在同一区域中，通过购买终端节点可以实现所属VPC内云资源跨VPC访问终端节点服务。 终端节点与终端节点服务一一对应，访问不同类型终端节点服务的终端节点存在差异： 访问“接口”型终端节点服务的终端节点：是具备私有IP地址的弹性网络接口，作为接口型终端节点服务的通信入口。 访问“网关”型终端节点服务的终端节点：是一个网关，在其上配置路由，用于将流量指向网关型终端节点服务。 终端节点与终端节点服务一一对应，访问不同类型终端节点服务的终端节点存在差异。 根据终端节点访问的终端节点服务的类型，终端节点分为接口终端节点、网关终端节点。 接口终端节点：指访问“接口”型终端节点服务的终端节点，是具备私有IP地址的弹性网络接口，作为接口型终端节点服务的通信入口。 网关终端节点：指访问“网关”型终端节点服务的终端节点，是作为一个网关，在其上配置路由，用于将流量指向网关型终端节点服务。 终端节点的资源实例类型分为专业型、基础型，不同实例类型的特点如下： 专业型：新上线终端节点实例类型，目前已在华东二区域公测。单实例带宽规格最大支持10Gbps、支持IPv6双栈、组织粒度的策略授权等功能。 基础型：原终端节点实例类型。 仅“拉美-墨西哥城一”、“拉美-圣保罗一”和“拉美-圣地亚哥”区域支持购买访问“网关”型终端节点服务的终端节点。 父主题： 基本概念

如何选择区域？ 选择区域时，您需要考虑以下几个因素： 地理位置 一般情况下，建议就近选择靠近您或者您的目标用户的区域，这样可以减少网络时延，提高访问速度。 在除中国大陆以外的亚太地区有业务的用户，可以选择“中国-香港”、“亚太-曼谷”或“亚太-新加坡”区域。 在非洲地区有业务的用户，可以选择“非洲-约翰内斯堡”区域。 在拉丁美洲地区有业务的用户，可以选择“拉美-圣地亚哥”区域。 “拉美-圣地亚哥”区域位于智利。 资源的价格 不同区域的资源价格可能有差异，请参见华为云服务价格详情。

什么是区域、可用区？ 区域和可用区用来描述数据中心的位置，您可以在特定的区域、可用区创建资源。 区域（Region）：从地理位置和网络时延维度划分，同一个Region内共享弹性计算、块存储、对象存储、VPC网络、弹性公网IP、镜像等公共服务。Region分为通用Region和专属Region，通用Region指面向公共租户提供通用云服务的Region；专属Region指只承载同一类业务或只面向特定租户提供业务服务的专用Region。 可用区（AZ，Availability Zone）：一个AZ是一个或多个物理数据中心的集合，有独立的风火水电，AZ内逻辑上再将计算、网络、存储等资源划分成多个集群。一个Region中的多个AZ间通过高速光纤相连，以满足用户跨AZ构建高可用性系统的需求。 图1阐明了区域和可用区之间的关系。 图1 区域和可用区 目前，华为云已在全球多个地域开放云服务，您可以根据需求选择适合自己的区域和可用区。更多信息请参见华为云全球站点。

产品架构 VPC终端节点由“终端节点服务”和“终端节点”两种资源实例组成。 终端节点服务：指将云服务或用户私有服务配置为VPC终端节点支持的服务，可以被终端节点连接和访问。 更多内容，请参考终端节点服务。 终端节点：用于在VPC和终端节点服务之间建立便捷、安全、私密的连接通道。 根据终端节点访问的终端节点服务的类型，终端节点分为接口终端节点、网关终端节点。 接口终端节点：指访问“接口”型终端节点服务的终端节点，是具备私有IP地址的弹性网络接口，作为接口型终端节点服务的通信入口。 网关终端节点：指访问“网关”型终端节点服务的终端节点，是作为一个网关，在其上配置路由，用于将流量指向网关型终端节点服务。 终端节点的资源实例类型分为专业型、基础型，不同实例类型的特点如下： 专业型：新上线终端节点实例类型，目前已在华东二区域公测。单实例带宽规格最大支持10Gbps、支持IPv6双栈、组织粒度的策略授权等功能。 基础型：原终端节点实例类型。 更多内容，请参考终端节点。 图1 VPC终端节点组网示意图 如图1所示，建立了“终端节点”到“终端节点服务”的访问通道，实现： VPC 1中的云资源（ECS 1）通过内网访问VPC 3中的云资源（ECS 3）。 VPC 2中的云资源（ECS 2）通过内网访问云服务（如OBS、DNS）。 本地数据中心（IDC）通过VPN或者DC的方式与VPC 2连通，实现IDC通过内网访问云服务（如OBS、DNS）。 更多关于VPC终端节点的组网应用信息，请参见应用场景。

计费项 VPC终端节点包含两种资源实例：终端节点服务、终端节点。其中，终端节点服务不收取费用，终端节点根据实例类型分为专业型和基础型。 专业型：新上线终端节点实例类型，目前已在华东二区域公测，按照购买时长和使用流量计费。 专业型支持设置付费方为服务使用方或者服务提供方，详细请参见付费方说明。 基础型：原终端节点实例类型，按照购买时长计费。 终端节点支持的计费方式为：按需计费。 表1 VPC终端节点计费介绍 规格/实例类型 计费方式 计费项 计费公式 专业型 按需计费 实例费 实例单价*购买时长 流量费 流量单价*计费流量 基础型 按需计费 实例费 关联终端节点服务的类型属于DNS或OBS：免费 关联终端节点服务类型不属于DNS或OBS： 实例单价*购买时长 VPC终端节点服务在用户成功购买终端节点后开始计费，按照终端节点在用户账号中保留的小时数收取费用，无论其与终端节点服务的关联状态如何或者是否产生交互。 如果终端节点服务被删除，或者其所有者拒绝让您的终端节点与其服务连接，此时终端节点将无法使用且持续计费，建议及时删除。 VPCEP费用详情请参见产品价格详情。

计费模式 按需计费 基础型终端节点按照终端节点的购买时长（精确到秒）计费。 专业型终端节点按照终端节点的购买时长（精确到秒）和使用流量计费。 计费公式： 基础型：实例单价*购买时长 专业型：实例单价*购买时长+流量单价*计费流量 例如，用户购买了1个连接API的终端节点，自购买成功到删除资源一共5小时，则会收取5个小时的实例费用。 VPCEP的按需计费与终端节点是否产生业务交互无关，即使用户实际没有使用终端节点，也会收取实例费用。

付费方说明 VPCEP服务支持将终端节点服务跨账号授权至其他华为云账号使用，详细请参见管理终端节点服务的白名单。 用户在使用专业型终端节点时，如果终端节点和终端节点服务属于不同的华为云账号，可以提交工单申请设置付费方为服务使用方或者服务提供方。 服务使用方付费（默认）：即由连接终端节点服务的终端节点所属账号付费，承担终端节点相关的所有费用。 服务提供方付费：即由终端节点连接的终端节点服务所属账号付费，承担终端节点相关的所有费用。

终端节点简介 终端节点用于在VPC和终端节点服务之间建立便捷、安全、私密的连接通道。 在同一区域中，通过购买终端节点可以实现所属VPC内云资源跨VPC访问终端节点服务。 根据终端节点访问的终端节点服务的类型，终端节点分为接口终端节点、网关终端节点。 接口终端节点：指访问“接口”型终端节点服务的终端节点，是具备私有IP地址的弹性网络接口，作为接口型终端节点服务的通信入口。 网关终端节点：指访问“网关”型终端节点服务的终端节点，是作为一个网关，在其上配置路由，用于将流量指向网关型终端节点服务。 终端节点的资源实例类型分为专业型、基础型，不同实例类型的特点如下： 专业型：新上线终端节点实例类型，目前已在华东二区域公测。单实例带宽规格最大支持10Gbps、支持IPv6双栈、组织粒度的策略授权等功能。 基础型：原终端节点实例类型。 本章节介绍如何购买并管理终端节点，如表1所示。 表1 终端节点管理说明 操作 说明 使用限制 购买终端节点 介绍如何购买连接终端节点服务的终端节点。 终端节点属于区域级资源，在购买时需要设置区域和项目。 每个租户支持购买50个终端节点。 购买时需要保证所连接的终端节点服务已经存在，且与终端节点服务位于同一区域。 终端节点按购买时长计费。 查询并访问终端节点 介绍如何查看终端节点的详细信息。 一个终端节点支持最大并发连接数： 基础型：3000 专业型：1000000 删除终端节点 介绍如何删除终端节点。 终端节点删除后无法恢复，请谨慎操作。 设置终端节点的访问控制 介绍如何开启终端节点的访问控制功能，并通过白名单设置允许访问终端节点的IP地址或网段。 只有连接“接口”型终端节点服务的终端节点支持访问控制功能。 如果关闭访问控制功能，表示允许任何IP访问终端节点。 管理终端节点的标签 介绍如何管理终端节点的标签，包括查看、添加、编辑和删除标签。 支持为终端节点创建10个标签。 父主题： 终端节点管理