| <rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Apache Dubbo – Committer 指南</title><link>https://dubbo.apache.org/zh-cn/contact/committer/</link><description>Recent content in Committer 指南 on Apache Dubbo</description><generator>Hugo -- gohugo.io</generator><language>zh-cn</language><atom:link href="https://dubbo.apache.org/zh-cn/contact/committer/index.xml" rel="self" type="application/rss+xml"/><item><title>Contact: Apache 提交者注册流程</title><link>https://dubbo.apache.org/zh-cn/contact/committer/new-committer-guide_dev/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/zh-cn/contact/committer/new-committer-guide_dev/</guid><description> |
| <h2 id="一apache-提交者的产生">一、Apache 提交者的产生</h2> |
| <h3 id="项目孵化初始化提交者">项目孵化初始化提交者</h3> |
| <p>项目孵化阶段，在孵化项目提案中，会有初始化提交者列表这一选项。确认你是初始化提交者的一员。项目在 apache 孵化器社区投票通过后，提交者可以开始准备注册账户了。可以参看<a href="https://wiki.apache.org/incubator/">孵化器 wiki</a></p> |
| <h3 id="活跃的贡献者被选举为提交者">活跃的贡献者被选举为提交者</h3> |
| <p>在后期的开发过程中，活跃的贡献者可以被选举为提交者。见<a href="https://www.apache.org/dev/new-committers-guide.html#becoming-a-committer">如何成为 committer</a></p> |
| <h2 id="二个人开发者提交-icla">二、个人开发者提交 ICLA</h2> |
| <h3 id="1选择-apache-id">1、选择 apache id</h3> |
| <p>在<a href="http://people.apache.org/committer-index.html"> apache 提交者列表页</a>查看已经注册过的 apache id，</p> |
| <h3 id="2个人提交者授权协议icla">2、个人提交者授权协议（ICLA）：</h3> |
| <p>下载<a href="https://www.apache.org/licenses/icla.pdf"> ICLA 模板</a>，查找可用的 id。将 icla.pdf 个人信息填写正确后打印,签名、扫描、并当做附件发送邮件给秘书 <a href="mailto:secretary@apache.org">secretary@apache.org</a>，秘书会帮忙创建 apache 用户 id。同时会创建一个 <a href="mailto:your_id@apache.org">your_id@apache.org</a> 的邮箱，可以在<a href="http://people.apache.org/committer-index.html"> apache 提交者列表页</a>查看查找用户是否已经创建。</p> |
| <h3 id="3导师帮助提交用户id创建请求">3、导师帮助提交用户id创建请求</h3> |
| <p>导师将帮助提交 apache 账户创建请求给 root 邮件组，会有人帮助建立 id。一般需要2天时间账户会建立，请等待并在<a href="http://people.apache.org/committer-index.html"> apache 提交者列表页</a>查看查找用户是否已经创建。</p> |
| <h2 id="三加入apache开发者组">三、加入apache开发者组</h2> |
| <ol> |
| <li>登陆 <a href="https://id.apache.org/">Apache 账户工具</a>，在登陆页面点击&quot;忘记密码&quot;设置始化密码，会有一封密码重置邮件发送到 forward 邮箱(在孵化项目提案中提交的开发者邮件)</li> |
| <li>关于 apache 邮箱：apache.org 邮箱并没有自己的邮件内容存储服务器。它需要借用其他邮件提供商的邮件内容存储、分发功能。在很多投票环节是建议使用 apache 邮箱的。 |
| 这里就有一个问题，怎么在其它邮箱里面配置 apache.org 邮箱转发功能： |
| <ul> |
| <li>收件箱：收取发送到 apache.org 的邮件。这个在第一步配置好 Apache 账户工具的 forward 邮箱就可以用 forward 邮箱收取邮件了</li> |
| <li>发件箱：将发出的邮件显示发件邮箱为 apache.org 邮箱。请参考：<a href="https://reference.apache.org/committer/email">设置 apache 邮箱指南</a>和<a href="https://support.google.com/mail/answer/22370"> gmail 邮箱设置方式</a>。 其他邮箱服务的设置方式不方便找到，gmail 的最方便，建议换成 gmail 邮箱(不是广告)。</li> |
| </ul> |
| </li> |
| <li>修改编辑页面的 homepage url，<a href="http://people.apache.org/committer-index.html">apache 提交者列表页</a>中你的账户能加主页链接。</li> |
| <li>修改编辑页面的 github 账户(username)，提交确认后两个小时内会有邮件邀请你加入 github.com/apache-committers 组。这期间可以阅读<a href="http://www.apache.org/foundation/how-it-works.html#developers"> ASF 工作方式</a>以对 ASF 开发做一些基本了解。</li> |
| </ol> |
| <h2 id="四提交者获得对项目的写权限">四、提交者获得对项目的写权限</h2> |
| <p><a href="https://gitbox.apache.org/setup/">GitBox 账户链接工具</a>的操作</p> |
| <h3 id="apache账户授权">Apache账户授权</h3> |
| <p>按照提示授权对 Apache 账户的 OAuth 协议登入</p> |
| <h3 id="github账户授权">Github账户授权</h3> |
| <p>按照提示授权对 github 账户的 OAuth 协议登入</p> |
| <h3 id="在-githubcom-设置-github-账户两因素授权2fa">在 github.com 设置 github 账户两因素授权（2FA）</h3> |
| <p>按照<a href="https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication">授权 GitHub 2FA wiki</a> 操作如下：</p> |
| <ul> |
| <li> |
| <p>在手机安装 “google 身份验证器” app</p> |
| </li> |
| <li> |
| <p>按照<a href="https://docs.github.com/en/authentication/securing-your-account-with-two-factor-authentication-2fa/configuring-two-factor-authentication">授权 GitHub 2FA wiki</a> 一步一步操作。</p> |
| <p>在<a href="https://github.com/settings/security">两因素授权验证</a>界面，不建议选择用手机扫描二维码，因为有些手机会扫描不出来。 |
| 请打开手机 “google 身份验证器” app，点“+”选择“输入提供的秘钥”： 在“账户名” input 框写入 github 账户。在“您的秘钥” input 框写入:打开的网页中 &ldquo;enter this text code&rdquo; 链接里面的文本。在 app 中点击&quot;添加&quot; 后，将为此账户生成6位数字动态。将此6位数字写入网页中的文本框，然后点 “Enable”。这样 2FA 就设置成功了。</p> |
| </li> |
| <li> |
| <p>退出并重新登陆 github，输入用户名、密码后会多一步动态密码的填写，该动态密码就是 google 身份验证器上面的动态密码</p> |
| </li> |
| <li> |
| <p>大概需要半个小时,会有邮件通知你已经加入了 xx project-committers 开发者组。你也可以进入 <a href="https://github.com/orgs/apache/teams">apache teams</a> 页面查看。</p> |
| </li> |
| <li> |
| <p>2FA 提交后，你已经 clone 的项目会有权限校验问题，解决方法为下面二选一：</p> |
| <ul> |
| <li>申请 Access Token： |
| 在 github 上生成 access token 后，指令行需要密码的地方就粘贴token。 |
| 参考官网<a href="https://docs.github.com/cn/repositories/creating-and-managing-repositories/troubleshooting-cloning-errors#provide-access-token-if-2fa-enabled">帮助链接一</a>和<a href="https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token">帮助链接二</a></li> |
| <li>改用 ssh： |
| 在命令行执行 ssh-keygen 命令， 然后把pub文件中的内容粘贴到 github 上</li> |
| </ul> |
| </li> |
| <li> |
| <p>注意：一定要保证 github 的 2FA 为 &ldquo;enable&rdquo; 状态。当你将 2FA 设置为 &ldquo;off&rdquo; 时候，将会被对应的 apache committer 写权限组除名，直到你再次设置成功为止。</p> |
| </li> |
| </ul> |
| <h2 id="五其他">五、其他</h2> |
| <h3 id="the-apache-way">The Apache Way</h3> |
| <p>详情请参考 <a href="http://apache.org/foundation/governance/">wiki</a></p> |
| <p>社区重于代码，如果某问题或者方案没有在社区(邮件列表)讨论过，就当没有发生过</p> |
| <h3 id="小福利">小福利</h3> |
| <p>Jetbrains 给 apache 提交者一个小福利，就是可以免费使用 idea 的全产品系列。具体注册地址为：https://www.jetbrains.com/shop/eform/apache?product=ALL</p> |
| <h3 id="相关-wiki">相关 wiki</h3> |
| <p><a href="https://www.apache.org/dev/new-committers-guide.html">https://www.apache.org/dev/new-committers-guide.html</a></p></description></item><item><title>Contact: CLA 签署向导</title><link>https://dubbo.apache.org/zh-cn/contact/committer/cla-signing-guide_dev/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/zh-cn/contact/committer/cla-signing-guide_dev/</guid><description> |
| <p>以下情况，需要您签署 Apache ICLA：</p> |
| <ul> |
| <li>在 Dubbo 被捐赠给 Apache 之前，您已经为 Dubbo 作出了很多贡献，并且您以前没有签署过 Alibaba-CLA。</li> |
| <li>您已经为 Dubbo 作出了很多贡献，并且您被邀请成为 Dubbo 提交者，且之前没有签署过 Alibaba-CLA 或者 Apache ICLA。</li> |
| </ul> |
| <h3 id="步骤">步骤</h3> |
| <ul> |
| <li>下载这篇 <a href="https://www.apache.org/licenses/icla.pdf">pdf 文档</a></li> |
| <li>编辑该文档，在必要的空格处填上适当的内容</li> |
| <li>打印</li> |
| <li>在打印好的文件上签字</li> |
| <li>扫描</li> |
| <li>发送一封邮件到secretary@apache.org，并抄送给private@dubbo.apache.org： |
| <ul> |
| <li>邮件标题为 “ICLA submission”</li> |
| <li>请在邮件正文附上您的github账号链接</li> |
| <li>请记得将您的 ICLA 文档放入邮件的附件里</li> |
| </ul> |
| </li> |
| </ul> |
| <h3 id="空格填写必要说明">空格填写必要说明</h3> |
| <ul> |
| <li>Mailing address：首选英文格式的公司地址</li> |
| <li>Preferred apache id(s)：如果您被邀请成为一名提交者，那么需要您填写一个apache账号，否则，可以不填</li> |
| <li>Notify project：Dubbo（意思就是Dubbo就是通知您签署ICLA的项目）</li> |
| </ul></description></item><item><title>Contact: 如何准备 Apache Release</title><link>https://dubbo.apache.org/zh-cn/contact/committer/release-guide/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/zh-cn/contact/committer/release-guide/</guid><description/></item><item><title>Contact: 网站向导</title><link>https://dubbo.apache.org/zh-cn/contact/committer/website-guide_dev/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/zh-cn/contact/committer/website-guide_dev/</guid><description> |
| <ol> |
| <li>Apache Dubbo 的网站仓库是 <a href="https://github.com/apache/dubbo-website">https://github.com/apache/dubbo-website</a></li> |
| <li>网站构建完毕后，它会被自动发布到 dubbo.apache.org，您也可以通过 <a href="https://selfserve.apache.org">https://selfserve.apache.org</a> 手动触发（需要使用 Apache 账号登陆）</li> |
| </ol></description></item><item><title>Contact: 给问题打标签</title><link>https://dubbo.apache.org/zh-cn/contact/committer/label-an-issue-guide_dev/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/zh-cn/contact/committer/label-an-issue-guide_dev/</guid><description> |
| <p>如果您正在处理一个问题，请记得<strong>给这个问题标记一个或者多个您认为有意义的标签</strong>。有了标签，其他开发人员就会很轻松地识别出问题，以便对其进行分类并跟踪进度。</p> |
| <p>对于需要编码和发版修复的 issues 和 pull requests，需要您<strong>将其标记为 <a href="https://github.com/apache/dubbo/milestones">milestone</a></strong>。</p> |
| <p>一些常用的标签：</p> |
| <ul> |
| <li>请求帮助 |
| <ul> |
| <li>help wanted</li> |
| <li>good first issue</li> |
| </ul> |
| </li> |
| <li>优先级 |
| <ul> |
| <li>priority/blocker</li> |
| <li>priority/high</li> |
| <li>priority/low</li> |
| <li>priority/normal</li> |
| </ul> |
| </li> |
| <li>状态 |
| <ul> |
| <li>status/need-triage</li> |
| <li>status/DO-NOT-MERGE</li> |
| <li>status/READY-TO-MERGE</li> |
| <li>status/invalid</li> |
| <li>status/wontfix</li> |
| </ul> |
| </li> |
| <li>类型 |
| <ul> |
| <li>type/bug</li> |
| <li>type/documentation</li> |
| <li>type/enhancement</li> |
| <li>type/feature</li> |
| </ul> |
| </li> |
| </ul></description></item><item><title>Contact: 官方 Dubbo 主页的维护</title><link>https://dubbo.apache.org/zh-cn/contact/committer/apache-dubbo-page_dev/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://dubbo.apache.org/zh-cn/contact/committer/apache-dubbo-page_dev/</guid><description> |
| <p>Apache 有一个官方的网站，用来维护所有的孵化项目的信息。每一个孵化项目在这个网站下都有一个信息页。 |
| Dubbo 的信息页地址是 <a href="https://incubator.apache.org/projects/dubbo.html">https://incubator.apache.org/projects/dubbo.html</a>。</p> |
| <p>当项目发生比较大的变化，比如新的 committer 的加入，新的 PMC 的当选，或是新版本的 Release 等，都需要将这些更新信息维护到这个页面。</p> |
| <p>这个官方网站的项目地址是<a href="https://svn.apache.org/repos/asf/incubator/public/trunk">https://svn.apache.org/repos/asf/incubator/public/trunk</a>。</p> |
| <p>维护这个页面的方法如下：</p> |
| <p>1.安装 SVN。若是 Mac OS X 系统或是 Linux 系统，则自带了 SVN。若是 Windows 系统，则请首先自行安装 SVN。</p> |
| <p>2.用 SVN 将这个<a href="https://svn.apache.org/repos/asf/incubator/public/trunk">项目</a> checkout 下来 。</p> |
| <p>3.修改 content/projects/dubbo.xml 文件，并保存。</p> |
| <p>4.安装 ANT。执行 trunk 目录下的 build.sh 或者 build.bat 脚本构建项目。</p> |
| <p>5.构建完成后，可以用浏览器打开 target/site/projects/dubbo.html 文件，预览修改是否生效。</p> |
| <p>6.用 SVN 的 commit 命令将 dubbo.xml 文件提交到服务器，并且不要提交 dubbo.html 文件（因为服务器端会定时自动构建）。 |
| 此过程会要求输入Apache id和密码。</p> |
| <p>参考:</p> |
| <ol> |
| <li><a href="http://incubator.apache.org/guides/website.html">http://incubator.apache.org/guides/website.html</a></li> |
| <li><a href="https://svn.apache.org/repos/asf/incubator/public/trunk/README.txt">https://svn.apache.org/repos/asf/incubator/public/trunk/README.txt</a></li> |
| </ol></description></item></channel></rss> |
