报告 Azure Linux 的问题和请求功能

本文介绍如何报告 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 支持和生命周期承诺范围之外的场景问题,包括:
  • 缺少复制步骤、版本信息或环境详细信息的不完整报告
  • 重复的问题:改为在现有问题上添加大拇指(👍)。
  • 没有明确Azure用例或业务理由的功能请求。
  • 属于官方支持渠道的生产相关问题:查看 Azure Linux 官方支持选项中的指南,获取有关生产问题的帮助。

提交后会发生什么

  • 会审是尽最大努力。 维护者会在有余力时对问题进行分流处理。 对于社区提交的问题,不提供任何 SLA 保证。
  • 问题可能会加上标签以便跟踪(例如,bugdocsupstreamhelp-wanted)。
  • 当这是正确的所有权路径时,问题可能会 重定向 到上游项目或 Fedora。
  • 如果问题超出处理范围、缺少关键信息或无法处理,则可能会在不作说明的情况下被关闭
  • 我们优先处理影响在 Azure 上使用 Azure Linux 的问题,并附上可复现的详细信息。
  • 30 天内无活动的问题可能会自动关闭。