Contributing to the hpc Linux System Role

Where to start

The first place to go is Contribute. This has all of the common information that all role developers need:

Bugs and needed implementations are listed on Github Issues. Issues labeled with help wanted are likely to be suitable for new contributors!

Code is managed on Github, using Pull Requests.

Steps:

If you are using RHEL or CentOS, enable the EPEL repository for your platform - https://docs.fedoraproject.org/en-US/epel/
Use yum or dnf to install standard-test-roles-inventory-qemu
- If for some reason dnf/yum do not work, just download the script from https://pagure.io/standard-test-roles/raw/master/f/inventory/standard-inventory-qcow2
  - copy to your $PATH, and make sure it is executable
Install tox
- Use yum/dnf to install python3-tox - if that does not work, then use pip install --user tox, then make sure ~/.local/bin is in your $PATH
Install tox-lsr https://github.com/linux-system-roles/tox-lsr#how-to-get-it
```
pip install --user git+https://github.com/linux-system-roles/tox-lsr@main
```
Download the config file to ~/.config/linux-system-roles.json from https://github.com/linux-system-roles/linux-system-roles.github.io/blob/main/download/linux-system-roles.json
Assuming you are in a git clone of a role repo which has a tox.ini file - you can use e.g.
```
tox -e qemu-ansible-core-2.14 -- --image-name centos-9 tests/tests_default.yml
```

There are many command line options and environment variables which can be used to control the behavior, and you can customize the testenv in tox.ini. See https://github.com/linux-system-roles/tox-lsr#qemu-testing

This method supports RHEL also - will download the latest image for a compose, and will set up the yum repos to point to internal composes.