jhipster/jhipster-sample-app-microservice

jhipsterSampleMicroservice

本应用使用JHipster 5.8.1生成，相关文档和帮助可查阅 https://www.jhipster.tech/documentation-archive/v5.8.1%E3%80%82

这是一个"微服务"应用，旨在作为微服务架构的一部分，更多信息请参考文档中的 https://www.jhipster.tech/documentation-archive/v5.8.1/microservices-architecture/ 页面。

本应用已配置JHipster-Registry用于服务发现和配置。启动时，若无法连接到位于 http://localhost:8761 的JHipster-Registry，应用将无法启动。更多信息，请阅读关于 https://www.jhipster.tech/documentation-archive/v5.8.1/microservices-architecture/#jhipster-registry 的文档。

开发

要在开发环境（dev profile）中启动应用，只需运行：

./mvnw

有关如何使用JHipster进行开发的更多说明，请查看 https://www.jhipster.tech/documentation-archive/v5.8.1/development/。

生产环境构建

要优化jhipsterSampleMicroservice应用以用于生产环境，运行：

./mvnw -Pprod clean package

为确保构建成功，运行：

java -jar target/*.war

更多详情请参考 https://www.jhipster.tech/documentation-archive/v5.8.1/production/。

测试

要运行应用的测试，执行：

./mvnw clean test

更多信息，请参考 https://www.jhipster.tech/documentation-archive/v5.8.1/running-tests/。

代码质量

使用Sonar进行代码质量分析。可通过以下命令启动本地Sonar服务器（可通过 http://localhost:9001 访问）：

docker-compose -f src/main/docker/sonar.yml up -d

然后运行Sonar分析：

./mvnw -Pprod clean test sonar:sonar

更多信息，请参考 https://www.jhipster.tech/documentation-archive/v5.8.1/code-quality/。

使用Docker简化开发（可选）

可使用Docker提升JHipster开发体验。src/main/docker 目录中提供了多个docker-compose配置，用于启动所需的第三方服务。

例如，要在Docker容器中启动postgresql数据库，运行：

docker-compose -f src/main/docker/postgresql.yml up -d

要停止并移除容器，运行：

docker-compose -f src/main/docker/postgresql.yml down

也可将应用及其所有依赖服务完全容器化。为此，首先通过以下命令构建应用的Docker镜像：

./mvnw package -Pprod verify jib:dockerBuild

然后运行：

docker-compose -f src/main/docker/app.yml up -d

更多信息请参考 https://www.jhipster.tech/documentation-archive/v5.8.1/docker-compose，该页面还包含关于docker-compose子生成器（jhipster docker-compose）的信息，该生成器可生成一个或多个JHipster应用的Docker配置。

持续集成（可选）

要为项目配置CI，运行ci-cd子生成器（jhipster ci-cd），这将生成多个持续集成系统的配置文件。更多信息请查阅 https://www.jhipster.tech/documentation-archive/v5.8.1/setting-up-ci/ 页面。