BallCat-Codegen
执行启动脚本后,运行启动类
com/hccake/ballcat/codegen/GeneratorApplication.java
SQL 脚本的执行
从 v1.1.0 版本开始,sql 表结构以及部分基本数据交由 flyway 管理。
用户只需修改 ballcat-codegen-backend/src/main/resources/application-dev.yml 中的数据源配置,项目启动后即可自动生成数据库和表结构。
注意:自动生成数据库依赖 jdbc 的连接参数:createDatabaseIfNotExist=true 建议使用一个全新的数据库,如果使用的数据库中已经存在其他表,则需要添加配置 spring.flyway.baseline-version=0 再进行启动
模板管理
模板组的 sql 不在 flyway 的管理之下,用户自己按需构建模板组。 欢迎大家 pr 来共享自己创建的模板组
目前在根目录下的 template
文件夹下,提供了一些默认模板的 SQL 文件,用户按需选择对应的 SQL 进行初始化:
Ballcat Admin 单体项目骨架 (ballcat-admin-boot)
一键生成基于 Ballcat Admin 的单体后台管理应用
Ballcat 业务增删改查模板 (ballcat-bussines-crud)
快速生成基于 ballcat framework 的增删改查的基础代码,包含前后端
如何在不启动前端项目的情况下使用
必须先在父工程 ballcat-codegen 处执行 mvn clean package
打包命令
此命令会将前端进行 build,并将打包好的代码 copy 入后端项目的 resource 资源下。
第一次打包时会下载 node 以及前端项目依赖,耗时较久,可以先 cd 进 ballcat-codegen-frontend 前端项目处自行执行 npm install,切换使用淘宝镜像源以加快依赖下载速度。
Docker打包
采用 dockerfile-maven-plugin 插件生成 docker 镜像,所在路径 ballcat-codegen-backend/pom.xml
<plugin>
<groupId>com.spotify</groupId>
<artifactId>dockerfile-maven-plugin</artifactId>
<executions>
<execution>
<id>default</id>
<goals>
<!-- 如果package时不想用docker打包,就注释掉这个goal -->
<goal>build</goal>
</goals>
</execution>
</executions>
<configuration>
<repository>ballcat-codegen</repository>
<tag>latest</tag>
<buildArgs>
<JAR_FILE>${project.build.finalName}.jar</JAR_FILE>
</buildArgs>
</configuration>
</plugin>
执行 mvn clean package
打包命令时会根据 ballcat-codegen-backend 根目录下的 Dockerfile 自动构建 docker 镜像。
docker-compose部署
打开 ballcat-codegen-backend 根目录下的 docker-compose.yml文件,修改环境变量配置你的数据库连接信息
version: "3.9"
services:
codegen:
image: ballcat-codegen:latest
container_name: ballcat-codegen
restart: always
ports:
- "7777:7777"
volumes:
- "./logs:/workspace/logs"
environment:
- TZ=Asia/Shanghai
- LANG=en_US.UTF-8
- JAVA_OPTS=-Xmx256m -Xms256m -Xmn256m -Xss1m
- DB_HOST=192.168.1.66
- DB_PORT=3306
- DB_NAME=ballcat_codegen
- DB_USER=root
- DB_PASSWORD=root
终端切换到 docker-compose.yml 所在目录,执行 docker-compose up -d
一键部署。