华为云用户手册

场景介绍 知识库是一个组织、存储及管理知识的系统，包括文档、数据库、图表、表格等多种形式的信息的分类、整理和归纳，可以帮助用户组织和管理大量的信息，平台为用户提供了创建并管理知识库的能力，且创建的知识库可在工作流和Agent中调用。 对于需要处理大量问答知识、对检索效率有较高要求的场景，通过构建知识库组织和管理信息，可以提升信息获取效率。本实践以构建儿科知识库为例进行介绍，主要完成以下设置： 上传儿科问答知识.pdf文档，对文档进行自定义切分。切分出来的切片为“问答对”格式（包含图片），切片效果如图1所示。 图1 切片效果 对切片的问题和答案进行提取，用于向量化检索。 对问题做向量化检索，附加返回答案内容。在检索时，通过对问题配置条件过滤和排序规则，确保精准返回查询结果。 使用混合检索的方式检索内容。

命中测试 命中测试即测试检索的命中率。 在知识库列表中，单击操作列的“命中测试”。 在命中测试页面，配置测试输入参数，参数说明如表5所示，配置完单击“测试”。 表5 测试输入参数配置 参数 说明 检索内容 输入测试文本“肥胖懒惰”。 选择数据集 默认选择“儿科知识库”。 相似度阈值 取值范围为0~1，配置为0.5，则返回相似度大于等于0.5的结果。 查询数量 查询最大返回数量，设置为5。 在“测试结果”区域查看测试效果，测试结果根据相似度从大到小进行排序。 在索引字段配置时，本实践选择question作为向量化检索字段，answer为附加返回字段。因此在命中测试时，命中内容即为question字段内容，并同时返回answer字段的内容。 图6 命中测试

场景介绍 知识检索流是一种特殊的工作流，在工作流的基础上，添加了检索规划、召回及重排序三个节点，用于优化知识检索过程并提高结果质量。 例如在医疗领域，知识的高度专业性和复杂性导致用户很难快速准确地检索出所需知识，本实践介绍如何通过知识检索流增强医疗知识检索能力，提高医疗知识问答的准确性和相关性，主要实现过程如下： 在起始节点中引入用户输入的原始查询问题。 使用检索规划_意图识别节点，对用户原始问题进行分类，使用大模型区分用户原始问题属于儿科医疗问题还是消化科医疗问题（当前案例仅提供两种医疗分支，用户可根据实际需要扩展）。 根据不同的意图类别，选择并执行不同的检索流程，在相应的知识库中进行检索召回。 儿科医疗问题 使用检索规划_Query拆解节点，将原始问题拆解为多个子问题。 针对子问题，使用召回节点，在儿科知识库中逐一进行检索召回。 返回召回结果，用于重排序。 消化科医疗问题 使用检索规划_Query改写节点，改写原始问题，让问题更具专业性。 使用召回节点，在消化科知识库中进行检索召回。 返回召回结果，用于重排序。 使用重排序节点，对召回结果进行重排序。 返回重排序结果。

场景介绍 工作流体现的是一个具体的业务场景，通过一系列不同功能节点中的触发事件和执行动作编排而成，AI原生应用引擎通过将传统工具API和大模型编排在一起实现复杂的工作流。在Agent中调用工作流，当起始节点触发，后续动作即可自动执行，完成一系列复杂的任务。 本实践中，工作流主要完成如下任务：根据用户输入的城市，获取该城市的实时天气及实时空气质量，调用大模型生成旅游规划，将旅游规划内容作为整个工作流的输出。同时，还支持以短信的形式发送温馨提醒到用户手机。

AppStage最佳实践汇总 本文汇总了基于应用平台AppStage常见应用场景的操作实践，为每个实践提供详细的方案描述和操作指导，帮助您深入了解AppStage的各个功能。 表1 AppStage最佳实践一览表 最佳实践 说明 一站式应用开发、应用托管以及应用运维 介绍如何使用应用平台AppStage一站式功能，完成基于应用维度提供的开发、测试、版本发布、托管部署、运维监控的全场景全生命周期管理。 基于运维数仓的数据开发与应用 介绍如何通过AppStage运维中心完成对业务实时数据的接入、处理、开发与应用。 基于Spring Cloud框架进行应用上云 以Spring Cloud Demo项目为例，带您体验使用AppStage的开发中心、运维中心进行工程创建、代码开发、打包发布、部署上线的全过程。 AI原生应用引擎 包含使用工作流规划旅游行程、构建儿科知识库、使用知识检索流增强知识库检索能力等实践案例，通过这些典型案例带您体验AI原生应用引擎各功能模块的使用场景。

准备工作 在执行操作前，需要提前完成如下准备工作，以满足操作的环境要求。 已购买AppStage的开发中心、运维中心 已关联组织 已配置AppStage各中心服务授权 已添加组织的部门/成员信息 已录入产品/服务/微服务信息 已获取组织管理员、项目经理、开发人员、测试人员、服务运维岗位、基础运维岗位或运维管理员权限，权限申请操作请参见申请权限。 AppStage租户需要在华为云上购买一个OBS桶并配置桶名（用于存放编译构建的产物），具体操作方法请参见创建桶。 父主题： 一站式应用开发、应用托管以及应用运维

步骤五：安装日志采集插件 在“日志接入”页面，选择左侧导航栏的“集群插件管理”。 在集群列表中单击待安装插件的集群所在行“操作”列的“安装插件”。 在“插件安装”页面配置安装参数，具体内容如下所示，配置完成后，单击“确定”。 输入日志挂载路径：挂载到容器指定挂载点中的容器所在宿主机的文件目录，通常为宿主机上日志文件的hostpath目录。需要设置为单独的文件路径，不能设置为类似于/root、/home等包含有其他文件的目录，并且一个集群只能设置一个挂载路径。 需要对日志挂载路径执行chmod o+rx命令，确保日志采集容器的启动用户拥有该路径的访问权限。 选择主机：选择待安装插件的主机，默认全部勾选进行安装，可以去掉勾选不需要安装插件的主机，且当主机状态为“Active”时才可以正常安装插件。 选择日志配置组：选择日志配置组，安装插件并下发配置。

步骤三：创建日志采集配置 在“日志接入”页面，选择左侧导航栏的“日志采集配置”。 单击“创建日志采集配置”。 配置日志采集参数，配置完成后，单击“确定”。 新创建的采集配置默认为草稿状态，展示在“草稿”页签下，当配置被微服务使用后，状态会更新为“已下发”，并展示到“已下发”页签下。 表4 日志采集配置参数说明 参数名称 参数说明 日志项目 选择已创建的日志项目，相同服务的不同日志使用同一个日志项目 日志空间 选择已创建的日志空间。选择日志空间时日志提取规则会展示日志空间定义的日志格式，采集的日志须满足对应格式。 配置名称 自定义日志采集配置名称。 配置类型 选择日志采集配置类型，建议选择“FILEBEAT”。 日志类型 输入采集日志类型。 日志路径 宿主机上的日志文件的绝对路径（业务容器通过hostpath挂载到宿主机上的路径）。 可使用通配符进行匹配。 注意避免同一台主机上下发的多个采集任务重复采集相同的日志文件，会导致filebeat进程异常。 日志TPS TPS表示单实例每秒日志条数，请准确填写，用于推荐资源自动计算。 日志模式 选择日志采集模式，是单行模式还是多行模式。 是否支持软连接 当填写的日志路径为链接路径时，需要开启支持软连接。 首行正则表达式 日志模式选择多行模式时，需要输入首行正则表达式。 日志提取规则 根据填写的配置参数会自动生成提取规则。

步骤二：创建日志空间 在“日志接入”页面，选择左侧导航栏的“日志空间”。 单击“申请实时日志空间”。 根据界面提示填写日志空间参数。 配置实时日志空间信息，参数说明如表2所示，配置完成后，单击“下一步”。 表2 实时日志空间信息参数说明 参数名称 参数说明 空间名称 自定义日志空间名称，建议包含日志类型语义。 空间描述 输入日志空间描述，非必填项。 区域 选择需要接入日志的区域，可选区域为已完成初始化的区域。 日志类型 选择需接入的日志类型，该日志空间中接入的日志数据“logType”字段会根据选择的日志类型生成。不同日志类型所对应的“logType”字段如下： 访问日志：AC CES S_ LOG 接口日志：INTERFACE_LOG 错误日志：ERROR_LOG 异常日志：EXCEPTION_LOG 安全日志：SAFE_LOG 资源日志：RESOURCE_LOG 运行日志：RUN_LOG 话单日志：CDR_LOG 指标日志：METRI CS _LOG GC日志：GC_LOG HCW日志：HCW_LOG 日志大小 预计一天的日志量，默认为1GB。 开启日志检索 如果需要使用日志检索功能，可以打开该开关，并创建导流任务，创建导流任务后可以在“日志检索”页面查看日志。 如果创建时没有打开日志检索开关，后续编辑打开该开关，需要手动创建或绑定检索空间表。 单击该空间所在行“操作”列的，选择“日志空间表管理”并切换至“检索空间表”页签，单击右上角的“创建新空间表”或“选择已有空间表”，手动为该日志空间创建或绑定检索空间表，然后单击列表“操作”列的“上线”。 检索空间类型 选择ClickHouse。 原索引名称(ClickHouse) 可选择现有的ClickHouse，如果不填会自动生成。 配置实时日志字段信息，参数说明如表3所示，配置完成后，单击“下一步”。 表3 实时日志字段信息参数说明 参数名称 参数说明 自定义字段 必须接入的日志字段已默认勾选，可以勾选其他需要接入的日志字段，包括通用字段、容器字段和虚机字段。 清洗规则 选择日志清洗规则。 请优先使用算子清洗模式采样，通过配置解析脚本将原始日志清洗为业务需要的日志字段，算子清洗功能及使用样例请参见算子清洗功能介绍。原始日志采样清洗只适用于单纯采样，不需要清洗的场景。 如果创建时选择“无清洗”，后续编辑选择对日志进行清洗，需要手动创建或绑定异常存储空间表。 单击该空间所在行“操作”列的，选择“日志空间表管理”并切换至“异常存储空间表”页签，单击右上角的“创建新空间表”或“选择已有空间表”，手动为该日志空间创建或绑定异常存储空间表，然后单击列表“操作”列的“上线”。 日志样例 输入日志样例。 解析脚本 配置解析脚本，将日志样例清洗为字段显示，具体算子功能及使用样例请参见算子清洗功能介绍。 配置解析脚本时字段命名不支持使用中划线“-”，支持使用下划线“_”。 清洗字段 配置解析脚本后单击“测试解析脚本”，自动生成清洗字段，查看字段是否符合预期。 日志字段确认，确认日志字段配置是否达到预期，已达到预期，单击“下一步”。 其中字段来源COMMON表示通用字段、CONTAINER表示容器字段、VM表示虚机字段。 申请日志空间共享，如果需要其他服务共用这个空间进行日志下发和日志检索，可以添加共享服务。配置完成后，单击“保存”。

步骤四：创建日志配置组 在“日志接入”页面，选择左侧导航栏的“日志配置组”。 单击“创建日志配置组”。 设置日志配置组参数，参数说明如表5所示，配置完成后，单击“确定”。 表5 日志配置组参数说明 参数名称 参数说明 日志配置组名称 自定义日志配置组名称。 安装方式 选择安装方式，推荐使用“DAEMONSET”。 命名空间 当安装方式为“DAEMONSET”时，需要配置服务日志命名空间。 命名空间为hostpath的下一级目录名称，该目录下48小时内有日志文件更新，才会拉取日志采集配置，必须为英文名。 日志项目 选择已创建的日志项目。 配置类型 选择配置类型，即创建日志采集配置时选择的配置类型，根据配置类型会过滤采集配置列表中的数据。 采集配置列表 选择需要下发的配置。

步骤三：创建日志采集配置 在“日志接入”页面，选择左侧导航栏的“日志采集配置”。 单击“创建日志采集配置”。 配置日志采集参数，配置完成后，单击“确定”。 新创建的采集配置默认为草稿状态，展示在“草稿”页签下，当配置被微服务使用后，状态会更新为“已下发”，并展示到“已下发”页签下。 表4 日志采集配置参数说明 参数名称 参数说明 日志项目 选择已创建的日志项目，相同服务的不同日志使用同一个日志项目。 日志空间 选择已创建的日志空间。选择日志空间时日志提取规则会展示日志空间定义的日志格式，采集的日志须满足对应格式。 配置名称 自定义日志采集配置名称。 配置类型 选择日志采集配置类型，建议选择“FILEBEAT”。 日志类型 输入采集日志类型。 日志路径 填写实际日志路径，可使用通配符进行匹配。 接入容器日志需要根据通配符匹配完成。 注意避免同一台主机上下发的多个采集任务重复采集相同的日志文件，会导致filebeat进程异常。 日志TPS TPS表示单实例每秒日志条数，请准确填写，用于推荐资源自动计算。 如果采集路径是单个日志，则按照单个日志单台机器（pod）的TPS值填写，且按照高峰期计算。 如果采集路径配置了通配符，则将采集的日志TPS累加，累加计算高峰期单台机器（pod）的TPS，建议按近期业务增长预期填写。 日志模式 选择日志采集模式，是单行模式还是多行模式。 是否支持软连接 当填写的日志路径为链接路径时，需要开启支持软连接。 首行正则表达式 日志模式选择多行模式时，需要输入首行正则表达式。 日志提取规则 根据填写的配置参数会自动生成提取规则。

步骤四：创建任务 在“日志接入”页面，选择左侧导航栏的“任务管理”。 单击页面右上角的“新建任务”。 配置任务参数，参数说明如表5所示，配置完成后，单击“确定”。 表5 任务参数说明 参数名称 参数说明 日志项目 选择已创建的日志项目。 任务名称 自定义任务名称。 任务类型 选择任务类型。 配置类型 选择日志采集配置类型。 配置列表 选择需要下发的配置。 用户名称 选择已规划并拥有日志读取权限的业务账号。 选择主机 选择需要下发配置的主机。 已选主机 显示已选主机。 在任务列表中查看已创建的任务，单击任务所在行“操作”列的“执行”，如图1所示。 图1 执行任务 执行完成后，状态为成功即表示日志配置内容已下发成功，filebeat已成功安装，监控服务会按照配置将日志接入AppStage。 如需卸载filebeat，请参考如何卸载虚拟机上安装的filebeat。

步骤二：创建日志空间 在“日志接入”页面，选择左侧导航栏的“日志空间”。 单击“申请实时日志空间”。 根据界面提示填写日志空间参数。 配置实时日志空间信息，参数说明如表2所示，配置完成后，单击“下一步”。 表2 实时日志空间信息参数说明 参数名称 参数说明 空间名称 自定义日志空间名称，建议包含日志类型语义。 空间描述 输入日志空间描述，非必填项。 区域 选择需要接入日志的区域，可选区域为已完成初始化的区域。 日志类型 选择需接入的日志类型，该日志空间中接入的日志数据“logType”字段会根据选择的日志类型生成。不同日志类型所对应的“logType”字段如下： 访问日志：ACCESS_LOG 接口日志：INTERFACE_LOG 错误日志：ERROR_LOG 异常日志：EXCEPTION_LOG 安全日志：SAFE_LOG 资源日志：RESOURCE_LOG 运行日志：RUN_LOG 话单日志：CDR_LOG 指标日志：METRICS_LOG GC日志：GC_LOG HCW日志：HCW_LOG 日志大小 预计一天的日志量，默认为1GB。 开启日志检索 如果需要使用日志检索功能，可以打开该开关，并创建导流任务，创建导流任务后可以在“日志检索”页面查看日志。 如果创建时没有打开日志检索开关，后续编辑打开该开关，需要手动创建或绑定检索空间表。 单击该空间所在行“操作”列的，选择“日志空间表管理”并切换至“检索空间表”页签，单击右上角的“创建新空间表”或“选择已有空间表”，手动为该日志空间创建或绑定检索空间表，然后单击列表“操作”列的“上线”。 检索空间类型 选择ClickHouse。 原索引名称(ClickHouse) 可选择现有的ClickHouse，如果不填会自动生成。 配置实时日志字段信息，参数说明如表3所示，配置完成后，单击“下一步”。 表3 实时日志字段信息参数说明 参数名称 参数说明 自定义字段 必须接入的日志字段已默认勾选，可以勾选其他需要接入的日志字段，包括通用字段、容器字段和虚机字段。 清洗规则 选择日志清洗规则。 请优先使用算子清洗模式采样，通过配置解析脚本将原始日志清洗为业务需要的日志字段，算子清洗功能及使用样例请参见算子清洗功能介绍。原始日志采样清洗只适用于单纯采样，不需要清洗的场景。 如果创建时选择“无清洗”，后续编辑选择对日志进行清洗，需要手动创建或绑定异常存储空间表。 单击该空间所在行“操作”列的，选择“日志空间表管理”并切换至“异常存储空间表”页签，单击右上角的“创建新空间表”或“选择已有空间表”，手动为该日志空间创建或绑定异常存储空间表，然后单击列表“操作”列的“上线”。 日志样例 输入日志样例。 解析脚本 配置解析脚本，将日志样例清洗为字段显示，具体算子功能及使用样例请参见算子清洗功能介绍。 配置解析脚本时字段命名不支持使用中划线“-”，支持使用下划线“_”。 清洗字段 配置解析脚本后单击“测试解析脚本”，自动生成清洗字段，查看字段是否符合预期。 日志字段确认，确认日志字段配置是否达到预期，达到预期后可单击“下一步”。 其中字段来源COMMON表示通用字段、CONTAINER表示容器字段、VM表示虚机字段。 申请日志空间共享，如果需要其他服务共用这个空间进行日志下发和日志检索，可以添加共享服务。配置完成后，单击“保存”。

限制条件 绑定监控模板进行主机监控，支持的主机的操作系统如表1所示，其余类型的主机无法绑定监控插件。 表1 监控服务支持的主机操作系统 操作系统 系统版本 CentOS CentOS 7.2、CentOS 7.6、CentOS 7.8、CentOS 7.9、CentOS 8.2 Ubuntu Ubuntu 18.04、Ubuntu 20.04、Ubuntu 22.04 EulerOS EulerOS2.5、EulerOS2.9 Huawei Cloud EulerOS Huawei Cloud EulerOS 2.0 SUSE SUSE11、SUSE12、SUSE15、OpenSUSE 15.0

操作步骤 在“服务环境管理”页面，单击待变更环境所在行“操作”列的“更新”，进入“更新环境”页面。 配置变更参数。 完成“变更基本配置”，单击“下一步”，会根据配置内容产生变更计划。 环境基本信息：作为环境的元数据无法修改、无法被更新。 服务级IaC包：选择服务级IaC包的版本和规格。服务级IaC包为“spec”类型的包，可以定义环境下的流水线和组件，以及组件下的资源。 变更任务流：基于用户选择的服务级IaC包，系统可以获取此包定义的所有流水线。可以选择其中一个用于执行变更，如果不选择流水线，则系统会生成一条执行环境下所有组件的流水线。变更的内容是spec包中声明的所有组件。 组件级IaC包：选择流水线后，系统会根据流水线内容生成组件列表，可以基于列表中的元素选择需要变更的组件，或者为组件变更指定patch包，不指定patch包的组件将会基于spec包中对组件的定义进行变更； 如果没有选择流水线，那么系统将会展示选择的spec包中所定义的所有组件，同样地，也可以为组件指定用于变更的patch包。组件名称会根据自己的iacspec包代码的描述自动带出包中声明的组件，可以全量或者部分进行变更。 等待1~2分钟(具体时间长短取决于资源的数量以及当前系统的负载)，变更计划生成完毕后，可以在“任务流程图”中查看此次变更的“变更流程图”和“变更流水线”，确认无误后可以单击“提交”执行变更。

通过控制台申请资源 AppStage支持使用控制台完成资源申请，或者在华为云申请资源，然后接入至AppStage运维中心。 申请虚拟机：需要在华为云购买ECS虚拟机，然后将主机接入AppStage运维中心。 申请CCE集群：需要在华为云购买CCE集群，然后将容器集群接入AppStage运维中心。 申请数据库：需要在华为云购买数据库，然后将数据库接入AppStage运维中心，当前只支持RDS(for MySQL)、GeminiDB Cassandra、 GaussDB (for openGauss)/TaurusDB接入AppStage运维中心。

步骤二：配置环境 在“服务环境配置”页面，选择左侧导航栏的“服务关联”。 在环境配置区域，选择待配置环境的环境名称。 单击“新增”，新增环境配置，具体参数如表2所示。 表2 环境配置参数 参数 说明 部门 选择已录入的部门。 产品 选择已录入的产品。 服务 选择已录入的服务。 华为公有云账号名 选择用户的华为账号名。 区域 选择使用的区域。 如果选择不到对应区域，需要将鼠标悬停在右上角的账号，在下拉列表选择“服务环境配置”，在“账号列表”页面单击对应账号后的“编辑”，然后单击“确定”，自动刷新该账号下的区域信息。 容灾区域 选择使用的容灾区域。 模式 环境中资源实例的部署模式，单云指部署一个AZ，双云指部署两个AZ。 单击“确定”，完成环境配置。 配置的环境会显示在环境配置列表中。

步骤一：创建环境 进入AppStage运维中心。 将鼠标悬停在右上角的账号，选择下拉列表中的“服务环境配置”，选择左侧导航栏的“环境管理”。 单击“创建”，配置环境参数，具体参数如表1所示。 表1 创建环境参数 参数 说明 名称 填写环境名称，名称全局唯一，只能包含小写字母、数字以及下划线，不能以下划线开头。 用途 选择环境的用途。可选用途包括开发、测试、生产、安全和性能。 描述 环境的描述信息。 单击“确定”。

步骤四：录入企业项目 在项目配置区域，单击“新增”。 新增项目配置，具体参数如表3所示。 表3 项目配置参数 名称 说明 部门 选择已录入的部门。 产品 选择已录入的产品。 服务 选择已录入的服务。 华为公有云账号名 选择用户的华为云账号名。 类型 关联项目：关联已有的公有云EPS。 关联且新增项目：在公有云EPS创建一个新项目，同时进行关联。 企业项目名称 关联项目时，选择已有的公有云EPS。 关联且新增时，填写创建的企业项目名称。 单击“确定”。

管理单项测试结论 在“测试评估”页面选择“测试结论”页签，系统预置了四个测试类型：遗留DI值、功能评估、性能评估和安全评估。 单击“新增”，在“新增测试结论”页面，设置测试结论相关参数，如图2所示，参数说明请参见表2，设置完成后单击“确定”。 图2 编辑测试结论 表2 测试结论参数说明 参数名 参数说明 测试类型 输入测试类型。 测试结论 根据实际情况可设置为：通过、不通过或不涉及。 评估说明（可选） 测试评估的相关说明。 附件（可选） 单击“添加文件”，最多可上传一个附件文件辅助测试评估的说明，且只能上传ZIP、RAR、DOCX、DOC、XLS、XLSX格式文件，文件不能超过50MB。 用户需对自己上传文件的安全风险负责，开发中心不对用户自己上传的文件做任何处理。 添加文件后，如需变更文件，可光标移至文件，在文件右侧单击，将旧文件删除后，再单击“添加文件”重新上传新文件。

管理版本缺陷 Scrum项目 在开发中心首页下方的“我的团队”区域，选择需要操作的团队卡片，进入该团队空间。 如果该团队关联多个服务，可在顶部切换团队关联的其他服务。也可在顶部切换其他团队。 在左侧导航栏选择“缺陷管理”，进入“缺陷管理”页面。 单击“创建缺陷”。 配置如表1所示参数，然后单击“确定”。 表1 创建Scrum项目缺陷参数说明 参数名称 参数说明 缺陷标题 输入缺陷标题，长度应在1~255个字符。 归属版本 选择缺陷归属的版本。 缺陷描述（可选） 输入缺陷描述。 当前处理人 选择缺陷的处理人。取值范围为该项目的全部成员。 IPD系统设备类项目和IPD独立软件类项目：请参考在IPD系统设备类项目中新建缺陷和在IPD独立软件类项目中新建缺陷。

配置流水线（以添加代码检查任务为例） 在流水线的“任务编排”页面，单击，新建阶段，如图3所示。 图3 新建阶段 单击，在“编辑阶段”页面，修改“阶段名称”为“代码检查”，并将“总是运行”设置为“否”（选择“是”，表示流水线执行时，该阶段下的任务默认选中必须执行且不可取消；选择“否”，表示流水线执行时，该阶段下的任务默认选中但可以取消。），然后单击“确定”。 在流水线的“代码检查”阶段，单击“新建任务”。 在“新建任务”页面的右侧区域，选择“代码检查”页签，单击“CodeArtsCheck代码检查”后的“添加”，将此插件添加到任务中，如图4所示。 图4 代码检查 在“CodeArtsCheck代码检查”页面右侧区域“请选择需要调度的任务”处单击“点击创建”，如图5所示，进入“新建任务”页面，参照表2配置参数信息（此处以创建Repo源码源检查任务为例），配置完成后单击“确定”。 图5 创建代码检查任务 表2 参数说明 参数项 描述 所属项目 任务所属项目。默认填写，无需设置。 新建方式 支持直接新建、基于自定义模板新建。 代码源 选择Repo，从代码托管拉取代码进行检查。 任务名称 代码检查任务名称，可自定义。 代码仓 选择需要检查的代码仓库。 默认分支 填写需要检查的仓库分支名称。 检查语言 选择需要检查的代码语言。 返回5的“任务配置”页面，在“请选择需要调度的任务”下拉列表中选择已配置完成的代码检查任务，“仓库”在选择调度的任务后，自动关联且不可修改，其他参数无需配置，保持默认即可。 单击“确定”，添加代码检查任务完成。 单击“任务编排”页面右上角“保存”，保存流水线的任务配置。

配置流水线（以添加业务包构建任务为例） 在流水线的“任务编排”页面，单击，新建阶段。 单击，在“编辑阶段”页面，修改“阶段名称”为“构建阶段”，并将“总是运行”设置为“是”（选择“是”，表示流水线执行时，该阶段下的任务默认选中必须执行且不可取消；选择“否”，表示流水线执行时，该阶段下的任务默认选中但可以取消。），然后单击“确定”。 在流水线的“构建阶段”，单击“新建任务”。 在“新建任务”页面的右侧区域，选择“构建”页签，单击“Build构建”后的“添加”，将此插件添加到任务中。 在“Build构建”页面右侧区域“请选择需要调用的任务”处单击“点击创建”，如图6所示。 图6 Build构建任务配置 在“新建构建任务”页面的“基本信息”页面，自定义任务名称（以“adadss-build”为例），归属项目默认为当前服务，源码源选择“Repo”，选择对应的代码仓库（以创建好的“adadss”仓库为例）以及分支“master”，单击“下一步”。 在“构建模板”页面，选择“空白构建模板”模板，然后单击“确定”，进入“构建步骤”的“图形化”页签，该页面的“构建环境配置”和“代码下线配置”无需配置，保持默认配置即可。 配置构建步骤“Maven构建”。 返回“构建步骤”页签，单击“点击添加构建步骤”，在右侧“添加步骤”页面搜索“Maven构建”，鼠标移至插件卡片并单击“添加”，如图7所示。 图7 Maven构建 执行maven构建命令将业务代码打包，不同项目有所不同。 参考示例：mvn -Dassembly clean compile package -Dmaven.test.skip=true -U -T4 如果某些jar包依赖不到，可将仓库地址添加在setting配置的公有依赖仓库。 配置镜像构建。 登录华为云 容器镜像服务 控制台，在左侧导航栏选择“我的镜像”，单击右上角“页面上传”，在“页面上传”对话框，创建组织（必须使用华为云账号），单击“选择镜像文件”，选择已经准备好的基础镜像tar包，单击“开始上传”，待任务进度显示“上传完成”，表示镜像文件上传成功。 基础镜像tar包仅需上传一次，后续可直接从镜像文件列表中选取。 在镜像仓库找到9.a上传的基础镜像，参照图8复制镜像地址。 图8 复制镜像地址 将9.b复制的镜像地址粘贴到Dockerfile文件中第一行FROM命令后，如图9所示。 图9 将镜像地址粘贴到Dockerfile文件中 返回华为云容器 镜像服务 控制台镜像列表中单击镜像tar包名称，进入镜像详情页面，选择“Pull/Push指南”页签，单击“操作步骤”中的“生成登录指令”。 在“登录指令”对话框中的“临时登录指令”框的指令末尾处单击，复制临时登录指令，如图10所示。 图10 复制临时登录指令 返回“构建步骤”页面，单击“添加步骤”，在右侧“添加步骤”页面搜索“执行Docker命令”，鼠标移至该插件卡片并单击“添加”。 单击“执行Docker命令”步骤，在右侧“命令”参数下单击“添加”添加docker命令，在“命令”下拉框中选择“login”，参数框中输入9.e获取的临时登录指令中login后的部分，例如“-u ******@K5X8GVN5B4H4B8KB9SDO -p 1dd00acee886bd05886cded19f5af1cb1e96326e4354fc0f3f493f12a3586518 swr.******.******.com”，登录环境以便Dockerfile文件中可正常获取基础镜像。 在“操作”列单击“+”继续添加docker命令，“命令”下拉框中选择“build”，并在参数框中输入命令，指定代码仓中的Dockerfile文件并构建镜像。 例如构建helloworldservice:23.11.02.1镜像，可输入“-t helloworldservice:23.11.02.1 -f ./deploy_docker/Dockerfile .”，其中“./deploy_docker/Dockerfile”为Dockerfile文件目录。 工作目录一般为根目录。 在“操作”列单击“+”继续添加docker命令，“命令”下拉框中选择“save”，并在参数框中输入命令，将镜像包保存为tar包。 例如将elloworldservice:23.11.02.1镜像包保存为helloworldservice.23.11.02.1.tar包，可输入“-o helloworldservice.23.11.02.1.tar helloworldservice:23.11.02.1”。至此，添加docker命令完成，如图11所示。 图11 执行docker命令 返回“构建步骤”页面，单击“添加步骤”，在右侧“添加步骤”页面搜索“Maven构建”，鼠标移至插件卡片并单击“添加”。执行zip命令，将tar包与业务代码中的package.json文件直接压缩成一个zip包。 如下命令，将helloworldservice.23.11.02.1.tar和package.json文件压缩为helloworldservice_23.11.02.1.zip包。 zip helloworldservice_23.11.02.1.zip helloworldservice.23.11.02.1.tar package.json 继续单击“添加步骤”，添加“上传文件到OBS”插件，在“上传文件到OBS”页面，参照表3配置相关参数，配置完成后单击右上角“新建”，配置构建任务完成。 表3 “上传文件到OBS”（业务包）步骤配置的参数说明 参数名称 参数说明 步骤显示名称 构建步骤的名称，默认为“上传文件到OBS”，保持默认或自定义修改均可。 授权用户 在下拉列表选择： 当前用户：上传到当前租户的OBS桶。 其他用户：可以通过选择 IAM 账号的方式上传到指定租户的OBS桶。 IAM账号 “授权用户”选择“其他用户”时需配置此参数，配置步骤如下： 单击“管理IAM账号”，进入“服务扩展点管理”页面。 单击“新建服务扩展点”，选择“IAM账户”，弹出“新建服务扩展点”对话框，填写以下参数，补充租户下用户的AK、SK即可： 连接名称：服务扩展点的名称。例如“obs权限”。 Access Key Id：访问密钥ID（AK），获取访问密钥AK/SK。 Secret Access Key：秘密访问密钥（SK），获取访问密钥AK/SK。 信息填写完成，单击“确定”。 构建产物路径 路径为10的zip包的相对路径或输入*模糊匹配（如“./DemoServiceB/*.zip”） 桶名 用户自定义构建结果上传到的目标OBS桶名。 OBS存储目录 用户自定义构建结果在OBS上的存储目录 OBS存储文件名 非必填项，构建结果在OBS上的存储文件名（不包含目录），留空时可上传多个文件，取构建产物文件名为OBS存储文件名；不为空时只能上传单个文件，如application.jar。 是否上传文件夹 非必填项，可选择是否开启上传文件夹。 OBS头域 非必填项，上传文件时加入一个或多个自定义的响应头，当用户下载此对象或查询此对象元数据时，加入的自定义响应头会在返回消息的头域中出现。如：“键”填写成“x-frame-options”，“值”填写成“false”，即可禁止OBS中存放的网页被第三方网页嵌入。 返回5的“任务配置”页面，在“请选择需要调用的任务”下拉列表中选择已配置完成的构建任务，“仓库”下拉列表选择已创建的仓库，其他参数无需配置，保持默认即可。 单击“确定”，添加业务包构建任务完成。 单击“任务编排”页面右上角“保存”，保存流水线的任务配置。

步骤一：创建代码仓 开发人员进行代码开发前，需要先创建代码仓库用于托管代码。 在开发中心首页下方的“我的团队”区域，选择需要操作的团队卡片，进入该团队空间。 如果该团队关联多个服务，可在左侧团队名称右侧单击切换团队关联的其他服务。也可在左侧团队名称右侧单击切换其他团队。 在左侧导航栏选择“代码仓管理”。 单击页面右上角“创建仓库”，输入仓库名称及仓库描述，单击“确定”。 创建后仓库列表显示该仓库，状态为“创建中”，待状态变为“使用中”，可以单击该仓库所在行“操作”列的“详情”，进入仓库详情页面，使用该仓库。关于代码托管文档请参见代码托管 CodeArts Repo。

步骤二：下载代码 下载代码是AppStage集成代码托管CodeArts Repo服务的能力，基于Git的 代码托管服务 ，支持将仓库文件下载到本地进行文件的操作。该操作需要具备开发人员角色权限，权限申请方法请参见申请权限。 在开发中心左侧导航栏，选择“代码仓管理”。首次将仓库克隆/下载到本地的方式主要分为以下三种： 使用SSH协议克隆代码托管仓库到本地。 使用HTTPS协议克隆代码托管仓库到本地。 从浏览器下载代码包。

创建版本 为服务创建版本，进而在版本管理活动中进行流水线和发布流程等有序开发和特定发布过程管理。 在开发中心首页下方的“我的团队”区域，选择需要操作的团队卡片，进入该团队空间。 如果该团队关联多个服务，可在左侧团队名称右侧单击切换团队关联的其他服务。也可在左侧团队名称右侧单击切换其他团队。 在左侧导航栏选择“版本管理”。 在“版本管理”页面右上角，单击“创建版本”。 在“创建版本”页面，设置版本的基本及配置信息，参数说明详见表1。 表1 创建版本参数说明 参数名称 参数说明 基本及配置信息 服务 无需配置，默认为当前服务名称。 版本号 必填项，根据界面输入框填写规划的版本号（系统将自动合成完整版本号）。示例：23.0.1.100 版本描述（可选） 非必填项，版本信息相关的简要描述。由0~200个字符组成。 软件类型 无需配置，默认为“服务软件”。 版本类型 必填项，可分为两种类型： 基线 补丁，在版本规划时需规划补丁版本缺陷。 发布类型 无需配置，默认为“标准发布”。 关联发布计划 仅服务关联了IPD类型的项目（IPD系统设备类项目、IPD独立软件类项目），且“版本类型”选择“基线”时，需配置此参数。 选择需要关联的发布计划，也可勾选“自动创建新发布计划”，自动创建的新发布计划名称默认为版本号。 关联迭代 仅服务关联了Scrum类型的项目，且“版本类型”选择“基线”时，需配置此参数。 选择需要关联的迭代，也可勾选“自动创建新迭代”，自动创建的新迭代名称默认为版本号。 产能 必填项，指版本开发团队每天能提供的开发人员的数量。单位：人/天。 选择计划时间 版本开始时间 必填项，版本开始的日期。 自动创建新发布计划或自动创建新迭代时，开始时间默认为设置的版本开始时间。 版本发布时间 必填项，版本发布的日期。 自动创建新发布计划或自动创建新迭代时，发布时间默认为设置的版本发布时间。 单击“提交”。 在版本列表中可查看到此新建版本。

解决方案 一站式使用应用平台流程如图1所示。 图1 使用流程 表1 使用流程详解 序号 流程环节 说明 1 准备工作 将应用接入AppStage前需要购买AppStage的开发中心、运维中心，并完成相关配置。 2 应用开发 配置开发团队及服务扩展信息 添加开发中心用户 开发中心的用户数根据购买规格有相应的用户数量限制，组织管理员通过用户的添加或删除来合理管理开发中心的使用人员。 创建团队 在开发中心进行服务开发前，需要组织管理员先创建一个团队，将团队关联需要开发的服务。 服务配置 将团队关联服务后，还需将团队关联的服务关联CodeArts项目，后续的服务开发管理过程中才能正常使用CodeArts服务的代码托管、流水线、编译构建功能。 添加团队成员 在团队多用户协作开发过程中，不同角色成员执行各自权限和责任事项，因此需要在团队中添加协作开发的各角色成员（项目经理、开发人员、测试人员等），实现统一有序的成员信息管理。 创建及规划版本 创建版本 对团队所关联的服务划分版本，包括创建版本的基本配置信息以及选择版本开始和结束时间。 规划交付件 在版本开发启动初期对产品开发过程所需的交付件进行规划，以辅助开发过程规范有序且可追溯。 开发版本 创建代码仓 使用代码托管内置的仓库模板创建代码管理的仓库。 下载代码 基于Git的代码托管服务，支持将仓库文件下载到本地进行文件的操作。 安装插件 开发人员可下载所需的开发工具，如WiseStudio插件、Nuwa插件、Wushan插件后进行安装。 开发代码 开发代码的详细指导请参见《开发指南》。 提交代码到代码仓 开发在本地完成业务代码后，需要提交代码文件至代码仓库。 代码安全检视 进行安全编码TOP问题的信息统计和检查结果录入。 管理交付件 管理版本开发过程不同阶段所需或交付的必要文档，保证版本开发过程阶段性成果沉淀以及过程可追溯。 构建版本 根据需要的场景，如开发测试环境应用部署、生产环境应用部署等，对这些自动化任务进行自定义编排，一次配置后就可以一键自动化触发调度执行。 测试版本 对于版本测试过程发现的缺陷进行记录、跟踪、分析和解决，包括管理版本缺陷、管理测试结论以及管理关键风险等。 编辑总体测试结论、系统预置的测试类型结论，新增和管理自定义测试类型的测试结论，以及新增和管理版本关键风险问题。 发布版本 待版本开发及编译构建完成，且发布准入检查项均通过后，可由开发人员、测试人员或项目经理提交标准发布申请，待项目经理审批通过后，将软件发布到对应的部署平台。 3 应用部署 配置服务环境 使用AppStage运维中心前需要先准备环境并为服务关联区域、账号和企业项目。 申请资源 应用部署需要使用虚拟机、CCE、数据库等相关资源，您可以申请资源，或者在华为云购买资源后，将资源接入AppStage。 更新环境 开发完成的应用软件包，通过流水线发布，可以发布至运维中心的部署服务中，使用部署服务完成应用部署。 4 应用运维 数据接入 虚拟机日志接入 支持通过部署filebeat完成虚拟机日志采集。日志接入后，可以对日志进行检索，查看已接入日志，具体操作请参见日志检索。 容器日志接入 支持将容器日志接入AppStage运维中心。 日志接入后，可以对日志进行检索，查看已接入日志，具体操作请参见日志检索。 主机监控接入 支持定义服务的监控模板，然后通过为主机绑定监控模板，采集主机监控数据。 CES指标接入 支持将 云监控服务 CES采集的监控指标数据接入至AppStage运维中心，如需将CES生成的告警接入AppStage运维中心，可参考CES告警接入操作。 运维监控 指标开发 对已产生或接入的数据进行指标开发 监控报表开发 对已创建的指标或视图数据进行业务报表开发。配置后可以查看业务报表监控，具体操作请参见查看业务报表。 告警配置 支持对虚拟机监控数据或业务数据配置告警，及时掌握虚拟机状态，容器接入并安装监控插件后会自动生成告警。告警配置后可以查看告警，并及时处理告警问题，具体操作请参见查看告警。

背景信息 应用平台以“应用”为中心，基于云原生技术，打造了覆盖应用开发、托管、运维全生命周期支持的应用平台，面向企业IT应用、移动应用等提供一站式、集成式的云原生应用服务能力，支持开箱即用，全流程规范可视，高效异地协作，是沉淀行业通用能力，结合华为优秀实践，为产业上云及行业SaaS构建的竞争力底座。 开发应用主要使用AppStage的开发中心，其深度集成CodeArts的功能，购买AppStage后需开通CodeArts后才能使用开发中心，请在AppStage购买页面根据页面提示，前往开通CodeArts地址进行开通。

验证接口能否正常调用 验证接口能否正常调用，本实践中以验证Cloud Map间的相互通信及OrgID的登录流程为例。 配置host。 打开C:\Windows\System32\drivers\etc\hosts，添加本地 域名 ，本实践中添加内容如下：100.85.157.106 org-app.huawei.com。 浏览器访问域名：http://org-app.huawei.com。 登录OrgID。 账号：139*****485 密码：zzp139*****485 访问后端接口：http://org-app.huawei.com:8080/order/1。

操作步骤 在华为云控制台，完成如表1所示的资源购买。 表1 资源列表 资源名称 说明 参考文档 CCE集群 购买1个CCE集群。 根据业务需要选择规模，本实践中选择集群规模为50节点。 购买集群 ECS服务器 购买1个ECS服务器，容灾场景下购买2个ECS服务器。 根据业务需要选择规格，本实践中选择规格为：通用计算增强型/2vCPUs/4GiB/c6.large.2 购买ECS 启用环境并录入账号信息，具体请参见环境配置及账号录入。 完成资源接入，具体请参见资源接入。 在微服务容器化部署前，需要在微服务平台为环境绑定CCE集群，用于在环境下部署和运行微服务。具体请参见创建容器部署环境。