This repository contains the terraform and ansible necessary to create and maintain the Galaxy Australia ecosystem. The contents of this repository are very specific to Galaxy Australia and are not general in any way.
Galaxy Australia can be accessed at: https://usegalaxy.org.au
If you wish to use Ansible and Terraform for your own Galaxy server then head over to the Galaxy Project's Git Hub for more resources or checkout the amazing range of Galaxy Administration with Ansible tutorials located at the Galaxy Training Network's site.
Galaxy Australia currently runs a number of instances and nodes, mostly on cloud resources using Openstack. The head node of Galaxy Australia runs on AARNet virtual machines in Sydney, with additional infrastructure deployed at the University of Queensland, the University of Melbourne and NCI.
We use Terraform to instantiate all of our VMs. Instructions for the installation of Terraform can be found here.
The terraform files contained here are for each of the clusters in the Galaxy Australia ecosystem. They also require the appropriate Openstack credentials file to be sourced before running.
To run the terraform scripts, go to the appropriate subfolder and test with:
terraform planThis will show you what changes will be made. Once satisfied use:
terraform apply
These playbooks are designed for Ansible versions 2.9 and above, but we recommend running with ansible-core version 2.12. This can be installed with pip. Note that PYPI versions are different to the ansible-core version:
# Requires python >=3.8; <3.12
pip install ansible==5.6.0 # this gets you ansible-core==2.12Further installation instructions for Ansible can be found here
Most of the roles used here are from Ansible Galaxy
They are all listed in the requirements.yml file. They can be installed locally with the ansible-galaxy command.
ansible-galaxy install -p roles -r requirements.ymlEach playbook can be run with:
ansible-playbook -i hosts --vault-password-file <vault-password-file> --private-key <ssh_key> <playbook>where you supply the <vault-password-file>, the <ssh_key> and the playbook you want to run.
All contributions to these playbooks are to be made by pull request.
We strongly suggest you fork the repository.
Jobs are scheduled using the Total Perspective Vortex (TPV) job scheduler. See also: TPV by example.
This repository is maintained by the Galaxy Australia team.
Credits:
The documentation/instructions for the Galaxy Australia implementation of Galaxy Europe's TIaaS (Training Infrastructure as a Service) system can be found here
 |
 |
|---|