WeCube Developer Guide

准备工作

安装JDK

需要在开发电脑上先安装JDK，请参考JDK安装文档
安装Eclipse

需要在开发电脑上先安装Eclipse，请参考Eclipse安装文档
安装Mysql

需要在开发电脑上先安装Mysql，请参考Mysql安装文档
安装node.js

访问node.js官方网站：http://nodejs.cn/download，下载v10.16.3版本。双击下载后的安装文件，按默认配置进行安装。
安装对象存储（可选）

在本地开发电脑上运行WeCube，如果需要使用物料管理、插件功能，则需要一个支持S3协议的对象存储，可以使用远程服务，也可以在本地开发电脑部署。本指引以Minio为例。

如果不使用物料管理、插件功能，则无需部署。

dockerhub上有容器镜像，可以直接下载安装：https://hub.docker.com/r/minio/minio/

安装命令如下：
```
docker pull minio/minio
docker run -p 9000:9000 -e MINIO_ACCESS_KEY=access_key -e MINIO_SECRET_KEY=secret_key minio/minio server /data
```
需要预先部署WeCMDB

在本地开发电脑上运行WeCube，需要WeCMDB支持。

可以使用远程服务器上部署的WeCMDB，也可以在本地开发电脑上运行WeCMDB，详情请查看WeCMDB介绍中的“快速入门”和“开发者文档”。

注：需要在WeCMDB的白名单中增加本地IP地址， WeCube才能调用WeCMDB的接口。

导入工程

可以直接从git上拉取代码，也可以先将代码工程拉取到本地后，再导入到Eclipse中，本文以从本地导入为例。

导入工程

选择导入已有项目

选择已有maven工程

选择wecube的代码目录作为根目录，确认后完成导入。

工程导入后，会自动下载依赖包及编译，请确保网络连接正常。
切换视图

导入项目后，需要在 Window > Show View 中选择 Project Explorer

初始化数据库

需要在本地或者远程的数据库上建立用户和database。

参考语句：

create database wecube_dev DEFAULT CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci; 

create USER 'wecube'@'localhost' IDENTIFIED WITH mysql_native_password BY 'Abcd1234';

grant all privileges on `wecube_dev`.* to 'wecube'@'%' identified by 'Abcd1234';

在database上执行以下数据初始化脚本： 01.wecube.schema.sql, 02.wecube.system.data.sql

配置文件

在 Project Explorer 视图中，将 application-uat.yml 复制一份，更名为 application-dev.yml wecube_config_1

打开 application-dev.yml ，修改相关配置，开发模式下无需CAS，可将CAS相关配置去掉。

application-dev.yml配置示例：

server:
  port: 8080
  address: localhost

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://127.0.0.1:3306/wecube_dev?characterEncoding=utf8&serverTimezone=UTC
    username: wecube
    password: password

wecube:
  core:
    cmdb-server-url: http://192.168.20.5:37000/cmdb
    plugin:
      plugin-hosts: 192.168.0.1, 192.168.0.2
      plugin-package-name-of-deploy: deployment-plugin-name

    s3:
      endpoint: http://dev-s3-server:9000
      access-key: access_key
      secret-key: secret_key

在本地开发模式下可以不启用S3服务，endpoint可以不需要填。

cmdb-server-url必填，并需要在WeCMDB中将本地IP添加到白名单中。

启动WeCube后端

打开Window->Preferences窗口，选择Java->Installed JREs，新增jdk配置，如下图

下载依赖，编译，如下图：

启动

在浏览器输入 http://localhost:8080/swagger-ui.html 会跳转到登录页面

输入用户后确认，会重定向到首页

需要重新输入 http://localhost:8080/swagger-ui.html , 进入swagger页面
启动WeCube前端

运行CMD（Win+R或右下角点开始菜单的输入处），在展开的命令行窗口中,进入wecube-platform的代码子目录wecube-portal目录

执行npm安装命令
```
npm install
```
安装完成后，执行命令
```
npm start
```
如下图：

服务已启动，打开 http://localhost:3000, 可看到WeCube的页面