Localhost Deployment Applications
Use localhost deployment applications to stand up development-friendly Vantage environments on your own machine.
After completing the prerequisites for your chosen substrate, use the standard CLI workflow:
Create a localhost cloud account
uvx v8x cloud account create localhost-lab --provider on_prem
Create a cluster with a localhost deployment application
Inspect the available deployment applications:
uvx v8x app list
Then create a cluster with one of the localhost deployment applications covered below:
uvx v8x cluster create my-local-cluster \
--cloud-account-id <ID> \
--app <deployment-application-name> \
--cluster-type slurm
Success looks like this: the localhost deployment application is configured and ready to back local clusters.
Inspect the resulting cluster
Use uvx v8x cluster get my-local-cluster or uvx v8x cluster list to monitor the result.
Localhost Provider Prereqs
To use the localhost deployment applications you will need to install the prereqs, depending on your use case.
MicroK8S
We use microk8s for a k8s sandbox on localhost.
To use the localhost deployment applications on microk8s, install microk8s first.
Install MicroK8S
sudo snap install microk8s --channel 1.29/stable --classic
Configure MicroK8S
sudo microk8s.enable hostpath-storage
sudo microk8s.enable dns
sudo microk8s.enable metallb:10.64.140.43-10.64.140.49
sudo usermod -a -G microk8s $USER
sudo chown -f -R $USER ~/.kube
newgrp microk8s
MicroK8S is now configured to work with the Vantage platform! Proceed to MicroK8S Deployment Applications to start deploying!
Multipass
Use multipass to launch a singlenode virtual-machine slurm cluster with the v8x.
To use the multipass localhost Deployment Applications, install multipass first.
Install Multipass
sudo snap install multipass
Verify Multipass Installation
multipass --version
Multipass is now installed. Proceed to the Multipass Singlenode Deployment Application Documentation.
Charmed HPC
The v8x provides charmed-hpc, curated to run in containers and VMs on your laptop or local machine.
Install lxd and juju
sudo snap install juju --channel 3.6/stable
sudo snap install lxd --channel latest/stable
Initialize LXD
sudo lxd init --auto
sudo adduser $USER lxd
lxc network set lxdbr0 ipv6.nat false
Bootstrap Juju
juju bootstrap localhost
At this point you have bootstrapped a localhost Juju controller on an LXD container and are ready to deploy. Proceed to the Charmed-HPC Deployment Application Documentation.