Reporting bugs and requesting features

Reporting a bug

Security bugs

Ansible practices responsible disclosure. To report security-related bugs, send an email to security@ansible.com for an immediate response. Do not submit a ticket or post to any public groups.

Bugs in ansible-core

Before reporting a bug, search in GitHub for already reported issues and open pull requests to see if someone has already addressed your issue. Unsure if you found a bug? Discuss the behavior with the community on the Ansible Forum<ansible_forum>.

Also, use the Ansible Forum<ansible_forum> to discuss whether the problem is in ansible-core or a collection, and for "how do I do this" type questions.

You need a free GitHub account to report bugs that affect:

• multiple plugins
• a plugin that remained in the ansible/ansible repo
• the overall functioning of Ansible

How to write a good bug report

If you find a bug, open an issue using the issue template.

Fill out the issue template as completely and as accurately as possible. Include:

• your Ansible version
• the expected behavior and what you've tried, including the exact commands you were using or tasks you are running.
• the current behavior and why you think it is a bug
• the steps to reproduce the bug
• a minimal reproducible example and comments describing examples
• any relevant configurations and the components you used
• any relevant output plus ansible -vvvv (debugging) output
• add the output of ansible-test-env --show when filing bug reports involving ansible-test.

When sharing YAML in playbooks, ensure that you preserve formatting using code blocks. For multiple-file content, use gist.github.com, more durable than Pastebin content.

Requesting a feature

Before you request a feature, check what is planned for future Ansible Releases <roadmaps>. Check existing pull requests tagged with feature.

To get your feature into Ansible, submit a pull request <community_pull_requests>, either against ansible-core or a collection. See also ansible_collection_merge_requirements. For ansible-core, you can also open an issue in ansible/ansible or in a corresponding collection repository (To find the correct issue tracker, refer to Bugs in collections<reporting_bugs_in_collections> ).