diff --git a/content/zh/blog/koupleless-community-cultivating-an -engineering-mindset-in-open-source b/content/zh/blog/koupleless-community-cultivating-an -engineering-mindset-in-open-source new file mode 100644 index 000000000..a1052acc4 --- /dev/null +++ b/content/zh/blog/koupleless-community-cultivating-an -engineering-mindset-in-open-source @@ -0,0 +1,147 @@ +# 开源之夏经验分享|Koupleless 社区黄兴抗:在开源中培养工程思维 + +**文|黄兴抗** + +电子信息工程专业 + +Koupleless 社区贡献者 + +就读于南昌师范学院,电子信息工程专业的大三学生。 + +**本文 2634 字,预计阅读 7​ 分钟​** + +今天 SOFAStack 邀请到了开源之夏 2024 Koupleless 社区的中选学生**黄兴抗**同学!在本项目中,他参与完成了​**存量应用自动改造成模块**​。希望他分享的这段经历,能让更多人了解到 Koupleless 开源社区,感受开源的魅力~ + +​**项目链接**​:[https://summer-ospp.ac.cn/org/prodetail/2495a0376?lang=zh&list=pro](https://summer-ospp.ac.cn/org/prodetail/2495a0376?lang=zh&list=pro) + +## 项目信息 + +​**项目名称**​:存量应用自动改造成模块 + +​**项目导师**​:赵真灵 + +​**项目背景**​:在参与 Koupleless 社区项目之前,我就在社区文章中了解到,当前企业在向云原生转型的过程中往往面临着一个重要痛点——​**存量应用改造成本高**​。特别是对于大量已经运行的 SpringBoot/SOFABoot 应用,「如何低成本地实现模块化改造」成为一个急需解决的问题。 + +​**项目目的**​:本项目的核心目标是建设存量应用的自动化模块改造工具,使得应用能够实现传统应用向模块化的低成本升级,兼顾代码兼容性,同时支持独立启动与合并部署。 + +## 技术方案设计 + +**​ 整体架构** + +为了实现目标,我们通过 `arkctl` 命令行工具提供简单易用的入口,将核心逻辑封装在一个包含以下 4 个主要组件的 JAR 包中: + +1. Launcher—作为整个工具的统一入口 +2. ApplicationPropertiesModifier—用于扫描并修改应用配置 +3. SlimmingConfiguration—负责模块瘦身和依赖管理 +4. PomModifier—专门处理 Maven 配置相关的逻辑 + +### ​ 关键技术点 + +**1. 配置文件自动化处理** + +自动扫描和修改配置文件,支持多环境配置合并,确保改造过程安全、可回滚。 + +**2. POM 文件智能改造​** + +自动添加必要的依赖和插件,实现版本兼容检测和适配。 + +**3. 模块瘦身方案** + +实现依赖隔离,优化模块体积,保证改造后的应用在运行时的兼容性。 + +### 模块改造的核心要素​ + +**1. 模块打包插件的引入** +POM 文件中的关键配置如下: + +```bash + +com.alipay.sofa +sofa-ark-maven-plugin + +true +true + + +``` + +> **Q:为什么需要引入模块打包插件?** +> 传统的 Spring Boot 应用打包后是一个可独立运行的 JAR,sofa-ark-maven-plugin 能够将应用打包成符合模块规范的格式,模块化部署需要特殊的类加载隔离机制,通过 declaredMode 实现精确的类隔离,避免多模块间的冲突。 + +**2. 模块瘦身的必要性** +模块瘦身配置示例: + +```bash +slimming.excludeGroupIds=org.springframework,org.apache.commons +slimming.excludeArtifactIds=commons-lang,commons-io +``` + +> **Q:为什么需要模块瘦身?** +> 基座已包含大量公共依赖,模块无需重复打包。重复依赖会导致类加载冲突,模块体积过大影响启动性能和资源利用,通过瘦身可以优化模块大小,提高部署效率。 + +**3. 配置文件改造的意义** +配置文件处理的核心逻辑如下: + +```bash +public static void modifyApplicationProperties(String directoryPath, String applicationName) { +Properties props = new Properties(); +props.setProperty("spring.application.name", applicationName); +} +``` + +> **Q:为什么需要改造配置文件?** +> 模块需要独立的应用名称和上下文路径,避免多模块间的配置冲突,确保模块能够在合并部署环境中正确运行,支持模块的动态部署和热更新。 + +## 项目实现思路 + +针对传统的存量应用手动改造成模块的方式,对其相关步骤进行拆解和分析后,可感知到三个挑战:配置文件改造、依赖管理和构建适配。 + +* **配置文件改造​**方面,挑战主要在于配置文件分散在不同目录、多环境*(如开发、测试、生产)*配置的复杂性,以及可能存在的配置冲突。为了解决这些问题,我们通过递归扫描定位所有配置文件,利用 Java Properties API 确保读写的安全性,同时采用追加写入的方式,避免覆盖已有配置内容。 +* **依赖管理**方面,我们需要处理模块与基座依赖的重复问题、版本冲突的风险,以及模块体积过大导致加载性能下降的情况。针对这些问题,我们设计了预设排除规则,精确分析依赖关系,添加必要依赖,并将有冲突的模块默认调整为经过测试的稳定版本。此外,我们在配置文件中增加了黑白名单规则,以实现模块瘦身。 +* **构建适配**方面,主要难点在于多模块项目复杂的依赖关系以及构建效率的优化。我们通过 `declaredMode` 实现类加载隔离,统一管理版本号,并合理配置构建参数,优化插件的执行顺序,减少了不必要的构建步骤。 + +## 开源之夏个人随访 + +### ​ 自我介绍 + +大家好,我是​**黄兴抗**​,目前就读于南昌师范学院电子信息工程专业,大三学生。虽然我的专业和计算机软件领域并不完全对口,但我对软件开发也颇感兴趣,因此也十分向往接触云原生技术、微服务架构等前沿技术领域。接触开源是大二下学期时开始,自那之后我就经常关注开源社区的技术动态。 + +### 参与该项目的原因​ + +选择 SOFAStack 社区主要有基于以下几点的考虑: + +**1. 技术积累** + +SOFAStack 作为蚂蚁集团开源的金融级云原生架构,拥有丰富的企业级实践经验。社区项目涵盖了微服务、云原生等热门技术领域,与我未来想从事的就业发展方向高度契合。 + +**2. 社区氛围** + +SOFAStack 社区有着完善的新人引导机制,仓库所有者也会为新人提供适合入手的 issue 作为开始。使得我在相关课题正式开发之前,就可以对其中的模块瘦身白名单实现的相关 issue 做一定贡献,让我能够切身感受到解决问题过程中完善的反馈机制。同时社区维护者积极响应,使我能够及时获得技术指导。 + +**3. 项目价值** + +Koupleless 项目致力于解决企业实际痛点,具有明确的商业价值。自动化改造工具的开发也能够帮助我积累工程化经验。此外,项目涉及多个技术领域,有助于拓展技术视野。 + +### ​如何克服项目过程中的困难与挑战 + +在开发过程中少不了各种大大小小的困难与挑战,其中不仅有代码实现部分,也有许多非代码要求的项目流程,如文档编写、工作流的设计、测试用例等工作。这些实际面向企业的开发流程规范,让尚未就业的我时常感到困惑和阻碍。在这一情况下,导师给到我很多指导和建议,如参考一些优秀的活跃社区,这让我收获颇多。 + +在项目开发的初期阶段,导师会细心引导我深入了解项目的愿景、业务背景以及代码的整体架构,帮助我整体紧抓课题的方向,为后续开发奠定了坚实的基础。 + +在实际开发过程中,每当我遇到困难或卡点时,导师总是耐心地为我提供具体的建议和可行的改进方向,帮助我快速找到解决问题的思路。此外,社区还定期举办双周例会,大家在会上同步开发进展、交流心得,针对开发中遇到的难题展开讨论,并集思广益寻找高效的解决方案。这种机制不仅增强了团队协作,也让我更好地在学习中成长。 + +最让我印象深刻的挑战之一,是如何处理各种不同项目的**配置文件差异**和**版本兼容性**问题。针对前者,我采用了递归扫描的方式,并实现了智能合并策略,确保改造过程不会破坏原有配置。针对后者,面对不同版本的 Spring Boot 和 SOFABoot 应用,需要确保工具的通用性,最终通过实现版本检测和适配机制解决了这个问题。 + +### 有哪些收获 + +**1. 技术积累** + +通过这个项目,我锻炼了编码能力,更重要的是学会了如何设计一个自动化工具来解决实际问题。尤其是在处理配置文件、管理依赖等方面积累了宝贵经验。 + +**2. 开源精神** + +参与社区让我深刻体会到开源的协作精神。从社区成员的热情帮助到积极的反馈机制,都让我在解决问题的同时感受到了团队合作的力量。 + +**3. 工程思维** + +项目让我开始从更全面的角度看问题:功能的实现只是第一步,如何保证工具的可维护性、扩展性,甚至用户体验,都是需要考虑的重要因素。