Execution target plugins and HPC support
New in q8s version v0.14.0
You can now install execution targets as separate plugins and run quantum workloads on HPC CPUs and AMD GPUs.
Select an execution target to run your workload on Kubernetes nodes or on HPC resources through interLink.
Install execution target plugins
The core q8s package includes the cpu target. Install additional plugins for the execution environments you use:
| Package | Target | Execution environment |
|---|---|---|
q8s | cpu | Kubernetes CPU nodes |
q8s-cuda | gpu | Kubernetes nodes with NVIDIA GPUs |
q8s-hpc-cpu | hpc-cpu | HPC CPU nodes |
q8s-hpc-rocm | hpc-rocm | HPC AMD GPUs using ROCm |
For example, to run workloads on NVIDIA GPUs:
pip install "q8s==0.14.0" q8s-cudaCUDA execution has moved to the q8s-cuda plugin. Install it when upgrading to
keep using --target gpu in your existing projects.
Run workloads on HPC resources
The new hpc-cpu and hpc-rocm targets submit workloads to an HPC system through a Kubernetes cluster connected using interLink . To use them, you need access to a cluster with this integration and the HPC resources.
HPC execution has been tested on the LUMI supercomputer .
Install the plugin for your HPC environment:
pip install q8s-hpc-cpuFor AMD GPUs using ROCm, install q8s-hpc-rocm instead.
Add the selected target and its Python dependencies to your Q8Sproject, then build its container image. Create an HpcConfig file alongside Q8Sproject with the virtual node and Slurm allocation settings for your HPC environment:
--q8s-node your-hpc-virtual-node
--account your-project
--partition your-partition
--time 00:30:00Execute your program with the selected target:
q8sctl execute app.py --target hpc-cpuUse --target hpc-rocm to run on AMD GPUs. To use a configuration file in another location, pass --hpc-config /path/to/HpcConfig.
Extend Qubernetes with new targets
Qubernetes discovers target plugins automatically through the q8s.targets Python entry point group. You can add new execution targets in separate Python packages without changing the q8s core.