报告错误与请求功能

报告 Bug

安全漏洞

Ansible 实践负责任的披露原则。如需报告与安全相关的错误，请发送电子邮件至 security@ansible.com 以获得立即响应。请勿提交 ticket 或发布到任何公开群组中。

ansible-core 中的错误

在报告错误之前，请在 GitHub 中搜索已报告的问题和开放的拉取请求 (pull requests)，以确认是否已有其他人解决了您的问题。不确定是否发现了错误？请在 Ansible 论坛上与社区讨论该行为。

同时，请使用 Ansible 论坛来讨论问题是出在 ansible-core 还是某个 collection 中，以及询问“我该如何实现此功能”之类的问题。

您需要一个免费的 GitHub 账户来报告影响以下内容的错误：

• 多个插件

• 保留在 ansible/ansible 仓库中的插件

• Ansible 的整体运行

如何编写一份高质量的错误报告

如果您发现了错误，请使用问题模板 (issue template)提交 issue。

请尽可能完整且准确地填写问题模板。请包括：

• 您的 Ansible 版本

• 预期行为以及您尝试过的操作，包括您使用的确切命令或运行的任务。

• 当前行为以及您认为它是错误的原因

• 重现该错误的步骤

• 一个最小可重现示例以及描述示例的注释

• 任何相关的配置以及您使用的组件

• 任何相关的输出以及 ansible -vvvv（调试）输出

• 在提交涉及 ansible-test 的错误报告时，请添加 ansible-test-env --show 的输出。

在 playbook 中分享 YAML 时，请确保使用代码块 (code blocks)来保留格式。对于多文件内容，请使用 gist.github.com，它比 Pastebin 内容更持久。

请求功能

在请求功能之前，请检查未来 Ansible 版本的计划。检查标记为 feature 的现有拉取请求。

若要将您的功能引入 Ansible，请针对 ansible-core 或某个 collection 提交拉取请求 (pull request)。另请参阅合并 PR 的要求。对于 ansible-core，您也可以在 ansible/ansible 或相应的 collection 仓库中提交 issue（要查找正确的问题追踪器，请参考collection 中的错误）。