在开发搭建的环境中,会不可避免的出现一些官方文档中没有出现的错误或者没有提到的注意点,所以根据我自己的搭建经验以及官方文档让初学者都能自己搭建一个轻量级开发环境用于学习和小团队本地开发。本篇只涉及到搭建过程,具体概念自行查找官方文档进行浏览。
一、开发者工具下载和安装
这是必要的前置步骤,需要有开发者工具才能进行后续的环境搭建。
点击前往安装:
新建一个空目录用于存储环境资源文件,注意不要安装在C盘,安装成功后点击打开
注意:安装过程中碰到以下错误时,需去任务管理器中杀掉java进程,然后重新运行安装文件,进行安装
正常注册登录
二、轻量级环境安装
在进行环境安装之前,需要先安装环境所需的数据库,金蝶当前版本只支持postgresql为默认数据库,但在后续的租户管理中可以切换数据中心为其他主流数据库,所以此处不需太担心,需要先将postgresql数据库安装进行基础环境搭建。
1、安装postgresql数据库
安装链接:https://get.enterprisedb.com/postgresql/postgresql-12.12-1-windows-x64.exe
安装目录需为空目录,不要安装在C盘中
配置数据库初始密码,用户名默认postgres
设置端口,默认端口5432
使用默认值
如果出现安装失败的情况,参考此帖子解决问题:PostgreSQL安装,出现Failed to load sql modules into the database cluster解决方法_风停水止的博客-CSDN博客
取消后续附属插件安装
出现服务启动失败问题,参照此帖子解决问题:本地计算机上的 postgresql 服务启动后停止解决方法_本地计算机上的postgresql服务启动后停止__苏沐的博客-CSDN博客
安装成功后进行postgresql配置文件相关配置,配置postgresql的端口开放,打开postgresql的数据存储目录(默认为数据库安装目录下的data文件夹),找到pg_hba.conf文件,默认情况下,只有127.0.0.1能连接数据库,若需要开放给其他IP连接,可以加一行记录“host all all 0.0.0.0/0 md5”
修改postgresql.conf文件,搜索max_connections,将最大连接数改成1000或者更大;搜索wal_keep_segments,取消注释(即去掉#),修改wal的保留个数wal_keep_segments=3。
配置修改完成后,需要重启postgresql服务。在开始菜单,输入“服务”,打开服务管理界面,搜索postgres,找到数据库服务,右键重启服务。
重启服务后,在其他电脑若还是连不上postgresql数据库。则查看系统防火墙,把防火墙关闭了。(也可以配置应用允许通过防火墙)
至此,postgresql数据库安装及参数配置已全部完成。
2、环境安装
登录成功后显示主页面
点击+号新增
一般我们选择第一个苍穹+星瀚Saas安装就好,也可以按需选择
-
苍穹+星瀚SaaS:内含苍穹开发平台及星瀚五大领域的SaaS应用
-
星空旗舰版:内含苍穹开发平台及星空各领域的SaaS应用,提供星空旗舰版本地开发及演示环境
-
苍穹社区版:30天免费体验金蝶云·苍穹低代码开发、可视化流程设计等技术
注意:允许安装多个环境,但不支持同时运行多个环境,即一次只能运行一个环境
进行上一步骤安装的postgresql数据库配置
进行服务端口配置,此处租户中心及服务ip地址建议选择本机网络地址(如192.168.3.10这种),方便后续局域网其他主机连接进行开发。
开始安装,出现安装失败的提示不需要去操作,会自动进行重启重安装。如果某个安装项一直失败,查看应用列表数据库是否启动,租户中心是否启动,有些安装项需要前置应用启动或者前置安装项安装才能安装成功,启动步骤为数据库->租户中心->服务,安装项安装成功步骤为服务静态资源->租户中心静态资源->租户中心服务(此处需数据库启动)->服务(此处需租户中心启动)
3、环境访问
MC租户中心初始登录账号密码为:admin 和 Kdadmin001
服务初始登录账号密码:administrator 和 123456 (该账号为管理员账号)
三、环境管理
1、添加许可
进行开发需要先进行许可绑定才能正常进行开发
登录租户中心
点击进入租户列表,点击需要绑定的对应租户
点击许可信息
通关特征码向金蝶工作人员申请许可,也可自己在个人中心进行申请
导入许可,一般为.lic后缀
导入成功
2、管理员设置全功能用户进行开发
管理员账号登录服务地址
点击左上角菜单,点击基础服务
点击人员
点击新增
添加必要人员信息
点击全功能用户进行授权
进行用户添加
点击许可管理,点击许可分配用户
选择需要分配的云服务,选择用户进行分配
3、idea苍穹插件安装和环境资源拉取
打开IDEA:File -> Settings -> Plugins -> Manage Plugin Repositories...
新增自定义插件仓库(Custom Plugin Repositories):
https://dev.kingdee.com/tools/cosmic-coding-assistant/updatePlugins.xml
在Marketplace中,搜索关键字”苍穹”,点击Install
登录开发者工具->进入环境列表->进入已创建环境详情页->查看及复制环境资源下载地址
新创建工程,选择“金蝶云苍穹”,输入上一步中获取的环境资源地址,修改工程名称和工程目录后,点击”创建“
集群编码和租户编码值不正确的。做以下修改:
1. 修改集群编码和租户编码
2. 修改webPath值,在最后加上/static-file-service就可以了。
3. 在cosmic.start();行前增加以下代码:
cosmic.set("lightweightdeploy", "true"); //标注环境为轻量级
cosmic.set("redismodelcache.enablelua", "false"); //轻量级不能用lua,设为false
cosmic.set("lightweightdeploy.services" , ""); //设置服务为空。服务由MC启动,这里就不用启动了。
接下来就可以愉快的进行开发啦