如何为 Azure Linux 做贡献

感谢你有兴趣参与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 作为常规更新和发布过程的一部分。

建议使用以下方法来确定你的贡献应位于何处:

  1. 从源开始。 你的更改是否涉及另一个项目拥有的包,例如 systemdbinutils或者 rust? 请先将此事提交到该项目社区讨论。 他们最了解这段代码,而你的改进会让所有依赖它的发行版受益。
  2. 然后看看费多拉 你的更改是有助于多个发行版的分发级打包、集成还是策略更改? Fedora Linux Project是正确的位置。 Azure Linux 会在我们的常规发布流程中纳入这些更改。
  3. 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 联系,如有任何问题或意见。