CANN社区新建仓与仓开放操作指引
本指引结合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://gitcode.com/cann/infrastructure/blob/main/docs/services.md) │
│ │
│ 第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:准备材料+申报议题(会议前任意时间)
步骤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://gitcode.com/cann/community)准备权限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
七、关键链接汇总
会议平台
Issue提交
- 基础设施Issue - 建仓/CI配置申请
模板下载
指导文档
邮件订阅
文档版本: v1.0
创建时间: 2026-04-18
来源: CANN community仓库 + 会议平台信息