-
安装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中, 本文以从本地导入为例。
-
导入工程
工程导入后, 会自动下载依赖包及编译, 请确保网络连接正常。
-
切换视图
-
初始化数据库
需要在本地或者远程的数据库上建立用户和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
打开 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的页面