Terraform for deploying a full Charmed HPC cluster using the Slurm workload manager.
The plans make use of the Juju Terraform Provider to interact with a previously bootstrapped Juju controller. A justfile
is provided to simplify deployment through the just command runner and OpenTofu infrastructure as code tool.
A Juju 3.x controller bootstrapped on your choice of cloud is required. Steps for deploying:
# Prerequisites
juju bootstrap <cloud name> <controller name>
sudo snap install --classic opentofu
sudo apt install just
# Deploy with a single command!
just deploy
To learn more about the deployment and use of a Charmed HPC cluster, the following resources are available:
A useful command to help while hacking on the plans is:
just check # Checks file formatting and syntax are valid.
or equivalent OpenTofu commands:
tofu fmt -check -recursive # Apply formatting standards to files.
tofu validate # Ensure files are syntactically valid.
If you're interested in contributing, take a look at our contributing guidelines.
The Charmed HPC Terraform plans are a project of the Ubuntu High-Performance Computing community. Interested in contributing bug fixes, patches, documentation, or feedback? Want to join the Ubuntu HPC community? You’ve come to the right place!
Here’s some links to help you get started with joining the community:
- Ubuntu Code of Conduct
- Contributing guidelines
- Join the conversation on Matrix
- Get the latest news on Discourse
- Ask and answer questions on GitHub
The Charmed HPC Terraform plans are free software, distributed under the Apache Software License, version 2.0. See the Apache-2.0 LICENSE file for further details.