如何飞速成为开源贡献者(Contributor)

简介: 如何飞速成为开源贡献者(Contributor)

一、环境信息

1.1 硬件信息

  1. 型号 :MacBook Pro
  2. 内存 :16GB
  3. 硬盘 :512GB SSD
  4. 处理器 :Apple M2
  5. 宿主机CPU架构 :ARM

1.2 软件信息

  1. Git版本 :2.39.2 (Apple Git-143)
  2. Maven版本 :3.8.8
  3. JDK版本 :17

二、Git安装

2.1 Git介绍

Git 是一个分布式版本控制系统,用于管理和跟踪文件的变化。它可以帮助开发人员或团队追踪代码的修改历史、协同开发、管理各个版本的代码,并提供了回滚、分支管理、合并等功能。

使用 Git,开发人员可以在不同的分支上独立工作,然后将各自的修改合并到主分支上,以便保持代码的整洁和可维护性。Git 是开源的,易于安装和使用,因此被广泛应用于软件开发和其他版本控制的场景中。

2.2 Git下载安装

直接参考 git 官方网站:https://git-scm.com/

三、开源项目选定

乙真仙人选定的是Apache Doris

Apache Doris 是一个基于 MPP 架构的高性能、实时的分析型数据库,以极速易用的特点被人们所熟知,仅需亚秒级响应时间即可返回海量数据下的查询结果,不仅可以支持高并发的点查询场景,也能支持高吞吐的复杂分析场景。

基于此,Apache Doris 能够较好的满足报表分析、即席查询、统一数仓构建、数据湖联邦查询加速等使用场景,用户可以在此之上构建用户行为分析、AB 实验平台、日志检索分析、用户画像分析、订单分析等应用。

四、GitHub参与开源流程

4.1 Fork项目

在GitHub中,“fork” 指的是将别人的代码库复制到自己的账户下,并在独立的分支上进行修改和扩展的行为。

当你在GitHub上找到一个你感兴趣的项目,并希望对其做出改进、贡献或者使用它作为自己项目的基础时,你可以选择将该项目进行fork。这将在你的GitHub账户下创建一个原项目的副本,包含了所有的代码、历史记录和分支。

在你进行分叉后,你便可以在自己的项目副本上自由地进行修改和实验,而不会影响原项目的稳定性和功能。你可以添加新的特性、修复问题、优化代码,或者根据自己的需求进行个性化定制。

fork之后,你可以将你的修改提交回原项目,这就是所谓的"pull request"(合并请求)。原项目的维护者将会审核你的更改,并决定是否接受你的修改并将其合并到原项目中。

通过这种方式,fork功能为开源社区提供了一种协作的方式,使得项目能够从众多贡献者的力量中受益。

1.点击fork

2.创建fork

3.查看fork

4.2 SSH配置

4.2.1 为什么要配置SSH

git clone支持https和git(即ssh)两种方式下载源码:

当使用git方式下载时,如果没有配置过ssh key,则会报如下错误提示:

4.2.2 如何配置SSH

1.首先用如下命令(如未特别说明,所有命令均默认在Git Bash工具下执行)检查一下用户名和邮箱是否配置(github支持我们用用户名或邮箱登录):

git config --global  --list 
# 如下图所示,说明还没配置

2.配置用户名和邮箱(如已配置则跳过)

# 可以在自己github的Settings中找到
git config --global  user.name "这里换上你的用户名"
git config --global user.email "这里换上你的邮箱"

3.再次检查用户名和邮箱(如已检查成功则跳过)

git config --global  --list 
# 如下图所示,说明配置成功

4.生成秘钥

# 执行命令后需要进行3次或4次确认(可以一路回车)
ssh-keygen -t rsa -C "这里换上你的邮箱"
# 结果如下图所示,记住红框内id_rsa.pub文件路径,后续需要配置到github上

5.打开你的github,进入Settings配置页

6.选择SSH and GPG keys项并新增

7.将id_rsa.pub的内容填入Key中并Add

至此ssh就配置完成了

4.3 Clone项目

SSH配置完成后,再次进行Clone就可以正常下载了

git clone git@github.com:yz-jayhua/doris.git

4.4 IDEA关联

1.打开clone的项目

2.打开Settings并搜索git

3.点击测试让idea自动匹配并应用

4.5 PR生成

来个简单的文档PR体验一把:修改一个文档的错别字

1.定位修改文件

查阅官方文档时发现如下一个错别字,对应官方文档的地址:DATETIME

2.从master新建一个分支去修改

3.分支命名并创建

4.创建后自动切换分支

5.提交代码到本地仓库

Commit Message参考:

fix:表示该提交用于修复错误或问题。

feat:表示该提交用于添加新功能。

docs:表示该提交用于更新文档。

style:表示该提交用于代码格式化或结构调整。

refactor:表示该提交用于代码重构,不添加新功能或修复错误。

perf:表示该提交用于提高性能。

test:表示该提交用于测试代码。

6.推送代码至github仓库上

7.PR生成确认

此时刷新github个人仓库对应的项目时,会出现PR请求,即说明PR生成成功

4.6 PR提交

1.点击【Compare & pull request】并创建PR

2.提交结果确认

提交后会生成相关的pr编号,后续流程如下:

  1. 会有社区小伙伴进行review(Apache Doris目前需要2位小伙伴review后才可进行下一步,不同的项目要求不同)
  2. review完成并确认后会开始跑流水线,即自动对项目进行各种规则检测
  3. 流水线全部跑完后,会有社区的负责人进行合并Merge
  4. 合并成功后,恭喜你成为Apache Doris贡献者(Contributor)

至此,你已飞速成为开源贡献者(Contributor)啦~查阅过程中若遇到问题欢迎留言或私信交流。

相关文章
|
Cloud Native Dubbo 应用服务中间件
阿里巴巴捐献的14个顶级开源项目,国内开源贡献第一!
代表性的项目包括龙蜥操作系统、Apache RocketMQ、Apache Dubbo、Spring Cloud Alibaba 等
|
Cloud Native Linux Go
如何从开源项目中受益?
如何从开源项目中受益?
74 0
|
4月前
|
消息中间件 Kubernetes Kafka
iLogtail 开源两周年:社区使用调查报告
iLogtail 两周年之际,iLogtail 团队针对开源社区进行了一次使用调研,用户的反馈异常宝贵,为 iLogtail 策略制定与优化提供了第一手的洞察力。点击本文即可查看调研关键要点,欢迎更多的开发者一同来塑造项目的未来。
293 14
|
4月前
|
设计模式 前端开发 开发者
个人开源项目商业化经验分享
开源项目推向商业化道路的开发者,将自的经历分享出来与诸位一同交流,期望大家能够少走弯路,让开源项目更健康的活下去。
个人开源项目商业化经验分享
|
7月前
|
Linux Anolis 芯片
龙蜥社区荣获 OSCHINA “2023 年度优秀开源技术团队”
龙蜥社区荣获 OSCHINA “2023 年度优秀开源技术团队”。
|
7月前
|
程序员 项目管理 开发工具
gitt开源项目的意义,公司为什么会对在gitt上有开源项目的人更大机会
gitt开源项目的意义,公司为什么会对在gitt上有开源项目的人更大机会
83 0
|
机器学习/深度学习 人工智能 达摩院
隐语开源社区「2022年度开源报告」
隐语开源社区「2022年度开源报告」
375 1
|
机器学习/深度学习 算法 安全
「隐语开源社区」Meetup答疑篇
「隐语开源社区」Meetup答疑篇
368 0
|
Apache 开发者
成功打造一个开源软件的秘诀在于开源社区
成功打造一个开源软件的秘诀在于开源社区
200 0
|
Cloud Native 数据可视化 关系型数据库
训练营 | 如何成为一名开源社区贡献者?
「云原生应用插件扩展训练营」由阿里云云原生团队围绕 KubeVela、OpenYurt、Koordinator、OpenKruise、Fluid 等云原生开源项目打造,为了帮助更多开发者感受开源社区的魅力,了解如何更快地参与社区贡献。
训练营 | 如何成为一名开源社区贡献者?