CANN社区新建仓与仓开放操作指引
【免费下载链接】community本项目是CANN开源社区的核心管理仓库,包含社区的治理章程、治理组织、通用操作指引及流程规范等基础信息项目地址: https://gitcode.com/cann/community
本指引结合TSC、PMC会议时间,为开发者提供清晰的操作步骤和时间安排建议。
一、会议时间速查表
关键评审会议(必须参加)
| 组织 | 会议时间 | 频次 | 评审内容 | 纪要链接 |
|---|---|---|---|---|
| QA-SIG | 双周二 10:30-12:00 | 双周 | 测试报告/开源评审 | QA纪要 |
核心决策会议(必须参加)
| 组织 | 会议时间 | 频次 | 评审内容 | 申报方式 | 纪要链接 |
|---|---|---|---|---|---|
| TSC | 月末周六 | 月度 | 新建仓/SIG创建审批 | 纪要申报 | TSC纪要 |
| PMC | 双周三 14:00-16:00 | 双周 | 开源审批/版本发布审批 | 纪要申报 | PMC纪要 |
其他会议(可选/按需参加)
| 组织 | 会议时间 | 频次 | 说明 | 纪要链接 |
|---|---|---|---|---|
| Infrastructure SIG | 双周二 14:00-15:00 | 双周 | CI配置讨论,建仓通过Issue异步执行 | Infra纪要 |
| Security SIG | 月末周五 10:00-12:00 | 按需 | 三方件引入申请时需参加,不涉及三方引入则不需要关注 | Security纪要 |
二、新建仓完整流程
流程图
┌─────────────────────────────────────────────────────────────────────────────┐ │ 新建仓流程(约2-3周) │ ├─────────────────────────────────────────────────────────────────────────────┤ │ │ │ 第1步:准备材料+申报议题(会议前任意时间) │ │ ├─ 下载模板:新建仓申报模板 v0.1.pptx │ │ ├─ 填写:仓库名称、目标、技术方案、维护者等 │ │ ├─ 申报方式:直接在TSC纪要填写议题 │ │ └─ 格式:「1. XXX仓库新建申请 -- 申请人:XXX」 │ │ │ │ 第2步:TSC会议评审 ⏰ 月末周六 │ │ ├─ 在会议上陈述建仓方案 │ │ ├─ TSC委员投票(需2/3赞同) │ │ └─ 通过后记录评审纪要 │ │ │ │ 第3步:基础设施团队执行建仓 │ │ ├─ 向 infrastructure 提交Issue申请建仓 │ │ ├─ 申请者通过[CANN数字化平台](https://digital.hicann.cn/#/repo_manage/all_repo)提交建仓申请 │ │ ├─ 附上TSC评审纪要截图 │ │ └─ 基础设施团队同步审批并执行仓库创建 │ │ ↓(以下步骤并行执行) │ │ │ │ 第4步:CI流水线配置(并行) │ │ ├─ 向 infrastructure 提交Issue申请CI配置 │ │ ├─ 提供:编译命令、UT运行命令 │ │ └─ 基础设施团队配置门禁和每日构建 │ │ │ │ 第5步:权限配置(并行) │ │ ├─ Fork cann/community │ │ ├─ 修改 org-info.yaml(添加仓库到对应SIG) │ │ ├─ 提交PR,获得tsc_member评审 │ │ └─ 创建 sig-info.yaml(配置maintainer/committer) │ │ │ └─────────────────────────────────────────────────────────────────────────────┘补充说明:如需同步创建SIG和仓库,可在同一次TSC会议评审两个议题
┌─────────────────────────────────────────────────────────────────────────────┐ │ 同步创建SIG和仓库流程(约2-3周) │ ├─────────────────────────────────────────────────────────────────────────────┤ │ │ │ 第1步:准备材料+申报议题(会议前任意时间) │ │ ├─ SIG申请:下载SIG组申报模板PPT │ │ ├─ 建仓申请:下载新建仓申报模板PPT │ │ ├─ 申报方式:在TSC纪要填写议题 │ │ └─ 格式:「XXX SIG新建申请及仓库新建 -- 申请人:XXX」 │ │ │ │ 第2步:TSC会议评审 ⏰ 月末周六(同一次会议) │ │ ├─ 同时陈述SIG申请和建仓申请 │ │ ├─ TSC委员投票(需2/3赞同) │ │ └─ 通过后记录评审纪要 │ │ │ │ 第3步:基础设施团队执行建仓 │ │ ├─ 向 infrastructure 提交Issue申请建仓 │ │ ├─ 申请者通过[CANN数字化平台](https://digital.hicann.cn/#/repo_manage/all_repo)提交建仓申请 │ │ ├─ 附上TSC评审纪要 │ │ └─ 基础设施团队同步审批并执行仓库创建 │ │ ↓(以下步骤并行执行) │ │ │ │ 第4步:CI流水线配置(并行) │ │ ├─ 向 infrastructure 提交Issue申请CI配置 │ │ ├─ 提供:编译命令、UT运行命令 │ │ └─ 基础设施团队配置门禁和每日构建 │ │ │ │ 第5步:创建SIG配置(并行,需按顺序提交PR) │ │ ├─ PR1:修改 org-info.yaml(同时添加SIG定义和仓库) │ │ │ └─ 提交PR,获得tsc_member评审合入 │ │ ├─ PR2:在sigs目录创建SIG目录 │ │ │ ├─ 创建 sig-info.yaml(配置maintainer/committer) │ │ │ ├─ 创建 README.md(SIG介绍、会议时间、成员信息) │ │ │ └─ 提交PR,获得tsc_member评审合入 │ │ └─ 申请邮件列表(可选):参阅[基础设施支撑矩阵](https://link.gitcode.com/i/e9521addcf143475d5370d54b6118dc2) │ │ │ │ 第6步:绑定账号获取会议权限 │ │ ├─ 登录会议平台绑定GitCode账号与华为账号 │ │ └─ SIG maintainer/committer自动获得创建会议权限 │ │ │ └─────────────────────────────────────────────────────────────────────────────┘关键时间节点
| 阶段 | 时间安排 | 操作 | 等待时间 |
|---|---|---|---|
| 准备材料+申报议题 | 会议前任意时间 | 填写PPT模板,在TSC纪要申报 | 无限制 |
| TSC评审 | 月末周六 | 参加会议陈述方案 | 当天 |
| 基础设施执行 | 评审后1-3天 | 提交建仓Issue | 异步处理 |
| CI配置 | 评审后1-3天 | 提交CI配置Issue(并行) | 异步处理 |
| 权限配置 | 评审后1-3天 | 修改community配置PR(并行) | 等待评审合入 |
总耗时:约2-3周(主要取决于TSC会议周期和PR评审时间)
同步创建SIG和仓库时间节点:
| 阶段 | 时间安排 | 操作 | 说明 |
|---|---|---|---|
| 准备材料+申报 | 会议前任意时间 | 同时准备SIG和建仓PPT,在TSC纪要申报两个议题 | 无时间限制 |
| TSC评审 | 月末周六 | 同时陈述SIG申请和建仓申请 | 同一次会议完成 |
| 基础设施执行 | 评审后1-3天 | 提交建仓Issue+CI配置Issue(并行) | 异步处理 |
| SIG配置PR1 | 评审后1-3天 | 修改org-info.yaml(添加SIG定义和仓库) | 需等待评审合入 |
| SIG配置PR2 | PR1合入后 | 创建sigs目录、sig-info.yaml、README.md | 需等待评审合入 |
同步创建SIG和仓库总耗时:约2-3周(主要取决于TSC会议周期和PR评审时间)
关键点:
- SIG申请和建仓申请可在同一次TSC会议评审
- org-info.yaml PR可同时包含SIG定义和仓库定义
- SIG配置PR需按顺序提交(PR1合入后才能提交PR2)
说明:
- 准备材料和申报议题可在任何时间进行,无时间限制
- 只需确保在月末周六TSC会议召开前准备好即可
- CI配置和权限配置可与基础设施执行同步进行
三、新仓库开源流程
流程图
┌─────────────────────────────────────────────────────────────────────────────┐ │ 新仓库开源流程(约1-2周) │ ├─────────────────────────────────────────────────────────────────────────────┤ │ │ │ 第1步:准备测试报告 │ │ └─ 使用测试报告模板 │ │ └─ 包含:版本信息、测试结果、覆盖率等 │ │ │ │ 第2步:QA-SIG评审 ⏰ 双周二 10:30-12:00 │ │ ├─ 在QA纪要申报议题 │ │ ├─ 陈述测试报告和质量出口标准 │ │ ├─ QA评审通过后记录纪要 │ │ ↓(同一天申报PMC议题) │ │ │ │ 第3步:PMC开源评审 ⏰ 双周三 14:00-16:00(同一周) │ │ ├─ 在PMC纪要申报议题 │ │ ├─ 附上QA评审纪要 │ │ ├─ PMC评审通过后安排开源 │ │ │ │ 第4步:基础设施审视仓的配置 │ │ ├─ 基础设施团队审视仓库配置是否符合规范 │ │ ├─ 配置门禁、每日构建等CI流水线 │ │ └─ 审视通过后正式开源 │ │ │ └─────────────────────────────────────────────────────────────────────────────┘关键时间节点
| 阶段 | 时间安排 | 操作 | 等待时间 |
|---|---|---|---|
| 准备测试报告 | T-1周 | 完成测试并填写报告 | 约1周 |
| QA-SIG评审 | T+0(双周二) | 质量出口评审 | 当天 |
| PMC评审 | T+0(双周三) | 开源审批 | 当天 |
| 基础设施审视 | T+0~T+1周 | 审视仓配置、配置CI | 1-3天异步处理 |
| 正式开源 | T+1周 | 开源宣传 | 当天 |
总耗时:约1-2周(QA和PMC评审在同一周)
四、具体操作步骤
4.1 申报TSC议题(新建仓)
- 打开 TSC会议纪要
- 在最近未召开会议区域填写:
1. XXX仓库新建申请 -- 申请人:张三 - 准备好PPT材料,会议时陈述
4.2 提交基础设施Issue与数字化平台申请建仓
- 打开 基础设施Issue
- 选择「新建仓申请」模板
- 填写信息:
- 仓库名称
- 所属SIG
- TSC评审纪要链接
- Maintainer/Committer名单
- 提交Issue
- 同时登录 CANN数字化平台 提交建仓申请
- 基础设施团队同步审批并执行仓库创建
4.3 提交CI配置Issue
- 在 基础设施Issue 提交
- 选择「门禁/版本集成申请反馈」模板
- 填写信息:
- 代码编译命令:
bash build.sh --pkg - UT运行命令:
bash build.sh -u --ophost - 门禁触发命令:
/compile(默认) - 特殊依赖说明
- 代码编译命令:
4.4 配置权限(修改community)
步骤1:修改org-info.yaml
详细配置说明请参阅:org-info.yaml文件指导说明
步骤2:创建sig-info.yaml
详细配置说明请参阅:sig-info.yaml文件指导说明
步骤3:提交PR
- Fork cann/community
- 提交修改
- 等待评审:
cann-cla/yes:自动检查CLA签署(提交邮箱需要签署CLA)/lgtm:由tsc_member评论/approve:由tsc_member评论
4.5 同步创建SIG和仓库(如需要)
如果新仓库不属于现有SIG,可同时申请创建新SIG,在同一次TSC会议评审。
判断是否需要创建SIG
- 不需要:新仓库归属于现有SIG(如ops-math、ops-nn、runtime等),按正常建仓流程操作
- 需要:新仓库属于新的技术领域,需要成立独立SIG管理,可同步创建SIG和仓库
同步创建流程
步骤1:准备材料+申报议题(会议前任意时间)
- 准备两份PPT材料,可合一:
- SIG申请:使用 SIG组申报模板
- 建仓申请:使用 新建仓申报模板
- 在TSC纪要申报议题:
XXX SIG新建申请及仓库新建 -- 申请人:张三
步骤2:TSC评审(同一次会议)
- 同时陈述SIG申请和建仓申请
- TSC委员投票通过后记录评审纪要
步骤3:提交建仓申请(评审后立即提交)
- 向infrastructure提交建仓Issue(附上TSC评审纪要)
- 同时登录 CANN数字化平台 提交建仓申请
- 基础设施团队同步审批并执行仓库创建
- 同时提交CI配置Issue
步骤4:创建SIG配置(按顺序提交PR)
PR1:修改org-info.yaml(添加SIG定义和仓库)
详细配置说明请参阅:org-info.yaml文件指导说明
提交PR1,等待tsc_member评审合入(/lgtm+/approve)
PR2:创建SIG目录和文件(PR1合入后)
- 在
CANN/sigs/目录下创建新SIG目录:your-new-sig/ - 创建
sig-info.yaml文件,详细配置说明请参阅:sig-info.yaml文件指导说明 - 创建
README.md文件(包含SIG介绍、会议时间、成员信息等) - 提交PR2,等待tsc_member评审合入
步骤5:申请邮件列表(可选)
PR2合入后,如需新建邮件列表:
- 参阅 基础设施支撑矩阵 获取邮件列表联系人
- 邮件列表使用指南
步骤6:绑定账号获取会议权限
PR合入后:
- 登录 社区会议平台 个人中心
- 绑定GitCode账号与华为账号
- SIG maintainer/committer自动获得创建会议权限
- 注意:权限每隔1小时刷新一次
时间对比
| 情况 | 总耗时 | 说明 |
|---|---|---|
| 仅新建仓 | 约2-3周 | 归属现有SIG |
| 同步创建SIG和仓库 | 约3-4周 | 同一次TSC会议评审,多一次PR评审周期 |
4.6 申报QA-SIG议题(开源评审)
- 打开 QA会议纪要
- 填写议题:
1. XXX仓库开源评审 -- 申请人:张三 测试报告链接:XXX 开源版本:v1.0.0 - 会议时陈述测试报告
4.6 申报PMC议题(开源审批)
- 打开 PMC会议纪要
- 填写议题:
1. XXX仓库开源审批 -- 申请人:张三 QA评审纪要:XXX 开源计划:XXX - 会议时陈述开源方案
五、最佳实践时间规划
新建仓推荐时间线
┌─────────────────────────────────────────────────────────────────────────────┐ │ 说明:T+0为TSC会议当周(月末周六),整个流程约2-3周 │ ├─────────────────────────────────────────────────────────────────────────────┤ │ │ │ 时间点 关键事件 具体操作 │ │ ───────────────────────────────────────────────────────────────────── │ │ 会议前 准备+申报 填写新建仓申报PPT模板 │ │ 任意时间 在TSC纪要填写议题 │ │ ↓ (无时间限制,会议前完成即可) │ │ │ │ T+0周 ★TSC评审 参加月末周六TSC会议 │ │ (月末周六) 陈述建仓方案,获取评审纪要 │ │ ↓ │ │ 当天/次日 向infrastructure提交建仓Issue + 数字化平台申请 │ │ ↓ 同时:提交CI配置Issue │ │ ↓ 同时:Fork [community](https://link.gitcode.com/i/953105fe8983b16e36c20005ab4a0e81)准备权限PR │ │ │ │ T+1周 异步执行(并行) 基础设施团队创建仓库(1-3天) │ │ ├─ CI配置 CI门禁配置完成 │ │ ├─ 权限配置 提交权限PR,等待评审合入 │ │ ↓ (约3-7天PR评审) │ │ │ │ T+2周 开发就绪 PR合入,仓库正式可用 │ │ 开始正常开发 │ │ │ └─────────────────────────────────────────────────────────────────────────────┘ 关键里程碑: ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ 准备材料 │ → │ ★TSC评审通过 │ → │ 开发就绪 │ │ (任意时间) │ │ (月末周六) │ │ (评审后2周) │ └──────────────┘ └──────────────┘ └──────────────┘ ↓ ┌──────────────┐ │ 并行执行阶段 │ │ ├─ 仓库创建 │ │ ├─ CI配置 │ │ └─ 权限配置 │ └──────────────┘开源推荐时间线
┌─────────────────────────────────────────────────────────────────────────────┐ │ 说明:T+0为QA/PMC评审当周(双周二+双周三),整个流程约1-2周 │ ├─────────────────────────────────────────────────────────────────────────────┤ │ │ │ 周次 关键事件 具体操作 │ │ ───────────────────────────────────────────────────────────────────── │ │ T-1周 准备阶段 完成测试,填写测试报告 │ │ ↓ 在QA纪要申报议题 │ │ │ │ T+0周 ★QA-SIG评审 参加双周二QA会议 │ │ (双周二 10:30) 陈述测试报告,获取评审纪要 │ │ ↓ 当天在PMC纪要申报议题 │ │ ↓ │ │ ★PMC评审 参加双周三PMC会议 │ │ (双周三 14:00) 陈述开源方案,获取审批 │ │ ↓ 当天/次日基础设施审视 │ │ │ │ T+1周 正式开源 配置完成,开源宣传材料 │ │ 仓库正式对外开放 │ │ │ └─────────────────────────────────────────────────────────────────────────────┘ 关键里程碑: ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ QA评审通过 │ → │ PMC评审通过 │ → │ 配置审视完成 │ → │ 正式开源 │ │ (T+0周二) │ │ (T+0周三) │ │ (T+0~T+1周) │ │ (T+1周) │ └──────────────┘ └──────────────┘ └──────────────┘ └──────────────┘六、常见问题
Q1:准备材料和申报议题的时间安排?
说明:
- 准备材料和申报议题可在任何时间进行,无时间限制
- 只需确保在月末周六TSC会议召开前准备好PPT和完成申报即可
- 建仓前可先在对应SIG会议讨论技术方案
Q2:基础设施SIG会议时间冲突怎么办?
建议:
- Issue提交后,基础设施团队会异步处理
- 紧急需求可在Issue中标注「紧急」
Q3:QA-SIG和PMC评审时间安排?
说明:
- QA-SIG评审在双周二 10:30-12:00
- PMC评审在同周双周三 14:00-16:00
- 两场评审在同一周内完成,评审周期约1周
- 可提前与QA-SIG沟通预审
Q4:需要引入开源三方件怎么办?
建议:
- 在Security SIG申报引入申请
- 使用「开源软件引入申请模板」
- Security SIG会议:月末周五 10:00-12:00
七、关键链接汇总
会议平台
- 会议日历 - 查看所有会议安排
- TSC纪要 - 申报TSC议题
- PMC纪要 - 申报PMC议题
- QA纪要 - 申报QA议题
- Infra纪要 - 申报基础设施议题
Issue提交
- 基础设施Issue - 建仓/CI配置申请
模板下载
- 新建仓申报模板
- 测试报告模板
- 会议PPT模板
指导文档
- org-info.yaml文件指导说明
- sig-info.yaml文件指导说明
- CI集成指南
- 会议指南
- 邮件列表指南
邮件订阅
- TSC邮件列表
- PMC邮件列表
- Infrastructure邮件列表
文档版本: v1.0
创建时间: 2026-04-18
来源: CANN community仓库 + 会议平台信息
【免费下载链接】community本项目是CANN开源社区的核心管理仓库,包含社区的治理章程、治理组织、通用操作指引及流程规范等基础信息项目地址: https://gitcode.com/cann/community
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考