This repository contains Ansible installation scripts for use in conjunction with SURF ResearchCloud. ResearchCloud catalog maintainers can configure components from the playbooks in this repo.
The scripts in this repository all target Unix/Linux workspaces. There is a separate repisitory for install scripts for Windows workspaces here.
The roles and playbooks in this repository can also be installed as an Ansible collection. The collection is named uusrc.general
. After installation, this means you can use the roles from this repository, for example as follows:
roles:
- role: uusrc.general.fact_regular_users
To install the collection you have two options:
- install manually with
ansible-galaxy collection install git+https://github.com/utrechtuniversity/researchcloud-items.git
- add this repository to your
requirements.yml
:
---
collections:
- name: https://github.com/UtrechtUniversity/researchcloud-items.git
type: git
Script developers, please consult the developer documentation before using a playbook to find out if the playbook meets your use case. For end-users, there is a Primer SURF ResearchCloud.
Some of the code maintained in this repo is derived from other sources. As a consequence, unfortunately we are unable to provide the entire repo content under a single general license. We use the following licensing policy:
- If their exists a license file in the root directory of a role then that license applies to all files belonging to that role.
- In all other cases the license specified in the top-level directory of this repository applies.
We are very happy with any contributions in terms of new Ansible scripts for Research Plug-ins and/or documentation. Read the contributing guidelines.
Molecule tests are run in GitHub Actions for pull requests and pushes to the main
branch. In order to avoid running expensive tests (spinning up SRC workspace containers for every scenario), the workflow checks which files have been modified, and thus need to be tested again.
There are two kinds of tests:
- Role tests. Molecule scenarios should be stored in the
playbooks/roles/<role>/molecule/
directory. - Playbook tests. Molecule scenarios should be stored in the
molecule/
directory and given aplaybook-
prefix.
By following this convention, the CI workflow knows that when a pull request modifies e.g. playbooks/roles/pyenv/tasks/main.yml
, the scenario molecule/role-pyenv
should be run. The CI tests are also run when anything changes in the scenario itself (so e.g. when you change molecule/playbook-python-workbench/molecule.yml
).