Commit Graph
36 Commits
Author SHA1 Message Date
Rich MegginsonandRichard Megginson 04db64b712 docs(changelog): version 1.2.3 [citest skip]
Update changelog and .README.html for version 1.2.3

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-12-17 11:08:10 -05:00
Rich MegginsonandRichard Megginson 9a65c30112 ci: add qemu tests for Fedora 43, drop Fedora 41
add qemu tests for Fedora 43, drop Fedora 41

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-12-05 17:12:26 -05:00
Rich MegginsonandRichard Megginson 783d08440d ci: bump gha checkout from v5 to v6
bump gha checkout from v5 to v6

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-12-01 15:48:17 -05:00
Rich MegginsonandRichard Megginson 189c7a6f85 fix: support new config file options, expose aide_version
Cause: The aide role custom config test is using the old configuration options
on newer EL9 systems which use AIDE version 0.17 and later.

Consequence: The test gives errors like "ERROR: /etc/aide.conf:12: unexpected character"
and the test fails.

Fix: The role will now determine the AIDE version, set the new aide_version variable,
and use this variable to determine the old or new style configuration.

Result: The aide system role can process custom config on all supported AIDE
versions.

See https://github.com/aide/aide/blob/master/ChangeLog#L241

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-11-24 09:26:37 -05:00
Rich MegginsonandRichard Megginson 21e441ee90 docs(changelog): version 1.2.2 [citest skip]
Update changelog and .README.html for version 1.2.2

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-11-17 12:05:06 -05:00
Rich MegginsonandRichard Megginson d5754b7bf7 fix: cannot use community-general version 12 - no py27 and py36 support
community.general version 12 has dropped support for py27 and py36 - ensure that
the roles do not install/use this version - see
https://github.com/ansible-collections/community.general/issues/582

By default, installation will get the latest 11.x version. The lower bound
`6.6.0` is an older version, but I don't want to restrict the ability of a user
of a particular role to use an old version, rather than forcing them to use
`11.x` or later. Some roles like `rhc` explicitly require `6.6.0` or later - I
think this is a reasonable lower bound for all roles.If a role needs a different
version, the role can define its own `community_general_version` in the role's
`host_vars` file in .github.

Standardize file format across all roles for consistency and ease of updating

This update may remove the SPDX license information from the file - this is ok -
the role/project already has a license, this file is trivial, and many
requirements files do not have the license header anyway.

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-11-15 10:50:08 -05:00
Rich MegginsonandRichard Megginson 2eb5471a39 ci: bump tox-lsr to 3.14.0 - this moves standard-inventory-qcow2 to tox-lsr
Previously, CI would download the standard-inventory-qcow2 script from pagure.  However,
the pagure download url is now being protected by Anubis which by default
will check the User-Agent header and deny attempts from clients that look
like scrapers or hackers. Rather than trying to play arms race with setting
headers, etc. - just move this script to tox-lsr. If we really need to sync
with the upstream development, we can do that manually.

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-11-11 09:31:06 -05:00
Rich MegginsonandRichard Megginson f946015556 ci: bump tox-lsr to 3.13.0
fixes ci failure in qemu test related to missing extra_images file

https://github.com/linux-system-roles/tox-lsr/releases/tag/3.13.0
Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-11-04 09:37:44 -05:00
Rich MegginsonandRichard Megginson 1d3b95f354 ci: use versioned upload-artifact instead of master; bump codeql-action to v4; bump upload-artifact to v5
use versioned upload-artifact instead of master

bump codeql-action from v3 to v4

bump upload-artifact from v4 to v5

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-11-04 04:56:14 -05:00
Rich MegginsonandRichard Megginson d7f26a6e09 ci: use JSON format for __bootc_validation
On some versions of ansible/jinja, the YAML format does not work, so use
the JSON format to pass in __bootc_validation

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-09-20 07:08:41 -06:00
Rich MegginsonandRichard Megginson cb7b8ed08a ci: use tox-lsr 3.12.0 for osbuild_config.yml feature
Use tox-lsr 3.12.0 for the new osbuild_config.yml feature for bootc and users
https://github.com/linux-system-roles/tox-lsr/pull/211

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-09-19 12:45:19 -06:00
Rich MegginsonandRichard Megginson 1f5c9c9e5e ci: use the new epel feature to enable EPEL for testing farm
Now that https://github.com/teemtee/tmt/pull/3128 has merged
we can use the new epel feature to enable EPEL for testing farm

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-09-09 07:46:43 -06:00
Rich MegginsonandRichard Megginson 353535c34e ci: support openSUSE Leap in qemu/kvm test matrix
Some of our system roles now support openSUSE Leap so add this
platform to our testing matrix.

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-09-08 13:26:56 -06:00
Rich MegginsonandRichard Megginson b7d6ec5ba3 ci: rollout several recent changes to CI testing
* Pass in a YAML true value as `__bootc_validation: true` using
the --extra-vars option to ensure that `__bootc_validation` is
treated as a boolean and not a string value.

`-e "__bootc_validation: true"`

You can also use JSON format:

`-e '{"__bootc_validation": true}'`

but YAML is simpler in this case.

* Use tox-lsr version 3.11.1

* Ensure the citest bad comment works when the test was cancelled in
addition to the failure case.

* Update contributing.md documentation

* Update number of nodes to use in testing farm, if needed

* remove unnecessary ansible-lint skips

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-09-05 16:19:19 -06:00
Rich MegginsonandRichard Megginson d00ac1835b docs(changelog): version 1.2.1 [citest skip]
Update changelog and .README.html for version 1.2.1

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-07-02 16:45:00 -06:00
Rich MegginsonandRichard Megginson 7ebc20d774 refactor: fix Ansible 2.19 issues
Cannot write to ansible_managed - it is a special variable

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-06-26 13:40:09 -06:00
Rich MegginsonandRichard Megginson 387004f5d8 docs(changelog): version 1.2.0 [citest skip]
Update changelog and .README.html for version 1.2.0

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-06-16 17:49:01 -06:00
Rich MegginsonandRichard Megginson a12cbffe2c ci: Use ansible 2.19 for fedora 42 testing; support python 3.13
NOTE: This also requires upgrading to tox-lsr 3.11.0

Ansible 2.19 will be released soon and has some changes which will
require fixes in system roles.  This adds 2.19 to our testing matrix
on fedora 42 so that we can start addressing these issues.

python 3.13 is now being used on some platforms.

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-06-10 09:06:23 -06:00
Rich MegginsonandRichard Megginson 62a517fa97 ci: Add support for bootc end-to-end validation tests
NOTE: This also requires upgrading to tox-lsr 3.10.0, and some
hacks to workaround a podman issue in ubuntu.

These tests run the role during a bootc container image build, deploy
the container into a QEMU VM, boot that, and validate the expected
configuration there. They run in two different tox environments, and
thus have to be run in two steps (preparation in buildah, validation in
QEMU). The preparation is expected to output a qcow2 image in
`tests/tmp/TESTNAME/qcow2/disk.qcow2`, i.e. the output structure of
<https://github.com/osbuild/bootc-image-builder>.

There are two possibilities:

* Have separate bootc end-to-end tests. These are tagged with
`tests::bootc-e2` and are skipped in the normal qemu-* scenarios.
They run as part of the container-* ones.

* Modify an existing test: These need to build a qcow2 image exactly
*once* (via calling `bootc-buildah-qcow.sh`) and skip setup/cleanup
and role invocations in validation mode, i.e. when
`__bootc_validation` is true.

In the container scenario, run the QEMU validation as a separate step in
the workflow.

See https://issues.redhat.com/browse/RHEL-88396

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-06-03 16:39:13 -06:00
Rich MegginsonandRichard Megginson 22d787a281 ci: Add Fedora 42; use tox-lsr 3.9.0; use lsr-report-errors for qemu tests
Add Fedora 42 to testing farm test matrix, drop Fedora 40

Use tox-lsr 3.9.0 for the `--lsr-report-errors-url` argument.

Add the argument `--lsr-report-errors-url DEFAULT` to the qemu test so that
the errors will be written to the output log.  This uses the output callback
https://github.com/linux-system-roles/auto-maintenance/blob/main/callback_plugins/lsr_report_errors.py

Use the check_logs.py script
https://github.com/linux-system-roles/auto-maintenance/blob/main/check_logs.py
with the `--github-action-format` argument to format the errors
in a github action friendly manner.

Rename the log files `-FAIL.log` or `-SUCCESS.log` depending on status.
This is compatible with the way the testing farm log files are named, and
makes it easy to tell if a test passed or failed from the log file name.

Upload README.html as artifacts of the build_docs job for debugging

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-05-19 14:30:41 -06:00
Rich MegginsonandMartin Pitt 07da24d05f ci: bump tox-lsr to 3.8.0; rename qemu/kvm tests
This will make the qemu/kvm tests be tested in either
ascending or descending ASCII order.  This should give
us better test coverage of clean up scenarios which may
fail depending on the order of the previous tests.

Rename the qemu/kvm tests so that the statuses are shorter
and more intuitive.

Improve qemu/kvm test failure error reporting.

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-05-07 22:46:44 +02:00
Rich MegginsonandRichard Megginson 8f1d3c79d6 ci: skip storage scsi, nvme tests in github qemu ci
These tests are problematic in github qemu tests, and that
functionality (scsi, anyway) in the testing farm integration
tests.

Yes, we should have a way to provide tags on a per-role basis . . .

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-04-22 15:50:34 -06:00
Rich MegginsonandRichard Megginson a8418ce31a ci: use tox-lsr 3.6.0; improve qemu test logging
tox-lsr 3.6.0 will guarantee order of qemu test execution, which should
help make tests reproducible and help debug test failures.

Improve qemu test logging - this will help debug the qemu test
failures.

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-04-22 15:06:31 -06:00
Rich MegginsonandRichard Megginson fa134b8aab ci: several changes related to new qemu test, ansible-lint, python versions, ubuntu versions
There is a new QEMU based test which uses the qemu/kvm capability of
github action runners.  This is the basis for new bootc/image mode tests
which we will be rolling out in the near future.

ansible-lint requires that the collection path is set so that the requirements
it installs are installed in the correct place.

There has been some general github action deprecation of python versions and
ubuntu versions that we have had to fix.

Remove `CONTRIBUTOR` from the list of users who can trigger citest.

For more information, see

* https://github.com/linux-system-roles/.github/pull/98
* https://github.com/linux-system-roles/.github/pull/94
* https://github.com/linux-system-roles/.github/pull/93
* https://github.com/linux-system-roles/.github/pull/92
* https://github.com/linux-system-roles/.github/pull/91

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-04-11 13:17:45 -06:00
Rich MegginsonandRichard Megginson 21122732bd docs(changelog): version 1.1.1 [citest skip]
Update changelog and .README.html for version 1.1.1

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-02-11 07:48:19 -07:00
Rich MegginsonandRichard Megginson e5990bece0 fix: aide --check should not report changed
The task "Check against AIDE reference database" should not report
changed since it does not change anything.

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-02-11 07:42:23 -07:00
Rich MegginsonandRichard Megginson 3bca54f29b docs(changelog): version 1.1.0 [citest skip]
Update changelog and .README.html for version 1.1.0

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-01-31 15:43:14 -07:00
Rich MegginsonandRichard Megginson cc5de8664f feat: ensure role works on ostree systems
Ensure role works on ostree systems

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-01-31 15:35:25 -07:00
Rich MegginsonandRichard Megginson c9f0262b04 ci: bump ansible-lint to v25; provide collection requirements for ansible-lint
There is a new version of ansible-lint - v25.
Newer versions of ansible-lint require the collection requirements to be
installed so it can find the modules/plugins.
Enhance our ansible-lint ci job to provide the collection requirements,
including merging the runtime meta/collection-requirements.yml with
the testing tests/collection-requirements.yml.
This should somewhat mitigate the loss of ansible-plugin-scan.
We have to remove mock_modules that are actually present now.

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-01-31 05:16:18 -07:00
Rich MegginsonandRichard Megginson 22d8e5aa41 ci: ansible-plugin-scan is disabled for now
ansible-plugin-scan is broken due to lack of support for older versions
of python in ci.
One of the main reasons for using this scan is to check if the roles/tests
are using plugins that are not compatible with ansible 2.9.  Since 2.9
is EOL, this is no longer necessary.
The other reason for using the scan is to check that the role/test
author has correctly listed dependencies in meta/collection-requirements.yml
and tests/collection-requirements.yml - that is - that the author has
correctly specified the dependencies for any plugins used that are
not built-in.  This will mostly be caught in CI testing now.

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-01-29 13:30:43 -07:00
Rich MegginsonandRichard Megginson a4307661b7 docs(changelog): version 1.0.0 [citest skip]
Update changelog and .README.html for version 1.0.0

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-01-09 08:32:54 -07:00
Rich MegginsonandRichard Megginson 129feb1ac1 test: add cleanup for cron test; fix formatting
Ensure cron test restores state of crontab after test.
Fix formatting in a few places.
Do not check ansible managed header and fingerprint unless the test
uses a custom template with header and fingerprint.
Use default for gather_facts unless otherwise needed.

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2025-01-07 11:31:56 -07:00
Rich MegginsonandRichard Megginson cdfdd3523d ci: Use Fedora 41, drop Fedora 39 - part two
Fedora 41 is released, and Fedora 39 will soon be unsupported
Part two - first part did not work

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2024-12-02 17:53:37 -07:00
Rich MegginsonandRichard Megginson 0cc6d3d650 ci: Use Fedora 41, drop Fedora 39
Fedora 41 is released, and Fedora 39 will soon be unsupported

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2024-12-02 13:53:05 -07:00
Rich MegginsonandRichard Megginson 86685b0f5b docs(changelog): version 0.0.1 [citest skip]
Update changelog and .README.html for version 0.0.1

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2024-11-12 14:02:47 -07:00
Rich MegginsonandRichard Megginson 1b526b93ea refactor: Use vars/RedHat_N.yml symlink for CentOS, Rocky, Alma wherever possible
We have a lot of requests to support Rocky and Alma in various system roles. The
first part of adding support is adding `vars/` files for these platforms. In
almost every case, for a given major version N, the vars file RedHat_N.yml can
be used for CentOS, Rocky, and Alma.  Rather than making a copy of the
RedHat_N.yml file, just use a symlink to reduce size and maintenance burden, and
standardize this across all system roles for consistency.

NOTE: There is no Alma or Rocky version 7 or less.

NOTE: OracleLinux is not a strict clone, so we are not going to do this for
OracleLinux at this time.  Support for OracleLinux will need to be done in
separate PRs. For more information, see
https://github.com/linux-system-roles/cockpit/issues/130

**Question**: Why not just use `ansible_facts["os_family"] == "RedHat"`?

**Answer**:  This is what Ansible uses as the RedHat os_family:
https://github.com/ansible/ansible/blob/1e6ffc1d02559a26def6c9c3b07baf27032865a2/lib/ansible/module_utils/facts/system/distribution.py#L511
There are a lot of distributions in there. I know that Fedora is not a clone of
RHEL, but it is very closely related. Most of the others are not clones, and it
would generally not work to replace ansible_distribution in ['CentOS', 'Fedora',
'RedHat'] with ansible_facts['os_family'] == 'RedHat' (but it would probably
work in specific cases with specific distributions).  For example, OracleLinux
is in there, and we know that doesn't generally work.  The only ones we can be
pretty sure about are `RedHat`, `CentOS`, `Fedora`, `AlmaLinux`, and `Rocky`.

**Question**: Does my role really need this because it should already work on
RHEL clones?

**Answer**: Maybe not - but:

* it doesn't hurt anything
* it's there if we need it in the future
* the role will be inconsistent with the other system roles if we don't have this

**Question**: Why do I need the `tests/vars/rh_distros_vars.yml` file?  Doesn't
the test load the vars from the role?

**Answer**: No, the test does not load the vars from the role until the role is
included, and many tests use version and distribution before including the role.

**Question**: Do we need to change the code now to use the new variables?

**Answer**: No, not now, in subsequent PRs, hopefully by Alma and Rocky users.

Note that there may be more work to be done to the role to fully support Rocky
and Alma.  Many roles have conditionals like this:

```yaml
some_var: "{{ 'some value' if ansible_distribution in ['CentOS', 'RedHat'] else 'other value' }}"
another_var: "{{ 'some value' if ansible_distribution in ['CentOS', 'Fedora', 'RedHat'] else 'other value' }}"

...

- name: Do something
  when: ansible_distribution in ['CentOS', 'RedHat']
  ...
- name: Do something else
  when: ansible_distribution in ['CentOS', 'Fedora', 'RedHat']
  ...
```

Adding Rocky and AlmaLinux to these conditionals will have to be done
separately. In order to simplify the task, some new variables are being
introduced:

```yaml
__$rolename_rh_distros:
  - AlmaLinux
  - CentOS
  - RedHat
  - Rocky

__$rolename_rh_distros_fedora: "{{ __$rolename_rh_distros + ['Fedora'] }}"

__$rolename_is_rh_distro: "{{ ansible_distribution in __$rolename_rh_distros }}"
__$rolename_is_rh_distro_fedora: "{{ ansible_distribution in __$rolename_rh_distros_fedora }}"
```

Then the conditionals can be rewritten as:

```yaml
some_var: "{{ 'some value' if __$rolename_is_rh_distro else 'other value' }}"
another_var: "{{ 'some value' if __$rolename_is_rh_distro_fedora else 'other value' }}"

...

- name: Do something
  when: __$rolename_is_rh_distro | bool
  ...
- name: Do something else
  when: __$rolename_is_rh_distro_fedora | bool
  ...
```

For tests - tests that use such conditionals will need to use `vars_files` or
`include_vars` to load the variables that are defined in
`tests/vars/rh_distros_vars.yml`:

```yaml
vars_files:
  - vars/rh_distros_vars.yml
```

We don't currently have CI testing for Rocky or Alma, so someone wanting to run
tests on those platforms would need to change the test code to use these.

Signed-off-by: Rich Megginson <rmeggins@redhat.com>
2024-10-25 14:08:09 -06:00