本文介绍如何报告 bug、文档问题和安全漏洞,以及如何请求 Azure Linux 的新功能。 按照此处的指导,确保你的问题和请求路由到正确的通道,并可以有效地解决。
Important
Azure Linux 是开源的,但 Microsoft 的支持和生命周期承诺仅适用于 Azure 场景。 具体如下:
- Azure Linux 虚拟机(VM)/虚拟机规模集、AKS 容器主机和容器映像受支持。
- 不支持裸机、ISO 映像、本地和其他云。
- 仅当在预生成Azure Linux 映像的基础上生成(例如,使用 Image 定制器)时,才支持自定义映像。 从 GitHub 上的 Azure Linux 源代码从头构建的映像不在涵盖范围内。
超出此范围的问题可能会被关闭。
Note
Azure Linux 4.0 现在位于 preview 中,严格限制为评估和测试目的。 它不适合生产用途。
提交前
- 搜索现有问题 ,查看问题是否已报告。 如果发现与方案匹配的现有问题,请添加大拇指(👍)反应,并在批注中包含任何额外的上下文。 这有助于我们确定优先级,而无需创建重复项。
- 在提交新问题之前,请检查最新的 Azure Linux 映像和修补程序,以查看此问题是否已在较新版本中修复。
提交地点
| 问题/请求类型 | 提交地点 |
|---|---|
| 生产问题或中断 | 如果遇到影响Azure工作负荷的技术问题,请通过 Azure 门户打开Azure 支持请求。 不会监视生产支持GitHub问题。 |
| Bug 报告、文档问题、功能请求 | 在正确的存储库中使用相应的问题模板提交 GitHub 问题。 |
| 安全漏洞 | 按照 “管理 CVE”下的指南进行操作。 请不要通过公开的 GitHub Issue 报告安全漏洞。 |
如何编写良好的 bug 报告
Important
在GitHub上打开 bug 报告时,预先填充的问题模板将引导你完成这些字段。 使用模板提供所有请求的信息。 请完全填写。 不完整的报告可能会被关闭。
复现案例越小、越独立完整,分诊就会越快。 尝试将问题与不相关的配置或依赖项隔离开来。
良好的 bug 报告可帮助维护人员更快地重现和解决问题。 在报表中,请包括以下信息:
-
Azure Linux 版本和映像名称:例如
AzureLinux 4.0 AKS node image 2026.05。 - 重现步骤:按编号列出的具体步骤,便于其他人遵循。
- 预期行为 与 实际行为。
- 日志:显示错误或意外行为的相关系统或应用程序日志。
- 环境详细信息:Azure服务(AKS、VM、虚拟机规模集 等)、VM 大小/SKU、区域、网络配置以及任何自定义映像或包修改。
- 有用的屏幕截图或终端输出 (粘贴文本,而不是文本图像)。
分类处理排除项
为便于管理问题分流,以下类型的问题将被关闭:
-
Microsoft 支持和生命周期承诺范围之外的场景问题,包括:
- 裸机、ISO 镜像、本地部署和其他云。
- 基于GitHub 上的 Azure Linux 源代码从头构建的映像(仅涵盖在预构建的 Azure Linux 映像基础上进行的自定义,例如使用 映像自定义工具)。
- 缺少复制步骤、版本信息或环境详细信息的不完整报告。
- 重复的问题:改为在现有问题上添加大拇指(👍)。
- 没有明确Azure用例或业务理由的功能请求。
- 属于官方支持渠道的生产相关问题:查看 Azure Linux 官方支持选项中的指南,获取有关生产问题的帮助。
提交后会发生什么
- 会审是尽最大努力。 维护者会在有余力时对问题进行分流处理。 对于社区提交的问题,不提供任何 SLA 保证。
- 问题可能会加上标签以便跟踪(例如,
bug、docs、upstream、help-wanted)。 - 当这是正确的所有权路径时,问题可能会 重定向 到上游项目或 Fedora。
- 如果问题超出处理范围、缺少关键信息或无法处理,则可能会在不作说明的情况下被关闭。
- 我们优先处理影响在 Azure 上使用 Azure Linux 的问题,并附上可复现的详细信息。
- 30 天内无活动的问题可能会自动关闭。