herodotus/herodotus-cloud-preview repository overview

⁠[一]项目简介

Dante Cloud 国内首个支持阻塞式和响应式服务并行的、开箱即用的企业级云原生微服务基座。是采用领域驱动模型(DDD)设计思想，以「高质量代码、低安全漏洞」为核心，基于 Spring 生态全域开源技术，高度模块化和组件化设计，支持智能电视、IoT等物联网设备认证，满足国家三级等保要求，支持接口国密数字信封加解密等一系列安全体系的一站式多租户微服务解决方案。独创的可以“一套代码实现微服务和单体两种架构灵活切换”的企业级应用系统。

⁠一、项目理念

Dante Cloud 一直秉承着“简洁、高效、包容、务实”的理念，使用微服务领域及周边相关的各类新兴技术或主流技术进行建设，不断地深耕细作、去粗取精、用心打造。目标是构建一款代码质量高、维护投入低、安全防护强的微服务基座，可以帮助用户快速跨越架构技术选型、技术研究探索、基础架构搭建阶段，直接聚焦业务开发。极大地降低传统项目中因安全漏洞、技术负债、低质代码等潜在隐患所产生的高维护投入。期望像项目名字寓意一样，构建一套可以在在行业变革的时期承上启下，助力企业信息化建设和数字化转型的产品。

Dante Cloud 核心关注点是：「高质量的系统代码」、「合理的系统架构」、「低耦合的模块划分」、「高安全性系统实现」、「灵活的功能扩展能力」，「优质的微服务防范」。不会像其它一些系统一样，追求 业务功能 的 丰富 性。堆叠大量无法做到真正通用的功能，反倒会成为负担和干扰，不如由用户自己按照需求灵活设计和实现。

⁠二、架构设计

Dante Cloud 优秀的模块化能力，为系统提供了高度灵活的配置能力、功能的“可插拔”能力 以及不同需求场景的适配能力。正因为优秀的模块化体系，使得 Dante Cloud 不仅是一套完整的微服务架构，还是一套高质量的 「单体模块化」 系统。这里的微服务架构和单体架构并不是分离的两套代码，也不是分离的两个项目。而是完全融合的一整套代码，使用时可以根据需要选择是以微服务模式或者单体模式运行，配合灵活的模块能力，实现系统的多样化定制和功能的管控。

这是 Dante Cloud 微服务最大的特色之一：“一套代码、两种架构”。可以帮助企业在项目早期以单体架构快速建设项目、方便开发人员在本地进行开发以及新技术研究。在项目后期随着用户规模增大以及并发需求提升时，可以快速无缝迁移至微服务架构。

⁠三、适用用户

微服务技术并不是落伍了，而是进入了成熟期，它的适用场景和边界被更清晰地定义了。微服务不再是一个“必须要有”的选项，而是一个“权衡之后”的选择。同时，Dante Cloud 也并未使用任何复杂难懂或难以上手掌握的技术，项目中所涉及核心关键组件中，其中 「近 80% 均为 Spring 生态原生组件」。技术实现均为各组件标准用法的组合与应用，编码风格和代码设计一直也在极尽努力尽量与 Spring 生态的标准规范用法保持一致，只不过经过大量的版本迭代和重构之后逐渐形成了一定的封装与抽象。

本项目适用的用户如下：

• 「传统项目用户」：可以先体验的单体版，先从“前后端分离”以及“多端适配”开始，尝试不同于传统内嵌页面的开发模式。
• 「数字转型用户」：如果您正在考虑进行数字化转型，可以直接选择使用微服务版本，不用再为“基础组件碎片化，需花大量时间整合、踩坑版本兼容”等问题而苦恼。
• 「复杂项目用户」：如果您的业务复杂度上升到一定阶段，可以直接选择使用微服务版本，直接聚焦于业务开发，节省大量前期搭建基础设施、解决通用技术问题的时间。
• 「初创团队用户」：可以先使用单体版进行开发，只要代码放置规范、模块划分合理，后期可以根据需要无缝迁移至微服务架构
• 「技术尝鲜用户」：本项目并不拘泥局限于常规成熟的技术内容，目标是探索新型技术并用其来为业务的创新服务。喜欢技术尝鲜的用户可以尝鲜使用。
• 「学习提升用户」：本项目代码实现优雅和领域划分清晰，编码风格和模块实现尽最大可能与 Spring 生态规范保持一致，是深入学习 Spring 生态组件和提升技能的优秀案例

⁠[二]镜像说明

本镜像是 Dante Cloud 的单体版本体验镜像。

如果您想进一步体验 Dante Cloud 的系统能力，可以考虑下载离线版本进行体验。可以通过修改 Docker 环境变量或者系统 application.yml 配置，来体验更多内容。

离线版镜像与在线演示系统部署的是同一个镜像，只不过是配置不同而已。

⁠[三]系统启动

⁠[1]Docker

镜像下载完成之后，你可以直接使用 Docker 命令进行启动。

docker run --name preview quay.io/herodotus-cloud/herodotus-cloud-preview:latest -p 8000:8000 -p 8847:8847

⁠[2]Docker Compose

除了 Docker 命令外，也可以使用 Docker Compose 脚本启动。

services:
  preview:
    image: quay.io/herodotus-cloud/herodotus-cloud-preview:latest
    container_name: preview
    hostname: preview
    environment:
      HERODOTUS_CHECK_STARRED: false
      HERODOTUS_USE_DISABLE_DEVTOOL: false
    ports:
      - 8000:8000
      - 8847:8847
    volumes:
      - D:\\local-cached\\docker-volumes\\herodotus-cloud\\logs:/usr/local/herodotus/logs

⁠[四]环境变量

离线演示 Docker 镜像，提供了部分环境变量，便于对系统内的一些信息进行修改。

⁠[五]访问地址

• 前端地址：http：//localhost:8000/preivew
• 后端地址：http：//localhost:8847/online
• 文档地址：http：//localhost:8847/online/swagger-ui.html

⁠[六]修改配置

系统后端基于 Spring Boot，所以如果你可以修改一些配置，来改变系统内部的一些控制。

可以将离线版演示系统中的 application.yml 配置文件拷贝出来，放到指定的 volumes 映射下，就可以进行修改了。例如：自己安装个 Minio 配置一下对象存储的使用。

⁠其它

如系统使用有任何问题或者意见建议，可以直接在文章下面留言，或者【发 ISSUE】⁠

如果本项目对你有所帮助，欢迎 Star 一波来支持我们！

Gitee：https://gitee.com/dromara/dante-cloud⁠

Github：https://github.com/dromara/dante-cloud⁠

Gitcode：https://gitcode.com/dromara/dante-cloud⁠