1
0
Fork 0
mirror of https://github.com/ansible-collections/community.general.git synced 2026-04-10 22:15:05 +00:00
community.general/tests/utils/ALIASES.md
Alexei Znamensky 68ae04a95a
Cleanup of aliases skip statements (#11686)
* add scripts to clean aliases' skips

* remove legacy skips

* code cosmetics

* add license to ALIASES.md

* Fix typos in ALIASES.md documentation

* rolling back freebsd14.2 and 14.3 in iso_extract

* fix versions and re-run
2026-03-30 19:31:17 +02:00

38 lines
1.3 KiB
Markdown

<!--
Copyright (c) Ansible Project
GNU General Public License v3.0+ (see LICENSES/GPL-3.0-or-later.txt or https://www.gnu.org/licenses/gpl-3.0.txt)
SPDX-License-Identifier: GPL-3.0-or-later
-->
# Cleaning up `aliases` skips
The skip statements in `tests/integration/targets/*/aliases` files may contain specific OSes and their versions.
For example:
skip/rhel8.8
skip/centos6
skip/macos
Those items being skipped are called `remotes` and they come from the file `test/lib/ansible_test/_data/completion/remote.txt`
in the `ansible-core` repository. Eventually, these remotes are removed from that `ansible_test` config,
but they keep silently cluttering the aliases files here.
The scripts `list-remotes` and `clean-aliases-skips` can help you remove those entries from the `aliases` files.
For that, you will need to have a clone of the `ansible-core` repository in your machine.
In the example below, the path to that repo is `../ansible`:
```shell
./tests/utils/list-remotes ../ansible
```
**Note:** The supported versions of `ansible-core` are hardcoded in `list-remotes`. Those should be updated or automated in the future.
To remove all the skips that are **not** in that list, you should run:
```shell
./tests/utils/list-remotes ../ansible | ./tests/utils/clean-aliases-skips
```
Make sure to thoroughly review the changes before committing!