中心应用是利用BizWorks平台进行建模、开发、部署并运维的应用,除了包含托管应用的能力外,还提供可视化编排、脚手架生成等能力加快应用开发速度。本文为您介绍如何创建和管理中心应用。
前提条件
已完成项目创建。
当前账号拥有项目权限。
已准备好代码仓库和访问凭证,供代码库配置使用。
创建中心应用(DDD模板)
登录BizWorks,在选择平台下拉列表中选中微服务开发平台。
单击页面右上角图标或其文本框区域,在下拉列表中单击目标项目名称,单击应用页签。在应用列表页面,单击新增应用。
在创建应用面板,选中根据模板创建,单击下一步。
在创建应用的选择模板配置向导页,选中中心应用DDD模板,单击下一步。
您可以单击详情,在详情面板的应用模板介绍和可配置项页签查看相应详情。
在根据模板(ddd-template)创建应用面板的应用基本信息配置向导页面,设置相关参数。
配置应用基本信息,填写应用名称、应用编码、描述(可选填),并为应用设置一个图标标识。
说明应用编码为小写字母、数字、短划线(-)的组合,需以小写字母开头,长度不超过30个字符,且项目内唯一。
配置起始版本信息,填写起始版本号(默认为v1.0.0)及起始版本号描述。
配置代码库有两种方式:新建代码库和关联已有代码库。
方式一:新建代码库
如果仓库类型选择自建Gitlab,您可以参考以下步骤完成配置。
从代码源下拉列表中选择目标代码源。
如果您是首次使用,或者需要新增代码源,单击代码源右侧的管理代码源。
在管理代码源面板,单击添加代码源,设置相关参数,然后单击保存,界面提示保存成功后,单击关闭。
您也可以单击面板右上角连接测试,验证所填信息是否正确。
如果您需要修改代码源,单击代码源右侧的管理代码源。在管理代码源面板,单击目标代码源,设置相关参数,然后单击保存,界面提示保存成功后,单击关闭。
如果您需要删除代码源,单击代码源右侧的管理代码源。在管理代码源面板,单击目标代码源右侧的图标,界面提示删除成功后,单击关闭。
重要如果目标代码源已经被某个或某些应用使用,请您解除应用与该代码源的使用关系后,再重新进行删除操作。
从代码组下拉列表中选择目标代码组。
填写新建仓库,完成后单击下一步。
说明英文字母、数字和短划线(-)的组合,需以字母开头。
如果仓库类型选择云效Codeup-公有云,您可以参考以下步骤完成配置。
在仓库组件下拉列表中选择目标仓库组织,在请选择组下拉列表中选择目标组。
填写新建仓库。
说明英文字母、数字和短划线(-)的组合,需以字母开头。
方式二:关联已有代码库
如果仓库类型选择自建Gitlab,您可以参考方式一中的新建代码库相关步骤完成配置。
如果仓库类型选择云效Codeup-公有云,您可以参考以下步骤完成配置。
在仓库组织下拉列表中选择目标仓库组织,在请选择组下拉列表中选择目标组。
在代码仓库下拉列表中选择目标代码仓库。
完成后单击下一步。
可选:在模板基础配置向导页面,设置GroupId,选择Spring Boot版本,且按需完成其他配置项设置或修改后,单击下一步。
说明GroupId、ArtifactId和包路径需为小写字母、数字和小数点的组合,且需以字母开头,以字母或数字结尾。
Version需为大小写字母、数字、小数点和短横线的组合,且需以字母开头,以字母或数字结尾。
可选:在模板高级配置向导页面,您可添加一个或多个当前项目中的限界上下文。
重要限界上下文如果已经被其他应用关联了,则不能被再次关联。
支持关联BizWorks建模平台的技术模型产物,并围绕模型信息在脚手架中生成代码。如果未关联则默认不基于模型生成代码,后续在应用详情页中配置关联。
单击添加。
在选择限界上下文对话框,选中目标限界上下文,单击确定。
在目标限界上下文的限界上下文版本下拉列表中,选择目标版本。
可选:支持自定义脚手架模板的包路径。在脚手架模板目录下,单击目标Package右侧的,您可以进行如下操作:
新建子包路径。单击新建子包路径,在新建子包路径对话框中完成包路径配置后,单击创建。
添加聚合为子包路径。单击添加聚合为子包路径,在添加聚合为子包路径对话框中您可以填写说明信息,完成后单击创建。
说明自定义的子包路径支持删除。
编辑包路径。单击编辑包路径,在编辑子包路径对话框中,完成包路径修改后,单击保存。
单击保存。
可选:在应用列表页面,单击目标中心应用,在目标中心应用导航栏中,单击应用概览。
中心应用的应用概览页包括以下内容:
序号
名称
描述
①
应用名称
中心应用实例的名称。
②
快速入口
单击页面右侧的快速入口,进入对应的页面。
③
基本信息
展示应用类型、当前版本、所属项目以及关联的代码仓库地址等信息。
单击所属项目,跳转至该项目的详情页。
单击代码仓库地址,在新标签页中打开代码仓库。
④
Serverless资源用量
显示当前版本轻应用的Serverless资源用量,包括:本月CPU资源使用量、本月Memory资源使用量、实时CPU资源使用量和实时Memory资源使用量。
⑤
应用部署信息
显示所有已经部署成功的环境的相关信息,环境的显示顺序为:
。单击运行日志可以查看运行日志。
创建中心应用(MVC模板)
在创建应用面板,选中根据模板创建,单击下一步。
在创建应用的选择模板配置向导页,选中中心应用MVC模板,单击下一步。
您可以单击详情,在详情面板的应用模板介绍和可配置项页签查看相应详情。
在根据模板(mvc-template)创建应用面板的应用基本信息配置向导页面,设置相关参数。
配置应用基本信息,填写应用名称、应用编码、描述(可选填),并为应用设置一个图标标识。
说明应用编码为小写字母、数字、短划线(-)的组合,需以小写字母开头,长度不超过30个字符,且项目内唯一。
配置起始版本信息,填写起始版本号(默认为v1.0.0)及起始版本号描述。
配置代码库有两种方式:新建代码库和关联已有代码库。
方式一:新建代码库
如果仓库类型选择自建Gitlab,您可以参考以下步骤完成配置。
从代码源下拉列表中选择目标代码源。
如果您是首次使用,或者需要新增代码源,单击代码源右侧的管理代码源。
在管理代码源面板,单击添加代码源,设置相关参数,然后单击保存,界面提示保存成功后,单击关闭。
您也可以单击面板右上角连接测试,验证所填信息是否正确。
如果您需要修改代码源,单击代码源右侧的管理代码源。在管理代码源面板,单击目标代码源,设置相关参数,然后单击保存,界面提示保存成功后,单击关闭。
如果您需要删除代码源,单击代码源右侧的管理代码源。在管理代码源面板,单击目标代码源右侧的图标,界面提示删除成功后,单击关闭。
重要如果目标代码源已经被某个或某些应用使用,请您解除应用与该代码源的使用关系后,再重新进行删除操作。
从代码组下拉列表中选择目标代码组。
填写新建仓库,完成后单击下一步。
说明英文字母、数字和短划线(-)的组合,需以字母开头。
如果仓库类型选择云效Codeup-公有云,您可以参考以下步骤完成配置。
在仓库组件下拉列表中选择目标仓库组织,在请选择组下拉列表中选择目标组。
填写新建仓库。
说明英文字母、数字和短划线(-)的组合,需以字母开头。
方式二:关联已有代码库
如果仓库类型选择自建Gitlab,您可以参考方式一中的新建代码库相关步骤完成配置。
如果仓库类型选择云效Codeup-公有云,您可以参考以下步骤完成配置。
在仓库组织下拉列表中选择目标仓库组织,在请选择组下拉列表中选择目标组。
在代码仓库下拉列表中选择目标代码仓库。
完成后单击下一步。
可选:在模板基础配置向导页面,设置GroupId,选择Spring Boot版本,且按需完成其他配置项设置或修改后,单击保存。
创建空应用
在创建应用面板,选中空应用,单击下一步。
新建空应用:新建一个空的中心应用,即未关联模型、未生成代码、未关联代码仓库等,仅包含应用基本信息的中心应用。
在创建空应用面板,您可以参考以下步骤完成设置。
配置应用基本信息,填写应用名称、应用编码、描述(可选填),并为应用设置一个图标标识。
说明应用编码为小写字母、数字、短划线(-)的组合,需以小写字母开头,长度不超过30个字符,且项目内唯一。
配置起始版本信息,填写起始版本号(默认为v1.0.0)及起始版本号描述。完成后单击保存。
可选:配置代码库信息。打开配置代码库开关。
配置代码库有两种方式:新建代码库和关联已有代码库。
方式一:新建代码库
如果仓库类型选择自建Gitlab,您可以参考以下步骤完成配置。
从代码源下拉列表中选择目标代码源。
如果您是首次使用,或者需要新增代码源,单击代码源右侧的管理代码源。
在管理代码源面板,单击添加代码源,设置相关参数,然后单击保存,界面提示保存成功后,单击关闭。
您也可以单击面板右上角连接测试,验证所填信息是否正确。
如果您需要修改代码源,单击代码源右侧的管理代码源。在管理代码源面板,单击目标代码源,设置相关参数,然后单击保存,界面提示保存成功后,单击关闭。
如果您需要删除代码源,单击代码源右侧的管理代码源。在管理代码源面板,单击目标代码源右侧的图标,界面提示删除成功后,单击关闭。
重要如果目标代码源已经被某个或某些应用使用,请您解除应用与该代码源的使用关系后,再重新进行删除操作。
从代码组下拉列表中选择目标代码组。
填写新建仓库,完成后单击保存。
说明英文字母、数字和短划线(-)的组合,需以字母开头。
如果仓库类型选择云效Codeup-公有云,您可以参考以下步骤完成配置。
在仓库组件下拉列表中选择目标仓库组织,在请选择组下拉列表中选择目标组。
填写新建仓库,完成后单击保存。
方式二:关联已有代码库
如果仓库类型选择自建Gitlab,您可以参考方式一:新建代码库的相关步骤完成配置。
如果仓库类型选择云效Codeup-公有云,您可以参考以下步骤完成配置。
在仓库组织下拉列表中选择目标仓库组织,在请选择组下拉列表中选择目标组。
在代码仓库下拉列表中选择目标代码仓库。完成后单击保存。
编辑中心应用
在应用列表中,单击目标应用右侧操作列下的编辑属性。
在编辑中心应用面板,完成相关配置项修改后,单击完成。
修改应用名称、描述和应用图标设置等配置项。
说明您在编辑修改时,个人凭证类型需和代码源类型需保持一致。例如:如果代码源类型是
Gitlab
,个人凭证类型修改成了云效Codeup-公有云
,平台会校验不通过。设置代码项目基本信息中的GroupId和ArtifactId配置项。
该配置项用于生成代码的脚手架工程信息和SDK生成的Maven坐标。
参数
说明
GroupId
填写工程GroupId的名称。限制如下:
由小写字母、数字和小数点组成。
需以小写字母开头,且需以小写字母或数字结尾。
字符数不超过64位。
ArtifactId
默认为该应用的编码。您可以修改此编码,限制如下:
由小写字母、数字和短横线(-)组成。
需以小写字母开头,且需以小写字母或数字结尾。
字符数不超过64位。
删除中心应用
在应用列表中,单击目标应用右侧操作列下的删除,在二次确认对话框中单击删除。
请确保待删除的应用中没有正在运行的部署实例,否则系统会提示您删除应用失败。