- Dev - mailweb.openeuler.org

《openEuler 补丁管理规范》意见收集，欢迎大家参与评论
by Licihua 30 Nov '20

30 Nov '20

Hi，大家好，为了降低openEuler 社区补丁维护成本，支撑社区自动升级工具运行，特拟定了openEuler 社区补丁管理草稿，欢迎大家参与评率原文Issue链接： https://gitee.com/openeuler/community/issues/I27H0Z?from=project-issue 以下为正文内容：范围: 适用于openEuler 维护的src-openEuler 项目下开源软件仓库中的补丁。用词约定：规则：必须遵守的约定建议：需要加以考虑的约定 1 目的为了降低openEuler 社区开源软件补丁维护成本，根据开源社区对补丁应用惯例，制定如下规则。 2 补丁定义从开源软件补丁来源，补丁可分为以下2类：补丁来源定义自研补丁基于开源软件构筑差异化竞争力或修复开源软件社区未提供修复方案的缺陷，由openEuler社区自研开发且未被上游社区接纳的补丁。社区补丁开源软件社区提供用于特性增强/缺陷修复的补丁、对社区补丁进行适配的补丁、被社区接纳的openEuler社区自研补丁。从开源软件补丁用途，补丁可分为以下4类：补丁用途定义 Bugfix补丁解决开源软件缺陷的补丁 Feature补丁基于开源软件进行特性增强的补丁 CVE补丁解决开源软件安全漏洞的补丁 3 补丁划分 3.1 【规则】禁止一个补丁解决多个问题/需求为了确保问题/需求对应的合入可追溯，禁止一个补丁解决多个问题/需求。 3.2 【建议】遵守“一个或多个补丁解决一个问题/需求”原则 1、优先使用一个补丁解决一个问题； 4 补丁命名 4.1 【规则】补丁文件名由前缀、名字主体和补丁后缀组成，补丁名中单词间通过”-”相连 1、**补丁文件名前缀：**标识补丁来源，具体见下表。补丁文件名前缀适用范围无自研补丁。 backport- 上游开源社区补丁。 backport-[cve-name]- 上游开源社区的CVE补丁。 2、**名字主体：**名字主体应能体现该补丁解决的问题或新增的需求，通常与第6章节描述信息中的主题保持一致。从上游社区backport的补丁，优先使用git-format-patch 命令生成，主体名称为git commit message 中标题内容。 3、**补丁后缀：**后缀固定为“.patch”。样例：示例类别补丁文件名自研补丁 net-hinic-Add-NIC-Layer.patch 社区补丁 backport-nvme-rdma-fix-timeout-handler.patch CVE补丁 backport-CVE-2017-17806-crypto-hmac-require-that-the-underlying-hash-algorit.patch 5 补丁存放 5.1 【规则】补丁文件放置目录：对于spec管理的补丁，将补丁放置在源码压缩包的同级目录下 1、对使用spec管理的补丁，所有补丁放置在源码压缩包所在目录中。 2、对于spec管理的补丁，在spec文件中通过序号指定补丁打入顺序。 6 补丁应用顺序 6.1 【规则】补丁应用顺序按照先打上游社区补丁、再打openEuler 社区自研补丁根据经验，大部分软件包自研补丁数量远小于开源补丁，为了减少对开源源补丁适配工作量，建议先打开源补丁，再打自研补丁。 6 补丁辅助信息补丁辅助信息用于对补丁进行说明，主要包含：补丁描述信息、补丁标签、补丁修改记录等。 1、补丁描述信息补丁描述信息是对代码的合入原因、方案及影响等进行有效描述，目的是让阅读者快速理解该补丁，主要包括以下几方面。描述类别含义主题补丁主题：一句话描述补丁功能背景提交该补丁的原因问题现象问题发生时的直观现象复现条件问题复现需要执行的具体操作根因分析导致问题的根本原因实现方案解决问题或实现新特性的具体方案补丁来源地址该补丁的社区链接地址 2、补丁标签补丁标签对不同贡献者进行标识，包括：补丁开发/合入者、补丁对应的问题发现者、补丁检视者、补丁验证者和补丁建议者，具体如下表所示。标签含义 Fixes: 当前补丁所要修复的补丁信息格式：Fixes: (“commit-subject”) Signed-off-by: 开发者和committers签名 Reported-by: 问题发现者签名：包括发现错误的人或者自动化扫描工具 Reviewed-by: 检视人签名 Tested-by: 测试人签名 Suggested-by: 补丁建议者签名 3、补丁修改记录补丁被检视后，需要对检视意见进行修改，补丁修改记录是对每次检视后所做修改的描述。以上信息应尽量填写完整，以便其他人员只通过查看补丁信息就能了解整个补丁的情况，但不对所有信息做强制要求，以下针对每类补丁有具体的要求。 6.1 自研补丁对于自研补丁，只对补丁描述信息做明确要求，补丁标签和补丁修改记录可以通过代码提交系统承载。 6.1.1 【规则】自研补丁描述信息须包含两个信息：主题和背景。自研补丁的描述信息须包含主题和背景，其他描述信息可由Issue单承载。 6.2 开源社区补丁开源社区补丁一般通过邮件承载，信息承载较零散，应在补丁中把各种信息尽量描述清楚。 6.2.1 【建议】补丁描述信息：每一个补丁都要有描述信息，包括：主题、背景、问题现象、复现条件、根因分析、解决方法和补丁影响不同类别补丁的描述信息有不同的要求，以下列出不同类别应包含的描述信息：补丁类别应包含的描述信息 Bugfix补丁主题、问题现象、复现条件、根因分析、实现方案 Feature补丁主题、背景、实现方案 CVE补丁主题、CVE名字、问题现象、复现条件、根因分析、实现方案 6.2.2 【规则】补丁标签：开源社区补丁必须对不同贡献者通过不同标签进行区别为了保证补丁版权信息的完整性，补丁中需要增加所有贡献者的签名信息。 6.2.3 【建议】补丁修改记录：经过多次修改的补丁建议添加每一次修改所做出的变化补丁在修改后，建议添加此次补丁相比上次补丁所做的修改说明，最近一次修改说明放在最上方。添加修改说明的位置通常在签名等标签后，写明修改原因、作者、日期等信息。 6.2.3 【规则】在补丁回合MR提交信息中，补齐补丁名称和commit链接地址（中间可以通过空格或者冒号隔开） MR 中描述解决的问题，并且填写补丁的commit 链接地址，方便代码检视 6.2.4 【建议】开源软件补丁头必须保持和上游社区一致，若补丁需要适配，不允许修改补丁头，且需要在补丁头Subject字段对适配情况做简要说明如果对上游backport 的补丁做了适配，建议在Subject 后面增加适配内容的简要描述。 6.3 【规则】软件版升级时需要重新审视已有补丁如果补丁解决的问题在高版本已经合入，补丁可以删除，否则需要判断是否继承。待继承的补丁需要找到补丁解决的原始问题然后重新适配。尤其要避免从上游新版本适配回来的补丁对低版本做了适配裁剪，升级高版本时补丁可以打上但是修改不全的问题。 6.4 【规则】自研补丁被社区接纳后，须使用被社区接纳的补丁替换 openEuler自研补丁要尽量贡献到上游社区，推送到社区时，补丁辅助信息应遵从6.2章节，社区接纳后，须使用被社区接纳的补丁替换，包括补丁文件名和辅助信息等，以保持与社区一致。 7 相关文件&参考资料 [1] Linux文档：https://github.com/torvalds/linux/blob/master/Documentation/process… 李次华欧拉部-2012 实验室华为技术有限公司 Tel : +86 15158056404 Email : licihua(a)huawei.com [cid:image001.png@01D6C727.1050A1A0] This e-mail and its attachments contain confidential information from HUAWEI, which is intended only for the person or entity whose address is listed above. Any use of the information contained herein in any way (including, but not limited to, total or partial disclosure, reproduction, or dissemination) by persons other than the intended recipient(s) is prohibited. If you receive this e-mail in error, please notify the sender by phone or email immediately and delete it!

1 0

openeuler奖励计划发布内容评审
by openEuler conference 30 Nov '20

30 Nov '20

1 0

sig-Kubernetes 工作例会
by pengfeizhou＠yunify.com 30 Nov '20

30 Nov '20

您好！ openEuler sig-Kubernetes SIG 邀请您参加 2020-11-30 16:00 召开的 ZOOM 会议会议主题：sig-Kubernetes 工作例会会议链接：https://us02web.zoom.us/j/88206728352?pwd=NmRnSFF3ZUdwRi9ZQXlmUUdhQXp5dz09 会议号：882 0672 8352 密码：openeuler （由于我们缺少 openEuler 会议小程序预定权限，此次会议还未在小程序预定）会议大纲： • openEuler Summit 展台计划展示的 Demo 交流与确认 • SIG 当前适配与对接 openEuler 的工作进展讨论 • SIG 相关 issue 讨论： 1. 使用 kubekey 在openEuler 20.03 LTS 部署 Kubernetes+kubesphere，不支持 k8s-1.18.6： https://gitee.com/openeuler/kubekey/issues/I24INZ#note_3704610 2. iSula 2.0.5 对接 K8s，calico-node 无法启动：https://gitee.com/openeuler/iSulad/issues/I26JLU?from=project-issue 3. kata-runtime 适配 Stratovirt ，修改错误提示错误：https://gitee.com/src-openeuler/kata-runtime/issues/I25MHG 4. iSula 无法导出镜像打包成文件： https://gitee.com/openeuler/iSulad/issues/I272IX?from=project-issue 5. Kubekey 迁移到 src-openEuler 组织下：https://gitee.com/openeuler/kubekey/issues/I271P6 https://gitee.com/oschina/git-osc/issues/I274OF 更多资讯尽在：https://openeuler.org/zh/ _______________________________________________ Dev mailing list -- dev(a)openeuler.org To unsubscribe send an email to dev-leave(a)openeuler.org

1 0

答复: 关于ABI工具的一些疑问
by Hexiaowen (Hex, EulerOS) 30 Nov '20

30 Nov '20

各位高校的开发者，你好，首先欢迎关注开发者大赛。[cid:image003.png@01D6C6F9.DF14FFA0] ? 我们想问一下，这个赛题是希望我们自己重写一个类 lvc 项目，还是希望我们对现有 lvc 进行调整和改进呢？能否请您给一些这方面的建议呢？此题目的背景是，社区有很多软件，在做选型升级时往往面临大量的差异分析工作，社区希望能够通过自动化工具来减少工作量。开源社区已有多种方案来部分解决此问题，参赛者通过引入（封装、提高易用性）或借鉴（自己实现）的方式集成到openEuler版本，给openeuler社区开发者提高效率。开发者可以自由选择引入或借鉴两种方式其一来着手，但要考虑开发者大赛时间紧迫。开发者大赛只是引子，我们希望是做集大成者，成立一个长期项目，将ABI检测这一领域持续完善。 ? 另外在 Python 方面，Python作为脚本语言，一般没有编译后的二进制文件，那这个项目的Python部分关注的输入是什么呢？是 Python源码吗？还是别的输入类型？ Python和java等解释性语言类似，可以源码作为输入来开展。然后再考虑不断支持其他可能的输入，如java的字节码等。 ? 很感谢你的回复, 我这边是我和两个大二学生组的团队, 很希望能与你又一次线上交流! 我们可以先加个微信(xiaowen_he)，协调一个合适的时间来做一次线上的交流。何晓文（Hex EulerOS） Email : hexiaowen(a)huawei.com [cid:image001.png@01D6C6FA.30267A40] This e-mail and its attachments contain confidential information from HUAWEI, which is intended only for the person or entity whose address is listed above. Any use of the information contained herein in any way (including, but not limited to, total or partial disclosure, reproduction, or dissemination) by persons other than the intended recipient(s) is prohibited. If you receive this e-mail in error, please notify the sender by phone or email immediately and delete it! 发件人: Hexiaowen (Hex, EulerOS) 发送时间: 2020年11月27日 9:19 收件人: 'LY' <liuting713(a)foxmail.com>; '2764476004' <2764476004(a)qq.com> 抄送: dev <dev(a)openeuler.org> 主题: 答复: 关于ABI工具的一些疑问 > 老师好: > 我是西安邮电大学大三在读的一名本科生, 最近看到openeuler高校开发者大赛, 看到了这个赛题, 我觉得主要是干elf文件的分析工作, 想问问您对吗? 如果不对, 您能指一个方向吗? liuting你好，ABI差异分析工具，主要是针对elf等格式二进制文件的分析处理，同时，也可以支持源码作为输入进行差异分析。 ? 你好，能看看你们这个赛题的ppt吗，想再了解一下，小龙你好，附件是几道竞赛题的简单解析，如有需要，我们可以做一次线上非正式交流。后续有任何关于openEuler的疑问，都可以发送到dev(a)openeuler.org<mailto:都可以发送到dev@openeuler.org>邮件列表中咨询。何晓文（Hex EulerOS）庞加莱实验室 [2012实验室] Tel : +86 18042018786 Email : hexiaowen(a)huawei.com<mailto:hexiaowen@huawei.com> [cid:image004.png@01D6C6F7.15E72560] This e-mail and its attachments contain confidential information from HUAWEI, which is intended only for the person or entity whose address is listed above. Any use of the information contained herein in any way (including, but not limited to, total or partial disclosure, reproduction, or dissemination) by persons other than the intended recipient(s) is prohibited. If you receive this e-mail in error, please notify the sender by phone or email immediately and delete it! 发件人: LY [mailto:liuting713@foxmail.com] 发送时间: 2020年11月26日 20:17 收件人: Hexiaowen (Hex, EulerOS) <hexiaowen(a)huawei.com<mailto:hexiaowen@huawei.com>> 主题: 关于ABI工具的一些疑问老师好: 我是西安邮电大学大三在读的一名本科生, 最近看到openeuler高校开发者大赛, 看到了这个赛题, 我觉得主要是干elf文件的分析工作, 想问问您对吗? 如果不对, 您能指一个方向吗?

1 0

12月2日 TC例行会议
by openEuler conference 30 Nov '20

30 Nov '20

1 0

sig-confidential-computing例会
by openEuler conference 29 Nov '20

29 Nov '20

1 0

sig-Java工作例会
by openEuler conference 29 Nov '20

29 Nov '20

1 0

SIG例会
by openEuler conference 28 Nov '20

28 Nov '20

1 0

openEuler社区开发指导课程需求收集
by Zhuyanpeng 28 Nov '20

28 Nov '20

为了更好地让开发者上手社区开发，一步一步了解、掌握社区开发的技能、技巧，初步整理了一些课程，后续录制为课程微视频放出来，请各位开发者提提意见、建议，以及新的课程诉求 https://gitee.com/openeuler/community/issues/I27C62?from=project-issue

1 0

OS-Builder sig组例会
by openEuler conference 28 Nov '20

28 Nov '20

3 2

2024

2023

2022

2021

2020

2019

Dev