# Unified Collection Testing Strategy - Kick off & Landscape Overview

**URL:** <https://forum.ansible.com/t/unified-collection-testing-strategy-kick-off-landscape-overview/45799>\
**Category:** Collection Development\
**Tags:** azure, fedora, ubuntu, collection-test-strat, ansible-lint, galaxy-ng\
**Created:** [May 14, 2026, 4:23pm UTC](https://forum.ansible.com/t/unified-collection-testing-strategy-kick-off-landscape-overview/45799 "2026-05-14T16:23:45Z")\
**Posts on this page:** 1\
**Showing post:** 14

<div class="post-metadata">

**Author:** ![mattclay](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/mattclay/32/268_2.png) [@mattclay](https://forum.ansible.com/u/mattclay)\
**Post date:** [May 16, 2026, 12:23am UTC](https://forum.ansible.com/t/unified-collection-testing-strategy-kick-off-landscape-overview/45799/14 "2026-05-16T00:23:20Z")

</div>

> ansible-test can selectively run tests in CI based on changes in a PR

This feature is not covered in the official documentation. It is enabled by using the `--changed` option. That option works locally (with caveats), and on AZP. It is not yet supported on GHA, although it should be possible to implement it.

To see it in use, take a look at the `community.general` collection. Here’s where it is enabled: [community.general/tests/utils/shippable/shippable.sh at 47a19fad1bd23cd1d358d1538346bf9a977ed570 · ansible-collections/community.general · GitHub](https://github.com/ansible-collections/community.general/blob/47a19fad1bd23cd1d358d1538346bf9a977ed570/tests/utils/shippable/shippable.sh#L125)

> ansible-test can collect and report on code coverage for integration tests.

There is brief mention of this feature in the official documentation: [Testing Ansible and Collections — Ansible Community Documentation](https://docs.ansible.com/projects/ansible/latest/dev_guide/testing_running_locally.html#code-coverage)

To see it in use, take a look at the `community.general` collection. Here’s where it is enabled: [community.general/tests/utils/shippable/shippable.sh at 47a19fad1bd23cd1d358d1538346bf9a977ed570 · ansible-collections/community.general · GitHub](https://github.com/ansible-collections/community.general/blob/47a19fad1bd23cd1d358d1538346bf9a977ed570/tests/utils/shippable/shippable.sh#L101-L115)

NOTE: This feature can also be used locally. It doesn’t require CI or using a service like Codecov. It also works for unit and sanity tests (although only the `import` sanity test contributes to coverage).

> ansible-test supports GHA, not just AZP, for creating ephemeral test VMs.

This feature is not covered in the official documentation, and is a relatively new feature. It is currently limited to specific projects within the `ansible-collections` and `redhat-cop` GitHub organizations, but we’re open to considering requests for usage in additional projects.

To see it in use, take a look at the `amazon.aws` collection. Here’s where it is enabled: [amazon.aws/.github/workflows/integration.yml at c0bc9f945fbb94259b796077e23c37662358095c · ansible-collections/amazon.aws · GitHub](https://github.com/ansible-collections/amazon.aws/blob/c0bc9f945fbb94259b796077e23c37662358095c/.github/workflows/integration.yml#L143)

NOTE: This collection uses it for ephemeral AWS credentials (another feature I forgot to mention), rather than requesting a VM directly.

> ansible-test can provide those same VMs to authorized users outside CI.

This is briefly mentioned in the official documentation: [Testing Ansible and Collections — Ansible Community Documentation](https://docs.ansible.com/projects/ansible/latest/dev_guide/testing_running_locally.html#remote-virtual-machines)

As the documentation notes, users outside of authorized AZP (and now GHA) projects will require an API key to take advantage of this feature from their local system. Maintainers of collections authorized to use the feature in CI can request access for use on their local system.

> ansible-test has integrated debugger support for VS Code and PyCharm for both Python and PowerShell code.

This feature is not covered in the official documentation, and is still considered experimental. As such, it doesn’t show up in the `--help` output for users unless they have the previously mentioned API key. However, despite that, any user can still use the feature.

The best reference for the options at the moment is to look at the code: [ansible/test/lib/ansible\_test/\_internal/cli/environments.py at 405a6052b0238d5c1bbd956e83e4d12a0f692d51 · ansible/ansible · GitHub](https://github.com/ansible/ansible/blob/405a6052b0238d5c1bbd956e83e4d12a0f692d51/test/lib/ansible_test/_internal/cli/environments.py#L451-L486)

---

_[View the full topic](https://forum.ansible.com/t/unified-collection-testing-strategy-kick-off-landscape-overview/45799)._
