Test - Runtime Verification¶

Overview¶

The test command provides comprehensive runtime verification for bazzite-ai installations. It tests GPU detection, CUDA/PyTorch functionality, service health, network connectivity, and pod container lifecycles.

Key Concept: Tests run on the LOCAL system to verify actual functionality, not just syntax.

Quick Reference¶

Action	Command	Description
All	`ujust test all`	Run all tests
Apptainer	`ujust test apptainer`	Apptainer GPU detection
Apptainer GPU	`ujust test apptainer gpu`	Apptainer GPU detection
Bootc	`ujust test bootc`	Bootc ephemeral VM test
ComfyUI	`ujust test comfyui`	ComfyUI test
Config	`ujust test config`	Configuration test
CUDA	`ujust test cuda`	CUDA test
GPU	`ujust test gpu`	GPU availability test
Help	`ujust test help`	Show test help
Jupyter	`ujust test jupyter`	JupyterLab test
Network	`ujust test network`	Network test
Ollama	`ujust test ollama`	Ollama inference test
Open WebUI	`ujust test openwebui`	Open WebUI test
Pods	`ujust test pods`	Pod container tests
PyTorch	`ujust test pytorch`	PyTorch test
Quick	`ujust test quick`	Quick runtime tests
Services	`ujust test services`	All services test
Status	`ujust test status`	Test status summary

Parameters¶

ACTION Parameter¶

ujust test ACTION=""

Parameter	Values	Description
`ACTION`	See actions below	Test to run

Without ACTION, shows interactive menu (requires TTY).

Test Options¶

ujust test [ACTION] [--instance=N] [--image=IMAGE] [--cpus=N] [--ram=MB] [--ssh-port=PORT]

Parameter	Default	Description
`--instance, -n`	`90`	Pod instance number for test pods
`--image, -i`	(default)	Container image for bootc testing
`--cpus`	`4`	CPUs for bootc VM
`--ram`	`8192`	RAM in MB for bootc VM
`--ssh-port`	`2222`	SSH port for bootc VM

Available Tests¶

Quick Tests¶

ujust test quick      # GPU + service status (~30s)
ujust test status     # Test status summary

GPU Tests¶

ujust test gpu        # GPU detection and CDI check
ujust test cuda       # CUDA tests in nvidia container
ujust test pytorch    # PyTorch GPU access test

Service Tests¶

ujust test ollama     # Ollama health + quick inference
ujust test jupyter    # Jupyter service health
ujust test comfyui    # ComfyUI service health
ujust test openwebui  # Open WebUI service health
ujust test services   # All installed services status

Infrastructure Tests¶

ujust test config     # Configuration dispatcher test
ujust test network    # Registry connectivity test
ujust test apptainer  # Apptainer GPU detection

VM Tests¶

ujust test bootc                    # Ephemeral bootc VM (auto-cleanup)
ujust test bootc --image=stable     # Test specific image

Pod Lifecycle Tests¶

ujust test pods config --instance=91   # Configure test pods
ujust test pods start --instance=91    # Start test pods
ujust test pods status --instance=91   # Check test pods status
ujust test pods stop --instance=91     # Stop test pods
ujust test pods delete --instance=91   # Delete test pod configs
ujust test pods all --instance=91      # Full lifecycle test

Common Workflows¶

Verify New Installation¶

# Quick verification
ujust test quick

# If issues found, run full suite
ujust test all

Verify GPU Support¶

# Check GPU detection
ujust test gpu

# Test CUDA if NVIDIA
ujust test cuda

# Test PyTorch GPU access
ujust test pytorch

Verify Services¶

# Test all services
ujust test services

# Or individual services
ujust test ollama
ujust test jupyter

Test Pod Lifecycle¶

# Full lifecycle test with isolated instance
ujust test pods all --instance=91

Non-Interactive Usage¶

All tests work without TTY:

# CI/automation-friendly
ujust test quick
ujust test gpu
ujust test all

Troubleshooting¶

GPU Not Detected¶

Symptom: ujust test gpu shows no GPU

Cause: GPU drivers not loaded or CDI not configured

Fix:

# Check NVIDIA driver
nvidia-smi

# Check CDI
ls /etc/cdi/

# Setup GPU container support
ujust config gpu setup

CUDA Test Fails¶

Symptom: ujust test cuda fails

Cause: NVIDIA container toolkit not configured

Fix:

ujust config gpu setup
# May require reboot

Service Test Fails¶

Symptom: Service test shows unhealthy

Cause: Service not running or misconfigured

Fix:

# Check specific service
ujust <service> status

# View logs
ujust <service> logs

# Restart service
ujust <service> restart

Cross-References¶

GPU Setup: config skill (ujust config gpu setup)
Service Management: Individual service skills (ollama, jupyter, etc.)
Pod Management: pods skill for aggregate operations

When to Use This Skill

Use when the user asks about:

"verify installation", "test bazzite-ai", "check if working"
"GPU test", "CUDA test", "PyTorch test"
"service health", "check services"
"network connectivity", "registry access"
"test pods", "lifecycle test"