• CubeAI智立方——个人中心(ppersonal)
• • 基本配置
  • 运行/调试/二次开发

CubeAI智立方——个人中心(ppersonal)

ppersonal是 CubeAI智立方平台 中用于实现个人中心用户界面的前端微服务。

ppersonal基于 CubePy微服务框架 和 ServiceBoot微服务引擎 开发。其中前端界面基于Angular框架，使用TypeScript、HTML等语言开发。

基本配置

• 监听端口

  • 开发环境： 8201（可任意）
  • 生产环境： 80

• 服务注册与发现：

  • 非k8s环境： Consul(8500)
  • k8s环境： k8s内置DNS

运行/调试/二次开发

1. 下载代码并安装前端依赖包

   第一次从Git服务器克隆本项目代码后，应先在本项目 webapp 目录下执行如下命令以安装前端开发需要的Node依赖：

    $ cd webapp
    $ npm install
   

2. 开发环境中运行本微服务之前，需要先拉起项目依赖的后台docker。

    $ cd ~/cubenet/cubeai/dev
    $ docker-compose up
   

   参见 CubeAI智立方平台 之README文档。

3. 使用PyCharm打开本project所在目录。

4. 建议在PyCharm中专门为本project新建一个专用Python虚拟环境，Python版本选择3.5以上。

5. 在PyCharm的terminal窗口中执行如下命令安装依赖包：

    $ sh pip-install-reqs.sh
   

   依赖包安装完成后，可在terminal窗口中执行如下命令来查看serviceboot所有命令行格式：

    $ serviceboot
   

6. 在PyCharm窗口中右键单击“start.py”文件，选择“run 'start'”或者“debug 'start'”来运行或调试程序。

7. 每次前端代码改动后，在terminal窗口中运行：

    $ cd webapp
    $ ng build
    或者
    $ ng build --prod
   

   来完成代码编译。

8. 然后在浏览器中打开或刷新页面：

    http://127.0.0.1:8080
   

   gateway网关会自动将主页面路由至portal微服务来提供前端界面服务。

   为了能在主页界面中显示并有效操作该应用，首次登录时需要执行如下操作：

   1. 以具有ROLE_APPLICATION角色的用户帐号登录。

   2. 进入“系统管理|应用管理”页面，创建一个新应用：

      • 应用名称： 个人中心
      • URL: /ppersonal/#/
      • 主题1： 平台导航
      • 主题2： homepage
      • 所需角色： ROLE_USER

9. 各前端微服务的Angular代码修改之后，重复执行上述第7-8步。

10. 开发完成后，可在terminal窗口中执行如下命令来生成微服务docker镜像：

    $ serviceboot build_docker
    或者
    $ sh build-docker.sh