-
Notifications
You must be signed in to change notification settings - Fork 35
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
一次Mentor创建新项目的流程记录 (IPMC建设新项目指南) #165
Comments
Cool, much clear. 👍🏻 |
关于
下面是
|
IPMC建设新项目指南.md
本文翻译自https://incubator.apache.org/guides/mentor.html
本文适用于项目已经在 [email protected] 投票通过的孵化器项目,后续由Mentor创建各种基础设施的过程。
介绍
在孵化器PMC (IPMC)接受了一个podling(指新项目)后,需要有一个导师设置如下内容:
(译者注:podling相关的svn基地址是:https://svn.apache.org/repos/asf/incubator/public/trunk/)
将Podling加入到podling摘要文件中
在svn的 content/podlings.xml中将podling添加到podling摘要文件中 (可以找找文件里面 status="current" 的项目,将其拷贝当作模板)。
参考格式:
注意,reporting非常重要,孵化器项目需要每月汇报。同时需要指明初始的三个月是什么(第一个月是进入孵化器的下个月)。
一旦前三个月的报告完成后,就要mentor把monthly属性删除,并且把后面的三个月份列举给删除。
注意第一份报告可能非常短,IPMC可以指导一下。详见PPMC指导
初始化 Podling 状态页面
导师需要创建podling状态页面来跟踪项目。在有PPMC可以更新页面之前,导师需要负责页面更新。
状态页面是孵化器对项目进展的记录。导师或PPMC必须在孵化期间使其保持最新。该页面的一些信息可以从podling提案中获得。随着启动过程的继续和项目创建资源,PPMC应该更新页面。
状态页面模板包含了所需的操作列表,其中那些不合适本项目的,可以删除。
状态页面对孵化工作流很有帮助。志愿者可以使用它来签署各种任务,并跟踪进展。一旦邮件列表建立起来并且有人订阅了,就可以使用dev@列表进行任务讨论。
资源
您需要根据所处理的文件以特定的顺序申请资源。
在对SGAs进行归档之前,不要申请源码仓库资源,例如,源代码尚未获得Apache许可或依赖满足A类许可。
项目的提案中应包括所需资源的清单。Infra团队在得到恰当的申请后会创建一些; IPMC成员(通常是导师)可以创建其他的内容。
Infra有一个指南,叫做Infra和孵化器,帮助您了解资源申请的流程,并指导您申请资源。
您需要创建的第一个资源是LDAP和DNS。通过Apache Infra Jira→创建任务从Infra 申请它们。
一旦这些项目可用,就创建邮件列表。其他资源通常将信息发布到这些列表。
申请邮件列表
Apache电子邮件列表需要志愿者来做审核员。在您设置电子邮件列表之前,至少需要一个志愿者,并且以后还可以添加新的审核员。审核是一个相当简单的任务,尽管版主可能想要设置垃圾邮件过滤。我们建议每个podle至少有三个审核员来分担负载。
提案应该包含请求电子邮件列表所需的其余信息。由于孵化器是负责任的顶级项目,所以域名必须是incubator.apache.org。例如:
一般刚开始的时候不需要创建user@,对于用户或者开发者可以都集中到dev@去。此外,进入podling前如果已经有了一些交流渠道,也可以保留下来,不过要在dev@ 列表中讨论和决定此事。
注意,如果你在使用SVN,那么所有在http://svn.apache.org/repos/asf/incubator/${podling} 的提交记录都会被发到commits@ 邮件列表。 如果要修改,则需要IPMC在asf-mailer.conf中增加特殊配制。
Infra团队有一个创建邮件列表的工具,来简化此事。 创建后,会有通知邮件被发到private@incubator列表。
当创建了邮件列表后,要记得更新项目状态页面。
一旦commits邮件列表被创建出来,项目需要审查下svn的/incubator/${podling} 树,因为之前的所有代码提交都没有邮件通知。
邮件归档
在此处 设置公开邮件的归档。导师无需做任何处理。
使用lists.apache.org也可以看归档邮件。
许多项目邮件列表还会使用额外的归档服务(例如 Mail Archive MARC). 这些归档服务有助于项目的曝光。但是这些需要手动来订阅。
你还必须手动创建新闻到邮件列表的订阅桥接,例如 Nabble 。这个也有助于增加曝光,但是要注意 Nabble的新闻用户可能并不知道他们正在向邮件列表发送信息。
邮件列表管理员
Apache 使用 ezmlm。 更多详情需要参见其它教程1, 教程2 。
邮件列表转换
这部分是在说如果过去项目有非apache的邮件列表,该怎么迁移。暂不涉及,不翻译。
自助服务
绝大多数资源都可以通过自助服务来建立,包括设置Git仓库、邮件列表、JIRA、Confluence Wiki。
JRIA
要申请JIRA,从这里申请。
其他issue 跟踪系统
如果要使用其他的issue跟踪系统,请向infra jira发送申请。
记得完成后要通知社区。
Git 迁移
如果要做Git的迁移,则需要写一个 New Git Repository的infra 申请,请求从已有的组织中迁移到apache组织。
Gitbox 申请
要申请一个Gitbox仓库地址的话,要首先写 GitBox Integration 申请。一旦你的podling被加入,你就可以使用如下链接:https://gitbox.apache.org/ 来管理你的Gitbox仓库和用户信息。
Podling 引导
任务列表:
以HugeGraph为例的实际操作
svn co https://svn.apache.org/repos/asf/incubator/public/trunk/content
修改
content/podlings.xml
添加:content/projects/
下新建项目文件 hugegraph.xml,建议找一个已有的孵化项目拷贝过来修改。``
svn add hugegraph.xml
,svn commit -m "init hugegraph project status page"
.更多.asf.yaml的功能可以参考 https://cwiki.apache.org/confluence/display/INFRA/Git+-+.asf.yaml+features
The text was updated successfully, but these errors were encountered: