文档

建设共享能力中心

更新时间:

本文为您介绍如何在BizWorks中建设一个完整的中心应用,包括创建应用、生成代码、完成应用部署。

前提条件

  • 已完成项目创建。

  • 当前账号拥有项目权限。

  • 已准备好代码仓库和访问凭证,供代码库配置使用。

步骤一:创建中心应用

中心应用是利用BizWorks平台进行建模、开发、部署并运维的应用,提供代码生成等能力,能够加快应用开发速度。本文以创建交易中心应用为例,实现基础交易、预售交易,以及交易域下基础能力。

  1. 登录BizWorks,在选择平台下拉列表中选中微服务开发平台image.png

  2. 单击页面右上角a7.png图标或其文本框区域,在下拉列表中单击目标项目名称,单击应用页签。在应用列表页面,单击新增应用

  3. 创建应用面板,选中根据模板创建,单击下一步image.png

  4. 创建应用选择模板配置向导页,选中中心应用DDD模板,单击下一步image.png

  5. 根据模板(ddd-template)创建应用面板的应用基本信息配置向导页面,设置相关参数。具体操作,请参见创建中心应用(DDD模板)

  6. 可选:在模板基础配置向导页面,设置GroupId,选择Spring Boot版本,且按需完成其他配置项设置或修改后,单击下一步

  7. 可选模板高级配置向导页面,您可添加一个或多个当前项目中的限界上下文。完成设置后,单击保存

    重要
    • 限界上下文如果已经被其他应用关联了,则不能被再次关联。

    • 支持关联BizWorks建模平台的技术模型产物,并围绕模型信息在脚手架中生成代码。如果未关联则默认不基于模型生成代码,后续在应用详情页中配置关联。

    image.png

    创建完成后,打开该应用的应用开发 > 代码生成页面,您可以看到代码已经生成。

步骤二:生成代码

根据模型设计生成代码,并将代码提交到代码仓库。

重要

如果要生成代码,请您确保当前应用为中心应用,且已关联了限界上下文。

  1. 单击页面右上角image.png图标或其文本框区域,在下拉列表中单击目标项目名称后,单击应用页签。在应用列表页面单击目标中心应用名称。image.png

  2. 在目标中心应用左侧导航栏中,选择应用开发 > 代码生成

  3. 代码生成页面,单击目标分支名称,在代码生成面板您可以查看相关代码详情。image.png

    代码生成后,您可以进入对应的代码仓库,查看生成的分支,包含App、Entry、Domain、Infrastructure、Client、Extension和Starter7个基础模块(Module)。模块具体说明,请参见代码模块说明

步骤三:部署应用

  1. 在目标中心应用左侧导航栏中,选择应用部署 > 实例管理

  2. 应用部署页面,选择需要部署的环境,单击目标环境下的虚线框区域。

    说明

    应用部署页面不仅支持显示一个环境下的多个实例,以及每个实例下的工作负载,而且能够显示每个工作负载的类型。

    1

    只有企业级用户、项目负责人和应用负责人账号角色,既能看到开发环境测试环境下的环境信息,也能看到预发环境生产环境下的环境信息,并能进行部署、更新实例等操作。其他账号角色只能看到开发环境测试环境下的环境信息,在相应的环境下也能进行部署、更新实例等操作。

    关于BizWorks的账号体系的详细信息,请参见平台账号和权限说明1

  3. 新建部署实例面板,完成部署配置,单击下一步

    • 如果您部署实例的环境所属的集群为非阿里云BizWorks Serverless集群1,则部署面板详情如下。1

      关于接入集群的更多信息,请参见接入和管理集群

    • 如果您部署实例的环境所属的集群为阿里云BizWorks Serverless集群1,则部署面板详情如下(资源配置的配额为固定选项,不支持自定义,且需设置网络配置)。2

    相关配置项说明请参见下表。

    配置项

    说明

    应用来源

    • 选择应用版本下拉列表中选择目标应用版本,您可以选择已发布或开发中的版本。

    • 选择类型,支持代码镜像

      • 如果选择代码,且选择的版本状态为开发中,则还需要选择代码分支,设置Commit ID(非必填,不填写Commit ID时,默认使用分支的最新版本)。

      • 如果选择镜像,则单击选择镜像,在选择镜像对话框中,选中目标镜像后,单击确定1

    说明

    Commit ID为空时,则默认使用该分支的最新版本,实例部署成功后平台会将代码检出时的Commit ID进行记录;实例更新部署时,Commit ID默认也是为空,如需指定版本,需要您再次设置。

    流水线

    选择流水线下拉列表中,选择目标流水线。

    • 默认流水线:BizWorks内置的流水线,包含拉取代码、编译代码、构建镜像和部署应用等基本功能。

    • 自定义流水线:关于如何新建自定义流水线,请参见新增自定义流水线

      说明

      如果您可以找到有满足条件的自定义流水线,则将无法使用默认流水线(即默认流水线不显示);如果您未找到满足条件的自定义流水线,则仍然可以使用默认流水线部署应用。

    • 三方流水线

      • 您可以通过集成三方流水线产品,使用DevOps中更多的能力。如果您已经为应用添加三方流水线,则可以选择三方流水线部署应用实例。关于如何集成三方流水线,请参见三方流水线集成概述

      • 如果您已经开启项目流水线配置开关,则在部署流水线下拉列表中,不会出现默认流水线的选项。关于如何打开项目流水线配置开关,请参见创建和管理三方流水线连接配置

    部署配置

    • 部署策略

      • 默认策略:按照滚动方式进行发布,每次启动一个新副本,就绪后停掉一个老副本,直到全部完成。

      • 自定义策略:可选择按Pod数按百分比

    • 高级选项:单击添加,完成相关配置项设置。

      容忍度:支持选择目标环境上已经部署成功的记录为基础,在其基础上确定应用模板需要的镜像信息、部署参数等。

      1

      KeyValue的配置规则如下:

      • Key

        • 不能超过253个字符。

        • 支持字母、数字、短划线(-) 和半角句号(.)。

        • 需以字母、数字字符(a~z、0~9、A~Z)开头和结尾。

      • Value

        • 不能超过63个字符。

        • 支持字母、数字、短划线(-)和半角句号(.)。

        • 如果标签值不为空,则需以字母、数字字符(a~z、0~9、A~Z)开头和结尾。

    网络配置

    部署实例的环境所属的集群为阿里云BizWorks Serverless公有版1时,您需设置网络配置

    • 安全组支持使用环境的默认安全组使用现有安全组。如果您选择使用现有安全组,需在相应下拉列表中选择目标现有安全组。

    • 应用访问策略支持集群内应用实例互访VPC内私网访问

    资源配置

    配置实例总数单实例资源配额

    • 如果您部署实例的环境所属的集群为非阿里云BizWorks Serverless集群1:CPU资源的约束和请求以CPU为单位,如果数值为0.1则等价为100 mCPU;内存的约束和请求以字节为单位,如果数值为1024 MiB则等价为1024 MB。资源限制需大于资源预留。

    • 如果您部署实例的环境所属的集群为阿里云BizWorks Serverless集群1:您可以选择vCPU内存的目标配额选项。1

  4. 新建实例部署 - 环境配置面板中,完成环境配置后,单击开始部署1

    1. 可选:设置生命周期管理

    2. 可选:设置环境变量

    3. 可选:设置存储

    4. 可选:设置健康检查

    5. 可选:设置应用监控

    6. 可选:设置标签

    相关配置项说明,请参见部署和管理中心应用实例

    页面提示创建成功,同时环境中新增一个正在部署中的实例卡片。1

  • 本页导读 (1)
文档反馈