感谢你有兴趣参与Azure Linux。 无论你是修复拼写错误、报告 bug 还是改进包,每个贡献都很重要,我们很高兴你在这里。
Azure Linux 是在更广泛的 Linux 生态系统的基础上开放源代码构建的。 本文介绍在 何处 做贡献、 如何 开始,以及一路上期待 什么 。
Important
Azure Linux 贡献仅限于 Azure 上的 Azure Linux 场景。 Microsoft支持和生命周期承诺仅适用于:
- Azure Linux 虚拟机(VM)/虚拟机规模集、Azure Kubernetes 服务 (AKS) 容器主机和容器映像。
- 基于预构建的 Azure Linux 映像进行的自定义(例如,使用 映像自定义器)。
面向裸机、ISO 映像、本地部署环境、其他云,或基于 GitHub 上的 Azure Linux 源代码 从头构建的映像的相关贡献,均不在范围内。
Note
Azure Linux 4.0 现在位于 preview 中,严格限制为评估和测试目的。 它不适合生产用途。
供稿途径
可以根据你的兴趣和专业知识,以多种方式参与 Azure Linux:
- 为文档做贡献:修复、改进或扩展有关在 Azure 上运行 Azure Linux 的指南,包括虚拟机、AKS、虚拟机规模集和容器工作负载。
- 参与代码贡献:修复漏洞、改进软件包,或改进整个 Azure Linux 发行版中的工具。
还可以通过报告 bug、请求新功能或提供反馈来提供贡献。 清晰的缺陷报告和表述明确的功能请求有助于 Azure Linux 团队识别问题并有效确定改进事项的优先级。 有关详细信息,请参阅 报告 Azure Linux 的问题并请求功能和Azure Linux 官方支持选项。
建议的贡献路径
Azure Linux 是更大开源系列的一部分。 我们依托于我们所在的社区并积极参与其中,尤其是 Fedora Linux Project。 当你在上游做出贡献时,你的工作将到达更多人,加强生态系统,并自然流回到 Azure Linux 作为常规更新和发布过程的一部分。
建议使用以下方法来确定你的贡献应位于何处:
-
从源开始。 你的更改是否涉及另一个项目拥有的包,例如
systemd,binutils或者rust? 请先将此事提交到该项目社区讨论。 他们最了解这段代码,而你的改进会让所有依赖它的发行版受益。 - 然后看看费多拉 你的更改是有助于多个发行版的分发级打包、集成还是策略更改? Fedora Linux Project是正确的位置。 Azure Linux 会在我们的常规发布流程中纳入这些更改。
- Then 将其引入 Azure Linux。 如果更改真正特定于 Azure Linux,例如Azure集成逻辑、工具或文档,我们非常希望将其显示在 Azure Linux 存储库中。
Tip
创建源自上游的 Azure Linux PR 时,请附上上游问题或 PR 的链接。 它通过给审阅者提供上下文并显示更改的世系来加快审查速度。
为贡献选择正确的存储库
Azure Linux 跨多个存储库。 在正确的位置提交有助于更快地审查你的贡献。 下表显示了主要的 Azure Linux 存储库以及各自包含的更改类型:
| 要更改的内容 | 资料库 |
|---|---|
| Azure Linux | microsoft/azurelinux |
| Azure Linux 映像工具 | microsoft/azure-linux-image-tools |
| Azure Linux 开发工具 | microsoft/azure-linux-dev-tools |
| Azure Linux 文档 | MicrosoftDocs |
社区期望
我们正在共同建设 Azure Linux,我们希望这个空间对每个人都友好且富有成效。
此项目采用 Microsoft 开源行为准则。 有关详细信息,请参阅 行为准则常见问题解答 或与 opencode@microsoft.com 联系,如有任何问题或意见。