This repository contains the Checkbox DSS Provider (test cases and test plans for validating Intel GPU support in the Data Science Stack) as well as everything that is required to build the checkbox-dss snap. It also contains GitHub actions for running the tests weekly on Testflinger devices containing Intel GPUs.
Located in the checkbox-provider-dss directory, it contains:
- the test cases (also called "jobs" in the Checkbox jargon) and test plans to be run by Checkbox (in the
unitsdirectory)
- Ubuntu Jammy (22.04)
- Supported hardware platforms:
- Intel platforms with recent GPU (>= Broadwell)
Install the Checkbox runtime and build/install the dss provider snaps:
sudo snap install --classic snapcraft
sudo snap install checkbox22
lxd init --auto
git clone https://github.com/canonical/checkbox-dss-validation
cd checkbox-dss-validation
snapcraft
sudo snap install --dangerous --classic ./checkbox-dss_2.0_amd64.snapMake sure that the provider service is running and active:
systemctl status snap.checkbox-dss.remote-slave.serviceSome test need dependencies, so in order to run all tests, you might way to install those dependencies. A helper script is available to install them:
checkbox-dss.install-depsBy default this will install the data-science-stack snap from the latest/stable
channel. To instead install from latest/edge use:
checkbox-dss.install-deps --dss-snap-channel=latest/edgeTo run the test plans:
checkbox-dss.validate-intel-gpuWARNING: The following steps will remove kubectl and microk8s from your machine. If you wish to keep them, do not run.
To clean up and uninstall all installed tests, run:
checkbox-dss.remove-depsThis will also remove the data-science-stack snap as well as any notebook servers
that are managed by dss.
Since snaps are immutable, it is not possible to modify the content of the scripts or the test cases. Fortunately, Checkbox provides a functionality to side-load a provider on the DUT.
Therefore, if you want to edit a job definition, a script or a test plan, run the following commands on the DUT:
cd $HOME
git clone https://github.com/canonical/checkbox-dss-validation
mkdir /var/tmp/checkbox-providers
cp -r $HOME/checkbox-dss-validation/checkbox-provider-dss /var/tmp/checkbox-providers/You can then modify the content of the provider in /var/tmp/checkbox-providers/checkbox-provider-dss/, and it's this version that will be used when you run the tests.
Please refer to the Checkbox documentation on side-loading providers for more information.