创建和管理中心应用

中心应用是利用BizWorks平台进行建模、开发、部署并运维的应用,除了包含托管应用的能力外,还提供可视化编排、脚手架生成等能力加快应用开发速度。本文为您介绍如何创建和管理中心应用。

前提条件

  • 已完成项目创建。

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

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

创建中心应用(DDD模板)

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

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

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

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

    您可以单击详情,在详情面板的应用模板介绍可配置项页签查看相应详情。image.png

  5. 根据模板(ddd-template)创建应用面板的应用基本信息配置向导页面,设置相关参数。

    1. 配置应用基本信息,填写应用名称应用编码描述(可选填),并为应用设置一个图标标识。

      说明

      应用编码为小写字母、数字、短划线(-)的组合,需以小写字母开头,长度不超过30个字符,且项目内唯一。

    2. 配置起始版本信息,填写起始版本号(默认为v1.0.0)及起始版本号描述

    3. 配置代码库有两种方式:新建代码库关联已有代码库

      方式一:新建代码库

      • 如果仓库类型选择自建Gitlab,您可以参考以下步骤完成配置。

        1. 代码源下拉列表中选择目标代码源。

        2. 如果您是首次使用,或者需要新增代码源,单击代码源右侧的管理代码源

          管理代码源面板,单击添加代码源,设置相关参数,然后单击保存,界面提示保存成功后,单击关闭

          您也可以单击面板右上角连接测试,验证所填信息是否正确。

        3. 如果您需要修改代码源,单击代码源右侧的管理代码源。在管理代码源面板,单击目标代码源,设置相关参数,然后单击保存,界面提示保存成功后,单击关闭

        4. 如果您需要删除代码源,单击代码源右侧的管理代码源。在管理代码源面板,单击目标代码源右侧的1图标,界面提示删除成功后,单击关闭

          重要

          如果目标代码源已经被某个或某些应用使用,请您解除应用与该代码源的使用关系后,再重新进行删除操作。

        5. 代码组下拉列表中选择目标代码组。

        6. 填写新建仓库,完成后单击下一步

          说明

          英文字母、数字和短划线(-)的组合,需以字母开头。

      • 如果仓库类型选择云效Codeup-公有云,您可以参考以下步骤完成配置。

        1. 仓库组件下拉列表中选择目标仓库组织,在请选择组下拉列表中选择目标组。

        2. 填写新建仓库

          说明

          英文字母、数字和短划线(-)的组合,需以字母开头。

      方式二:关联已有代码库

      • 如果仓库类型选择自建Gitlab,您可以参考方式一中的新建代码库相关步骤完成配置。

      • 如果仓库类型选择云效Codeup-公有云,您可以参考以下步骤完成配置。

        1. 仓库组织下拉列表中选择目标仓库组织,在请选择组下拉列表中选择目标组。

        2. 代码仓库下拉列表中选择目标代码仓库。

    4. 完成后单击下一步

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

    说明
    • GroupIdArtifactId包路径需为小写字母、数字和小数点的组合,且需以字母开头,以字母或数字结尾。

    • Version需为大小写字母、数字、小数点和短横线的组合,且需以字母开头,以字母或数字结尾。

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

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

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

    1. 单击添加image.png

    2. 选择限界上下文对话框,选中目标限界上下文,单击确定image.png

    3. 在目标限界上下文的限界上下文版本下拉列表中,选择目标版本。

    4. 可选:支持自定义脚手架模板的包路径。在脚手架模板目录下,单击目标Package右侧的image.png,您可以进行如下操作:image.png

      • 新建子包路径。单击新建子包路径,在新建子包路径对话框中完成包路径配置后,单击创建image.png

      • 添加聚合为子包路径。单击添加聚合为子包路径,在添加聚合为子包路径对话框中您可以填写说明信息,完成后单击创建

        说明

        自定义的子包路径支持删除。

      • 编辑包路径。单击编辑包路径,在编辑子包路径对话框中,完成包路径修改后,单击保存image.png

    5. 单击保存

  8. 可选:应用列表页面,单击目标中心应用,在目标中心应用导航栏中,单击应用概览

    中心应用的应用概览页包括以下内容:image.png

    序号

    名称

    描述

    应用名称

    中心应用实例的名称。

    快速入口

    单击页面右侧的快速入口,进入对应的页面。

    基本信息

    展示应用类型当前版本所属项目以及关联的代码仓库地址等信息。

    • 单击所属项目,跳转至该项目的详情页。

    • 单击代码仓库地址,在新标签页中打开代码仓库。

    Serverless资源用量

    显示当前版本轻应用的Serverless资源用量,包括:本月CPU资源使用量、本月Memory资源使用量、实时CPU资源使用量和实时Memory资源使用量。

    应用部署信息

    显示所有已经部署成功的环境的相关信息,环境的显示顺序为:生产环境 > 预发环境 > 测试环境 > 开发环境。单击运行日志可以查看运行日志。

创建中心应用(MVC模板)

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

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

    您可以单击详情,在详情面板的应用模板介绍可配置项页签查看相应详情。image.png

  3. 根据模板(mvc-template)创建应用面板的应用基本信息配置向导页面,设置相关参数。

    1. 配置应用基本信息,填写应用名称应用编码描述(可选填),并为应用设置一个图标标识。

      说明

      应用编码为小写字母、数字、短划线(-)的组合,需以小写字母开头,长度不超过30个字符,且项目内唯一。

    2. 配置起始版本信息,填写起始版本号(默认为v1.0.0)及起始版本号描述

    3. 配置代码库有两种方式:新建代码库关联已有代码库

      方式一:新建代码库

      • 如果仓库类型选择自建Gitlab,您可以参考以下步骤完成配置。

        1. 代码源下拉列表中选择目标代码源。

        2. 如果您是首次使用,或者需要新增代码源,单击代码源右侧的管理代码源

          管理代码源面板,单击添加代码源,设置相关参数,然后单击保存,界面提示保存成功后,单击关闭

          您也可以单击面板右上角连接测试,验证所填信息是否正确。

        3. 如果您需要修改代码源,单击代码源右侧的管理代码源。在管理代码源面板,单击目标代码源,设置相关参数,然后单击保存,界面提示保存成功后,单击关闭

        4. 如果您需要删除代码源,单击代码源右侧的管理代码源。在管理代码源面板,单击目标代码源右侧的1图标,界面提示删除成功后,单击关闭

          重要

          如果目标代码源已经被某个或某些应用使用,请您解除应用与该代码源的使用关系后,再重新进行删除操作。

        5. 代码组下拉列表中选择目标代码组。

        6. 填写新建仓库,完成后单击下一步

          说明

          英文字母、数字和短划线(-)的组合,需以字母开头。

      • 如果仓库类型选择云效Codeup-公有云,您可以参考以下步骤完成配置。

        1. 仓库组件下拉列表中选择目标仓库组织,在请选择组下拉列表中选择目标组。

        2. 填写新建仓库

          说明

          英文字母、数字和短划线(-)的组合,需以字母开头。

      方式二:关联已有代码库

      • 如果仓库类型选择自建Gitlab,您可以参考方式一中的新建代码库相关步骤完成配置。

      • 如果仓库类型选择云效Codeup-公有云,您可以参考以下步骤完成配置。

        1. 仓库组织下拉列表中选择目标仓库组织,在请选择组下拉列表中选择目标组。

        2. 代码仓库下拉列表中选择目标代码仓库。

    4. 完成后单击下一步

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

创建空应用

  1. 创建应用面板,选中空应用,单击下一步image.png

    新建空应用:新建一个空的中心应用,即未关联模型、未生成代码、未关联代码仓库等,仅包含应用基本信息的中心应用。

  2. 创建空应用面板,您可以参考以下步骤完成设置。image.png

    1. 配置应用基本信息,填写应用名称、应用编码、描述(可选填),并为应用设置一个图标标识。

      说明

      应用编码为小写字母、数字、短划线(-)的组合,需以小写字母开头,长度不超过30个字符,且项目内唯一。

    2. 配置起始版本信息,填写起始版本号(默认为v1.0.0)及起始版本号描述。完成后单击保存

    3. 可选配置代码库信息。打开配置代码库开关。image.png

      配置代码库有两种方式:新建代码库关联已有代码库

      方式一:新建代码库

      • 如果仓库类型选择自建Gitlab,您可以参考以下步骤完成配置。

        1. 代码源下拉列表中选择目标代码源。

        2. 如果您是首次使用,或者需要新增代码源,单击代码源右侧的管理代码源

          管理代码源面板,单击添加代码源,设置相关参数,然后单击保存,界面提示保存成功后,单击关闭

          您也可以单击面板右上角连接测试,验证所填信息是否正确。

        3. 如果您需要修改代码源,单击代码源右侧的管理代码源。在管理代码源面板,单击目标代码源,设置相关参数,然后单击保存,界面提示保存成功后,单击关闭

        4. 如果您需要删除代码源,单击代码源右侧的管理代码源。在管理代码源面板,单击目标代码源右侧的1图标,界面提示删除成功后,单击关闭

          重要

          如果目标代码源已经被某个或某些应用使用,请您解除应用与该代码源的使用关系后,再重新进行删除操作。

        5. 代码组下拉列表中选择目标代码组。

        6. 填写新建仓库,完成后单击保存

          说明

          英文字母、数字和短划线(-)的组合,需以字母开头。

      • 如果仓库类型选择云效Codeup-公有云,您可以参考以下步骤完成配置。

        1. 仓库组件下拉列表中选择目标仓库组织,在请选择组下拉列表中选择目标组。

        2. 填写新建仓库,完成后单击保存

      方式二:关联已有代码库

      • 如果仓库类型选择自建Gitlab,您可以参考方式一:新建代码库的相关步骤完成配置。

      • 如果仓库类型选择云效Codeup-公有云,您可以参考以下步骤完成配置。

        1. 仓库组织下拉列表中选择目标仓库组织,在请选择组下拉列表中选择目标组。

        2. 代码仓库下拉列表中选择目标代码仓库。完成后单击保存

编辑中心应用

  1. 应用列表中,单击目标应用右侧操作列下的编辑属性

  2. 编辑中心应用面板,完成相关配置项修改后,单击完成

    • 修改应用名称描述应用图标设置等配置项。

      说明

      您在编辑修改时,个人凭证类型需和代码源类型需保持一致。例如:如果代码源类型是Gitlab,个人凭证类型修改成了云效Codeup-公有云,平台会校验不通过。

    • 设置代码项目基本信息中的GroupIdArtifactId配置项。

      该配置项用于生成代码的脚手架工程信息和SDK生成的Maven坐标。

      参数

      说明

      GroupId

      填写工程GroupId的名称。限制如下:

      • 由小写字母、数字和小数点组成。

      • 需以小写字母开头,且需以小写字母或数字结尾。

      • 字符数不超过64位。

      ArtifactId

      默认为该应用的编码。您可以修改此编码,限制如下:

      • 由小写字母、数字和短横线(-)组成。

      • 需以小写字母开头,且需以小写字母或数字结尾。

      • 字符数不超过64位。

删除中心应用

应用列表中,单击目标应用右侧操作列下的删除,在二次确认对话框中单击删除

说明

请确保待删除的应用中没有正在运行的部署实例,否则系统会提示您删除应用失败。