From 733ca6ddb465844d5b57dc98cbcbec98853522ed Mon Sep 17 00:00:00 2001 From: Zhao Hang Date: Mon, 6 Jan 2025 11:32:13 +0800 Subject: [PATCH] update docs links Signed-off-by: Zhao Hang --- ...w \344\273\243\347\240\201\346\214\207\345\215\227.md" | 4 ++-- ...66\351\233\206\346\210\220\346\240\267\344\276\213.md" | 4 ++-- ...14\347\256\241\347\220\206\345\216\237\345\210\231.md" | 8 ++++---- ...50\346\216\245\347\256\241\346\234\215\345\212\241.md" | 4 ++-- 4 files changed, 10 insertions(+), 10 deletions(-) diff --git "a/DEVELOPER_DOCS/\350\277\233\351\230\266\345\274\200\345\217\221/Review \344\273\243\347\240\201\346\214\207\345\215\227.md" "b/DEVELOPER_DOCS/\350\277\233\351\230\266\345\274\200\345\217\221/Review \344\273\243\347\240\201\346\214\207\345\215\227.md" index 2b654d2..fa394f6 100644 --- "a/DEVELOPER_DOCS/\350\277\233\351\230\266\345\274\200\345\217\221/Review \344\273\243\347\240\201\346\214\207\345\215\227.md" +++ "b/DEVELOPER_DOCS/\350\277\233\351\230\266\345\274\200\345\217\221/Review \344\273\243\347\240\201\346\214\207\345\215\227.md" @@ -6,7 +6,7 @@ ### 1.1 前提介绍 -本文章已经假设 source 仓库（[anolis](https://gitee.com/anolis)）或 rpm 仓库（[src-anolis-os](https://gitee.com/src-anolis-os) 和 [src-anolis-sig](https://gitee.com/src-anolis-sig)）已经存在，不涉及软件引入流程（[304 龙蜥社区软件包引入和管理原则](https://gitee.com/anolis/anolis-docs/DEVELOPER_DOCS/进阶开发/304-package-introduction-and-management-principles.md)）。 +本文章已经假设 source 仓库（[anolis](https://gitee.com/anolis)）或 rpm 仓库（[src-anolis-os](https://gitee.com/src-anolis-os) 和 [src-anolis-sig](https://gitee.com/src-anolis-sig)）已经存在，不涉及软件引入流程（[龙蜥社区软件包引入和管理原则](龙蜥社区软件包引入和管理原则.md)）。 ### 1.2 文档范围 @@ -56,7 +56,7 @@ maintainer 可以按照自己的意见填写审核结果，[+] 代表通过， | 提交规范 | PR 标题清晰 | must | | | | | PR 内容描述详细具体，尽可能描述清楚 PR 的修改内容和影响性 | must | | | | | 代码实际修改内容与 PR 一致 | must | | | -| spec-基本信息 | 符合 《[https://anolis.gitee.io/anolis-docs/DEVELOPER_DOCS/进阶开发/305-module-and-checklist-of-spec.html](https://anolis.gitee.io/anolis-docs/DEVELOPER_DOCS/进阶开发/305-module-and-checklist-of-spec.html)》中的字段要求 | must | | | +| spec-基本信息 | 符合 《[spec 模版和自检项.md](https://gitee.com/anolis/anolis-docs/blob/master/DEVELOPER_DOCS/%E8%BF%9B%E9%98%B6%E5%BC%80%E5%8F%91/spec%20%E6%A8%A1%E7%89%88%E5%92%8C%E8%87%AA%E6%A3%80%E9%A1%B9.md)》中的字段要求 | must | | | | | 不升级时 anolis\_release 采取递增，升级时，anolis\_release 从 1 开始。 | must | | | | | patch 和 souce 采用序号区分自研和开源三方  | must | | | | | 涉及具体架构的专项更改时，使用架构作为判断条件 | must | | | diff --git "a/DEVELOPER_DOCS/\350\277\233\351\230\266\345\274\200\345\217\221/\351\227\255\346\272\220\350\275\257\344\273\266\351\233\206\346\210\220\346\240\267\344\276\213.md" "b/DEVELOPER_DOCS/\350\277\233\351\230\266\345\274\200\345\217\221/\351\227\255\346\272\220\350\275\257\344\273\266\351\233\206\346\210\220\346\240\267\344\276\213.md" index d7df2a5..8084534 100644 --- "a/DEVELOPER_DOCS/\350\277\233\351\230\266\345\274\200\345\217\221/\351\227\255\346\272\220\350\275\257\344\273\266\351\233\206\346\210\220\346\240\267\344\276\213.md" +++ "b/DEVELOPER_DOCS/\350\277\233\351\230\266\345\274\200\345\217\221/\351\227\255\346\272\220\350\275\257\344\273\266\351\233\206\346\210\220\346\240\267\344\276\213.md" @@ -26,9 +26,9 @@ acc 的软件维护者 程斌 同学，在准备好公开策略（公开的 6. acc 这个包比较特殊，特殊在仅对 glibc 的 so 有依赖，且 an8 提供的 glibc.so 在 Anolis OS 23 上也能通用，所以仅构建一次，采用 Anolis OS 8 上构建出来的结果同步发布到 Anolis OS 23 版本。 -7. 新建 spec（[参考 spec 模版](https://gitee.com/anolis/anolis-docs/DEVELOPER_DOCS/进阶开发/305-module-and-checklist-of-spec.md)），并在本地编译出闭源软件的 rpm。 +7. 新建 spec（[参考 spec 模版](../进阶开发/spec%20模版和自检项.md)），并在本地编译出闭源软件的 rpm。 -8. rpmbuild 过程出现问题，可以查看 [构建指导手册](../进阶开发/306-instruction-manual-of-rpmbuild.md) +8. rpmbuild 过程出现问题，可以查看 [构建指导手册](../进阶开发/rpmbuild%20构建指导手册.md) 9. 此处直接给出 rpm 样例： diff --git "a/DEVELOPER_DOCS/\350\277\233\351\230\266\345\274\200\345\217\221/\351\276\231\350\234\245\347\244\276\345\214\272\350\275\257\344\273\266\345\214\205\345\274\225\345\205\245\345\222\214\347\256\241\347\220\206\345\216\237\345\210\231.md" "b/DEVELOPER_DOCS/\350\277\233\351\230\266\345\274\200\345\217\221/\351\276\231\350\234\245\347\244\276\345\214\272\350\275\257\344\273\266\345\214\205\345\274\225\345\205\245\345\222\214\347\256\241\347\220\206\345\216\237\345\210\231.md" index 055516c..86ecfea 100644 --- "a/DEVELOPER_DOCS/\350\277\233\351\230\266\345\274\200\345\217\221/\351\276\231\350\234\245\347\244\276\345\214\272\350\275\257\344\273\266\345\214\205\345\274\225\345\205\245\345\222\214\347\256\241\347\220\206\345\216\237\345\210\231.md" +++ "b/DEVELOPER_DOCS/\350\277\233\351\230\266\345\274\200\345\217\221/\351\276\231\350\234\245\347\244\276\345\214\272\350\275\257\344\273\266\345\214\205\345\274\225\345\205\245\345\222\214\347\256\241\347\220\206\345\216\237\345\210\231.md" @@ -124,7 +124,7 @@ must | 保证安全可靠，经过充分的测试保障 | 1. 闭源软件引入 ### 3.4 SPEC 规范 -详细规范请参阅 [Anolis OS 23 spec 规范](/DEVELOPER_DOCS/进阶开发/305-module-and-checklist-of-spec.md)。
下列情形需严格遵守该规范编写 SPEC 文件： +详细规范请参阅 [Anolis OS 23 spec 规范](../进阶开发/spec%20模版和自检项.md)。
下列情形需严格遵守该规范编写 SPEC 文件： - Anolis OS 23 及以后的发行版引入的所有软件包； - Anolis OS 7, Anolis OS 8 中新引入的软件包。 @@ -140,7 +140,7 @@ must | 保证安全可靠，经过充分的测试保障 | 1. 闭源软件引入 1. 如果软件包在 ospkg-list 里不存在，则需要参照「[附录1.1 软件包引入申请模板](#附录-11-软件包引入申请模板)」填写一个新的 `{package}.yaml`文件。申请通过后由产品发布 SIG maintainer 创建新的仓库和对应分支； 1. 如果软件包在 ospkg-list 里已经存在，则无需提交新的 `{package}.yaml`，在现有软件包数据中添加新的字段即可。申请通过后由产品发布 SIG maintainer在现有仓库创建新的分支。 1. **本地验证**：在本地进行软件包的构建和安装验证，保证基本功能正常。 -1. **提交软件包代码**：根据 「[305 SPEC 规范](../进阶开发/305-module-and-checklist-of-spec.md)」制作符合要求的 rpm tree 代码，并提交 PR 到对应的软件包分支中。 +1. **提交软件包代码**：根据 「[SPEC 规范](../进阶开发/spec%20模版和自检项.md)」制作符合要求的 rpm tree 代码，并提交 PR 到对应的软件包分支中。 1. **完成引入:** 产品发布 SIG maintainer，必要时社区技术委员会指派成员，根据 review 规范审核对应的 PR，如通过后则完成软件包整体引入。其他 review 结果包括：打回修改，拒绝等。如拒绝则需给出明确的理由。 @@ -150,7 +150,7 @@ must | 保证安全可靠，经过充分的测试保障 | 1. 闭源软件引入 2. **联系法务人员，保证二进制开源合规**：软件维护者需要联系软件提供厂家的法务人员，一般要申请两个纰漏流程，包括二进制披露和开源代码合规扫描，完成流程审批。 3. **提交软件包引入申请**：同 「[3.5 开源软件引入流程](#35-开源软件引入流程)」中的提交申请步骤相同，在 ([ospkg-list](https://gitee.com/anolis/ospkg-list)) 发起申请，按照模版填写清楚背景（包括闭源原因）、收益、维护者、维护方式、License 类型等基本信息。 4. **建立代码仓库和分支**：发行版同学在接收 ospkg-list 申请之后，进行评估，评估通过之后，会进行建立代码仓库、建立分支操作。 -5. **提交代码**：软件维护 owner 按照 [308 闭源软件集成样例](../进阶开发/308-example-of-epao-nonfree-package.md) 将二进制提交，并发起 pr，等待门禁 CI 的运行结果 +5. **提交代码**：软件维护 owner 按照 [闭源软件集成样例](../进阶开发/闭源软件集成样例.md) 将二进制提交，并发起 pr，等待门禁 CI 的运行结果 6. **合并代码和正式构建**： 待 maintainer 审核通过后，由发行版同学负责正式构建和发布。 7. **用户安装使用**：待软件发布到 epao-nonfree 源之后，需要先安装 anolis-epao-nonfree-release 包，再通过 yum install 方式安装闭源组件。 @@ -164,7 +164,7 @@ must | 保证安全可靠，经过充分的测试保障 | 1. 闭源软件引入 - 本地通过 mock 机制构建，参考《[Anolis OS 8 软件包本地构建 · 语雀](https://www.yuque.com/anolis-docs/kbase/cvy9g3?view=doc_embed)》一文； - 通过 Anolis Build System (ABS) 提供的个人工作空间机制进行自定义构建，可以参考[《使用ABS平台轻松胜任Anolis OS开发工作》](../基础开发/208-how-to-build-package-via-ABS.md) 一文的内容，进行构建。 -- 构建过程中遇到的问题参考 「[306 rpmbuild 构建指导手册](../进阶开发/306-instruction-manual-of-rpmbuild.md)」 +- 构建过程中遇到的问题参考 「[rpmbuild 构建指导手册](../进阶开发/rpmbuild%20构建指导手册.md)」 ### 4.2 正式构建 diff --git "a/PRODUCT_DOCS/Anolis OS \345\256\211\350\243\205\345\215\207\347\272\247\350\277\201\347\247\273/CentOS 8 \347\224\250\346\210\267\345\256\211\345\205\250\346\216\245\347\256\241\346\234\215\345\212\241.md" "b/PRODUCT_DOCS/Anolis OS \345\256\211\350\243\205\345\215\207\347\272\247\350\277\201\347\247\273/CentOS 8 \347\224\250\346\210\267\345\256\211\345\205\250\346\216\245\347\256\241\346\234\215\345\212\241.md" index 7852422..90e1098 100644 --- "a/PRODUCT_DOCS/Anolis OS \345\256\211\350\243\205\345\215\207\347\272\247\350\277\201\347\247\273/CentOS 8 \347\224\250\346\210\267\345\256\211\345\205\250\346\216\245\347\256\241\346\234\215\345\212\241.md" +++ "b/PRODUCT_DOCS/Anolis OS \345\256\211\350\243\205\345\215\207\347\272\247\350\277\201\347\247\273/CentOS 8 \347\224\250\346\210\267\345\256\211\345\205\250\346\216\245\347\256\241\346\234\215\345\212\241.md" @@ -3,7 +3,7 @@ -⚠️ 请注意，安全接管服务不等同于迁移，在实施安全接管服务后，用户的系统仍然是原有 CentOS 8 系统。如果需要更干净的操作系统，建议[迁移到](https://www.yuque.com/anolis-docs/manual/migration-guide) Anolis OS 8. 安全接管服务的约束和限制详情，可以参阅本文“[约束和限制](#Kg7vD)”一章。 +⚠️ 请注意，安全接管服务不等同于迁移，在实施安全接管服务后，用户的系统仍然是原有 CentOS 8 系统。如果需要更干净的操作系统，建议[迁移到](Anolis%20OS%20迁移工具使用手册.md) Anolis OS 8. 安全接管服务的约束和限制详情，可以参阅本文“[约束和限制](#Kg7vD)”一章。 # 安全接管服务内容 目前安全接管服务主要包含两个部分， @@ -64,7 +64,7 @@ sudo reboot 安全接管服务是为了使 CentOS 8 用户在不更改原有系统的情况下，继续获得安全更新服务能力的一项社区服务。对于暂时没有准备好完整迁移到 Anolis OS 8 的用户，安全接管是最低成本获得持续操作系统服务能力的方式。但是，该服务存在诸多的约束与限制，用户在执行安全接管服务之前，应当充分了解相关信息： 1. 安全接管服务只基于 CentOS 8.5 做过充分测试，推荐用户**先将系统升级到 CentOS 8.5** 再执行安全接管部署操作。虽然理论上 CentOS 8.0 - 8.4 的用户同样可以通过该服务获得安全接管，但是由于软件包版本跨度较大，可能会在极端情况下出现部分软件包问题。相关问题和解决方案会持续更新在[知识库文档](https://www.yuque.com/anolis-docs/kbase)中；对于用户经常遇到的问题我们会持续更新到 [CentOS 安全接管 FAQ](https://www.yuque.com/anolis-docs/faq/wbx6fv) 中。 -2. 安全接管服务**只承诺发布安全更新**，不承诺发布 Bug 修复和功能改进，不承诺在后续版本中提供对新硬件的支持。如果对于操作系统有完整的更新诉求，或者对于新硬件有使用诉求，请关注并[迁移到 Anolis OS 8](https://www.yuque.com/anolis-docs/manual/migration-guide)； +2. 安全接管服务**只承诺发布安全更新**，不承诺发布 Bug 修复和功能改进，不承诺在后续版本中提供对新硬件的支持。如果对于操作系统有完整的更新诉求，或者对于新硬件有使用诉求，请关注并[迁移到 Anolis OS 8](Anolis%20OS%20迁移工具使用手册.md)； 3. 安全接管服务是**社区支持性质**的服务，没有任何口头或书面的承诺和保证。我们欢迎更多人参与安全接管服务的使用，暴露可能存在的问题，并以社区协作的方式进行修复。 # 联系方式 -- Gitee