云原生时代音讯队列和流交融零碎 ，提供对立的生产模型，反对音讯队列和流两种场景，既能为队列场景提供企业级读写服务质量和强一致性保障，又能为流场景提供高吞吐、低提早；采纳存储计算拆散架构，反对大集群、多租户、百万级 Topic、跨地区数据复制、长久化存储、分层存储、高可扩展性等企业级和金融级性能。

GitHub 地址：http://github.com/apache/pulsar/

场景关键词 ：

异步解耦 削峰填谷 跨城同步 音讯总线 
流存储  批流交融  实时数仓 实时 ETL 金融风控

摘要：2022 年初，Apache Pulsar 社区迎来了一位新晋 Committer——李理（GitHub 地址: @urfreespace）。来自 StreamNative 的李理是一名全栈工程师，他的社区次要奉献方向为 Pulsar 官方网站与文档零碎建设。非 Pulsar 我的项目开发者如何参加开源？全栈工程师在开源我的项目里能够承当什么角色？李理将以亲自体验给大家带来参加开源我的项目、取得开源社区认证的“新”思路。\
本文策动：鸡排，海绮

• “为什么倡议大家做开源——除能够晋升自我外，开源我的项目自身就是一个品牌，为你的能力背书。”
• “文档写的好，用起来才好，体验感才好，大家才违心用，才有助于一个我的项目的推广与遍及。”
• “好的开源产品在网站和文档方面肯定要欠缺和强壮，有人去保护的文档和网站的用户体验才是敌对的。”
  ———— 李理

用一个字概括李理的格调，“杂”仿佛最为适合。此处的“杂”是贬义的，是李理职业生涯和日常生活的缩影：在职业生涯中，李理曾从事研发工作，各个领域都有涉猎，如 Java/Pyhton/Go 服务端、Web 前端、iOS 客户端、ELK 运维和研发等工作，当初是一名全栈工程师；在生活中，李理喜好宽泛：爬山、做木工、做各种手工小玩意儿、读书等等，浏览也涉猎宽泛。

（上面让咱们从李理的第一视角走进他的开源世界）

From Kafka to Pulsar，从用户到开发者

退出 Pulsar 社区前，我做了一年多的 ELK 相干技术栈运维和研发工作；在应用 Kafka 的过程中遇到一些运维上的痛点，于是开始调研 Pulsar，我也是从那时开始逐渐深刻理解 Pulsar。

此外，进入社区前，我始终以用户角色接触和调研 Pulsar 我的项目，并没有参加任何 Pulsar 主我的项目的奉献。当初作为全栈工程师，我一直接触 Pulsar 多个方面。从用户向开发者角色转变，一点点向 Apache Pulsar 奔赴。

两个 PIP 的诞生：打造更好的我的项目体验

我在 Pulsar 的次要奉献围绕 PIP – 87 和 PIP – 112 开展：

• 降级 Pulsar 网站，改版根底框架；
• 优化 Release Note 自动化脚本；
• 降级 Pulsar 文档，实现自动化解决。

最近拜访 Pulsar 官网的小伙伴会发现，目前 Pulsar 新网站 Beta 版本曾经进入 Review 阶段，大家可在以后 Pulsar 网站找到相干链接点击进入查看。新版网站是我的奉献成绩之一。

再见，旧网站

过来的网站框架版本过旧，性能个性不全，定制化能力不强（如文档左侧菜单无奈开展），用户应用感不敌对。因而我和 Pulsar PMC 成员刘昱接管社区对网站应用体验的多方反馈、框架的优化意见，并在对立整顿后，与社区屡次探讨编写出 PIP 文档解决网站痛点，降级优化网站框架。目前，已降级的网站性能个性欠缺，菜单能够开展，具备响应式布局；挪动端适配敌对，用户应用手机拜访也能取得舒服的体验。

此外，新网站满足多 Tab 切换需要，大家能够应用开发语言定制化文档，实现高级互动成果；同时，一些款式 UI 层已实现高级定制，不再仅仅局限于本来级别低的语法，无效进步了文档灵活性。

值得关注的是，咱们正在对新网站进行调研，以问卷调查的模式收集大家对新网站的倡议，欢送大家参加填写。

文档自动化

原先网站 Java 层代码类文档（Pulsar 主我的项目）的手动生成工作繁琐，大大增加了社区小伙伴的工作量。通过自动化脚本，在构建过程中实现文档主动生成，随后文档间接嵌入到网站中，如此能够大程度缩小繁琐的工作，优化人力工夫配置，进步执行效率。

晚期 Release Management 版本公布时，Release Note 的生成须要手动整顿写入文档中，这样的操作流程不仅节约人力工夫，还存在手工输出信息带来谬误脱漏的危险。因而，PIP-112 我的项目针对该问题，增加了自动化脚本配置，主动拉取和排版 Release Note 记录，实现归档。

此外，随着版本公布的迭代，文档越来越长，浏览起来艰难，找到指定内容须要消耗大量工夫。因此，针对版本多组件内容杂糅这样的问题，我搭建了归档分级的框架：辨别出不同组件，如 Broker、Bookie、Client 等，而后在各个组件下分出大小版本。如此不便用户们依据本人对特定组件的需要疾速浏览文档，实现高效索引。

目前，该归档分级尚未裸露，大家能够在 Pulsar 新网站获取跳转链接。

用户体验好才是真的好

理解一个新我的项目和社区有两种根本形式：一是网站和文档，二是源码。往往源码浏览难度较大，而文档更容易帮忙了解。文档既是入门指南，也是集结社区奉献的重要内容。文档不欠缺、网站不敌对会重大影响用户与开发者的体验。文档写的好，用起来便捷，体验感舒服，大家才违心深刻理解，才有助于一个我的项目的推广与遍及。

欠缺强壮的文档是开发优良开源我的项目的要害，加之以相干负责人员的定期维护，尽心保障用户体验感敌对。当初很多开源我的项目在文档和网站方面的贡献者数量匮乏。因而，对该方面工作投入必要的人力工夫技术是很有必要的。

为什么要参加开源

我十分倡议大家积极参与开源。为什么要参加开源呢？从我本身经验来讲，自退出 Pulsar 开源社区，我结识了很多优良的小伙伴，社区的技术气氛浓烈，对性能、代码品质等各方面要求高，这驱使我以更高标准要求本人、进步本人，让我感触到技术能力的倒退空间是有限的。此外，参加开源我的项目对集体职业生涯有很大帮忙：高含金量的我的项目自身就是一个品牌，我的项目经验能够为本身技能“背书”。

那么又如何去参加开源我的项目和社区呢？新人小伙伴初入 Pulsar 社区，能够从简略的工作动手，而文档就是一个不错的切入点。大家能够在 Pulsar 我的项目 Issue 列表中依据文档标签、重点标记以及本人的能力进行评估和筛选，筛选适宜的主题尝试奉献，由浅入深。

成为 Committer 后任重而道远

成为 Committer 后，我的责任感加强了，时常认为本人做的还不够，心愿本人能为 Pulsar 主我的项目多做奉献，因而我正在进行主我的项目奉献方向的学习，期待之后能为 Pulsar 社区带来多样化奉献。

与此同时，我期待能疏导并造就更多的人退出文档和网站保护团队，以解决以后这两方面参加人数不多、器重度有余的问题，施展文档和网站的最大价值，独特助推前期我的项目的倒退和用户体验的晋升。

致谢

感激社区大佬们的热心帮忙，每次我提 PR，大家都踊跃回应，帮忙标准代码、指出不足之处。咱们独特学习进取、碰撞出灵感的火花。我认为参加开源的意义正在于此：一群达成共识的人聚在一起做喜爱的事。

让 Apache Pulsar 为你“背书”

作为全球性开源我的项目，截至目前，Apache Pulsar 已领有 514 名贡献者、10.6K+ Star、2.8K+ Fork。Apache Pulsar 曾经取得了诸多用户认可，场景案例也越来越丰盛，笼罩畛域宽泛，如 AI 人工智能、IoT 物联网、直播 / 短视频与社交、即时批发与物流、电子商务、人力资源、电信运营商、证券交易与金融科技、商业智能、工业互联网、根底云服务……次要用户有知乎、涂鸦智能、达达团体、安全证券、华为云、腾讯计费平台 Midas、金山云、拉卡拉等。

正如李理所言，一个高含金量的我的项目能够为你的职业“背书”。参加 Pulsar 社区，岂但能够取得公司及社区内外的认可，结交来自各个领域、气味相投的小伙伴；还能够进步集体影响力，促成集体倒退。李理的亲身经历也为大家证实：参加开源的形式是多样的，社区、文档、网站等各方面都有足够的空间让大家成长为资深脉冲“星”。

咱们为大家提供了参加指南，欢送越来越多的小伙伴助力 Apache Pulsar 我的项目的一直倒退与后退。

• Apache Pulsar 官网奉献指南

相干浏览

• 95 后新生代 Committer 贺张俭：谈谈年轻人的开源观
• Committer 郭吉伟专访：做开源不是搞慈悲，用开源也不是薅羊毛
• 实力与颜值并存 —— Apache Pulsar PMC 成员刘昱专访

关注 公众号「Apache Pulsar」 获取更多技术干货

退出 Apache Pulsar 中文交换群👇🏻

点击填写“新 Apache Pulsar 官网”问卷吧~